@webtypen/webframez-react 0.0.30 → 0.0.31

package/dist/client.cjs

@@ -1 +1 @@
-var N=Object.create;var m=Object.defineProperty;var U=Object.getOwnPropertyDescriptor;var z=Object.getOwnPropertyNames;var B=Object.getPrototypeOf,M=Object.prototype.hasOwnProperty;var W=(e,t)=>{for(var n in t)m(e,n,{get:t[n],enumerable:!0})},v=(e,t,n,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of z(t))!M.call(e,r)&&r!==n&&m(e,r,{get:()=>t[r],enumerable:!(o=U(t,r))||o.enumerable});return e};var D=(e,t,n)=>(n=e!=null?N(B(e)):{},v(t||!e||!e.__esModule?m(n,"default",{value:e,enumerable:!0}):n,e)),F=e=>v(m({},"__esModule",{value:!0}),e);var oe={};W(oe,{mountWebframezClient:()=>ne,useCookie:()=>X,useRouter:()=>K});module.exports=F(oe);var i=D(require("react"),1),L=require("react-dom/client"),l=require("react-server-dom-webpack/client");var G=/^(?:[a-zA-Z][a-zA-Z\d+\-.]*:|\/\/|#)/;function u(e){let t=e?.trim();if(t)return t==="/"?"/":t.replace(/\/+$/,"")}function x(e,t){let n=e.trim(),o=u(t);return!n||!o||G.test(n)||o!=="/"&&(n===o||n.startsWith(`${o}/`))?n:o==="/"?n.startsWith("/")?n:`/${n}`:n.startsWith("/")?`${o}${n}`:`${o}/${n}`}function E(e,t){if(!e)return;let n=u(e.basename)??u(t),o={...e,...n?{basename:n}:{}};return o.favicon&&(o.favicon=x(o.favicon,n)),o.links&&(o.links=o.links.map(r=>({...r,href:x(r.href,n)}))),o}var s=require("react/jsx-runtime"),Y={push:()=>{},replace:()=>{},refresh:()=>{}},p=typeof i.default.createContext=="function"?i.default.createContext(null):null,O="__WEBFRAMEZ_ROUTER__",Z="[data-webframez-head='true']";function q(){return typeof window>"u"?null:window[O]??null}function j(e){typeof window>"u"||(window[O]=e)}function S(){let e={},t=typeof document>"u"?"":document.cookie;if(!t||t.trim()==="")return e;for(let n of t.split(";")){let o=n.trim();if(!o)continue;let r=o.indexOf("="),d=r>=0?o.slice(0,r).trim():o,c=r>=0?o.slice(r+1):"";d&&(e[d]=decodeURIComponent(c))}return e}function b(e,t,n={}){let o=[`${e}=${encodeURIComponent(t)}`];return n.path&&o.push(`Path=${n.path}`),n.domain&&o.push(`Domain=${n.domain}`),typeof n.maxAge=="number"&&o.push(`Max-Age=${Math.floor(n.maxAge)}`),n.expires&&o.push(`Expires=${n.expires.toUTCString()}`),n.sameSite&&o.push(`SameSite=${n.sameSite}`),n.secure&&o.push("Secure"),o.join("; ")}function X(){return i.default.useMemo(()=>({all:()=>S(),get:e=>S()[e],set:(e,t,n)=>{typeof document>"u"||(document.cookie=b(e,t,n))},remove:(e,t)=>{typeof document>"u"||(document.cookie=b(e,"",{...t??{},maxAge:0}))}}),[])}function K(){let e=p?i.default.useContext(p):null;if(!e){let t=q();if(t)return t;if(typeof window>"u")return Y;throw new Error("useRouter must be used inside mountWebframezClient()")}return e}function V({active:e}){return(0,s.jsx)("div",{style:{position:"fixed",top:0,left:0,width:"100%",height:3,zIndex:9999,transformOrigin:"left",transform:e?"scaleX(1)":"scaleX(0)",transition:"transform 180ms ease",background:"linear-gradient(90deg, #0ea5e9, #22c55e)"}})}function k(e){let t=document.createElement("meta");t.setAttribute("data-webframez-head","true");let n=Object.entries(e).filter(([,o])=>!!o);for(let[o,r]of n)t.setAttribute(o,String(r));document.head.appendChild(t)}function I(e){let t=document.createElement("link");t.setAttribute("data-webframez-head","true");let n=Object.entries(e).filter(([,o])=>!!o);for(let[o,r]of n)t.setAttribute(o,String(r));document.head.appendChild(t)}function P(e){if(typeof document>"u")return;let t=E(e)??e,n=u(t.basename);window.__RSC_BASENAME=n??"",document.title=t.title||"Webframez React";for(let o of document.head.querySelectorAll(Z))o.remove();t.description&&k({name:"description",content:t.description}),t.favicon&&I({rel:"icon",href:t.favicon});for(let o of t.meta??[])k(o);for(let o of t.links??[])I(o)}function J(e){let t=new TextEncoder;return new ReadableStream({start(n){n.enqueue(t.encode(e)),n.close()}})}function Q(){if(typeof window>"u")return null;let e=window.__RSC_INITIAL_PAYLOAD;return typeof e!="string"||e===""?null:(delete window.__RSC_INITIAL_PAYLOAD,(0,l.createFromReadableStream)(J(e)))}function ee(e){return Q()??(0,l.createFromFetch)(fetch(`${e}?path=${encodeURIComponent(window.location.pathname)}&search=${encodeURIComponent(window.location.search)}`,{headers:{Accept:"text/x-component"}}))}function te(e,t){return function(){let o=i.default.use(e),[r,d]=(0,i.useState)(o.model),[c,w]=(0,i.useState)(o.head),[T,h]=(0,i.useState)(!1),[$,H]=(0,i.useState)(!1);async function f(a,_="push"){h(!0);try{let g=await(0,l.createFromFetch)(fetch(`${t}?path=${encodeURIComponent(a.pathname)}&search=${encodeURIComponent(a.search)}`,{headers:{Accept:"text/x-component"}}));P(g.head),w(g.head),d(g.model);let y=`${a.pathname}${a.search}`;_==="replace"?history.replaceState(null,"",y):_==="push"&&history.pushState(null,"",y)}catch(A){console.error("[webframez-react] Failed to render route",A),d((0,s.jsx)("p",{children:"Failed to load route."}))}finally{h(!1)}}(0,i.useEffect)(()=>{P(c)},[c]),(0,i.useEffect)(()=>{H(!0);let a=()=>{f(new URL(window.location.href),"none")};return window.addEventListener("popstate",a),()=>{window.removeEventListener("popstate",a)}},[]);let R=i.default.useMemo(()=>({push:a=>{f(new URL(a,window.location.origin),"push")},replace:a=>{f(new URL(a,window.location.origin),"replace")},refresh:()=>{f(new URL(window.location.href),"none")}}),[]);j(R);let C=(0,s.jsxs)(s.Fragment,{children:[$?(0,s.jsx)(V,{active:T}):null,r??(0,s.jsx)("p",{style:{padding:24},children:"Loading..."})]});return p?(0,s.jsx)(p.Provider,{value:R,children:C}):C}}function ne(e={}){let t=e.rootId??"root",n=document.getElementById(t);if(!n)throw new Error(`Missing #${t} element`);let o=typeof window<"u"&&window.__RSC_ENDPOINT,r=e.rscEndpoint??o??"/rsc",d=ee(r),c=te(d,r);return(0,L.hydrateRoot)(n,(0,s.jsx)(c,{}))}
+var M=Object.create;var m=Object.defineProperty;var D=Object.getOwnPropertyDescriptor;var F=Object.getOwnPropertyNames;var q=Object.getPrototypeOf,G=Object.prototype.hasOwnProperty;var Y=(e,t)=>{for(var n in t)m(e,n,{get:t[n],enumerable:!0})},S=(e,t,n,o)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of F(t))!G.call(e,r)&&r!==n&&m(e,r,{get:()=>t[r],enumerable:!(o=D(t,r))||o.enumerable});return e};var Z=(e,t,n)=>(n=e!=null?M(q(e)):{},S(t||!e||!e.__esModule?m(n,"default",{value:e,enumerable:!0}):n,e)),j=e=>S(m({},"__esModule",{value:!0}),e);var ce={};Y(ce,{mountWebframezClient:()=>ue,useCookie:()=>ne,useRouter:()=>oe});module.exports=j(ce);var a=Z(require("react"),1),b=require("react-dom/client"),l=require("react-server-dom-webpack/client");var X=/^(?:[a-zA-Z][a-zA-Z\d+\-.]*:|\/\/|#)/;function u(e){if(typeof e!="string")return;let t=e.trim();return!t||t==="/"?"":t.replace(/\/+$/,"")}function y(e,t){let n=e.trim(),o=u(t);return!n||!o||X.test(n)||n.startsWith("/")||o!=="/"&&(n===o||n.startsWith(`${o}/`))?n:o==="/"?n.startsWith("/")?n:`/${n}`:n.startsWith("/")?`${o}${n}`:`${o}/${n}`}function v(e,t){if(!e)return;let n=u(e.basename)??u(t),o=u(e.routeBasePath),r=u(e.transportBasePath),i={...e,...n!==void 0?{basename:n}:{},...o!==void 0?{routeBasePath:o}:{},...r!==void 0?{transportBasePath:r}:{}};return i.favicon&&(i.favicon=y(i.favicon,n)),i.links&&(i.links=i.links.map(c=>({...c,href:y(c.href,n)}))),i}var d=require("react/jsx-runtime"),K={push:()=>{},replace:()=>{},refresh:()=>{}},p=typeof a.default.createContext=="function"?a.default.createContext(null):null,N="__WEBFRAMEZ_ROUTER__",V="[data-webframez-head='true']";function w(e){return u(e)??""}function J(e,t){return t?e===t?"/":e.startsWith(`${t}/`)?e.slice(t.length)||"/":e||"/":e||"/"}function k(e,t){let n=!t||t==="/"?"/":t.startsWith("/")?t:`/${t}`;return e?n==="/"?e:`${e}${n}`:n}function Q(){return w(typeof window>"u"?globalThis.__RSC_ROUTE_BASE_PATH:window.__RSC_ROUTE_BASE_PATH)}function H(e){if(typeof window>"u")return e||"/";let t=w(window.__RSC_BASENAME),n=Q(),o=J(e||"/",t);return k(n,o)}function U(e){if(typeof window>"u")return e;let t=window.__RSC_ENDPOINT;return typeof t=="string"&&t.trim()!==""?t:e}function ee(){return typeof window>"u"?null:window[N]??null}function te(e){typeof window>"u"||(window[N]=e)}function T(){let e={},t=typeof document>"u"?"":document.cookie;if(!t||t.trim()==="")return e;for(let n of t.split(";")){let o=n.trim();if(!o)continue;let r=o.indexOf("="),i=r>=0?o.slice(0,r).trim():o,c=r>=0?o.slice(r+1):"";i&&(e[i]=decodeURIComponent(c))}return e}function B(e,t,n={}){let o=[`${e}=${encodeURIComponent(t)}`];return n.path&&o.push(`Path=${n.path}`),n.domain&&o.push(`Domain=${n.domain}`),typeof n.maxAge=="number"&&o.push(`Max-Age=${Math.floor(n.maxAge)}`),n.expires&&o.push(`Expires=${n.expires.toUTCString()}`),n.sameSite&&o.push(`SameSite=${n.sameSite}`),n.secure&&o.push("Secure"),o.join("; ")}function ne(){return a.default.useMemo(()=>({all:()=>T(),get:e=>T()[e],set:(e,t,n)=>{typeof document>"u"||(document.cookie=B(e,t,n))},remove:(e,t)=>{typeof document>"u"||(document.cookie=B(e,"",{...t??{},maxAge:0}))}}),[])}function oe(){let e=p?a.default.useContext(p):null;if(!e){let t=ee();if(t)return t;if(typeof window>"u")return K;throw new Error("useRouter must be used inside mountWebframezClient()")}return e}function re({active:e}){return(0,d.jsx)("div",{style:{position:"fixed",top:0,left:0,width:"100%",height:3,zIndex:9999,transformOrigin:"left",transform:e?"scaleX(1)":"scaleX(0)",transition:"transform 180ms ease",background:"linear-gradient(90deg, #0ea5e9, #22c55e)"}})}function x(e){let t=document.createElement("meta");t.setAttribute("data-webframez-head","true");let n=Object.entries(e).filter(([,o])=>!!o);for(let[o,r]of n)t.setAttribute(o,String(r));document.head.appendChild(t)}function O(e){let t=document.createElement("link");t.setAttribute("data-webframez-head","true");let n=Object.entries(e).filter(([,o])=>!!o);for(let[o,r]of n)t.setAttribute(o,String(r));document.head.appendChild(t)}function I(e){if(typeof document>"u")return;let t=v(e)??e,n=u(t.basename),o=u(t.routeBasePath),r=u(t.transportBasePath);window.__RSC_BASENAME=n??"",window.__RSC_ROUTE_BASE_PATH=o??"",r!==void 0&&(window.__RSC_ENDPOINT=k(r,"/rsc")),document.title=t.title||"Webframez React";for(let i of document.head.querySelectorAll(V))i.remove();t.description&&x({name:"description",content:t.description}),t.favicon&&O({rel:"icon",href:t.favicon});for(let i of t.meta??[])x(i);for(let i of t.links??[])O(i)}function ie(e){let t=new TextEncoder;return new ReadableStream({start(n){n.enqueue(t.encode(e)),n.close()}})}function ae(){if(typeof window>"u")return null;let e=window.__RSC_INITIAL_PAYLOAD;return typeof e!="string"||e===""?null:(delete window.__RSC_INITIAL_PAYLOAD,(0,l.createFromReadableStream)(ie(e)))}function se(e){let t=U(e),n=H(window.location.pathname);return ae()??(0,l.createFromFetch)(fetch(`${t}?path=${encodeURIComponent(n)}&search=${encodeURIComponent(window.location.search)}`,{headers:{Accept:"text/x-component"}}))}function de(e,t){return function(){let o=a.default.use(e),[r,i]=(0,a.useState)(o.model),[c,R]=(0,a.useState)(o.head),[$,h]=(0,a.useState)(!1),[L,z]=(0,a.useState)(!1);async function f(s,E="push"){h(!0);try{let g=U(t),W=H(s.pathname),_=await(0,l.createFromFetch)(fetch(`${g}?path=${encodeURIComponent(W)}&search=${encodeURIComponent(s.search)}`,{headers:{Accept:"text/x-component"}}));I(_.head),R(_.head),i(_.model);let P=`${s.pathname}${s.search}`;E==="replace"?history.replaceState(null,"",P):E==="push"&&history.pushState(null,"",P)}catch(g){console.error("[webframez-react] Failed to render route",g),i((0,d.jsx)("p",{children:"Failed to load route."}))}finally{h(!1)}}(0,a.useEffect)(()=>{I(c)},[c]),(0,a.useEffect)(()=>{z(!0);let s=()=>{f(new URL(window.location.href),"none")};return window.addEventListener("popstate",s),()=>{window.removeEventListener("popstate",s)}},[]);let C=a.default.useMemo(()=>({push:s=>{f(new URL(s,window.location.origin),"push")},replace:s=>{f(new URL(s,window.location.origin),"replace")},refresh:()=>{f(new URL(window.location.href),"none")}}),[]);te(C);let A=(0,d.jsxs)(d.Fragment,{children:[L?(0,d.jsx)(re,{active:$}):null,r??(0,d.jsx)("p",{style:{padding:24},children:"Loading..."})]});return p?(0,d.jsx)(p.Provider,{value:C,children:A}):A}}function ue(e={}){let t=e.rootId??"root",n=document.getElementById(t);if(!n)throw new Error(`Missing #${t} element`);let o=typeof window<"u"&&window.__RSC_ENDPOINT,r=e.rscEndpoint??o??"/rsc",i=se(r),c=de(i,r);return(0,b.hydrateRoot)(n,(0,d.jsx)(c,{}))}

package/dist/client.js

@@ -1 +1 @@
-import c,{useEffect as x,useState as f}from"react";import{hydrateRoot as N}from"react-dom/client";import{createFromFetch as P,createFromReadableStream as U}from"react-server-dom-webpack/client";var H=/^(?:[a-zA-Z][a-zA-Z\d+\-.]*:|\/\/|#)/;function u(t){let o=t?.trim();if(o)return o==="/"?"/":o.replace(/\/+$/,"")}function y(t,o){let n=t.trim(),e=u(o);return!n||!e||H.test(n)||e!=="/"&&(n===e||n.startsWith(`${e}/`))?n:e==="/"?n.startsWith("/")?n:`/${n}`:n.startsWith("/")?`${e}${n}`:`${e}/${n}`}function v(t,o){if(!t)return;let n=u(t.basename)??u(o),e={...t,...n?{basename:n}:{}};return e.favicon&&(e.favicon=y(e.favicon,n)),e.links&&(e.links=e.links.map(r=>({...r,href:y(r.href,n)}))),e}import{Fragment as q,jsx as d,jsxs as j}from"react/jsx-runtime";var z={push:()=>{},replace:()=>{},refresh:()=>{}},m=typeof c.createContext=="function"?c.createContext(null):null,L="__WEBFRAMEZ_ROUTER__",B="[data-webframez-head='true']";function M(){return typeof window>"u"?null:window[L]??null}function W(t){typeof window>"u"||(window[L]=t)}function E(){let t={},o=typeof document>"u"?"":document.cookie;if(!o||o.trim()==="")return t;for(let n of o.split(";")){let e=n.trim();if(!e)continue;let r=e.indexOf("="),a=r>=0?e.slice(0,r).trim():e,s=r>=0?e.slice(r+1):"";a&&(t[a]=decodeURIComponent(s))}return t}function S(t,o,n={}){let e=[`${t}=${encodeURIComponent(o)}`];return n.path&&e.push(`Path=${n.path}`),n.domain&&e.push(`Domain=${n.domain}`),typeof n.maxAge=="number"&&e.push(`Max-Age=${Math.floor(n.maxAge)}`),n.expires&&e.push(`Expires=${n.expires.toUTCString()}`),n.sameSite&&e.push(`SameSite=${n.sameSite}`),n.secure&&e.push("Secure"),e.join("; ")}function ee(){return c.useMemo(()=>({all:()=>E(),get:t=>E()[t],set:(t,o,n)=>{typeof document>"u"||(document.cookie=S(t,o,n))},remove:(t,o)=>{typeof document>"u"||(document.cookie=S(t,"",{...o??{},maxAge:0}))}}),[])}function te(){let t=m?c.useContext(m):null;if(!t){let o=M();if(o)return o;if(typeof window>"u")return z;throw new Error("useRouter must be used inside mountWebframezClient()")}return t}function D({active:t}){return d("div",{style:{position:"fixed",top:0,left:0,width:"100%",height:3,zIndex:9999,transformOrigin:"left",transform:t?"scaleX(1)":"scaleX(0)",transition:"transform 180ms ease",background:"linear-gradient(90deg, #0ea5e9, #22c55e)"}})}function b(t){let o=document.createElement("meta");o.setAttribute("data-webframez-head","true");let n=Object.entries(t).filter(([,e])=>!!e);for(let[e,r]of n)o.setAttribute(e,String(r));document.head.appendChild(o)}function k(t){let o=document.createElement("link");o.setAttribute("data-webframez-head","true");let n=Object.entries(t).filter(([,e])=>!!e);for(let[e,r]of n)o.setAttribute(e,String(r));document.head.appendChild(o)}function I(t){if(typeof document>"u")return;let o=v(t)??t,n=u(o.basename);window.__RSC_BASENAME=n??"",document.title=o.title||"Webframez React";for(let e of document.head.querySelectorAll(B))e.remove();o.description&&b({name:"description",content:o.description}),o.favicon&&k({rel:"icon",href:o.favicon});for(let e of o.meta??[])b(e);for(let e of o.links??[])k(e)}function F(t){let o=new TextEncoder;return new ReadableStream({start(n){n.enqueue(o.encode(t)),n.close()}})}function G(){if(typeof window>"u")return null;let t=window.__RSC_INITIAL_PAYLOAD;return typeof t!="string"||t===""?null:(delete window.__RSC_INITIAL_PAYLOAD,U(F(t)))}function Y(t){return G()??P(fetch(`${t}?path=${encodeURIComponent(window.location.pathname)}&search=${encodeURIComponent(window.location.search)}`,{headers:{Accept:"text/x-component"}}))}function Z(t,o){return function(){let e=c.use(t),[r,a]=f(e.model),[s,g]=f(e.head),[O,w]=f(!1),[T,$]=f(!1);async function l(i,C="push"){w(!0);try{let p=await P(fetch(`${o}?path=${encodeURIComponent(i.pathname)}&search=${encodeURIComponent(i.search)}`,{headers:{Accept:"text/x-component"}}));I(p.head),g(p.head),a(p.model);let A=`${i.pathname}${i.search}`;C==="replace"?history.replaceState(null,"",A):C==="push"&&history.pushState(null,"",A)}catch(_){console.error("[webframez-react] Failed to render route",_),a(d("p",{children:"Failed to load route."}))}finally{w(!1)}}x(()=>{I(s)},[s]),x(()=>{$(!0);let i=()=>{l(new URL(window.location.href),"none")};return window.addEventListener("popstate",i),()=>{window.removeEventListener("popstate",i)}},[]);let h=c.useMemo(()=>({push:i=>{l(new URL(i,window.location.origin),"push")},replace:i=>{l(new URL(i,window.location.origin),"replace")},refresh:()=>{l(new URL(window.location.href),"none")}}),[]);W(h);let R=j(q,{children:[T?d(D,{active:O}):null,r??d("p",{style:{padding:24},children:"Loading..."})]});return m?d(m.Provider,{value:h,children:R}):R}}function ne(t={}){let o=t.rootId??"root",n=document.getElementById(o);if(!n)throw new Error(`Missing #${o} element`);let e=typeof window<"u"&&window.__RSC_ENDPOINT,r=t.rscEndpoint??e??"/rsc",a=Y(r),s=Z(a,r);return N(n,d(s,{}))}export{ne as mountWebframezClient,ee as useCookie,te as useRouter};
+import c,{useEffect as y,useState as f}from"react";import{hydrateRoot as M}from"react-dom/client";import{createFromFetch as I,createFromReadableStream as D}from"react-server-dom-webpack/client";var W=/^(?:[a-zA-Z][a-zA-Z\d+\-.]*:|\/\/|#)/;function s(e){if(typeof e!="string")return;let t=e.trim();return!t||t==="/"?"":t.replace(/\/+$/,"")}function P(e,t){let n=e.trim(),o=s(t);return!n||!o||W.test(n)||n.startsWith("/")||o!=="/"&&(n===o||n.startsWith(`${o}/`))?n:o==="/"?n.startsWith("/")?n:`/${n}`:n.startsWith("/")?`${o}${n}`:`${o}/${n}`}function S(e,t){if(!e)return;let n=s(e.basename)??s(t),o=s(e.routeBasePath),i=s(e.transportBasePath),r={...e,...n!==void 0?{basename:n}:{},...o!==void 0?{routeBasePath:o}:{},...i!==void 0?{transportBasePath:i}:{}};return r.favicon&&(r.favicon=P(r.favicon,n)),r.links&&(r.links=r.links.map(d=>({...d,href:P(d.href,n)}))),r}import{Fragment as ee,jsx as u,jsxs as te}from"react/jsx-runtime";var F={push:()=>{},replace:()=>{},refresh:()=>{}},m=typeof c.createContext=="function"?c.createContext(null):null,b="__WEBFRAMEZ_ROUTER__",q="[data-webframez-head='true']";function _(e){return s(e)??""}function G(e,t){return t?e===t?"/":e.startsWith(`${t}/`)?e.slice(t.length)||"/":e||"/":e||"/"}function N(e,t){let n=!t||t==="/"?"/":t.startsWith("/")?t:`/${t}`;return e?n==="/"?e:`${e}${n}`:n}function Y(){return _(typeof window>"u"?globalThis.__RSC_ROUTE_BASE_PATH:window.__RSC_ROUTE_BASE_PATH)}function k(e){if(typeof window>"u")return e||"/";let t=_(window.__RSC_BASENAME),n=Y(),o=G(e||"/",t);return N(n,o)}function H(e){if(typeof window>"u")return e;let t=window.__RSC_ENDPOINT;return typeof t=="string"&&t.trim()!==""?t:e}function Z(){return typeof window>"u"?null:window[b]??null}function j(e){typeof window>"u"||(window[b]=e)}function v(){let e={},t=typeof document>"u"?"":document.cookie;if(!t||t.trim()==="")return e;for(let n of t.split(";")){let o=n.trim();if(!o)continue;let i=o.indexOf("="),r=i>=0?o.slice(0,i).trim():o,d=i>=0?o.slice(i+1):"";r&&(e[r]=decodeURIComponent(d))}return e}function T(e,t,n={}){let o=[`${e}=${encodeURIComponent(t)}`];return n.path&&o.push(`Path=${n.path}`),n.domain&&o.push(`Domain=${n.domain}`),typeof n.maxAge=="number"&&o.push(`Max-Age=${Math.floor(n.maxAge)}`),n.expires&&o.push(`Expires=${n.expires.toUTCString()}`),n.sameSite&&o.push(`SameSite=${n.sameSite}`),n.secure&&o.push("Secure"),o.join("; ")}function de(){return c.useMemo(()=>({all:()=>v(),get:e=>v()[e],set:(e,t,n)=>{typeof document>"u"||(document.cookie=T(e,t,n))},remove:(e,t)=>{typeof document>"u"||(document.cookie=T(e,"",{...t??{},maxAge:0}))}}),[])}function ue(){let e=m?c.useContext(m):null;if(!e){let t=Z();if(t)return t;if(typeof window>"u")return F;throw new Error("useRouter must be used inside mountWebframezClient()")}return e}function X({active:e}){return u("div",{style:{position:"fixed",top:0,left:0,width:"100%",height:3,zIndex:9999,transformOrigin:"left",transform:e?"scaleX(1)":"scaleX(0)",transition:"transform 180ms ease",background:"linear-gradient(90deg, #0ea5e9, #22c55e)"}})}function B(e){let t=document.createElement("meta");t.setAttribute("data-webframez-head","true");let n=Object.entries(e).filter(([,o])=>!!o);for(let[o,i]of n)t.setAttribute(o,String(i));document.head.appendChild(t)}function x(e){let t=document.createElement("link");t.setAttribute("data-webframez-head","true");let n=Object.entries(e).filter(([,o])=>!!o);for(let[o,i]of n)t.setAttribute(o,String(i));document.head.appendChild(t)}function O(e){if(typeof document>"u")return;let t=S(e)??e,n=s(t.basename),o=s(t.routeBasePath),i=s(t.transportBasePath);window.__RSC_BASENAME=n??"",window.__RSC_ROUTE_BASE_PATH=o??"",i!==void 0&&(window.__RSC_ENDPOINT=N(i,"/rsc")),document.title=t.title||"Webframez React";for(let r of document.head.querySelectorAll(q))r.remove();t.description&&B({name:"description",content:t.description}),t.favicon&&x({rel:"icon",href:t.favicon});for(let r of t.meta??[])B(r);for(let r of t.links??[])x(r)}function K(e){let t=new TextEncoder;return new ReadableStream({start(n){n.enqueue(t.encode(e)),n.close()}})}function V(){if(typeof window>"u")return null;let e=window.__RSC_INITIAL_PAYLOAD;return typeof e!="string"||e===""?null:(delete window.__RSC_INITIAL_PAYLOAD,D(K(e)))}function J(e){let t=H(e),n=k(window.location.pathname);return V()??I(fetch(`${t}?path=${encodeURIComponent(n)}&search=${encodeURIComponent(window.location.search)}`,{headers:{Accept:"text/x-component"}}))}function Q(e,t){return function(){let o=c.use(e),[i,r]=f(o.model),[d,w]=f(o.head),[U,R]=f(!1),[$,L]=f(!1);async function l(a,A="push"){R(!0);try{let p=H(t),z=k(a.pathname),g=await I(fetch(`${p}?path=${encodeURIComponent(z)}&search=${encodeURIComponent(a.search)}`,{headers:{Accept:"text/x-component"}}));O(g.head),w(g.head),r(g.model);let E=`${a.pathname}${a.search}`;A==="replace"?history.replaceState(null,"",E):A==="push"&&history.pushState(null,"",E)}catch(p){console.error("[webframez-react] Failed to render route",p),r(u("p",{children:"Failed to load route."}))}finally{R(!1)}}y(()=>{O(d)},[d]),y(()=>{L(!0);let a=()=>{l(new URL(window.location.href),"none")};return window.addEventListener("popstate",a),()=>{window.removeEventListener("popstate",a)}},[]);let h=c.useMemo(()=>({push:a=>{l(new URL(a,window.location.origin),"push")},replace:a=>{l(new URL(a,window.location.origin),"replace")},refresh:()=>{l(new URL(window.location.href),"none")}}),[]);j(h);let C=te(ee,{children:[$?u(X,{active:U}):null,i??u("p",{style:{padding:24},children:"Loading..."})]});return m?u(m.Provider,{value:h,children:C}):C}}function ce(e={}){let t=e.rootId??"root",n=document.getElementById(t);if(!n)throw new Error(`Missing #${t} element`);let o=typeof window<"u"&&window.__RSC_ENDPOINT,i=e.rscEndpoint??o??"/rsc",r=J(i),d=Q(r,i);return M(n,u(d,{}))}export{ce as mountWebframezClient,de as useCookie,ue as useRouter};

package/dist/http.cjs

@@ -55,6 +55,7 @@ function createHTMLShell(options = {}) {
     rootHtml = "",
     initialFlightData = "",
     basename = "",
+    routeBasePath = "",
     liveReloadPath,
     liveReloadServerId
   } = options;
@@ -103,6 +104,7 @@ function createHTMLShell(options = {}) {
     <div id="root">${rootHtml}</div>
     <script>window.__RSC_ENDPOINT = "${rscEndpoint}";</script>
     <script>window.__RSC_BASENAME = "${basename}";</script>
+    <script>window.__RSC_ROUTE_BASE_PATH = "${routeBasePath}";</script>
     <script>window.__RSC_INITIAL_PAYLOAD = ${escapedInitialFlightData};</script>
     <script type="module" src="${clientScriptUrl}"></script>
     ${liveReloadScript}
@@ -153,12 +155,12 @@ var import_node_path2 = __toESM(require("node:path"), 1);
 // src/head.ts
 var ABSOLUTE_ASSET_URL_PATTERN = /^(?:[a-zA-Z][a-zA-Z\d+\-.]*:|\/\/|#)/;
 function normalizeHeadBasename(value) {
-  const trimmed = value?.trim();
-  if (!trimmed) {
+  if (typeof value !== "string") {
     return void 0;
   }
-  if (trimmed === "/") {
-    return "/";
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "/") {
+    return "";
   }
   return trimmed.replace(/\/+$/, "");
 }
@@ -171,6 +173,9 @@ function resolveHeadAssetUrl(assetUrl, basename) {
   if (ABSOLUTE_ASSET_URL_PATTERN.test(normalizedAssetUrl)) {
     return normalizedAssetUrl;
   }
+  if (normalizedAssetUrl.startsWith("/")) {
+    return normalizedAssetUrl;
+  }
   if (normalizedBasename !== "/" && (normalizedAssetUrl === normalizedBasename || normalizedAssetUrl.startsWith(`${normalizedBasename}/`))) {
     return normalizedAssetUrl;
   }
@@ -187,9 +192,15 @@ function normalizeHeadConfig(head, inheritedBasename) {
     return void 0;
   }
   const effectiveBasename = normalizeHeadBasename(head.basename) ?? normalizeHeadBasename(inheritedBasename);
+  const normalizedRouteBasePath = normalizeHeadBasename(head.routeBasePath);
+  const normalizedTransportBasePath = normalizeHeadBasename(
+    head.transportBasePath
+  );
   const normalizedHead = {
     ...head,
-    ...effectiveBasename ? { basename: effectiveBasename } : {}
+    ...effectiveBasename !== void 0 ? { basename: effectiveBasename } : {},
+    ...normalizedRouteBasePath !== void 0 ? { routeBasePath: normalizedRouteBasePath } : {},
+    ...normalizedTransportBasePath !== void 0 ? { transportBasePath: normalizedTransportBasePath } : {}
   };
   if (normalizedHead.favicon) {
     normalizedHead.favicon = resolveHeadAssetUrl(
@@ -999,6 +1010,23 @@ function stripBasePath(pathname, basePath) {
   }
   return pathname;
 }
+function normalizeRuntimeBasePath(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "/") {
+    return "";
+  }
+  return trimmed.replace(/\/+$/, "");
+}
+function joinRuntimeBasePath(basePath, pathname) {
+  const normalizedPath = !pathname || pathname === "/" ? "/" : pathname.startsWith("/") ? pathname : `/${pathname}`;
+  if (!basePath) {
+    return normalizedPath;
+  }
+  return normalizedPath === "/" ? basePath : `${basePath}${normalizedPath}`;
+}
 function sanitizeInitialHtmlWorkerNodeOptions(rawNodeOptions) {
   if (!rawNodeOptions || rawNodeOptions.trim() === "") {
     return "";
@@ -1399,6 +1427,14 @@ function createNodeRequestHandler(options) {
     const initialFlightData = await renderRSCToString(initialPayload, {
       moduleMap
     });
+    const transportBasePath = normalizeRuntimeBasePath(resolved.head.transportBasePath) ?? normalizeRuntimeBasePath(basePath) ?? "";
+    const shellClientScriptUrl = joinRuntimeBasePath(
+      transportBasePath,
+      "/assets/client.js"
+    );
+    const shellRscEndpoint = joinRuntimeBasePath(transportBasePath, "/rsc");
+    const shellBasename = normalizeRuntimeBasePath(resolved.head.basename) ?? normalizeRuntimeBasePath(basePath) ?? "";
+    const shellRouteBasePath = normalizeRuntimeBasePath(resolved.head.routeBasePath) ?? "";
     let rootHtml = "";
     try {
       rootHtml = await initialHtmlWorker.renderFromFlightData({
@@ -1429,11 +1465,12 @@ function createNodeRequestHandler(options) {
             createHTMLShell({
               title: "500 - Initial HTML render failed",
               headTags: "",
-              clientScriptUrl,
-              rscEndpoint: rscPath,
+              clientScriptUrl: shellClientScriptUrl,
+              rscEndpoint: shellRscEndpoint,
               rootHtml: createInitialHtmlErrorMarkup("Initial HTML render failed."),
               initialFlightData,
-              basename: resolved?.head?.basename ?? basePath,
+              basename: shellBasename,
+              routeBasePath: shellRouteBasePath,
               liveReloadPath: liveReloadPath || void 0,
               liveReloadServerId: liveReloadPath ? devServerId : void 0
             })
@@ -1448,11 +1485,12 @@ function createNodeRequestHandler(options) {
       createHTMLShell({
         title: resolved.head.title || "Webframez React",
         headTags: renderHeadToString(resolved.head),
-        clientScriptUrl,
-        rscEndpoint: rscPath,
+        clientScriptUrl: shellClientScriptUrl,
+        rscEndpoint: shellRscEndpoint,
         rootHtml,
         initialFlightData,
-        basename: resolved.head.basename ?? basePath,
+        basename: shellBasename,
+        routeBasePath: shellRouteBasePath,
         liveReloadPath: liveReloadPath || void 0,
         liveReloadServerId: liveReloadPath ? devServerId : void 0
       })

package/dist/http.js

@@ -30,6 +30,7 @@ function createHTMLShell(options = {}) {
     rootHtml = "",
     initialFlightData = "",
     basename = "",
+    routeBasePath = "",
     liveReloadPath,
     liveReloadServerId
   } = options;
@@ -78,6 +79,7 @@ function createHTMLShell(options = {}) {
     <div id="root">${rootHtml}</div>
     <script>window.__RSC_ENDPOINT = "${rscEndpoint}";</script>
     <script>window.__RSC_BASENAME = "${basename}";</script>
+    <script>window.__RSC_ROUTE_BASE_PATH = "${routeBasePath}";</script>
     <script>window.__RSC_INITIAL_PAYLOAD = ${escapedInitialFlightData};</script>
     <script type="module" src="${clientScriptUrl}"></script>
     ${liveReloadScript}
@@ -128,12 +130,12 @@ import path2 from "node:path";
 // src/head.ts
 var ABSOLUTE_ASSET_URL_PATTERN = /^(?:[a-zA-Z][a-zA-Z\d+\-.]*:|\/\/|#)/;
 function normalizeHeadBasename(value) {
-  const trimmed = value?.trim();
-  if (!trimmed) {
+  if (typeof value !== "string") {
     return void 0;
   }
-  if (trimmed === "/") {
-    return "/";
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "/") {
+    return "";
   }
   return trimmed.replace(/\/+$/, "");
 }
@@ -146,6 +148,9 @@ function resolveHeadAssetUrl(assetUrl, basename) {
   if (ABSOLUTE_ASSET_URL_PATTERN.test(normalizedAssetUrl)) {
     return normalizedAssetUrl;
   }
+  if (normalizedAssetUrl.startsWith("/")) {
+    return normalizedAssetUrl;
+  }
   if (normalizedBasename !== "/" && (normalizedAssetUrl === normalizedBasename || normalizedAssetUrl.startsWith(`${normalizedBasename}/`))) {
     return normalizedAssetUrl;
   }
@@ -162,9 +167,15 @@ function normalizeHeadConfig(head, inheritedBasename) {
     return void 0;
   }
   const effectiveBasename = normalizeHeadBasename(head.basename) ?? normalizeHeadBasename(inheritedBasename);
+  const normalizedRouteBasePath = normalizeHeadBasename(head.routeBasePath);
+  const normalizedTransportBasePath = normalizeHeadBasename(
+    head.transportBasePath
+  );
   const normalizedHead = {
     ...head,
-    ...effectiveBasename ? { basename: effectiveBasename } : {}
+    ...effectiveBasename !== void 0 ? { basename: effectiveBasename } : {},
+    ...normalizedRouteBasePath !== void 0 ? { routeBasePath: normalizedRouteBasePath } : {},
+    ...normalizedTransportBasePath !== void 0 ? { transportBasePath: normalizedTransportBasePath } : {}
   };
   if (normalizedHead.favicon) {
     normalizedHead.favicon = resolveHeadAssetUrl(
@@ -974,6 +985,23 @@ function stripBasePath(pathname, basePath) {
   }
   return pathname;
 }
+function normalizeRuntimeBasePath(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "/") {
+    return "";
+  }
+  return trimmed.replace(/\/+$/, "");
+}
+function joinRuntimeBasePath(basePath, pathname) {
+  const normalizedPath = !pathname || pathname === "/" ? "/" : pathname.startsWith("/") ? pathname : `/${pathname}`;
+  if (!basePath) {
+    return normalizedPath;
+  }
+  return normalizedPath === "/" ? basePath : `${basePath}${normalizedPath}`;
+}
 function sanitizeInitialHtmlWorkerNodeOptions(rawNodeOptions) {
   if (!rawNodeOptions || rawNodeOptions.trim() === "") {
     return "";
@@ -1374,6 +1402,14 @@ function createNodeRequestHandler(options) {
     const initialFlightData = await renderRSCToString(initialPayload, {
       moduleMap
     });
+    const transportBasePath = normalizeRuntimeBasePath(resolved.head.transportBasePath) ?? normalizeRuntimeBasePath(basePath) ?? "";
+    const shellClientScriptUrl = joinRuntimeBasePath(
+      transportBasePath,
+      "/assets/client.js"
+    );
+    const shellRscEndpoint = joinRuntimeBasePath(transportBasePath, "/rsc");
+    const shellBasename = normalizeRuntimeBasePath(resolved.head.basename) ?? normalizeRuntimeBasePath(basePath) ?? "";
+    const shellRouteBasePath = normalizeRuntimeBasePath(resolved.head.routeBasePath) ?? "";
     let rootHtml = "";
     try {
       rootHtml = await initialHtmlWorker.renderFromFlightData({
@@ -1404,11 +1440,12 @@ function createNodeRequestHandler(options) {
             createHTMLShell({
               title: "500 - Initial HTML render failed",
               headTags: "",
-              clientScriptUrl,
-              rscEndpoint: rscPath,
+              clientScriptUrl: shellClientScriptUrl,
+              rscEndpoint: shellRscEndpoint,
               rootHtml: createInitialHtmlErrorMarkup("Initial HTML render failed."),
               initialFlightData,
-              basename: resolved?.head?.basename ?? basePath,
+              basename: shellBasename,
+              routeBasePath: shellRouteBasePath,
               liveReloadPath: liveReloadPath || void 0,
               liveReloadServerId: liveReloadPath ? devServerId : void 0
             })
@@ -1423,11 +1460,12 @@ function createNodeRequestHandler(options) {
       createHTMLShell({
         title: resolved.head.title || "Webframez React",
         headTags: renderHeadToString(resolved.head),
-        clientScriptUrl,
-        rscEndpoint: rscPath,
+        clientScriptUrl: shellClientScriptUrl,
+        rscEndpoint: shellRscEndpoint,
         rootHtml,
         initialFlightData,
-        basename: resolved.head.basename ?? basePath,
+        basename: shellBasename,
+        routeBasePath: shellRouteBasePath,
         liveReloadPath: liveReloadPath || void 0,
         liveReloadServerId: liveReloadPath ? devServerId : void 0
       })

package/dist/index.cjs

@@ -60,6 +60,7 @@ function createHTMLShell(options = {}) {
     rootHtml = "",
     initialFlightData = "",
     basename = "",
+    routeBasePath = "",
     liveReloadPath,
     liveReloadServerId
   } = options;
@@ -108,6 +109,7 @@ function createHTMLShell(options = {}) {
     <div id="root">${rootHtml}</div>
     <script>window.__RSC_ENDPOINT = "${rscEndpoint}";</script>
     <script>window.__RSC_BASENAME = "${basename}";</script>
+    <script>window.__RSC_ROUTE_BASE_PATH = "${routeBasePath}";</script>
     <script>window.__RSC_INITIAL_PAYLOAD = ${escapedInitialFlightData};</script>
     <script type="module" src="${clientScriptUrl}"></script>
     ${liveReloadScript}
@@ -186,12 +188,12 @@ var import_node_path2 = __toESM(require("node:path"), 1);
 // src/head.ts
 var ABSOLUTE_ASSET_URL_PATTERN = /^(?:[a-zA-Z][a-zA-Z\d+\-.]*:|\/\/|#)/;
 function normalizeHeadBasename(value) {
-  const trimmed = value?.trim();
-  if (!trimmed) {
+  if (typeof value !== "string") {
     return void 0;
   }
-  if (trimmed === "/") {
-    return "/";
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "/") {
+    return "";
   }
   return trimmed.replace(/\/+$/, "");
 }
@@ -204,6 +206,9 @@ function resolveHeadAssetUrl(assetUrl, basename) {
   if (ABSOLUTE_ASSET_URL_PATTERN.test(normalizedAssetUrl)) {
     return normalizedAssetUrl;
   }
+  if (normalizedAssetUrl.startsWith("/")) {
+    return normalizedAssetUrl;
+  }
   if (normalizedBasename !== "/" && (normalizedAssetUrl === normalizedBasename || normalizedAssetUrl.startsWith(`${normalizedBasename}/`))) {
     return normalizedAssetUrl;
   }
@@ -220,9 +225,15 @@ function normalizeHeadConfig(head, inheritedBasename) {
     return void 0;
   }
   const effectiveBasename = normalizeHeadBasename(head.basename) ?? normalizeHeadBasename(inheritedBasename);
+  const normalizedRouteBasePath = normalizeHeadBasename(head.routeBasePath);
+  const normalizedTransportBasePath = normalizeHeadBasename(
+    head.transportBasePath
+  );
   const normalizedHead = {
     ...head,
-    ...effectiveBasename ? { basename: effectiveBasename } : {}
+    ...effectiveBasename !== void 0 ? { basename: effectiveBasename } : {},
+    ...normalizedRouteBasePath !== void 0 ? { routeBasePath: normalizedRouteBasePath } : {},
+    ...normalizedTransportBasePath !== void 0 ? { transportBasePath: normalizedTransportBasePath } : {}
   };
   if (normalizedHead.favicon) {
     normalizedHead.favicon = resolveHeadAssetUrl(
@@ -1036,6 +1047,23 @@ function stripBasePath(pathname, basePath) {
   }
   return pathname;
 }
+function normalizeRuntimeBasePath(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "/") {
+    return "";
+  }
+  return trimmed.replace(/\/+$/, "");
+}
+function joinRuntimeBasePath(basePath, pathname) {
+  const normalizedPath = !pathname || pathname === "/" ? "/" : pathname.startsWith("/") ? pathname : `/${pathname}`;
+  if (!basePath) {
+    return normalizedPath;
+  }
+  return normalizedPath === "/" ? basePath : `${basePath}${normalizedPath}`;
+}
 function sanitizeInitialHtmlWorkerNodeOptions(rawNodeOptions) {
   if (!rawNodeOptions || rawNodeOptions.trim() === "") {
     return "";
@@ -1436,6 +1464,14 @@ function createNodeRequestHandler(options) {
     const initialFlightData = await renderRSCToString(initialPayload, {
       moduleMap
     });
+    const transportBasePath = normalizeRuntimeBasePath(resolved.head.transportBasePath) ?? normalizeRuntimeBasePath(basePath) ?? "";
+    const shellClientScriptUrl = joinRuntimeBasePath(
+      transportBasePath,
+      "/assets/client.js"
+    );
+    const shellRscEndpoint = joinRuntimeBasePath(transportBasePath, "/rsc");
+    const shellBasename = normalizeRuntimeBasePath(resolved.head.basename) ?? normalizeRuntimeBasePath(basePath) ?? "";
+    const shellRouteBasePath = normalizeRuntimeBasePath(resolved.head.routeBasePath) ?? "";
     let rootHtml = "";
     try {
       rootHtml = await initialHtmlWorker.renderFromFlightData({
@@ -1466,11 +1502,12 @@ function createNodeRequestHandler(options) {
             createHTMLShell({
               title: "500 - Initial HTML render failed",
               headTags: "",
-              clientScriptUrl,
-              rscEndpoint: rscPath,
+              clientScriptUrl: shellClientScriptUrl,
+              rscEndpoint: shellRscEndpoint,
               rootHtml: createInitialHtmlErrorMarkup("Initial HTML render failed."),
               initialFlightData,
-              basename: resolved?.head?.basename ?? basePath,
+              basename: shellBasename,
+              routeBasePath: shellRouteBasePath,
               liveReloadPath: liveReloadPath || void 0,
               liveReloadServerId: liveReloadPath ? devServerId : void 0
             })
@@ -1485,11 +1522,12 @@ function createNodeRequestHandler(options) {
       createHTMLShell({
         title: resolved.head.title || "Webframez React",
         headTags: renderHeadToString(resolved.head),
-        clientScriptUrl,
-        rscEndpoint: rscPath,
+        clientScriptUrl: shellClientScriptUrl,
+        rscEndpoint: shellRscEndpoint,
         rootHtml,
         initialFlightData,
-        basename: resolved.head.basename ?? basePath,
+        basename: shellBasename,
+        routeBasePath: shellRouteBasePath,
         liveReloadPath: liveReloadPath || void 0,
         liveReloadServerId: liveReloadPath ? devServerId : void 0
       })

package/dist/index.js

@@ -24,6 +24,7 @@ function createHTMLShell(options = {}) {
     rootHtml = "",
     initialFlightData = "",
     basename = "",
+    routeBasePath = "",
     liveReloadPath,
     liveReloadServerId
   } = options;
@@ -72,6 +73,7 @@ function createHTMLShell(options = {}) {
     <div id="root">${rootHtml}</div>
     <script>window.__RSC_ENDPOINT = "${rscEndpoint}";</script>
     <script>window.__RSC_BASENAME = "${basename}";</script>
+    <script>window.__RSC_ROUTE_BASE_PATH = "${routeBasePath}";</script>
     <script>window.__RSC_INITIAL_PAYLOAD = ${escapedInitialFlightData};</script>
     <script type="module" src="${clientScriptUrl}"></script>
     ${liveReloadScript}
@@ -150,12 +152,12 @@ import path2 from "node:path";
 // src/head.ts
 var ABSOLUTE_ASSET_URL_PATTERN = /^(?:[a-zA-Z][a-zA-Z\d+\-.]*:|\/\/|#)/;
 function normalizeHeadBasename(value) {
-  const trimmed = value?.trim();
-  if (!trimmed) {
+  if (typeof value !== "string") {
     return void 0;
   }
-  if (trimmed === "/") {
-    return "/";
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "/") {
+    return "";
   }
   return trimmed.replace(/\/+$/, "");
 }
@@ -168,6 +170,9 @@ function resolveHeadAssetUrl(assetUrl, basename) {
   if (ABSOLUTE_ASSET_URL_PATTERN.test(normalizedAssetUrl)) {
     return normalizedAssetUrl;
   }
+  if (normalizedAssetUrl.startsWith("/")) {
+    return normalizedAssetUrl;
+  }
   if (normalizedBasename !== "/" && (normalizedAssetUrl === normalizedBasename || normalizedAssetUrl.startsWith(`${normalizedBasename}/`))) {
     return normalizedAssetUrl;
   }
@@ -184,9 +189,15 @@ function normalizeHeadConfig(head, inheritedBasename) {
     return void 0;
   }
   const effectiveBasename = normalizeHeadBasename(head.basename) ?? normalizeHeadBasename(inheritedBasename);
+  const normalizedRouteBasePath = normalizeHeadBasename(head.routeBasePath);
+  const normalizedTransportBasePath = normalizeHeadBasename(
+    head.transportBasePath
+  );
   const normalizedHead = {
     ...head,
-    ...effectiveBasename ? { basename: effectiveBasename } : {}
+    ...effectiveBasename !== void 0 ? { basename: effectiveBasename } : {},
+    ...normalizedRouteBasePath !== void 0 ? { routeBasePath: normalizedRouteBasePath } : {},
+    ...normalizedTransportBasePath !== void 0 ? { transportBasePath: normalizedTransportBasePath } : {}
   };
   if (normalizedHead.favicon) {
     normalizedHead.favicon = resolveHeadAssetUrl(
@@ -1000,6 +1011,23 @@ function stripBasePath(pathname, basePath) {
   }
   return pathname;
 }
+function normalizeRuntimeBasePath(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "/") {
+    return "";
+  }
+  return trimmed.replace(/\/+$/, "");
+}
+function joinRuntimeBasePath(basePath, pathname) {
+  const normalizedPath = !pathname || pathname === "/" ? "/" : pathname.startsWith("/") ? pathname : `/${pathname}`;
+  if (!basePath) {
+    return normalizedPath;
+  }
+  return normalizedPath === "/" ? basePath : `${basePath}${normalizedPath}`;
+}
 function sanitizeInitialHtmlWorkerNodeOptions(rawNodeOptions) {
   if (!rawNodeOptions || rawNodeOptions.trim() === "") {
     return "";
@@ -1400,6 +1428,14 @@ function createNodeRequestHandler(options) {
     const initialFlightData = await renderRSCToString(initialPayload, {
       moduleMap
     });
+    const transportBasePath = normalizeRuntimeBasePath(resolved.head.transportBasePath) ?? normalizeRuntimeBasePath(basePath) ?? "";
+    const shellClientScriptUrl = joinRuntimeBasePath(
+      transportBasePath,
+      "/assets/client.js"
+    );
+    const shellRscEndpoint = joinRuntimeBasePath(transportBasePath, "/rsc");
+    const shellBasename = normalizeRuntimeBasePath(resolved.head.basename) ?? normalizeRuntimeBasePath(basePath) ?? "";
+    const shellRouteBasePath = normalizeRuntimeBasePath(resolved.head.routeBasePath) ?? "";
     let rootHtml = "";
     try {
       rootHtml = await initialHtmlWorker.renderFromFlightData({
@@ -1430,11 +1466,12 @@ function createNodeRequestHandler(options) {
             createHTMLShell({
               title: "500 - Initial HTML render failed",
               headTags: "",
-              clientScriptUrl,
-              rscEndpoint: rscPath,
+              clientScriptUrl: shellClientScriptUrl,
+              rscEndpoint: shellRscEndpoint,
               rootHtml: createInitialHtmlErrorMarkup("Initial HTML render failed."),
               initialFlightData,
-              basename: resolved?.head?.basename ?? basePath,
+              basename: shellBasename,
+              routeBasePath: shellRouteBasePath,
               liveReloadPath: liveReloadPath || void 0,
               liveReloadServerId: liveReloadPath ? devServerId : void 0
             })
@@ -1449,11 +1486,12 @@ function createNodeRequestHandler(options) {
       createHTMLShell({
         title: resolved.head.title || "Webframez React",
         headTags: renderHeadToString(resolved.head),
-        clientScriptUrl,
-        rscEndpoint: rscPath,
+        clientScriptUrl: shellClientScriptUrl,
+        rscEndpoint: shellRscEndpoint,
         rootHtml,
         initialFlightData,
-        basename: resolved.head.basename ?? basePath,
+        basename: shellBasename,
+        routeBasePath: shellRouteBasePath,
         liveReloadPath: liveReloadPath || void 0,
         liveReloadServerId: liveReloadPath ? devServerId : void 0
       })

package/dist/router.cjs

@@ -44,12 +44,12 @@ var import_node_path = __toESM(require("node:path"), 1);
 // src/head.ts
 var ABSOLUTE_ASSET_URL_PATTERN = /^(?:[a-zA-Z][a-zA-Z\d+\-.]*:|\/\/|#)/;
 function normalizeHeadBasename(value) {
-  const trimmed = value?.trim();
-  if (!trimmed) {
+  if (typeof value !== "string") {
     return void 0;
   }
-  if (trimmed === "/") {
-    return "/";
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "/") {
+    return "";
   }
   return trimmed.replace(/\/+$/, "");
 }
@@ -62,6 +62,9 @@ function resolveHeadAssetUrl(assetUrl, basename) {
   if (ABSOLUTE_ASSET_URL_PATTERN.test(normalizedAssetUrl)) {
     return normalizedAssetUrl;
   }
+  if (normalizedAssetUrl.startsWith("/")) {
+    return normalizedAssetUrl;
+  }
   if (normalizedBasename !== "/" && (normalizedAssetUrl === normalizedBasename || normalizedAssetUrl.startsWith(`${normalizedBasename}/`))) {
     return normalizedAssetUrl;
   }
@@ -78,9 +81,15 @@ function normalizeHeadConfig(head, inheritedBasename) {
     return void 0;
   }
   const effectiveBasename = normalizeHeadBasename(head.basename) ?? normalizeHeadBasename(inheritedBasename);
+  const normalizedRouteBasePath = normalizeHeadBasename(head.routeBasePath);
+  const normalizedTransportBasePath = normalizeHeadBasename(
+    head.transportBasePath
+  );
   const normalizedHead = {
     ...head,
-    ...effectiveBasename ? { basename: effectiveBasename } : {}
+    ...effectiveBasename !== void 0 ? { basename: effectiveBasename } : {},
+    ...normalizedRouteBasePath !== void 0 ? { routeBasePath: normalizedRouteBasePath } : {},
+    ...normalizedTransportBasePath !== void 0 ? { transportBasePath: normalizedTransportBasePath } : {}
   };
   if (normalizedHead.favicon) {
     normalizedHead.favicon = resolveHeadAssetUrl(

package/dist/router.js

@@ -14,12 +14,12 @@ import path from "node:path";
 // src/head.ts
 var ABSOLUTE_ASSET_URL_PATTERN = /^(?:[a-zA-Z][a-zA-Z\d+\-.]*:|\/\/|#)/;
 function normalizeHeadBasename(value) {
-  const trimmed = value?.trim();
-  if (!trimmed) {
+  if (typeof value !== "string") {
     return void 0;
   }
-  if (trimmed === "/") {
-    return "/";
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "/") {
+    return "";
   }
   return trimmed.replace(/\/+$/, "");
 }
@@ -32,6 +32,9 @@ function resolveHeadAssetUrl(assetUrl, basename) {
   if (ABSOLUTE_ASSET_URL_PATTERN.test(normalizedAssetUrl)) {
     return normalizedAssetUrl;
   }
+  if (normalizedAssetUrl.startsWith("/")) {
+    return normalizedAssetUrl;
+  }
   if (normalizedBasename !== "/" && (normalizedAssetUrl === normalizedBasename || normalizedAssetUrl.startsWith(`${normalizedBasename}/`))) {
     return normalizedAssetUrl;
   }
@@ -48,9 +51,15 @@ function normalizeHeadConfig(head, inheritedBasename) {
     return void 0;
   }
   const effectiveBasename = normalizeHeadBasename(head.basename) ?? normalizeHeadBasename(inheritedBasename);
+  const normalizedRouteBasePath = normalizeHeadBasename(head.routeBasePath);
+  const normalizedTransportBasePath = normalizeHeadBasename(
+    head.transportBasePath
+  );
   const normalizedHead = {
     ...head,
-    ...effectiveBasename ? { basename: effectiveBasename } : {}
+    ...effectiveBasename !== void 0 ? { basename: effectiveBasename } : {},
+    ...normalizedRouteBasePath !== void 0 ? { routeBasePath: normalizedRouteBasePath } : {},
+    ...normalizedTransportBasePath !== void 0 ? { transportBasePath: normalizedTransportBasePath } : {}
   };
   if (normalizedHead.favicon) {
     normalizedHead.favicon = resolveHeadAssetUrl(

package/dist/webframez-core.cjs

@@ -58,6 +58,7 @@ function createHTMLShell(options = {}) {
     rootHtml = "",
     initialFlightData = "",
     basename = "",
+    routeBasePath = "",
     liveReloadPath,
     liveReloadServerId
   } = options;
@@ -106,6 +107,7 @@ function createHTMLShell(options = {}) {
     <div id="root">${rootHtml}</div>
     <script>window.__RSC_ENDPOINT = "${rscEndpoint}";</script>
     <script>window.__RSC_BASENAME = "${basename}";</script>
+    <script>window.__RSC_ROUTE_BASE_PATH = "${routeBasePath}";</script>
     <script>window.__RSC_INITIAL_PAYLOAD = ${escapedInitialFlightData};</script>
     <script type="module" src="${clientScriptUrl}"></script>
     ${liveReloadScript}
@@ -156,12 +158,12 @@ var import_node_path2 = __toESM(require("node:path"), 1);
 // src/head.ts
 var ABSOLUTE_ASSET_URL_PATTERN = /^(?:[a-zA-Z][a-zA-Z\d+\-.]*:|\/\/|#)/;
 function normalizeHeadBasename(value) {
-  const trimmed = value?.trim();
-  if (!trimmed) {
+  if (typeof value !== "string") {
     return void 0;
   }
-  if (trimmed === "/") {
-    return "/";
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "/") {
+    return "";
   }
   return trimmed.replace(/\/+$/, "");
 }
@@ -174,6 +176,9 @@ function resolveHeadAssetUrl(assetUrl, basename) {
   if (ABSOLUTE_ASSET_URL_PATTERN.test(normalizedAssetUrl)) {
     return normalizedAssetUrl;
   }
+  if (normalizedAssetUrl.startsWith("/")) {
+    return normalizedAssetUrl;
+  }
   if (normalizedBasename !== "/" && (normalizedAssetUrl === normalizedBasename || normalizedAssetUrl.startsWith(`${normalizedBasename}/`))) {
     return normalizedAssetUrl;
   }
@@ -190,9 +195,15 @@ function normalizeHeadConfig(head, inheritedBasename) {
     return void 0;
   }
   const effectiveBasename = normalizeHeadBasename(head.basename) ?? normalizeHeadBasename(inheritedBasename);
+  const normalizedRouteBasePath = normalizeHeadBasename(head.routeBasePath);
+  const normalizedTransportBasePath = normalizeHeadBasename(
+    head.transportBasePath
+  );
   const normalizedHead = {
     ...head,
-    ...effectiveBasename ? { basename: effectiveBasename } : {}
+    ...effectiveBasename !== void 0 ? { basename: effectiveBasename } : {},
+    ...normalizedRouteBasePath !== void 0 ? { routeBasePath: normalizedRouteBasePath } : {},
+    ...normalizedTransportBasePath !== void 0 ? { transportBasePath: normalizedTransportBasePath } : {}
   };
   if (normalizedHead.favicon) {
     normalizedHead.favicon = resolveHeadAssetUrl(
@@ -1002,6 +1013,23 @@ function stripBasePath(pathname, basePath) {
   }
   return pathname;
 }
+function normalizeRuntimeBasePath(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "/") {
+    return "";
+  }
+  return trimmed.replace(/\/+$/, "");
+}
+function joinRuntimeBasePath(basePath, pathname) {
+  const normalizedPath = !pathname || pathname === "/" ? "/" : pathname.startsWith("/") ? pathname : `/${pathname}`;
+  if (!basePath) {
+    return normalizedPath;
+  }
+  return normalizedPath === "/" ? basePath : `${basePath}${normalizedPath}`;
+}
 function sanitizeInitialHtmlWorkerNodeOptions(rawNodeOptions) {
   if (!rawNodeOptions || rawNodeOptions.trim() === "") {
     return "";
@@ -1402,6 +1430,14 @@ function createNodeRequestHandler(options) {
     const initialFlightData = await renderRSCToString(initialPayload, {
       moduleMap
     });
+    const transportBasePath = normalizeRuntimeBasePath(resolved.head.transportBasePath) ?? normalizeRuntimeBasePath(basePath) ?? "";
+    const shellClientScriptUrl = joinRuntimeBasePath(
+      transportBasePath,
+      "/assets/client.js"
+    );
+    const shellRscEndpoint = joinRuntimeBasePath(transportBasePath, "/rsc");
+    const shellBasename = normalizeRuntimeBasePath(resolved.head.basename) ?? normalizeRuntimeBasePath(basePath) ?? "";
+    const shellRouteBasePath = normalizeRuntimeBasePath(resolved.head.routeBasePath) ?? "";
     let rootHtml = "";
     try {
       rootHtml = await initialHtmlWorker.renderFromFlightData({
@@ -1432,11 +1468,12 @@ function createNodeRequestHandler(options) {
             createHTMLShell({
               title: "500 - Initial HTML render failed",
               headTags: "",
-              clientScriptUrl,
-              rscEndpoint: rscPath,
+              clientScriptUrl: shellClientScriptUrl,
+              rscEndpoint: shellRscEndpoint,
               rootHtml: createInitialHtmlErrorMarkup("Initial HTML render failed."),
               initialFlightData,
-              basename: resolved?.head?.basename ?? basePath,
+              basename: shellBasename,
+              routeBasePath: shellRouteBasePath,
               liveReloadPath: liveReloadPath || void 0,
               liveReloadServerId: liveReloadPath ? devServerId : void 0
             })
@@ -1451,11 +1488,12 @@ function createNodeRequestHandler(options) {
       createHTMLShell({
         title: resolved.head.title || "Webframez React",
         headTags: renderHeadToString(resolved.head),
-        clientScriptUrl,
-        rscEndpoint: rscPath,
+        clientScriptUrl: shellClientScriptUrl,
+        rscEndpoint: shellRscEndpoint,
         rootHtml,
         initialFlightData,
-        basename: resolved.head.basename ?? basePath,
+        basename: shellBasename,
+        routeBasePath: shellRouteBasePath,
         liveReloadPath: liveReloadPath || void 0,
         liveReloadServerId: liveReloadPath ? devServerId : void 0
       })

package/dist/webframez-core.js

@@ -30,6 +30,7 @@ function createHTMLShell(options = {}) {
     rootHtml = "",
     initialFlightData = "",
     basename = "",
+    routeBasePath = "",
     liveReloadPath,
     liveReloadServerId
   } = options;
@@ -78,6 +79,7 @@ function createHTMLShell(options = {}) {
     <div id="root">${rootHtml}</div>
     <script>window.__RSC_ENDPOINT = "${rscEndpoint}";</script>
     <script>window.__RSC_BASENAME = "${basename}";</script>
+    <script>window.__RSC_ROUTE_BASE_PATH = "${routeBasePath}";</script>
     <script>window.__RSC_INITIAL_PAYLOAD = ${escapedInitialFlightData};</script>
     <script type="module" src="${clientScriptUrl}"></script>
     ${liveReloadScript}
@@ -128,12 +130,12 @@ import path2 from "node:path";
 // src/head.ts
 var ABSOLUTE_ASSET_URL_PATTERN = /^(?:[a-zA-Z][a-zA-Z\d+\-.]*:|\/\/|#)/;
 function normalizeHeadBasename(value) {
-  const trimmed = value?.trim();
-  if (!trimmed) {
+  if (typeof value !== "string") {
     return void 0;
   }
-  if (trimmed === "/") {
-    return "/";
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "/") {
+    return "";
   }
   return trimmed.replace(/\/+$/, "");
 }
@@ -146,6 +148,9 @@ function resolveHeadAssetUrl(assetUrl, basename) {
   if (ABSOLUTE_ASSET_URL_PATTERN.test(normalizedAssetUrl)) {
     return normalizedAssetUrl;
   }
+  if (normalizedAssetUrl.startsWith("/")) {
+    return normalizedAssetUrl;
+  }
   if (normalizedBasename !== "/" && (normalizedAssetUrl === normalizedBasename || normalizedAssetUrl.startsWith(`${normalizedBasename}/`))) {
     return normalizedAssetUrl;
   }
@@ -162,9 +167,15 @@ function normalizeHeadConfig(head, inheritedBasename) {
     return void 0;
   }
   const effectiveBasename = normalizeHeadBasename(head.basename) ?? normalizeHeadBasename(inheritedBasename);
+  const normalizedRouteBasePath = normalizeHeadBasename(head.routeBasePath);
+  const normalizedTransportBasePath = normalizeHeadBasename(
+    head.transportBasePath
+  );
   const normalizedHead = {
     ...head,
-    ...effectiveBasename ? { basename: effectiveBasename } : {}
+    ...effectiveBasename !== void 0 ? { basename: effectiveBasename } : {},
+    ...normalizedRouteBasePath !== void 0 ? { routeBasePath: normalizedRouteBasePath } : {},
+    ...normalizedTransportBasePath !== void 0 ? { transportBasePath: normalizedTransportBasePath } : {}
   };
   if (normalizedHead.favicon) {
     normalizedHead.favicon = resolveHeadAssetUrl(
@@ -974,6 +985,23 @@ function stripBasePath(pathname, basePath) {
   }
   return pathname;
 }
+function normalizeRuntimeBasePath(value) {
+  if (typeof value !== "string") {
+    return void 0;
+  }
+  const trimmed = value.trim();
+  if (!trimmed || trimmed === "/") {
+    return "";
+  }
+  return trimmed.replace(/\/+$/, "");
+}
+function joinRuntimeBasePath(basePath, pathname) {
+  const normalizedPath = !pathname || pathname === "/" ? "/" : pathname.startsWith("/") ? pathname : `/${pathname}`;
+  if (!basePath) {
+    return normalizedPath;
+  }
+  return normalizedPath === "/" ? basePath : `${basePath}${normalizedPath}`;
+}
 function sanitizeInitialHtmlWorkerNodeOptions(rawNodeOptions) {
   if (!rawNodeOptions || rawNodeOptions.trim() === "") {
     return "";
@@ -1374,6 +1402,14 @@ function createNodeRequestHandler(options) {
     const initialFlightData = await renderRSCToString(initialPayload, {
       moduleMap
     });
+    const transportBasePath = normalizeRuntimeBasePath(resolved.head.transportBasePath) ?? normalizeRuntimeBasePath(basePath) ?? "";
+    const shellClientScriptUrl = joinRuntimeBasePath(
+      transportBasePath,
+      "/assets/client.js"
+    );
+    const shellRscEndpoint = joinRuntimeBasePath(transportBasePath, "/rsc");
+    const shellBasename = normalizeRuntimeBasePath(resolved.head.basename) ?? normalizeRuntimeBasePath(basePath) ?? "";
+    const shellRouteBasePath = normalizeRuntimeBasePath(resolved.head.routeBasePath) ?? "";
     let rootHtml = "";
     try {
       rootHtml = await initialHtmlWorker.renderFromFlightData({
@@ -1404,11 +1440,12 @@ function createNodeRequestHandler(options) {
             createHTMLShell({
               title: "500 - Initial HTML render failed",
               headTags: "",
-              clientScriptUrl,
-              rscEndpoint: rscPath,
+              clientScriptUrl: shellClientScriptUrl,
+              rscEndpoint: shellRscEndpoint,
               rootHtml: createInitialHtmlErrorMarkup("Initial HTML render failed."),
               initialFlightData,
-              basename: resolved?.head?.basename ?? basePath,
+              basename: shellBasename,
+              routeBasePath: shellRouteBasePath,
               liveReloadPath: liveReloadPath || void 0,
               liveReloadServerId: liveReloadPath ? devServerId : void 0
             })
@@ -1423,11 +1460,12 @@ function createNodeRequestHandler(options) {
       createHTMLShell({
         title: resolved.head.title || "Webframez React",
         headTags: renderHeadToString(resolved.head),
-        clientScriptUrl,
-        rscEndpoint: rscPath,
+        clientScriptUrl: shellClientScriptUrl,
+        rscEndpoint: shellRscEndpoint,
         rootHtml,
         initialFlightData,
-        basename: resolved.head.basename ?? basePath,
+        basename: shellBasename,
+        routeBasePath: shellRouteBasePath,
         liveReloadPath: liveReloadPath || void 0,
         liveReloadServerId: liveReloadPath ? devServerId : void 0
       })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webtypen/webframez-react",
-  "version": "0.0.30",
+  "version": "0.0.31",
   "description": "TypeScript React RSC addition for @webtypen/webframez-core",
   "homepage": "https://webtypen.de/",
   "author": {