@finesoft/front 0.5.1 → 0.5.3

package/dist/index.mjs

@@ -1,264 +1,47 @@
-import{$ as e,$t as t,A as n,An as r,At as i,B as a,Bn as o,Bt as s,C as c,Cn as l,Ct as u,D as d,Dn as f,Dt as p,E as m,En as h,Et as g,F as _,Fn as v,Ft as y,G as b,Gn as x,Gt as S,H as ee,Hn as C,Ht as w,I as T,In as E,It as te,J as ne,Jn as re,Jt as ie,K as ae,Kn as oe,Kt as se,L as D,Ln as ce,Lt as le,M as ue,Mn as de,Mt as fe,N as pe,Nn as me,Nt as he,O as ge,On as _e,Ot as ve,P as ye,Pn as be,Pt as xe,Q as Se,Qt as Ce,R as we,Rn as Te,Rt as Ee,S as De,Sn as Oe,St as ke,T as Ae,Tn as je,Tt as O,U as k,Un as Me,Ut as Ne,V as Pe,Vn as Fe,Vt as Ie,W as Le,Wn as Re,Wt as A,X as ze,Xn as Be,Xt as Ve,Y as He,Yn as Ue,Yt as We,Z as Ge,Zn as Ke,Zt as qe,_ as Je,_n as Ye,_t as Xe,a as Ze,an as Qe,at as $e,b as et,bn as tt,bt as nt,c as rt,cn as it,ct as j,d as at,dn as ot,dt as st,en as ct,et as lt,f as ut,fn as M,ft as dt,g as ft,gn as pt,gt as mt,h as ht,hn as gt,ht as _t,i as vt,in as yt,it as bt,j as xt,jn as N,jt as St,k as Ct,kn as P,kt as wt,l as Tt,ln as Et,lt as F,m as Dt,mn as Ot,mt as kt,n as At,nn as jt,nt as Mt,o as Nt,on as Pt,ot as Ft,p as It,pn as Lt,pt as Rt,q as zt,qn as Bt,qt as I,r as Vt,rn as Ht,rt as Ut,s as Wt,sn as Gt,st as Kt,t as qt,tn as Jt,tt as L,u as Yt,un as Xt,ut as Zt,v as Qt,vn as $t,vt as en,w as tn,wn as nn,wt as rn,x as an,xn as on,xt as sn,y as cn,yn as ln,yt as un,z as dn,zn as fn,zt as pn}from"./browser-BHhVWXik.mjs";import{Hono as R}from"hono";async function z(e){return mn(e,0)}async function mn(e,t){if(t>=5)throw Error(`[SSR] Rewrite recursion depth exceeded (max 5) at "${e.url}"`);let{url:n,frameworkConfig:r,bootstrap:i,getErrorPage:a,renderApp:o,ssrContext:s,resolveLocale:c,loadMessages:l}=e,u=new URL(n,`http://localhost`),f=u.pathname+u.search,p=c?.(n,s?.request),m=p?{...r,locale:p.lang}:r,h=await P({locale:m.locale,loadMessages:l,context:m.locale?{runtime:`server`,fetch:hn(s?.fetch??m.fetch),url:f,request:s?.request}:void 0}),g={...m,fetch:s?.fetch??m.fetch},_=I.create({...g,_resolvedMessages:h});i(_);try{let n=await _.routeUrl(f);if(n?.renderMode===`csr`)return{html:``,head:``,css:``,serverData:[],renderMode:`csr`};let r,i=[],c;if(n){let l=d({url:f,intent:n.intent,container:_.container,request:s?.request}),u=await _.runBeforeLoad(l,n.beforeGuards);if(u.kind===`rewrite`)return mn({...e,url:u.url},t+1);if(u.kind!==`next`){let e=await gn(u,a,o,_);if(e)return e}try{r=await _.dispatch(n.intent),i=[{intent:n.intent,data:r}]}catch(e){_.container.resolve(M.LOGGER).error(`[SSR] dispatch failed for intent "${n.intent.id}":`,e),r=a(500,`Internal error`)}let p={...l,page:r},m=await _.runAfterLoad(p,n.afterGuards);if(m.kind===`rewrite`)c=m.url;else if(m.kind!==`next`){let e=await gn(m,a,o,_);if(e)return e}}else r=a(404,`Page not found`);let l=await o(r,_),u=p??_.getLocale();return{html:l.html,head:l.head,css:l.css,serverData:i,renderMode:n?.renderMode,slots:l.slots,locale:u,rewriteUrl:c}}finally{_.dispose()}}function hn(e){return(e??globalThis.fetch?.bind(globalThis))||(()=>{throw Error(`[ssrRender] loadMessages requires a fetch implementation.`)})}async function gn(e,t,n,r){switch(e.kind){case`next`:case`rewrite`:return null;case`redirect`:return{html:``,head:``,css:``,serverData:[],redirect:{url:e.url,status:e.status}};case`deny`:{let i=await n(t(e.status,e.message),r);return{html:i.html,head:i.head,css:i.css,serverData:[],slots:i.slots,status:e.status}}}}function _n(e){let{bootstrap:t,getErrorPage:n,renderApp:r,frameworkConfig:i,resolveLocale:a,loadMessages:o}=e;return(e,s)=>z({url:e,frameworkConfig:i??{},bootstrap:t,getErrorPage:n,renderApp:(e,t)=>r(e,t),ssrContext:s,resolveLocale:a,loadMessages:o})}const vn={HEAD:`<!--ssr-head-->`,BODY:`<!--ssr-body-->`,DATA:`<!--ssr-data-->`},yn=/<!--ssr-([a-z][a-z0-9-]*)-->/g;function B(e){let{template:t,head:n,css:r,html:i,serializedData:a,slots:o,locale:s}=e,c={head:`${n}\n${r?`<style>${r}</style>`:``}`,body:i,data:`<script id="serialized-server-data" type="application/json">${a}<\/script>`,...o},l=t.replace(yn,(e,t)=>c[t]??``);return s&&(l=Sn(l,s)),l}function V(e,t){let n=e.replace(yn,()=>``);return t&&(n=Sn(n,t)),n}const bn=/\s+lang=("[^"]*"|'[^']*'|[^\s>]+)/gi,xn=/\s+dir=("[^"]*"|'[^']*'|[^\s>]+)/gi;function Sn(e,t){return e.replace(/(<html)([^>]*)(>)/i,(e,n,r,i)=>`${n}${r.replace(bn,``).replace(xn,``)} lang="${t.lang}" dir="${t.dir}"${i}`)}const Cn=`@finesoft/navigation-tree`;async function wn(e){let{url:t,frameworkConfig:n,bootstrap:r,getErrorPage:a,renderApp:o,navigation:s,ssrContext:c,resolveLocale:l,loadMessages:u}=e,d=new URL(t,`http://localhost`),f=d.pathname+d.search,p=l?.(t,c?.request),m=p?{...n,locale:p.lang}:n,h=await P({locale:m.locale,loadMessages:u,context:m.locale?{runtime:`server`,fetch:In(c?.fetch??m.fetch),url:f,request:c?.request}:void 0}),g={...m,fetch:c?.fetch??m.fetch},_=I.create({...g,_resolvedMessages:h});r(_);try{let e=await Tn(_,s,f);if(e===void 0)return Fn({framework:_,resolvedLocale:p,renderApp:o,page:a(404,`Page not found`),snapshot:{tree:i(`@finesoft/not-found`),destinations:[]},serverData:[],renderMode:void 0,status:void 0});let{tree:t,renderMode:n}=e;if(n===`csr`)return{html:``,head:``,css:``,serverData:[],renderMode:`csr`,snapshot:{tree:t,destinations:[]}};let r,l=await En({framework:_,navigation:s,initialTree:t,fullPath:f,request:c?.request,getErrorPage:a,onRedirect:e=>{r??=e}}).resolve();if(r!==void 0)return{html:``,head:``,css:``,serverData:[],redirect:r,snapshot:l};let u=Dn(l,a);return Fn({framework:_,resolvedLocale:p,renderApp:o,page:u.page,snapshot:l,serverData:An(l),renderMode:n,status:u.status})}finally{_.dispose()}}async function Tn(e,t,n){let r=t.codec.decode(n,e.router);if(r!==void 0)return{tree:r,renderMode:void 0};let a=t.initial?.(n);if(a!==void 0)return{tree:a,renderMode:void 0};let o=await e.routeUrl(n);if(o!==null)return{tree:i(o.intent.id,o.intent.params??{}),renderMode:o.renderMode}}function En(e){let{framework:t,navigation:n,initialTree:r,fullPath:i,request:a,getErrorPage:o,onRedirect:s}=e;return L({intentDispatcher:t.intentDispatcher,router:t.router,initial:r,beforeLoad:n.beforeLoad,afterLoad:n.afterLoad,getErrorPage:o,onRedirect:s,createContext:({intent:e,params:n})=>({container:t.container,url:i,navigation:d({url:i,intent:{id:e,params:n},container:t.container,request:a})})})}function Dn(e,t){let n=On(e.tree);if(n!==void 0){let t=e.destinations.find(e=>e.intent===n.intent&&kn(e.params,n.params));if(t!==void 0)return t}return e.destinations.length>0?e.destinations[0]:{intent:`@finesoft/empty`,params:{},page:t(404,`Page not found`),status:404}}function On(e){let t=e;for(;;)switch(t.kind){case`leaf`:return{intent:t.intent,params:t.params};case`stack`:if(t.entries.length===0)return;t=t.entries[t.entries.length-1];break;case`tabs`:{let e=t.branches[t.active];if(e===void 0)return;t=e;break}case`split`:{let e;for(let n of t.columns)n.content!==void 0&&(e=n.content);if(e===void 0)return;t=e;break}}}function kn(e,t){let n=Object.keys(e),r=Object.keys(t);if(n.length!==r.length)return!1;for(let r of n)if(e[r]!==t[r])return!1;return!0}function An(e){let t=[];for(let n of e.destinations)t.push({intent:{id:n.intent,params:n.params},data:n.page});return t.push(jn(e.tree)),t}function jn(e){let t={__finesoftNavigationTree:!0,tree:F(e)};return{intent:{id:Cn},data:se(t,!0)}}function Mn(e){for(let t of e)if(Pn(t))return j(t.data.tree)}function Nn(e){return e.filter(e=>!Pn(e))}function Pn(e){if(e.intent.id!==`@finesoft/navigation-tree`)return!1;let t=e.data;return typeof t==`object`&&!!t&&t.__finesoftNavigationTree===!0}async function Fn(e){let{framework:t,resolvedLocale:n,renderApp:r,page:i,snapshot:a,serverData:o,renderMode:s,status:c}=e,l=await r(i,t,a),u=n??t.getLocale();return{html:l.html,head:l.head,css:l.css,serverData:o,renderMode:s,slots:l.slots,locale:u,status:c,snapshot:a}}function In(e){return(e??globalThis.fetch?.bind(globalThis))||(()=>{throw Error(`[ssrRenderNavigation] loadMessages requires a fetch implementation.`)})}function Ln(e){let{bootstrap:t,getErrorPage:n,renderApp:r,navigation:i,frameworkConfig:a,resolveLocale:o,loadMessages:s}=e;return(e,c)=>wn({url:e,frameworkConfig:a??{},bootstrap:t,getErrorPage:n,renderApp:r,navigation:i,ssrContext:c,resolveLocale:o,loadMessages:s})}const Rn={"<":`\\u003C`,">":`\\u003E`,"/":`\\u002F`,"\u2028":`\\u2028`,"\u2029":`\\u2029`},zn=RegExp(`[<>/\\u2028\\u2029]`,`g`);let Bn=!1;function Vn(e,t={}){let n=t.onUnmarkedPage??`all`,r=e.map(e=>Hn(e,n));return JSON.stringify(r).replace(zn,e=>Rn[e]??e)}function Hn(e,t){let n=e.data,r=A(n);if(r===!0)return e;if(Array.isArray(r))return{...e,data:Un(n,r)};if(t===`strict`)throw Error(`[serializeServerData] page for intent "${e.intent.id}" has no markPublic marker; wrap it with markPublic(page, ["field", ...]) to declare client-visible fields.`);return t===`base-fields`?{...e,data:Un(n,w)}:(Wn(e.intent.id),e)}function Un(e,t){let n={};for(let r of t)r in e&&(n[r]=e[r]);return n}function Wn(e){Bn||(Bn=!0,Gn()&&console.warn(`[finesoft/ssr] Page for intent "${e}" was serialized without markPublic(); all fields (including any sensitive data) are exposed in the SSR HTML. Wrap your page with markPublic(page, ["field", ...]) to declare client-visible fields explicitly. The next major version will default to BasePage-only fields when no marker is present.`))}function Gn(){try{return globalThis.process?.env?.NODE_ENV!==`production`}catch{return!1}}function Kn(e){return Object.entries(e).map(([e,t])=>t===``?e:`${e}="${qn(t)}"`).join(` `)}function qn(e){return e.replace(/&/g,`&amp;`).replace(/"/g,`&quot;`).replace(/</g,`&lt;`)}async function Jn(e,t){let n=[];for(let r of e.destinations){let e=k(r.intent,r.params),i=await t({intent:r.intent,params:r.params,entryKey:e,page:r.page}),a=Kn(O(r.intent,e));n.push(`<div ${a}>${i}</div>`)}return n.join(``)}const Yn=new Map,Xn=e=>import(e),Zn=typeof process<`u`&&process.env?.FINESOFT_DEBUG===`1`;function Qn(e){Zn&&console.debug(`[finesoft:dynamic-import] ${e}`)}async function H(e){let t=!e.startsWith(`file:`)&&!e.startsWith(`/`);if(t){let t=Yn.get(e);if(t)return Qn(`cache hit  → ${e}`),t}Qn(`importing  → ${e}`);let n=await Xn(e);return t&&Yn.set(e,n),n}const U=10*1024*1024;function $n(e){if(e.length>2048)return null;try{if(decodeURIComponent(e)!==e)return null}catch{return null}return e.startsWith(`//`)||!/^[/\w.\-~%:@!$&'()*+,;=]*$/.test(e)?null:e.startsWith(`/`)?e:`/${e}`}function er(e){if(!e.prefix.startsWith(`/`))throw Error(`[proxy] prefix must start with "/": "${e.prefix}"`);let t=e.target.startsWith(`https://`),n=e.target.startsWith(`http://`);if(!t&&!n)throw Error(`[proxy] target must start with "https://" or "http://": "${e.target}"`);n&&console.warn(`[proxy] ⚠ target "${e.target}" uses plain HTTP — traffic will not be encrypted. Use HTTPS in production to prevent data interception.`)}function W(e,t){for(let n of t){er(n);let t=n.methods??[`all`],r=`${n.prefix}/*`,i=async e=>{let t=$n(e.req.path.replace(n.prefix,``));if(!t)return e.text(`Invalid path`,400);let r=new URL(t,n.target),i=new URL(n.target).origin;if(r.origin!==i)return e.text(`Invalid proxy target`,400);new URL(e.req.url).searchParams.forEach((e,t)=>r.searchParams.set(t,e));let a={...n.headers};if(n.auth){let e=process.env[n.auth.envKey];e?a.Authorization=n.auth.type===`bearer`?`Bearer ${e}`:`Basic ${e}`:console.warn(`[Proxy ${n.prefix}] Auth env var "${n.auth.envKey}" is not set`)}try{let t=await fetch(r.toString(),{headers:a,redirect:n.followRedirects?`follow`:`manual`}),i=t.headers.get(`Content-Length`);if(i&&parseInt(i,10)>U)return e.text(`Proxy response too large`,502);let o=await t.arrayBuffer();if(o.byteLength>U)return e.text(`Proxy response too large`,502);let s={"Content-Type":t.headers.get(`Content-Type`)??`application/json`};return n.cache&&(s[`Cache-Control`]=n.cache),e.newResponse(o,t.status,s)}catch(t){return console.error(`[Proxy ${n.prefix}]`,t),e.json({error:`Proxy request failed`},502)}};for(let n of t)e[n](r,i)}}function tr(e){if(!e||e.length===0)return``;for(let t of e)er(t);let t=[];t.push(`
-// ─── 框架声明式代理路由 ───
-function _sanitizeProxyPath(raw) {
-  if (raw.length > 2048) return null;
-  try { if (decodeURIComponent(raw) !== raw) return null; } catch { return null; }
-  if (raw.startsWith("//")) return null;
-  if (!/^[/\\w.\\-~%:@!$&'()*+,;=]*$/.test(raw)) return null;
-  return raw.startsWith("/") ? raw : "/" + raw;
-}
-`);for(let n of e){let e=n.methods??[`all`],r=`"${n.prefix}/*"`,i=JSON.stringify(n.headers??{}),a=n.cache?JSON.stringify(n.cache):`null`,o=n.followRedirects?`"follow"`:`"manual"`,s=``;n.auth&&(s=`
-  const _token = (typeof process !== "undefined" && process.env && process.env[${JSON.stringify(n.auth.envKey)}]) || "";
-  if (_token) _headers.Authorization = "${n.auth.type===`bearer`?`Bearer `:`Basic `}" + _token;`);let c=`async (c) => {
-  const _sub = _sanitizeProxyPath(c.req.path.replace(${JSON.stringify(n.prefix)}, ""));
-  if (!_sub) return c.text("Invalid path", 400);
-  const _target = new URL(_sub, ${JSON.stringify(n.target)});
-  if (_target.origin !== ${JSON.stringify(new URL(n.target).origin)}) return c.text("Invalid proxy target", 400);
-  const _reqUrl = new URL(c.req.url);
-  _reqUrl.searchParams.forEach((v, k) => _target.searchParams.set(k, v));
-  const _headers = ${i};${s}
-  try {
-    const _resp = await fetch(_target.toString(), { headers: _headers, redirect: ${o} });
-    // Content-Length 快速拒绝，防止 serverless/edge 加载超大响应到内存
-    const _cl = _resp.headers.get("Content-Length");
-    if (_cl && parseInt(_cl, 10) > ${U}) {
-      return c.text("Proxy response too large", 502);
-    }
-    // arrayBuffer 保留二进制完整性
-    const _body = await _resp.arrayBuffer();
-    if (_body.byteLength > ${U}) {
-      return c.text("Proxy response too large", 502);
-    }
-    const _rh = { "Content-Type": _resp.headers.get("Content-Type") || "application/json" };
-    if (${a}) _rh["Cache-Control"] = ${a};
-    return c.newResponse(_body, _resp.status, _rh);
-  } catch (_e) {
-    console.error("[Proxy ${n.prefix}]", _e);
-    return c.json({ error: "Proxy request failed" }, 502);
-  }
-}`;for(let n of e)t.push(`app.${n}(${r}, ${c});`)}return t.join(`
-`)}const nr=[`vite`,`esbuild`,`rollup`,`fsevents`,`lightningcss`],rr=[`node:async_hooks`,`node:buffer`,`node:crypto`,`node:fs`,`node:http`,`node:http2`,`node:module`,`node:net`,`node:os`,`node:path`,`node:stream`,`node:url`,`node:util`,`node:zlib`,`crypto`,`http`,`http2`,`stream`];function G(e,t){let n=e.setupPath?`import _setupDefault from "./${e.setupPath}";`:``,r=e.setupPath?`if (typeof _setupDefault === "function") await _setupDefault(app);`:``,i=JSON.stringify(e.renderModes??{}),a=t.platformCache?t.platformCache:`
-const ISR_CACHE_MAX = 1000;
-const _isrMap = new Map();
-async function platformCacheGet(url) {
-  return _isrMap.get(url) ?? null;
-}
-async function platformCacheSet(url, html) {
-  if (_isrMap.size >= ISR_CACHE_MAX) {
-    const first = _isrMap.keys().next().value;
-    _isrMap.delete(first);
-  }
-  _isrMap.set(url, html);
-}`;return`
-import { Hono } from "hono";
-${t.platformImport}
-import { render, serializeServerData } from "./${e.ssrEntry}";
-${n}
-
-const TEMPLATE = ${JSON.stringify(e.templateHtml)};
-const RENDER_MODES = ${i};
-const DEFAULT_LOCALE = ${JSON.stringify(e.defaultLocale??null)};
-${a}
-
-function injectSSR(t, head, css, html, data, locale) {
-  const injected = t
-    .replace(/<!--ssr-([a-z][a-z0-9-]*)-->/g, (_, name) => {
-      const replacements = {
-        head: head + "\n<style>" + css + "</style>",
-        body: html,
-        data: '<script id="serialized-server-data" type="application/json">' + data + "<\/script>",
-      };
-      return replacements[name] ?? "";
-    });
-  return applyLocaleToHtml(injected, locale);
-}
-
-function applyLocaleToHtml(html, locale) {
-  if (!locale) return html;
-  return html.replace(/<html([^>]*)>/i, (_, attrs) => {
-    const a = attrs
-      .replace(/\\s+lang=("[^"]*"|'[^']*'|[^\\s>]+)/gi, "")
-      .replace(/\\s+dir=("[^"]*"|'[^']*'|[^\\s>]+)/gi, "");
-    return "<html" + a + ' lang="' + locale.lang + '" dir="' + locale.dir + '">';
-  });
-}
-
-function getLocaleAttrs(lang) {
-  if (!lang) return undefined;
-  const RTL = new Set(["ar","arc","dv","fa","ha","he","khw","ks","ku","ps","ur","yi"]);
-  const base = lang.split(/[-_]/)[0].toLowerCase();
-  return { lang: lang, dir: RTL.has(base) ? "rtl" : "ltr" };
-}
-
-function injectCSRShell(t, locale) {
-  const stripped = t.replace(/<!--ssr-([a-z][a-z0-9-]*)-->/g, () => "");
-  return applyLocaleToHtml(stripped, locale);
-}
-
-function matchRenderMode(url) {
-  const path = url.split("?")[0];
-  if (RENDER_MODES[path]) return RENDER_MODES[path];
-  for (const [pattern, mode] of Object.entries(RENDER_MODES)) {
-    if (pattern.includes("*")) {
-      const escaped = pattern.replace(/[.+?^\${}()|[\\]\\\\]/g, "\\\\$&");
-      const re = new RegExp("^" + escaped.replace(/\\*/g, ".*") + "$");
-      if (re.test(path)) return mode;
-    }
-  }
-  return null;
-}
-
-const app = new Hono();
-${tr(e.proxies??[])}
-${r}
-${t.platformMiddleware??``}
-
-// 内部 fetch 回环：SSR 控制器的 fetch 请求直接走 Hono 内存路由
-// 深度通过请求头传递，并发安全且能跨渲染正确追踪递归
-const _SSR_DEPTH_HEADER = "x-ssr-depth";
-const _MAX_SSR_DEPTH = 5;
-
-function _createInternalFetch(depth) {
-  return function(input, init) {
-    if (typeof input === "string" && input.startsWith("/")) {
-      const req = new Request("http://localhost" + input, init);
-      req.headers.set(_SSR_DEPTH_HEADER, String(depth));
-      return app.fetch(req);
-    }
-    return globalThis.fetch(input, init);
-  };
-}
-
-app.get("*", async (c) => {
-  // 递归深度保护：从请求头读取 SSR 深度
-  const _ssrDepth = parseInt(c.req.header(_SSR_DEPTH_HEADER) || "0", 10);
-  if (_ssrDepth >= _MAX_SSR_DEPTH) {
-    return c.text("SSR recursion loop detected", 508);
-  }
-
-  const url = c.req.path + (c.req.url.includes("?") ? "?" + c.req.url.split("?")[1] : "");
-  try {
-    // Vite 配置级别覆盖: CSR 直接返回空壳
-    const overrideMode = matchRenderMode(url);
-    if (overrideMode === "csr") {
-      return c.html(injectCSRShell(TEMPLATE, getLocaleAttrs(DEFAULT_LOCALE)));
-    }
-
-    // ISR 缓存命中
-    const cached = await platformCacheGet(url);
-    if (cached) return c.html(cached);
-
-    const { html: appHtml, head, css, serverData, renderMode, locale } = await render(url, { fetch: _createInternalFetch(_ssrDepth + 1) });
-    const localeAttrs = getLocaleAttrs(locale || DEFAULT_LOCALE);
-
-    // 路由级 CSR
-    if (renderMode === "csr") {
-      return c.html(injectCSRShell(TEMPLATE, localeAttrs));
-    }
-
-    const serializedData = serializeServerData(serverData);
-    const finalHtml = injectSSR(TEMPLATE, head, css, appHtml, serializedData, localeAttrs);
-
-    // Prerender ISR 缓存（包括 Vite 配置覆盖和路由级）
-    if (renderMode === "prerender" || overrideMode === "prerender") {
-      await platformCacheSet(url, finalHtml);
-      ${t.platformPrerenderResponseHook??``}
-    }
-
-    return c.html(finalHtml);
-  } catch (e) {
-    console.error("[SSR Error]", e);
-    return c.text("Internal Server Error", 500);
-  }
-});
-
-${t.platformExport}
-`}async function K(e,t){await e.vite.build({root:e.root,build:{ssr:t.entry,outDir:t.outDir,emptyOutDir:t.emptyOutDir??!0,target:t.target??`node18`,rollupOptions:{output:{entryFileNames:t.fileName??`index.mjs`}}},ssr:{noExternal:t.noExternal!==!1,external:[...t.external??nr,...rr]},resolve:e.resolvedResolve,css:e.resolvedCss})}function q(e,t,n){let{fs:r,path:i}=e;r.cpSync(i.resolve(e.root,`dist/client`),t,{recursive:!0}),n?.excludeHtml!==!1&&r.rmSync(i.join(t,`index.html`),{force:!0})}async function J(e){let{fs:t,path:n,root:r,vite:i}=e,{pathToFileURL:a}=await H(`node:url`),o=e.bootstrapEntry??`src/lib/bootstrap.ts`,s=[];if(t.existsSync(n.resolve(r,o))){await i.build({root:r,build:{ssr:o,outDir:n.resolve(r,`dist/server`),emptyOutDir:!1,rollupOptions:{output:{entryFileNames:`_routes_prerender.mjs`}}},resolve:e.resolvedResolve});let c=a(n.resolve(r,`dist/server/_routes_prerender.mjs`)).href,l=await H(c);s=l.routes??l.default??[],t.rmSync(n.resolve(r,`dist/server/_routes_prerender.mjs`),{force:!0})}let c=new Set;for(let e of s)e.renderMode===`prerender`&&e.path&&!e.path.includes(`:`)&&c.add(e.path);if(e.renderModes)for(let[t,n]of Object.entries(e.renderModes))n===`prerender`&&!t.includes(`*`)&&!t.includes(`:`)&&c.add(t);if(e.locales?.length){let t=[...c];for(let n of e.locales)for(let e of t){let t=e===`/`?`/${n}`:`/${n}${e}`;c.add(t)}}if(c.size===0)return[];let l=a(n.resolve(r,`dist/server/ssr.js`)).href,u=await H(l),d=[];for(let t of c)try{let{html:n,head:r,css:i,serverData:a,locale:o}=await u.render(t),s=u.serializeServerData(a),c=e.templateHtml.replace(/<!--ssr-([a-z][a-z0-9-]*)-->/g,(e,t)=>({head:r+`
-<style>`+i+`</style>`,body:n,data:`<script id="serialized-server-data" type="application/json">`+s+`<\/script>`})[t]??``);if(o){let{getLocaleAttributes:e}=await H(`@finesoft/core`),t=e(o);c=c.replace(/<html([^>]*)>/i,(e,n)=>`<html${n.replace(/\s+lang=("[^"]*"|'[^']*'|[^\s>]+)/gi,``).replace(/\s+dir=("[^"]*"|'[^']*'|[^\s>]+)/gi,``)} lang="${t.lang}" dir="${t.dir}">`)}d.push({url:t,html:c})}catch(e){console.warn(`  [prerender] Failed to render ${t}:`,e)}return d.length>0&&console.log(`  Pre-rendered ${d.length} pages (${c.size} routes)\n`),d}function ir(){return{name:`cloudflare`,async build(e){let{fs:t,path:n,root:r}=e,i=n.resolve(r,`dist/cloudflare`);t.rmSync(i,{recursive:!0,force:!0});let a=G(e,{platformImport:``,platformExport:`export default app;`,platformCache:`
-const ISR_CACHE_TTL = 3600; // 1 hour
-async function platformCacheGet(url) {
-  try {
-    const cache = caches.default;
-    const cacheKey = new Request("https://isr-cache/" + encodeURIComponent(url));
-    const resp = await cache.match(cacheKey);
-    if (resp) return await resp.text();
-  } catch {}
-  return null;
-}
-async function platformCacheSet(url, html) {
-  try {
-    const cache = caches.default;
-    const cacheKey = new Request("https://isr-cache/" + encodeURIComponent(url));
-    const resp = new Response(html, {
-      headers: { "Content-Type": "text/html; charset=utf-8", "Cache-Control": "public, max-age=" + ISR_CACHE_TTL },
-    });
-    await cache.put(cacheKey, resp);
-  } catch {}
-}`}),o=n.resolve(r,`.cf-entry.tmp.mjs`);t.writeFileSync(o,a);try{await K(e,{entry:`.cf-entry.tmp.mjs`,outDir:i,target:`es2022`,fileName:`_worker.js`}),q(e,n.resolve(i,`assets`));let r=await J(e);for(let{url:e,html:a}of r){let r=e===`/`?n.join(i,`assets`,`index.html`):n.join(i,`assets`,e,`index.html`);t.mkdirSync(n.resolve(r,`..`),{recursive:!0}),t.writeFileSync(r,a)}}finally{t.rmSync(o,{force:!0})}console.log(`  Cloudflare output → dist/cloudflare/
-`)}}}function ar(){return{name:`netlify`,async build(e){let{fs:t,path:n,root:r}=e,i=n.resolve(r,`.netlify/functions-internal/ssr`);t.rmSync(n.resolve(r,`.netlify`),{recursive:!0,force:!0});let a=G(e,{platformImport:`import { handle } from "hono/netlify";`,platformExport:`export default handle(app);
-export const config = { path: "/*", preferStatic: true };`,platformCache:`
-const ISR_SWR_TTL = 3600;
-const ISR_CACHE_MAX = 1000;
-const _isrMap = new Map();
-async function platformCacheGet(url) {
-  return _isrMap.get(url) ?? null;
-}
-async function platformCacheSet(url, html) {
-  if (_isrMap.size >= ISR_CACHE_MAX) {
-    const first = _isrMap.keys().next().value;
-    _isrMap.delete(first);
-  }
-  _isrMap.set(url, html);
-}`,platformPrerenderResponseHook:`c.header("Cache-Control", "public, max-age=0, must-revalidate");
-      c.header("Netlify-CDN-Cache-Control", "public, max-age=" + ISR_SWR_TTL + ", stale-while-revalidate=" + ISR_SWR_TTL + ", durable");`}),o=n.resolve(r,`.netlify-entry.tmp.mjs`);t.writeFileSync(o,a);try{await K(e,{entry:`.netlify-entry.tmp.mjs`,outDir:i,target:`node18`})}finally{t.rmSync(o,{force:!0})}t.writeFileSync(n.resolve(r,`dist/client/_redirects`),`/* /.netlify/functions/ssr 200
-`);let s=await J(e),c=n.resolve(r,`dist/client`);for(let{url:e,html:r}of s){let i=e===`/`?n.join(c,`index.html`):n.join(c,e,`index.html`);t.mkdirSync(n.resolve(i,`..`),{recursive:!0}),t.writeFileSync(i,r)}console.log(`  Netlify output → .netlify/functions-internal/ssr/
-  Publish dir: dist/client/
-`)}}}function or(){return{name:`node`,async build(e){let{fs:t,path:n,root:r}=e,i=G(e,{platformImport:`import { serve } from "@hono/node-server";
-import { readFileSync, existsSync } from "node:fs";
-import { resolve, dirname } from "node:path";
-import { fileURLToPath } from "node:url";`,platformMiddleware:`
-// 预渲染文件中间件：检查 dist/prerender/ 下是否有对应的静态 HTML
-const __entry_dirname = dirname(fileURLToPath(import.meta.url));
-const prerenderDir = resolve(__entry_dirname, "../prerender");
-
-app.use("*", async (c, next) => {
-  const urlPath = c.req.path;
-  const candidates = [
-    resolve(prerenderDir, "." + urlPath, "index.html"),
-    resolve(prerenderDir, "." + urlPath + ".html"),
-  ];
-  if (urlPath === "/") candidates.unshift(resolve(prerenderDir, "index.html"));
-  for (const f of candidates) {
-    if (existsSync(f)) {
-      const html = readFileSync(f, "utf-8");
-      return c.html(html);
-    }
-  }
-  await next();
+import { $ as isLeafNode, A as createActiveLeafCodec, At as getLocaleAttributes, B as findNode, Bt as secureFetch, C as runBeforeLoadGuards, Ct as defineApp, D as SERVER_REQUEST, Dt as implementOperation, E as SERVER_CONTROLLER, Et as implementController, F as serializeNavigation, Ft as englishPlural, G as push, Gt as ReportingLoggerFactory, H as pop, Ht as enforceHostGuard, I as serializeNavigationStable, It as interpolate, J as selectColumn, Jt as CompositeLogger, K as replaceTop, Kt as ConsoleLogger, L as collectAllLeaves, Lt as resolvePluralKey, M as decodeNavigationTreeParam, Mt as isRtl, N as encodeNavigationTreeParam, Nt as makeLocaleInfo, O as controllerContext, Ot as SimpleTranslator, P as deserializeNavigation, Pt as resolveLocaleFromUrl, Q as resourceKey, Qt as Container, R as collectVisibleDestinations, Rt as generateUuid, S as runAfterLoadGuards, St as createRuntime, T as getWebPlan, Tt as defineOperation, U as popTo, Ut as stableStringify, V as mapNavigationLeaves, Vt as fetchWithRedirects, W as popToRoot, Wt as ReportingLogger, X as setVisibility, Xt as isMultiValueSchema, Y as selectTab, Yt as CompositeLoggerFactory, Z as visibleSplitColumns, Zt as list, _ as SERVER_CONTROLLER_PATH, _t as isExternalUrlAction, a as createSessionStore, at as stack, b as decodeWireEnvelope, bt as makeFlowAction, c as decodeSnapshot, ct as NavigationError, d as createWebSession, dt as createHydrationDigest, et as isSplitNode, f as SESSION_DEFAULT_KEY, ft as PrefetchedIntents, g as loadPage, gt as isCompoundAction, h as StorageUnavailableError, ht as ACTION_KINDS, i as createWebRuntime, it as split, j as createFullStateCodec, jt as getTextDirection, k as DEFAULT_NAV_PARAM, kt as resolveMessages, l as encodeSnapshot, lt as SPLIT_VISIBILITIES, m as SessionError, mt as ActionDispatcher, n as definePage, nt as isTabsNode, o as collectLeafKeys, ot as tabs, p as SESSION_DEFAULT_VERSION, pt as Router, q as resolveActivePath, qt as ConsoleLoggerFactory, r as resolveInitialNavigation, rt as leaf, s as createNavigationScopedState, st as NAVIGATION_NODE_KINDS, t as parseCookieString, tt as isStackNode, u as NavigationCommitError, ut as route, v as ServerControllerProxy, vt as isFlowAction, w as defineWebApp, wt as defineModule, x as getFrameworkBuildId, xt as provide, y as FRAMEWORK_PROTOCOL_VERSION, yt as makeExternalUrlAction, z as findNearestStack, zt as detectPlatform } from "./src-BQBfaaPO.mjs";
+import { C as bool, D as str, E as oneOf, O as uuid, S as withDefault, T as num, _ as mapEach, a as safeErrorPage, b as HttpClient, c as ConsoleEventRecorder, d as getBaseUrl, f as removeHost, g as isSome, h as isNone, i as rewrite, k as makeSchema, l as CompositeEventRecorder, m as removeScheme, n as next, o as WithFieldsRecorder, p as removeQueryParams, r as redirect, s as VoidEventRecorder, t as deny, u as buildUrl, v as pipe, w as int, x as optional, y as pipeAsync } from "./types-B1BT0N3t.mjs";
+import { i as HttpError, n as classifyUrl, r as HostGuardError, t as classifyHost } from "./host-guard-DDWxLpFL.mjs";
+import { n as ExecutionError, r as executionErrorFromHttp, t as compilePath } from "./path-CGFl2w7D.mjs";
+import { a as isPublicMarked, i as getPublicFields, n as BASE_PAGE_FIELDS, o as markPublic, r as FINESOFT_PUBLIC, s as BaseController, t as resolveConfiguredMessages } from "./messages-CAt2QdGr.mjs";
+import { t as LruMap } from "./lru-map-BKoUAySU.mjs";
+import { n as createToken, t as DEP_KEYS } from "./src-Ftl_0rhu.mjs";
+import { _ as tryScroll, a as shouldLog, c as createDomRestore, d as createSessionBridge, f as defaultShouldRestore, g as History, h as createNavigationBridge, i as resetFilterCache, l as createWebStorage, m as deserializeServerData, n as IntersectionImpressionObserver, o as createBrowserApp, p as createPrefetchedIntentsFromDom, r as getPWADisplayMode, s as createBrowserContext, t as setHtmlLocaleAttributes, u as SESSION_DEFAULT_DEBOUNCE_MS } from "./browser-CR5vhgXg.mjs";
+import { a as serializeServerData, i as materializeServerData, n as createServerContext, r as createSSRRender, t as BaseServerController } from "./ssr-Tn4YkuxM.mjs";
+import { c as injectSSRContent, i as matchRenderModeOverride, n as registerProxyRoutes, o as SSR_PLACEHOLDERS, r as createSSRHandler, s as injectCSRShell } from "./proxy-z02VvGIj.mjs";
+import { n as defineEndpoint, r as runManagedTask, t as createHttpHandler } from "./http-D70PL72H.mjs";
+import { loadImplementation } from "#finesoft/implementation";
+//#region src/host-api.ts
+const node = () => loadImplementation("node");
+const vite = () => loadImplementation("vite");
+const typegen = () => loadImplementation("typegen");
+const startNodeHandler = (...args) => node().startNodeHandler(...args);
+const nodeDnsLookup = (...args) => node().nodeDnsLookup(...args);
+const nodeSafeFetchOptions = Object.freeze({
+	validateDns: false,
+	wrapFetch: (fetch) => node().nodeSafeFetchOptions.wrapFetch(fetch)
 });
-`,platformExport:`
-const port = +(process.env.PORT || 3000);
-serve({ fetch: app.fetch, port }, (info) => {
-  console.log(\`Server running at http://localhost:\${info.port}\`);
-});
-`}),a=n.resolve(r,`.node-entry.tmp.mjs`);t.writeFileSync(a,i);try{await K(e,{entry:`.node-entry.tmp.mjs`,outDir:n.resolve(r,`dist/server`),target:`node18`,emptyOutDir:!1})}finally{t.rmSync(a,{force:!0})}let o=await J(e);if(o.length>0){let e=n.resolve(r,`dist/prerender`);t.mkdirSync(e,{recursive:!0});for(let{url:r,html:i}of o){let a=r===`/`?n.join(e,`index.html`):n.join(e,r,`index.html`);t.mkdirSync(n.resolve(a,`..`),{recursive:!0}),t.writeFileSync(a,i)}}console.log(`  Node output → dist/server/index.mjs
-  Run: node dist/server/index.mjs
-`)}}}function sr(e={}){return{name:`static`,async build(t){let{fs:n,path:r,root:i}=t,a=r.resolve(i,`dist/static`);n.rmSync(a,{recursive:!0,force:!0}),n.mkdirSync(a,{recursive:!0});let{pathToFileURL:o}=await H(`node:url`),s=o(r.resolve(i,`dist/server/ssr.js`)).href,c=await H(s);t.copyStaticAssets(a,{excludeHtml:!0});let{paths:l,defs:u}=await cr(t,e);console.log(`  Pre-rendering ${l.length} pages...\n`);for(let e of l)try{let i=dr(e,u.find(t=>t.path===e)?.renderMode,t.renderModes),o;if(i===`csr`)o=ur(t.templateHtml);else{let{html:n,head:r,css:i,serverData:a}=await c.render(e),s=c.serializeServerData(a);o=lr(t.templateHtml,r,i,n,s)}let s=e===`/`?r.join(a,`index.html`):r.join(a,e,`index.html`);n.mkdirSync(r.resolve(s,`..`),{recursive:!0}),n.writeFileSync(s,o)}catch(t){console.warn(`  [static] Failed to render ${e}:`,t)}console.log(`  Static output → dist/static/
-`)}}}async function cr(e,t){let n=t.routesExport??`src/lib/bootstrap.ts`,r=[],i=[];try{let{pathToFileURL:t}=await H(`node:url`);await e.vite.build({root:e.root,build:{ssr:n,outDir:e.path.resolve(e.root,`dist/server`),emptyOutDir:!1,rollupOptions:{output:{entryFileNames:`_routes.mjs`}}},resolve:e.resolvedResolve});let a=t(e.path.resolve(e.root,`dist/server/_routes.mjs`)).href,o=await H(a),s=o.routes??o.default;if(Array.isArray(s))for(let e of s)e.path&&!e.path.includes(`:`)&&(r.push(e.path),i.push({path:e.path,renderMode:e.renderMode}));e.fs.rmSync(e.path.resolve(e.root,`dist/server/_routes.mjs`),{force:!0})}catch(e){console.warn(`  [static] Could not load routes from "${n}". Using "/" only.`,e),r.length===0&&r.push(`/`)}if(t.dynamicRoutes)for(let e of t.dynamicRoutes)r.includes(e)||r.push(e);return r.length===0&&r.push(`/`),{paths:r,defs:i}}function lr(e,t,n,r,i){let a=/<!--ssr-([a-z][a-z0-9-]*)-->/g,o={head:t+`
-<style>`+n+`</style>`,body:r,data:`<script id="serialized-server-data" type="application/json">`+i+`<\/script>`};return e.replace(a,(e,t)=>o[t]??``)}function ur(e){return e.replace(/<!--ssr-([a-z][a-z0-9-]*)-->/g,()=>``)}function dr(e,t,n){if(n){if(n[e])return n[e];for(let[t,r]of Object.entries(n))if(t.includes(`*`)){let n=t.replace(/[.+?^${}()|[\]\\]/g,`\\$&`);if(RegExp(`^`+n.replace(/\*/g,`.*`)+`$`).test(e))return r}}return t??`ssr`}function fr(){return{name:`vercel`,async build(e){let{fs:t,path:n,root:r}=e,i=n.resolve(r,`.vercel/output`);t.rmSync(i,{recursive:!0,force:!0});let a=G(e,{platformImport:`import { getRequestListener } from "@hono/node-server";`,platformExport:[`const _listener = getRequestListener(app.fetch);`,`export default (req, res) => {`,`  const m = req.headers["x-now-route-matches"];`,`  if (typeof m === "string") {`,`    try {`,`      const p = new URLSearchParams(m);`,`      const c = p.get("1");`,`      if (c != null) {`,`        const qi = (req.url || "").indexOf("?");`,`        const qs = qi !== -1 ? req.url.slice(qi) : "";`,`        req.url = "/" + decodeURIComponent(c) + qs;`,`      }`,`    } catch {}`,`  }`,`  return _listener(req, res);`,`};`].join(`
-`)}),o=n.resolve(r,`.vercel-entry.tmp.mjs`);t.writeFileSync(o,a);try{let i=n.resolve(r,`.vercel/output/functions/ssr.func`);await K(e,{entry:`.vercel-entry.tmp.mjs`,outDir:i,target:`node18`}),t.writeFileSync(n.resolve(i,`.vc-config.json`),JSON.stringify({runtime:`nodejs20.x`,handler:`index.mjs`,launcherType:`Nodejs`},null,2)),q(e,n.resolve(r,`.vercel/output/static`)),t.writeFileSync(n.resolve(r,`.vercel/output/config.json`),JSON.stringify({version:3,routes:[{handle:`filesystem`},{src:`/(.*)`,dest:`/ssr`}]},null,2))}finally{t.rmSync(o,{force:!0})}let s=await J(e),c=n.resolve(r,`.vercel/output/static`);for(let{url:e,html:r}of s){let i=e===`/`?n.join(c,`index.html`):n.join(c,e,`index.html`);t.mkdirSync(n.resolve(i,`..`),{recursive:!0}),t.writeFileSync(i,r)}if(s.length>0){let e=n.resolve(r,`.vercel/output/config.json`),i=JSON.parse(t.readFileSync(e,`utf-8`));i.overrides=i.overrides??{};for(let{url:e}of s){let t=e===`/`?`index.html`:`${e.replace(/^\//,``)}/index.html`;i.overrides[t]={path:e===`/`?`/`:e,contentType:`text/html; charset=utf-8`}}t.writeFileSync(e,JSON.stringify(i,null,2))}console.log(`  Vercel output → .vercel/output/
-`)}}}function Y(e){if(typeof e!=`string`)return e;switch(e){case`vercel`:return fr();case`cloudflare`:return ir();case`netlify`:return ar();case`node`:return or();case`static`:return sr();case`auto`:return pr();default:throw Error(`[finesoft] Unknown adapter: "${e}". Available: vercel, cloudflare, netlify, node, static, auto`)}}function pr(){return{name:`auto`,async build(e){let t=mr();return console.log(`  [auto] Detected platform: ${t}\n`),Y(t).build(e)}}}function mr(){return process.env.VERCEL?`vercel`:process.env.CF_PAGES?`cloudflare`:process.env.NETLIFY?`netlify`:`node`}function hr(e,t=1){return((n,r)=>{if(typeof n==`string`&&n.startsWith(`/`)){let i=new Request(`http://localhost${n}`,r);return i.headers.set(`x-ssr-depth`,String(t)),Promise.resolve(e(i))}return globalThis.fetch(n,r)})}function gr(e,t){if(!t)return null;let n=e.split(`?`)[0];if(t[n])return t[n];for(let[e,r]of Object.entries(t))if(e.includes(`*`)){let t=e.replace(/[.+?^${}()|[\]\\]/g,`\\$&`);if(RegExp(`^`+t.replace(/\*/g,`.*`)+`$`).test(n))return r}return null}function X(e){let{root:t,vite:n,isProduction:r,ssrEntryPath:i=`/src/ssr.ts`,ssrProductionModule:a,parentFetch:o,renderModes:s,defaultLocale:c}=e,l=new R,u=new D(1e3),d;async function f(e){if(!r&&n){let{readFileSync:r}=await H(`node:fs`),i=r((await H(`node:path`)).resolve(t,`index.html`),`utf-8`);return n.transformIndexHtml(e,i)}if(d)return d;if(globalThis.Deno!==void 0){let e=import.meta.url;return d=globalThis.Deno.readTextFileSync(new URL(`../dist/client/index.html`,e)),d}let{readFileSync:i}=await H(`node:fs`);return d=i((await H(`node:path`)).resolve(t,`dist/client/index.html`),`utf-8`),d}async function p(){if(!r&&n)return await n.ssrLoadModule(i);if(a)return H(a);let e=await H(`node:path`),{pathToFileURL:o}=await H(`node:url`),s=o(e.resolve(t,`dist/server/ssr.js`)).href;return H(s)}return l.get(`*`,async e=>{let t=parseInt(e.req.header(`x-ssr-depth`)??`0`,10);if(t>=5)return e.text(`SSR recursion loop detected`,508);let i=e.req.path+(e.req.url.includes(`?`)?`?`+e.req.url.split(`?`)[1]:``);try{let n=await f(i),r=await p();if(typeof r.render!=`function`||typeof r.serializeServerData!=`function`)throw Error(`[SSR] Module missing required exports: render, serializeServerData`);let{render:a,serializeServerData:l}=r,d=gr(i,s);if(d===`csr`)return e.html(V(n,c?N(c):void 0));let m=u.get(i);if(m)return e.html(m);let h=o?hr(o,t+1):void 0,g={request:e.req.raw};h&&(g.fetch=h);let{html:_,head:v,css:y,serverData:b,renderMode:x,redirect:S,slots:ee,locale:C,status:w,rewriteUrl:T}=await a(i,g);if(S)return e.redirect(S.url,S.status);if(x===`csr`)return e.html(V(n,C));let E=B({template:n,head:v,css:y,html:_,serializedData:l(b),slots:ee,locale:C});return(x===`prerender`||d===`prerender`)&&!w&&!T&&u.set(i,E),T&&e.header(`Content-Location`,T),w&&w>=400?e.html(E,w):e.html(E)}catch(t){return!r&&n&&n.ssrFixStacktrace(t),console.error(`[SSR Error]`,t),e.text(`Internal Server Error`,500)}}),l}function Z(){return{isDeno:globalThis.Deno!==void 0,isBun:globalThis.Bun!==void 0,isVercel:!!process.env.VERCEL,isProduction:process.env.NODE_ENV===`production`}}async function _r(e,t=0){if(globalThis.Deno!==void 0){let n=new URL(e);for(let e=0;e<t;e++)n=new URL(`..`,n);return n.pathname}let n=await H(`node:path`),{fileURLToPath:r}=await H(`node:url`),i=n.normalize(n.dirname(r(e)));for(let e=0;e<t;e++)i=n.resolve(i,`..`);return i}async function Q(e){let{app:t,root:n,port:r=3e3,isProduction:i,vite:a,routes:o,ssrEntryPath:s}=e,{isDeno:c,isBun:l,isVercel:u}=e.runtime??Z();function d(){let e=[`\n  Server running at http://localhost:${r}\n`];if(o&&o.length>0){e.push(`  Routes:`);for(let t of o)e.push(`    ${t}`);e.push(``)}s&&e.push(`  SSR Entry: ${s}`),s&&e.push(``),console.log(e.join(`
-`))}if(u)return{vite:a};if(!i){let e=a;if(!e){let{createServer:t}=await H(`vite`);e=await t({root:n,server:{middlewareMode:!0},appType:`custom`})}let{getRequestListener:i}=await H(`@hono/node-server`),{createServer:o}=await H(`node:http`),s=i(t.fetch);return o((t,n)=>{e.middlewares(t,n,()=>s(t,n))}).listen(r,()=>{d()}),{vite:e}}if(c)globalThis.Deno.serve({port:r},t.fetch);else if(!l){let{serveStatic:e}=await H(`@hono/node-server/serve-static`),i=await H(`node:path`),a=new R,o=i.resolve(n,`dist/client`);a.use(`/*`,e({root:o,rewriteRequestPath:e=>e.endsWith(`/`)?`/__nosuchfile__`:e})),a.route(`/`,t);let{serve:s}=await H(`@hono/node-server`);s({fetch:a.fetch,port:r},()=>{d()})}return{vite:a}}async function vr(e={}){let{root:t,port:n=Number(process.env.PORT)||3e3,setup:r,proxies:i,ssr:a}=e,o=t??process.cwd(),{existsSync:s}=await H(`node:fs`),c=(await H(`node:path`)).resolve(o,`.env`);if(s(c))try{let{config:e}=await H(`dotenv`);e({path:c})}catch(e){console.warn(`[Server] Failed to load .env: ${e.message}`)}let l=Z(),u;if(!l.isProduction&&!l.isVercel){let{createServer:e}=await H(`vite`);u=await e({root:o,server:{middlewareMode:!0},appType:`custom`})}let d=new R;i?.length&&W(d,i),r&&await r(d);let f=X({root:o,vite:u,isProduction:l.isProduction,parentFetch:d.fetch.bind(d),...a});return d.route(`/`,f),await Q({app:d,root:o,port:n,isProduction:l.isProduction,vite:u,runtime:l,ssrEntryPath:a?.ssrEntryPath}),{app:d,vite:u,runtime:l}}function yr(e,t,n){let r=t??[`zh`,`en`],i=n??r[0]??`en`;if(!e||e.length>1024)return i;let a=e.split(`,`);if(a.length>50)return i;let o=a.map(e=>{let[t,n]=e.trim().split(`;q=`),r=n?parseFloat(n):1;return{lang:t.trim().toLowerCase(),q:Number.isFinite(r)&&r>=0&&r<=1?r:0}}).filter(e=>e.q>0).sort((e,t)=>t.q-e.q);for(let{lang:e}of o){let t=e.split(`-`)[0];if(r.includes(t))return t}return i}const $=`virtual:finesoft-front/i18n-loader`,br=`\0${$}`;function xr(e){return typeof e.default==`function`?e.default:typeof e.setup==`function`?e.setup:Object.values(e).find(e=>typeof e==`function`)??null}function Sr(e,t){if(!t)return null;let n=e.split(`?`)[0];if(t[n])return t[n];for(let[e,r]of Object.entries(t))if(e.includes(`*`)){let t=e.replace(/[.+?^${}()|[\]\\]/g,`\\$&`);if(RegExp(`^`+t.replace(/\*/g,`.*`)+`$`).test(n))return r}return null}function Cr(e){return e.replace(/\\/g,`/`)}let wr=!1;function Tr(){wr||(wr=!0,console.log(`\n${(e=>`\x1b[33m${e}\x1b[0m`)(`[finesoft]`)} dev server is exposing source via /src/* and /@fs/* (HMR).\n`+(e=>`\x1b[2m${e}\x1b[0m`)("           Do NOT expose this server to untrusted networks; run `vp build && vp preview` for production.\n")))}async function Er(e,t){let{existsSync:n}=await H(`node:fs`),r=await H(`node:path`),i=r.isAbsolute(t)?t:r.resolve(e,t);if(!n(i))throw Error(`[finesoftFrontViteConfig] i18n.messagesDir not found: ${t}`);let a=Cr(r.relative(e,i));if(!a||a.startsWith(`..`))throw Error(`[finesoftFrontViteConfig] i18n.messagesDir must stay inside the project root: ${t}`);return a.replace(/^\.\/+/,``)}function Dr(e={}){let t=e.ssr?.entry??`src/ssr.ts`,n=process.cwd(),r,i,a,o=/\.(css|scss|less|sass|styl|stylus|pcss|postcss)($|\?)/;return{name:`finesoft-front`,config(t){let n={appType:`custom`,define:{__FINESOFT_I18N_LOADER_SPECIFIER__:e.i18n?.messagesDir?JSON.stringify($):`undefined`}};return process.env.__FINESOFT_SUB_BUILD__||(n.build={outDir:t.build?.outDir??`dist/client`}),n},configResolved(e){r=e.command,i=e.resolve,a=e.css,n=e.root},resolveId(t){return t===$&&e.i18n?.messagesDir?br:null},async load(t){if(t!==br||!e.i18n?.messagesDir)return null;let r=`/${await Er(n,e.i18n.messagesDir)}`,i=`${r}/*.json`,a=`${r}/`;return`
-const localeModules = import.meta.glob(${JSON.stringify(i)}, { import: "default" });
+const finesoftFrontViteConfig = (...args) => vite().finesoftFrontViteConfig(...args);
+const generateControllerTypes = (...args) => typegen().generateControllerTypes(...args);
+const generateFrontTypes = (...args) => typegen().generateFrontTypes(...args);
+const autoAdapter = (...args) => vite().autoAdapter(...args);
+const cloudflareAdapter = (...args) => vite().cloudflareAdapter(...args);
+const netlifyAdapter = (...args) => vite().netlifyAdapter(...args);
+const nodeAdapter = (...args) => vite().nodeAdapter(...args);
+const staticAdapter = (...args) => vite().staticAdapter(...args);
+const vercelAdapter = (...args) => vite().vercelAdapter(...args);
+const resolveAdapter = (...args) => vite().resolveAdapter(...args);
+const generateProxyCode = (...args) => vite().generateProxyCode(...args);
+//#endregion
+//#region src/native-api.ts
+function binding(renderer) {
+	if (renderer !== "react" && renderer !== "vue" && renderer !== "svelte") throw TypeError(`Unknown native renderer: ${String(renderer)}`);
+	return loadImplementation(renderer);
+}
+/** Select once, outside rendering, to retain native component identity and local state. */
+const Outlet = (renderer) => binding(renderer).Outlet;
+/** Uses the selected framework's native subscription and cleanup lifetime. */
+const useSnapshot = (renderer, app) => binding(renderer).useSnapshot(app);
+//#endregion
+export { ACTION_KINDS, ActionDispatcher, BASE_PAGE_FIELDS, BaseController, BaseServerController, CompositeEventRecorder, CompositeLogger, CompositeLoggerFactory, ConsoleEventRecorder, ConsoleLogger, ConsoleLoggerFactory, Container, DEFAULT_NAV_PARAM, DEP_KEYS, ExecutionError, FINESOFT_PUBLIC, FRAMEWORK_PROTOCOL_VERSION, History, HostGuardError, HttpClient, HttpError, IntersectionImpressionObserver, LruMap, NAVIGATION_NODE_KINDS, NavigationCommitError, NavigationError, Outlet, PrefetchedIntents, ReportingLogger, ReportingLoggerFactory, Router, SERVER_CONTROLLER, SERVER_CONTROLLER_PATH, SERVER_REQUEST, SESSION_DEFAULT_DEBOUNCE_MS, SESSION_DEFAULT_KEY, SESSION_DEFAULT_VERSION, SPLIT_VISIBILITIES, SSR_PLACEHOLDERS, ServerControllerProxy, SessionError, SimpleTranslator, StorageUnavailableError, VoidEventRecorder, WithFieldsRecorder, autoAdapter, bool, buildUrl, classifyHost, classifyUrl, cloudflareAdapter, collectAllLeaves, collectLeafKeys, collectVisibleDestinations, compilePath, controllerContext, createActiveLeafCodec, createBrowserApp, createBrowserContext, createDomRestore, createFullStateCodec, createHttpHandler, createHydrationDigest, createNavigationBridge, createNavigationScopedState, createPrefetchedIntentsFromDom, createRuntime, createSSRHandler, createSSRRender, createServerContext, createSessionBridge, createSessionStore, createToken, createWebRuntime, createWebSession, createWebStorage, decodeNavigationTreeParam, decodeSnapshot, decodeWireEnvelope, defaultShouldRestore, defineApp, defineEndpoint, defineModule, defineOperation, definePage, defineWebApp, deny, deserializeNavigation, deserializeServerData, detectPlatform, encodeNavigationTreeParam, encodeSnapshot, enforceHostGuard, englishPlural, executionErrorFromHttp, fetchWithRedirects, findNearestStack, findNode, finesoftFrontViteConfig, generateControllerTypes, generateFrontTypes, generateProxyCode, generateUuid, getBaseUrl, getFrameworkBuildId, getLocaleAttributes, getPWADisplayMode, getPublicFields, getTextDirection, getWebPlan, implementController, implementOperation, injectCSRShell, injectSSRContent, int, interpolate, isCompoundAction, isExternalUrlAction, isFlowAction, isLeafNode, isMultiValueSchema, isNone, isPublicMarked, isRtl, isSome, isSplitNode, isStackNode, isTabsNode, leaf, list, loadPage, makeExternalUrlAction, makeFlowAction, makeLocaleInfo, makeSchema, mapEach, mapNavigationLeaves, markPublic, matchRenderModeOverride, materializeServerData, netlifyAdapter, next, nodeAdapter, nodeDnsLookup, nodeSafeFetchOptions, num, oneOf, optional, parseCookieString, pipe, pipeAsync, pop, popTo, popToRoot, provide, push, redirect, registerProxyRoutes, removeHost, removeQueryParams, removeScheme, replaceTop, resetFilterCache, resolveActivePath, resolveAdapter, resolveConfiguredMessages, resolveInitialNavigation, resolveLocaleFromUrl, resolveMessages, resolvePluralKey, resourceKey, rewrite, route, runAfterLoadGuards, runBeforeLoadGuards, runManagedTask, safeErrorPage, secureFetch, selectColumn, selectTab, serializeNavigation, serializeNavigationStable, serializeServerData, setHtmlLocaleAttributes, setVisibility, shouldLog, split, stableStringify, stack, startNodeHandler, staticAdapter, str, tabs, tryScroll, useSnapshot, uuid, vercelAdapter, visibleSplitColumns, withDefault };
 
-export async function loadMessages(locale) {
-  const loader = localeModules[${JSON.stringify(a)} + locale + ".json"];
-  if (!loader) return undefined;
-  const messages = await loader();
-  return messages ?? undefined;
-}
-`},transformIndexHtml:{order:`pre`,async handler(e,t){let n=t.server;if(!n)return;let r=(t.originalUrl||t.path||``).split(`?`)[0];if(/\.\w+$/.test(r)&&!r.endsWith(`.html`))return;let i=[...e.matchAll(/<script\b[^>]*\bsrc=["']([^"']+)["'][^>]*>/g)].find(e=>!e[1].startsWith(`/@`));if(!i)return;let a=i[1];try{await n.transformRequest(a)}catch{return}let s=[],c=new Set;function l(e,t=0){if(!(t>100)&&!(!e?.url||c.has(e.url))&&(c.add(e.url),o.test(e.url)&&!e.url.includes(`.svelte`)&&s.push(e.url),e.importedModules))for(let n of e.importedModules)l(n,t+1)}let u=await n.moduleGraph.getModuleByUrl(a);if(u&&l(u),s.length===0)return;let d=[];for(let e of s)try{let t=(await n.ssrLoadModule(e))?.default;typeof t==`string`&&t.length>0&&d.push({tag:`style`,attrs:{"data-vite-dev-id":e},children:t,injectTo:`head`})}catch{}return d}},configureServer(r){return async()=>{let{Hono:i}=await H(`hono`),{getRequestListener:a}=await H(`@hono/node-server`);Tr();let o=new i;if(e.proxies?.length&&W(o,e.proxies),typeof e.setup==`function`)await e.setup(o);else if(typeof e.setup==`string`){let t=xr(await r.ssrLoadModule(`/`+e.setup));t&&await t(o)}let s=X({root:n,vite:r,isProduction:!1,ssrEntryPath:`/`+t,parentFetch:o.fetch.bind(o),renderModes:e.renderModes,defaultLocale:e.defaultLocale});o.route(`/`,s);let c=a(o.fetch);r.middlewares.use((e,t)=>{c(e,t)})}},configurePreviewServer(t){return async()=>{let{readFileSync:r}=await H(`node:fs`),i=await H(`node:path`),{pathToFileURL:a}=await H(`node:url`),{Hono:o}=await H(`hono`),{getRequestListener:s}=await H(`@hono/node-server`),c=new o,l=new D(1e3);if(e.proxies?.length&&W(c,e.proxies),typeof e.setup==`function`)await e.setup(c);else if(typeof e.setup==`string`)try{let e=a(i.resolve(n,`dist/server/setup.mjs`)).href,t=xr(await H(e));t&&await t(c)}catch{console.warn(`[finesoft] Could not load setup module for preview. API routes disabled.`)}let u=r(i.resolve(n,`dist/client/index.html`),`utf-8`),d=a(i.resolve(n,`dist/server/ssr.js`)).href,f=await H(d);c.get(`*`,async t=>{let n=parseInt(t.req.header(`x-ssr-depth`)??`0`,10);if(n>=5)return t.text(`SSR recursion loop detected`,508);let r=t.req.path+(t.req.url.includes(`?`)?`?`+t.req.url.split(`?`)[1]:``);try{let i=Sr(r,e.renderModes);if(i===`csr`)return t.html(V(u,e.defaultLocale?N(e.defaultLocale):void 0));let a=l.get(r);if(a)return t.html(a);let{html:o,head:s,css:d,serverData:p,renderMode:m,redirect:h,slots:g,locale:_,status:v,rewriteUrl:y}=await f.render(r,{fetch:hr(c.fetch.bind(c),n+1)});if(h)return t.redirect(h.url,h.status);if(m===`csr`)return t.html(V(u,_));let b=B({template:u,head:s,css:d,html:o,serializedData:f.serializeServerData(p),slots:g,locale:_});return(m===`prerender`||i===`prerender`)&&!v&&!y&&l.set(r,b),y&&t.header(`Content-Location`,y),v&&v>=400?t.html(b,v):t.html(b)}catch(e){return console.error(`[SSR Preview Error]`,e),t.text(`Internal Server Error`,500)}});let p=s(c.fetch);t.middlewares.use((e,t)=>{p(e,t)})}},async closeBundle(){if(!process.env.__FINESOFT_SUB_BUILD__&&r===`build`){process.env.__FINESOFT_SUB_BUILD__=`1`;try{let r=await H(`vite`),o=await H(`node:fs`),s=await H(`node:path`);if(console.log(`
-  Building SSR bundle...
-`),await r.build({root:n,build:{ssr:t,outDir:`dist/server`},ssr:{external:rr},resolve:i,css:a}),typeof e.setup==`string`&&(console.log(`  Building setup module...
-`),await r.build({root:n,build:{ssr:e.setup,outDir:`dist/server`,emptyOutDir:!1,rollupOptions:{output:{entryFileNames:`setup.mjs`}}},resolve:i})),e.adapter){let c=Y(e.adapter),l=o.readFileSync(s.resolve(n,`dist/client/index.html`),`utf-8`),u={root:n,ssrEntry:t,setupPath:typeof e.setup==`string`?e.setup:void 0,bootstrapEntry:e.bootstrapEntry,templateHtml:l,renderModes:e.renderModes,proxies:e.proxies,locales:e.locales,defaultLocale:e.defaultLocale,resolvedResolve:i,resolvedCss:a,vite:r,fs:o,path:s,generateSSREntry(e){return G(u,e)},buildBundle(e){return K(u,e)},copyStaticAssets(e,t){return q(u,e,t)}};console.log(`  Running adapter: ${c.name}...\n`),await c.build(u)}}finally{delete process.env.__FINESOFT_SUB_BUILD__}}}}}export{oe as ACTION_KINDS,x as ActionDispatcher,w as BASE_PAGE_FIELDS,s as BaseController,Oe as BaseLogger,an as CompositeEventRecorder,l as CompositeLogger,nn as CompositeLoggerFactory,gt as ConsoleEventRecorder,$t as ConsoleLogger,ln as ConsoleLoggerFactory,Me as Container,Mt as DEFAULT_NAV_PARAM,M as DEP_KEYS,Ne as FINESOFT_PUBLIC,I as Framework,ht as History,Te as HostGuardError,fn as HttpClient,o as HttpError,Re as IntentDispatcher,et as IntersectionImpressionObserver,D as LruMap,xe as NAVIGATION_NODE_KINDS,lt as NAVIGATION_OP_KINDS,Cn as NAVIGATION_TREE_INTENT_ID,y as NavigationError,ie as PrefetchedIntents,pt as ReportingLogger,Ye as ReportingLoggerFactory,Pt as Router,vt as SESSION_DEFAULT_DEBOUNCE_MS,ae as SESSION_DEFAULT_KEY,zt as SESSION_DEFAULT_VERSION,te as SPLIT_VISIBILITIES,vn as SSR_PLACEHOLDERS,ne as SessionError,je as SimpleTranslator,cn as VoidEventRecorder,Qt as WithFieldsRecorder,pr as autoAdapter,ct as bool,Ct as buildUrl,Fe as classifyHost,C as classifyUrl,ir as cloudflareAdapter,st as collectAllLeaves,Pe as collectLeafKeys,dt as collectVisibleDestinations,Ut as createActiveLeafCodec,ut as createAppHandle,m as createBrowserContext,at as createDomRestore,bt as createFlatStackCodec,$e as createFullStateCodec,Yt as createIslandOrchestrator,Tt as createNavigationBridge,L as createNavigationController,ee as createNavigationScopedState,we as createNavigationSessionAdapter,Wt as createPrefetchedIntentsFromDom,X as createSSRApp,Ln as createSSRNavigationRender,_n as createSSRRender,vr as createServer,d as createServerContext,Ze as createSessionBridge,a as createSessionStore,dn as createUrlSessionAdapter,Vt as createWebStorage,Ft as decodeNavigationTreeParam,Le as decodeSnapshot,Nt as defaultShouldRestore,e as defineNavigation,ot as defineRequestScopedKey,ze as defineRoute,Ge as defineRoutes,De as deny,j as deserializeNavigation,rt as deserializeServerData,Ot as detectPlatform,Z as detectRuntime,Kt as encodeNavigationTreeParam,b as encodeSnapshot,h as englishPlural,Mn as extractNavigationTree,Rt as findNearestStack,kt as findNode,Dr as finesoftFrontViteConfig,tr as generateProxyCode,ge as generateUuid,n as getBaseUrl,N as getLocaleAttributes,ye as getPWADisplayMode,A as getPublicFields,de as getTextDirection,V as injectCSRShell,B as injectSSRContent,Jt as int,f as interpolate,Bt as isCompoundAction,re as isExternalUrlAction,Ue as isFlowAction,g as isLeafNode,Et as isMultiValueSchema,_ as isNone,S as isPublicMarked,me as isRtl,T as isSome,p as isSplitNode,ve as isStackNode,wt as isTabsNode,He as isUrlLocation,O as islandContainerAttributes,i as leaf,Xt as list,Lt as makeDependencies,Be as makeExternalUrlAction,Ke as makeFlowAction,be as makeLocaleInfo,Gt as makeSchema,le as mapEach,se as markPublic,ar as netlifyAdapter,c as next,or as nodeAdapter,jt as num,Ht as oneOf,Ce as optional,yr as parseAcceptLanguage,Ee as pipe,pn as pipeAsync,_t as pop,mt as popTo,Xe as popToRoot,en as push,tn as redirect,It as registerActionHandlers,Je as registerExternalUrlHandler,Dt as registerFlowActionHandler,W as registerProxyRoutes,xt as removeHost,ue as removeQueryParams,pe as removeScheme,Jn as renderIslandsHtml,un as replaceTop,tt as resetFilterCache,nt as resolveActivePath,Y as resolveAdapter,P as resolveConfiguredMessages,qt as resolveIslandsShell,v as resolveLocaleFromUrl,r as resolveMessages,_e as resolvePluralKey,_r as resolveRoot,Ae as rewrite,Se as route,Ve as runAfterLoadGuards,qe as runBeforeLoadGuards,it as runStandard,Ie as safeErrorPage,ce as secureFetch,sn as selectColumn,ke as selectTab,F as serializeNavigation,Zt as serializeNavigationStable,Vn as serializeServerData,k as sessionEntryKey,E as setHtmlLocaleAttributes,u as setVisibility,on as shouldLog,St as split,z as ssrRender,wn as ssrRenderNavigation,We as stableStringify,fe as stack,At as startBrowserApp,Q as startServer,sr as staticAdapter,yt as str,Nn as stripNavigationTree,he as tabs,ft as tryScroll,Qe as uuid,fr as vercelAdapter,rn as visibleSplitColumns,t as withDefault};
 //# sourceMappingURL=index.mjs.map

package/dist/load-node.d.mts

@@ -0,0 +1,5 @@
+//#region src/load-node.d.ts
+declare function loadImplementation(name: string): any;
+//#endregion
+export { loadImplementation };
+//# sourceMappingURL=load-node.d.mts.map

package/dist/load-node.mjs

@@ -0,0 +1,10 @@
+import { createRequire } from "node:module";
+//#region src/load-node.ts
+const require = createRequire(import.meta.url);
+function loadImplementation(name) {
+	return require(`./${name}.mjs`);
+}
+//#endregion
+export { loadImplementation };
+
+//# sourceMappingURL=load-node.mjs.map

package/dist/load-portable.d.mts

@@ -0,0 +1,5 @@
+//#region src/load-portable.d.ts
+declare function loadImplementation(name: string): never;
+//#endregion
+export { loadImplementation };
+//# sourceMappingURL=load-portable.d.mts.map

package/dist/load-portable.mjs

@@ -0,0 +1,8 @@
+//#region src/load-portable.ts
+function loadImplementation(name) {
+	throw Error(`[finesoft] ${name} requires its platform host. Use the finesoft Vite plugin for native UI bindings.`);
+}
+//#endregion
+export { loadImplementation };
+
+//# sourceMappingURL=load-portable.mjs.map

package/dist/lru-map-BKoUAySU.mjs

@@ -0,0 +1,50 @@
+//#region ../core/src/utils/lru-map.ts
+/**
+* LruMap — 固定容量的 LRU 缓存
+*/
+var LruMap = class {
+	map = /* @__PURE__ */ new Map();
+	capacity;
+	constructor(capacity) {
+		if (capacity < 1) throw new Error(`[LruMap] capacity must be >= 1, got ${capacity}`);
+		this.capacity = capacity;
+	}
+	get(key) {
+		if (!this.map.has(key)) return void 0;
+		const value = this.map.get(key);
+		this.map.delete(key);
+		this.map.set(key, value);
+		return value;
+	}
+	set(key, value) {
+		if (this.map.has(key)) this.map.delete(key);
+		else if (this.map.size >= this.capacity) {
+			const oldest = this.map.keys().next().value;
+			if (oldest !== void 0) this.map.delete(oldest);
+		}
+		this.map.set(key, value);
+	}
+	has(key) {
+		return this.map.has(key);
+	}
+	delete(key) {
+		return this.map.delete(key);
+	}
+	get size() {
+		return this.map.size;
+	}
+	clear() {
+		this.map.clear();
+	}
+	/** Iterate in eviction order: least recently used first. */
+	entries() {
+		return this.map.entries();
+	}
+	[Symbol.iterator]() {
+		return this.entries();
+	}
+};
+//#endregion
+export { LruMap as t };
+
+//# sourceMappingURL=lru-map-BKoUAySU.mjs.map

package/dist/messages-CAt2QdGr.mjs

@@ -0,0 +1,140 @@
+import { n as ExecutionError } from "./path-CGFl2w7D.mjs";
+//#region ../core/src/intents/base-controller.ts
+/**
+* BaseController — 抽象 Intent Controller 基类
+*
+* 提供标准化的 try/catch → fallback 模式。
+* 子类只需实现 execute() 和可选的 fallback()。
+*/
+/**
+* 抽象 Controller 基类
+*
+* 统一处理:
+* - 类型安全的输入 (ControllerInput)
+* - 返回类型约束 (TResult)
+* - try/catch 错误处理 + 可选 fallback
+*
+* 路由生成的输入可直接使用 BaseController<Input, Result>。
+*
+* @example
+* ```ts
+* const API = createToken<ApiClient>("api");
+*
+* type Input = ControllerInput<{ productId: string }>;
+* class ProductController extends BaseController<Input, ProductPage> {
+*   async execute({ params, context }: Input) {
+*     const api = await context.get(API);
+*     return api.getProduct(params.productId);
+*   }
+*
+*   fallback({ params }: ControllerFailure<{ productId: string }>) {
+*     return getMockProduct(params.productId);
+*   }
+* }
+* ```
+*/
+var BaseController = class {
+	prepareContext(context) {
+		return context;
+	}
+	/**
+	* 错误回退 — 子类可选覆写
+	*
+	* 当 execute() 抛出异常时调用。
+	* 默认行为: 重新抛出原始错误。
+	*
+	* @param input - 操作输入与 execute() 抛出的 error
+	* @returns 回退数据
+	*/
+	fallback({ error }) {
+		throw error;
+	}
+	/**
+	* 自动 try/catch → fallback 模式。
+	*/
+	async perform(params, context, ...query) {
+		const input = {
+			params,
+			query: query[0] ?? {},
+			context: this.prepareContext(context)
+		};
+		try {
+			context.signal.throwIfAborted();
+			const result = await this.execute(input);
+			context.signal.throwIfAborted();
+			return result;
+		} catch (e) {
+			if (context.signal.aborted || e instanceof Error && e.name === "AbortError" || e instanceof ExecutionError && e.code === "cancelled") throw e;
+			const error = e instanceof Error ? e : new Error(String(e));
+			return this.fallback({
+				...input,
+				error
+			});
+		}
+	}
+};
+//#endregion
+//#region ../web/src/models/page.ts
+/**
+* 显式声明 page 对象里哪些字段可以跨 SSR/CSR 边界进入 HTML。未列出的字段在
+* `serializeServerData` 时会被剥除，杜绝整 page 对象（含 apiToken、内部备注等）
+* 被无意中 hydrate 到客户端的失误。
+*
+* 用 symbol 而非普通字段名：避免和应用自己的字段冲突，且 `JSON.stringify` 自动
+* 忽略 symbol key，所以 marker 永远不会出现在序列化输出里。
+*/
+const FINESOFT_PUBLIC = Symbol.for("finesoft.publicFields");
+/** 标准 BasePage 字段 —— marker 缺失但显式标注时使用。 */
+const BASE_PAGE_FIELDS = [
+	"id",
+	"pageType",
+	"title",
+	"description",
+	"url"
+];
+function markPublic(page, publicFields) {
+	if (publicFields === true) {
+		Object.defineProperty(page, FINESOFT_PUBLIC, {
+			value: true,
+			enumerable: false,
+			configurable: true,
+			writable: false
+		});
+		return page;
+	}
+	Object.defineProperty(page, FINESOFT_PUBLIC, {
+		value: Object.freeze(Array.isArray(publicFields) ? [...publicFields] : { ...publicFields }),
+		enumerable: false,
+		configurable: true,
+		writable: false
+	});
+	return page;
+}
+/** True 如果 page 用 `markPublic` 显式标过。 */
+function isPublicMarked(page) {
+	return typeof page === "object" && page !== null && page[FINESOFT_PUBLIC] !== void 0;
+}
+/** 取出 `markPublic` 写入的字段白名单；`true` 表示本层字段，`null` 表示未标注。 */
+function getPublicFields(page) {
+	if (typeof page !== "object" || page === null) return null;
+	const v = page[FINESOFT_PUBLIC];
+	if (v === void 0) return null;
+	if (v === true) return true;
+	if (Array.isArray(v)) return v;
+	if (typeof v === "object" && v !== null) return v;
+	return null;
+}
+//#endregion
+//#region ../web/src/i18n/messages.ts
+/**
+* Resolve the effective translation source for a locale.
+*/
+async function resolveConfiguredMessages(options) {
+	const { locale, loadMessages, context } = options;
+	if (!locale || !context) return;
+	if (loadMessages) return loadMessages(locale, context);
+}
+//#endregion
+export { isPublicMarked as a, getPublicFields as i, BASE_PAGE_FIELDS as n, markPublic as o, FINESOFT_PUBLIC as r, BaseController as s, resolveConfiguredMessages as t };
+
+//# sourceMappingURL=messages-CAt2QdGr.mjs.map

package/dist/native-contract-DuR25hYB.d.mts

@@ -0,0 +1,14 @@
+import { g as WebAppView } from "./session-DnB4ZC3x.mjs";
+//#region src/native-contract.d.ts
+interface NativeBinding {
+  readonly Outlet: unknown;
+  useSnapshot(app: WebAppView): unknown;
+}
+/** One shared signature for the published API and project-specific declarations. */
+interface NativeAPI<Bindings extends { [K in keyof Bindings]: NativeBinding; }> {
+  Outlet<R extends keyof Bindings>(renderer: R): Bindings[R]["Outlet"];
+  useSnapshot<R extends keyof Bindings>(renderer: R, app: WebAppView): ReturnType<Bindings[R]["useSnapshot"]>;
+}
+//#endregion
+export { NativeBinding as n, NativeAPI as t };
+//# sourceMappingURL=native-contract-DuR25hYB.d.mts.map

package/dist/native-contract.d.mts

@@ -0,0 +1,2 @@
+import { n as NativeBinding, t as NativeAPI } from "./native-contract-DuR25hYB.mjs";
+export { NativeAPI, NativeBinding };