@symbo.ls/brender 3.14.664 → 3.14.666

package/dist/esm/shell.js

@@ -1,8 +1,9 @@
-const A=/<head(\s[^>]*)?>/i,C=/<body(\s[^>]*)?>/i,d=(e,t)=>{const s=new RegExp(`\\s${t}\\s*=\\s*("([^"]*)"|'([^']*)'|([^\\s>]+))`,"i").exec(e);return s?s[2]??s[3]??s[4]??"":null},y=e=>{const t=e.slice(0,12).toLowerCase();if(t.startsWith("<title"))return"title";if(t.startsWith("<meta")){if(d(e,"charset")!==null)return"charset";for(const s of["name","property","http-equiv","itemprop"]){const r=d(e,s);if(r!==null)return`${s}:${r.toLowerCase()}`}return null}if(t.startsWith("<link")){const s=(d(e,"rel")||"").toLowerCase();return s==="canonical"?"link:canonical":s==="icon"||s==="shortcut icon"?`link:${s}:${d(e,"href")||""}`:s==="alternate"&&d(e,"hreflang")!==null?`link:alternate:${(d(e,"hreflang")||"").toLowerCase()}`:null}return null},k=/<title[^>]*>[\s\S]*?<\/title\s*>|<meta\b[^>]*>|<link\b[^>]*>/gi,L=/<(script|style|noscript|template|textarea)\b[\s\S]*?<\/\1\s*>/gi,E=e=>[...e.matchAll(L)].map(t=>[t.index,t.index+t[0].length,t[0]]),R=(e,t,s=r=>r)=>{let r="",i=0;for(const[c,n,l]of E(e))r+=t(e.slice(i,c))+s(l),i=n;return r+t(e.slice(i))},f=(e,t,s=0)=>{const r=E(e),i=new RegExp(t.source,t.flags.includes("g")?t.flags:t.flags+"g");i.lastIndex=s;let c;for(;c=i.exec(e);){const n=c.index,l=r.find(([u,h])=>n>u&&n<h);if(!l)return c;i.lastIndex=l[1]}return null},B=e=>!!e&&!/^(?:[a-z][a-z0-9+.-]*:|\/|#|\?)/i.test(e),_=(e,t)=>e.replace(/(\s(?:src|href)\s*=\s*)(?:(["'])([^"']*)\2|([^\s"'>]+))/gi,(s,r,i,c,n)=>{const l=i?c:n;if(!B(l))return s;const u=i||"";return`${r}${u}${t}${l.replace(/^\.\//,"")}${u}`}),D=(e,t)=>{if(!t)return e;const s="../".repeat(t);return R(e,r=>r.replace(/<link\b[^>]*>/gi,i=>_(i,s)),r=>/^<script\b/i.test(r)?r.replace(/^<script\b[^>]*>/i,i=>_(i,s)):r)},I=(e,{headTags:t="",headEnd:s="",body:r="",depth:i=0,bootScripts:c=""}={})=>{if(typeof e!="string"||!e.trim())throw new Error("brender: the shell document is empty");let n=D(e,i);const l=new Set;for(const o of t.matchAll(k)){const a=y(o[0]);a&&l.add(a)}const u=o=>R(o,a=>a.replace(k,O=>l.has(y(O))?"":O)),h=t?`
-${t}`:"",g=s?`
-${s}
-`:"",p=f(n,A),w=p&&f(n,/<\/head\s*>/i,p.index);if(p&&w){const o=p.index+p[0].length,a=w.index;n=n.slice(0,o)+h+u(n.slice(o,a))+g+n.slice(a)}else{n=u(n);const o=f(n,/<html(\s[^>]*)?>/i)||f(n,/<!doctype[^>]*>/i),a=o?o.index+o[0].length:0;n=n.slice(0,a)+h+g+n.slice(a)}const $=`
-<script>window.__BRENDER__=true<\/script>
-${c?c+`
-`:""}${r}
-`,x=f(n,C);if(x){const o=x.index+x[0].length;return n.slice(0,o)+$+n.slice(o)}const m=f(n,/<\/(?:body|html)\s*>/i),b=m?m.index:n.length;return n.slice(0,b)+$+n.slice(b)};export{I as composeIntoShell,y as headTagKey};
+const I=/<head(\s[^>]*)?>/i,P=/<body(\s[^>]*)?>/i,f=(e,n)=>{const t=new RegExp(`\\s${n}\\s*=\\s*("([^"]*)"|'([^']*)'|([^\\s>]+))`,"i").exec(e);return t?t[2]??t[3]??t[4]??"":null},S=e=>{const n=e.slice(0,12).toLowerCase();if(n.startsWith("<title"))return"title";if(n.startsWith("<meta")){if(f(e,"charset")!==null)return"charset";for(const t of["name","property","http-equiv","itemprop"]){const r=f(e,t);if(r!==null)return`${t}:${r.toLowerCase()}`}return null}if(n.startsWith("<link")){const t=(f(e,"rel")||"").toLowerCase();return t==="canonical"?"link:canonical":t==="icon"||t==="shortcut icon"?`link:${t}:${f(e,"href")||""}`:t==="alternate"&&f(e,"hreflang")!==null?`link:alternate:${(f(e,"hreflang")||"").toLowerCase()}`:null}return null},v=/<title[^>]*>[\s\S]*?<\/title\s*>|<meta\b[^>]*>|<link\b[^>]*>/gi,_=/<(script|style|noscript|template|textarea)\b[\s\S]*?<\/\1\s*>/gi,x=e=>[...e.matchAll(_)].map(n=>[n.index,n.index+n[0].length,n[0]]),L=(e,n,t=r=>r)=>{let r="",i=0;for(const[o,l,a]of x(e))r+=n(e.slice(i,o))+t(a),i=l;return r+n(e.slice(i))},d=(e,n,t=0)=>{const r=x(e),i=new RegExp(n.source,n.flags.includes("g")?n.flags:n.flags+"g");i.lastIndex=t;let o;for(;o=i.exec(e);){const l=o.index,a=r.find(([s,u])=>l>s&&l<u);if(!a)return o;i.lastIndex=a[1]}return null},j=e=>!!e&&!/^(?:[a-z][a-z0-9+.-]*:|\/|#|\?)/i.test(e),E=(e,n)=>e.replace(/(\s(?:src|href)\s*=\s*)(?:(["'])([^"']*)\2|([^\s"'>]+))/gi,(t,r,i,o,l)=>{const a=i?o:l;if(!j(a))return t;const s=i||"";return`${r}${s}${n}${a.replace(/^\.\//,"")}${s}`}),q=(e,n)=>{if(!n)return e;const t="../".repeat(n);return L(e,r=>r.replace(/<link\b[^>]*>/gi,i=>E(i,t)),r=>/^<script\b/i.test(r)?r.replace(/^<script\b[^>]*>/i,i=>E(i,t)):r)},W=new Set(["","module","text/javascript","application/javascript"]),m=(e,n)=>new RegExp(`\\s${n}(?:\\s*=|\\s|>|/)`,"i").test(e),B=e=>{const n=[],t=new Set;for(const[,,r]of x(e)){if(!/^<script\b/i.test(r))continue;const i=r.slice(0,r.indexOf(">")+1),o=f(i,"src");if(!o||t.has(o))continue;const l=(f(i,"type")||"").trim().toLowerCase();if(!W.has(l)||m(i,"async")||m(i,"nomodule"))continue;t.add(o);const a=["crossorigin","integrity","referrerpolicy"].map(u=>{const h=f(i,u);return h===null?m(i,u)?` ${u}`:"":` ${u}="${h.replace(/"/g,"&quot;")}"`}).join(""),s=o.replace(/"/g,"&quot;");n.push(l==="module"?`<link rel="modulepreload" href="${s}" fetchpriority="high"${a}>`:`<link rel="preload" as="script" href="${s}" fetchpriority="high"${a}>`)}return n.join(`
+`)},D=(e,n)=>{const t=d(e,/<html(\s[^>]*)?>/i);if(!t)return e;const r=t[0],i=String(n).replace(/"/g,"&quot;"),o=f(r,"lang")!==null?r.replace(/(\slang\s*=\s*)(?:"[^"]*"|'[^']*'|[^\s>]+)/i,`$1"${i}"`):r.replace(/^<html/i,`<html lang="${i}"`);return e.slice(0,t.index)+o+e.slice(t.index+r.length)},H=(e,{headTags:n="",headEnd:t="",body:r="",depth:i=0,bootScripts:o="",lang:l,preloadScripts:a=!1}={})=>{if(typeof e!="string"||!e.trim())throw new Error("brender: the shell document is empty");let s=q(e,i);l&&(s=D(s,l));const u=a?B(s):"";u&&(t=t?`${u}
+${t}`:u);const h=new Set;for(const c of n.matchAll(v)){const p=S(c[0]);p&&h.add(p)}const w=c=>L(c,p=>p.replace(v,R=>h.has(S(R))?"":R)),y=n?`
+${n}`:"",O=t?`
+${t}
+`:"",g=d(s,I),b=g&&d(s,/<\/head\s*>/i,g.index);if(g&&b){const c=g.index+g[0].length,p=b.index;s=s.slice(0,c)+y+w(s.slice(c,p))+O+s.slice(p)}else{s=w(s);const c=d(s,/<html(\s[^>]*)?>/i)||d(s,/<!doctype[^>]*>/i),p=c?c.index+c[0].length:0;s=s.slice(0,p)+y+O+s.slice(p)}const k=`
+${r}
+${o?o+`
+`:""}`,$=d(s,P);if($){const c=$.index+$[0].length;return s.slice(0,c)+k+s.slice(c)}const C=d(s,/<\/(?:body|html)\s*>/i),A=C?C.index:s.length;return s.slice(0,A)+k+s.slice(A)};export{H as composeIntoShell,S as headTagKey,B as scriptPreloads};

package/env.js

@@ -33,12 +33,58 @@ const patchSelectValue = (document) => {
   })
 }
 
+// Web Storage for one environment.
+const createStorage = () => {
+  const store = {}
+  return {
+    getItem: (k) => store[k] ?? null,
+    setItem: (k, v) => { store[k] = String(v) },
+    removeItem: (k) => { delete store[k] },
+    clear: () => { for (const k in store) delete store[k] },
+    get length () { return Object.keys(store).length },
+    key: (i) => Object.keys(store)[i] ?? null
+  }
+}
+
 /**
  * Creates a virtual DOM environment for server-side rendering.
  * Returns window and document that DOMQL can use as context.
  */
 export const createEnv = (html = '<!DOCTYPE html><html><head></head><body></body></html>') => {
-  const { window, document } = parseHTML(html)
+  // Every environment owns its location, Web Storage and history.
+  // linkedom's window is a Proxy over globalThis itself: a property set on it
+  // is set on globalThis, and a property it does not know is read from
+  // globalThis — after the per-document globals parseHTML takes, which is
+  // where an environment's own objects have to live (`window.X` and
+  // `document.defaultView.X` read them first).
+  // - location was set on the window: that set globalThis.location, render()
+  //   put it back after the render, and every later environment found it
+  //   there and kept it — every render in a process shared one location and
+  //   rewrote only its pathname. A render inherited the search and hash of
+  //   the one before it, and renders that overlapped read each other's
+  //   pathname: three of five overlapping renders of different routes
+  //   rendered the home page.
+  // - Storage was set on the window too, so every environment's
+  //   `window.localStorage` was the NEWEST environment's store: renders that
+  //   overlapped read each other's persisted language and labels. (A new
+  //   store per environment keeps renders one after another apart — polyglot
+  //   keeps the language a page switched to and the labels it loaded there,
+  //   and the next page of a build booted with them: xma.info report,
+  //   brender build item 7.)
+  // - The history stub was set once on globalThis and shared by all.
+  // A complete Location shape (host/hostname/protocol/href too): framework
+  // modules read these at module load, before any route is set.
+  const own = {
+    location: { pathname: '/', search: '', hash: '', origin: 'http://localhost', protocol: 'http:', host: 'localhost', hostname: 'localhost', port: '', href: 'http://localhost/' },
+    localStorage: createStorage(),
+    sessionStorage: createStorage(),
+    history: {
+      pushState: () => {},
+      replaceState: () => {},
+      state: null
+    }
+  }
+  const { window, document } = parseHTML(html, own)
 
   // Stub APIs that DOMQL/smbls may call during rendering
   if (!window.requestAnimationFrame) {
@@ -51,18 +97,6 @@ export const createEnv = (html = '<!DOCTYPE html><html><head></head><body></body
   if (!window.cancelAnimationFrame) {
     window.cancelAnimationFrame = (id) => clearTimeout(id)
   }
-  if (!window.history) {
-    window.history = {
-      pushState: () => {},
-      replaceState: () => {},
-      state: null
-    }
-  }
-  if (!window.location) {
-    // A complete Location shape (host/hostname/protocol/href too): framework
-    // modules read these at module load, before any route is set.
-    window.location = { pathname: '/', search: '', hash: '', origin: 'http://localhost', protocol: 'http:', host: 'localhost', hostname: 'localhost', port: '', href: 'http://localhost/' }
-  }
   if (!window.URL) {
     window.URL = URL
   }
@@ -70,22 +104,15 @@ export const createEnv = (html = '<!DOCTYPE html><html><head></head><body></body
     window.scrollTo = () => {}
   }
 
-  // Storage stubs
-  const createStorage = () => {
-    const store = {}
-    return {
-      getItem: (k) => store[k] ?? null,
-      setItem: (k, v) => { store[k] = String(v) },
-      removeItem: (k) => { delete store[k] },
-      clear: () => { for (const k in store) delete store[k] },
-      get length () { return Object.keys(store).length },
-      key: (i) => Object.keys(store)[i] ?? null
-    }
-  }
-  if (!window.localStorage) window.localStorage = createStorage()
-  if (!window.sessionStorage) window.sessionStorage = createStorage()
-  if (!globalThis.localStorage) globalThis.localStorage = window.localStorage
-  if (!globalThis.sessionStorage) globalThis.sessionStorage = window.sessionStorage
+  // The BARE globals stay what they were (the window's setter used to write
+  // them): `localStorage` / `sessionStorage` are the newest environment's
+  // stores, and `history` is the first environment's stub when the host has
+  // none. render() swaps the bare storage and location to the rendering
+  // environment's own for the length of a render; overlapping renders still
+  // share them (a render queue or per-render globals — an open decision).
+  globalThis.localStorage = own.localStorage
+  globalThis.sessionStorage = own.sessionStorage
+  if (!globalThis.history) globalThis.history = own.history
 
   // linkedom's HTMLSelectElement has a `value` getter and NO setter: a
   // `value` prop on a <select> threw "Cannot set property value … which has

package/index.js

@@ -1,7 +1,7 @@
 import { createEnv } from './env.js'
 import { resetKeys, assignKeys, mapKeysToElements } from './keys.js'
 import { loadProject, loadAndRenderAll } from './load.js'
-import { render, renderElement, renderRoute, renderPage, resetGlobalCSSCache, getAccumulatedEmotionCSS, replaceEmotionCSS, adoptionScripts } from './render.js'
+import { render, renderElement, renderRoute, renderPage, resetGlobalCSSCache, getAccumulatedEmotionCSS, replaceEmotionCSS, adoptionScripts, prerenderParts } from './render.js'
 import { extractMetadata, generateHeadHtml } from './metadata.js'
 import { collectBrNodes, hydrate } from './hydrate.js'
 import { generateSitemap } from './sitemap.js'
@@ -30,7 +30,8 @@ export {
   prefetchPageData,
   injectPrefetchedState,
   composeIntoShell,
-  adoptionScripts
+  adoptionScripts,
+  prerenderParts
 }
 
 export default {
@@ -55,5 +56,6 @@ export default {
   prefetchPageData,
   injectPrefetchedState,
   composeIntoShell,
-  adoptionScripts
+  adoptionScripts,
+  prerenderParts
 }

package/load.js

@@ -1,15 +1,51 @@
-import { resolve, join } from 'path'
-import { existsSync, mkdirSync, writeFileSync, unlinkSync } from 'fs'
+import { resolve, join, extname, sep } from 'path'
+import { existsSync, readFileSync, unlinkSync } from 'fs'
 import { tmpdir } from 'os'
 import { randomBytes } from 'crypto'
+import { pathToFileURL } from 'url'
+
+// ── import.meta.url in project code ─────────────────────────────────────────
+// `new URL('../../assets/fonts/x.woff2', import.meta.url)` is how a project
+// names a file next to its source; the bundler turns it into the built
+// asset's address. Bundled into ONE temp module here, every project file's
+// `import.meta.url` became that temp file's, so the URL pointed into the
+// build machine's temp folder — every pre-rendered @font-face read
+// `file:///var/folders/…`, the page drew a fallback font, then shifted (CLS
+// 0.40; xma.info report, brender build item 6). Each project file (anything
+// outside node_modules) gets its OWN source address instead: the URL then
+// names the real source file, which a build maps to its output (the CLI's
+// brenderAssets) and refuses to ship as a file: URL.
+const IMPORT_META_URL = /\bimport\.meta\.url\b/g
+const HAS_IMPORT_META_URL = /\bimport\.meta\.url\b/
+const LOADERS = { '.js': 'js', '.mjs': 'js', '.cjs': 'js', '.jsx': 'jsx', '.ts': 'ts', '.mts': 'ts', '.tsx': 'tsx' }
+
+export const sourceUrlPlugin = {
+  name: 'brender-source-import-meta-url',
+  setup (build) {
+    build.onLoad({ filter: /\.[cm]?[jt]sx?$/ }, (args) => {
+      if (args.path.includes(`${sep}node_modules${sep}`)) return
+      const contents = readFileSync(args.path, 'utf8')
+      if (!HAS_IMPORT_META_URL.test(contents)) return
+      const url = JSON.stringify(pathToFileURL(args.path).href)
+      return {
+        contents: `const __brenderImportMetaUrl = ${url};\n` + contents.replace(IMPORT_META_URL, '__brenderImportMetaUrl'),
+        loader: LOADERS[extname(args.path)] || 'js'
+      }
+    })
+  }
+}
 
 /**
  * Bundles a module entry point with esbuild so that extensionless imports,
  * bare specifiers, and other bundler conventions resolve correctly.
- * Returns the default + named exports of the bundled module, or null on failure.
+ * Returns the default + named exports of the bundled module, or null on failure
+ * (or, with `strict`, throws what went wrong).
  */
-const bundleAndImport = async (entryPath) => {
-  if (!existsSync(entryPath)) return null
+const bundleAndImport = async (entryPath, { strict = false } = {}) => {
+  if (!existsSync(entryPath)) {
+    if (strict) throw new Error(`${entryPath} does not exist`)
+    return null
+  }
 
   let esbuild
   try {
@@ -30,20 +66,69 @@ const bundleAndImport = async (entryPath) => {
       outfile: outFile,
       write: true,
       logLevel: 'silent',
+      plugins: [sourceUrlPlugin],
       // Mark node builtins as external
       external: ['fs', 'path', 'os', 'crypto', 'url', 'http', 'https', 'stream', 'util', 'events', 'buffer', 'child_process', 'worker_threads', 'net', 'tls', 'dns', 'dgram', 'zlib', 'assert', 'querystring', 'string_decoder', 'readline', 'perf_hooks', 'async_hooks', 'v8', 'vm', 'cluster', 'inspector', 'module', 'process', 'tty'],
     })
 
     const mod = await import(`file://${outFile}`)
     return mod
-  } catch {
+  } catch (err) {
     // Fallback: try raw import
-    try { return await import(entryPath) } catch { return null } // fallback: module not found via this resolver, trying next
+    try { return await import(entryPath) } catch (rawErr) { // fallback: module not found via this resolver, trying next
+      if (strict) throw err
+      return null
+    }
   } finally {
     try { unlinkSync(outFile) } catch {} // cleanup: ignore if temp file already removed
   }
 }
 
+// A project's own context module (`context`): the object its entry hands to
+// `create(app, context)` — `{ state, components, pages, functions,
+// designSystem, files, sharedLibraries, ...config }`. The build's entry is
+// what decides which pages a site has; a project whose public entry boots a
+// smaller context than symbols/pages/index.js (xma.info: `siteContext.js`,
+// no admin pages) got every page pre-rendered, admin ones included (xma.info
+// report, brender build item 10). Its keys are spread into plain objects (a
+// module namespace is not extensible); config keys stay at the top level,
+// where render() reads them, as in a frank payload.
+const CONTEXT_OBJECT_KEYS = ['state', 'dependencies', 'components', 'snippets', 'pages', 'functions', 'methods', 'designSystem', 'files', 'assets']
+
+const loadContextModule = async (projectPath, contextPath) => {
+  const entry = resolve(projectPath, contextPath)
+  let mod
+  try {
+    mod = await bundleAndImport(entry, { strict: true })
+  } catch (err) {
+    throw new Error(`brender: cannot load the context module ${contextPath} (${err.message})`)
+  }
+  const context = mod && (mod.default || mod)
+  if (!context || typeof context !== 'object') {
+    throw new Error(`brender: the context module ${contextPath} has no default export object`)
+  }
+  const out = { ...context }
+  for (const key of CONTEXT_OBJECT_KEYS) {
+    if (context[key] && typeof context[key] === 'object') out[key] = { ...context[key] }
+  }
+  out.sharedLibraries = Array.isArray(context.sharedLibraries) ? context.sharedLibraries : []
+  return out
+}
+
+const mergeLibraries = async (result) => {
+  // Pre-resolve string library references and merge into context
+  // so production builds have zero runtime overhead
+  if (result.sharedLibraries.length) {
+    const { resolveSharedLibraries, mergeSharedLibraries } = await import('@symbo.ls/utils')
+    const hasStrings = result.sharedLibraries.some(lib => typeof lib === 'string')
+    if (hasStrings) {
+      result.sharedLibraries = await resolveSharedLibraries(result.sharedLibraries)
+    }
+    mergeSharedLibraries(result, result.sharedLibraries)
+  }
+  return result
+}
+
 /**
  * Loads a Symbols project from a filesystem path.
  * Expects the standard symbols/ directory structure.
@@ -52,13 +137,28 @@ const bundleAndImport = async (entryPath) => {
  * and other bundler conventions work in Node.js.
  *
  * Used for prebuild scenarios where brender runs locally
- * against a project directory (e.g. `smbls build --prerender`).
+ * against a project directory (e.g. `smbls build`).
  *
  * For server runtime rendering, pass the project data
  * directly to render() instead.
+ *
+ * @param {string} projectPath
+ * @param {object} [options]
+ * @param {string} [options.dir='symbols'] - the symbols directory (symbols.json `dir`)
+ * @param {string} [options.context] - a module, relative to `projectPath`,
+ *   whose default export is the context the build's entry boots with
+ *   (symbols.json `brender.context`). Everything but `app` comes from it.
  */
-export const loadProject = async (projectPath) => {
-  const symbolsDir = resolve(projectPath, 'symbols')
+export const loadProject = async (projectPath, options = {}) => {
+  const symbolsDir = resolve(projectPath, options.dir || 'symbols')
+
+  if (options.context) {
+    const [appModule, context] = await Promise.all([
+      bundleAndImport(join(symbolsDir, 'app.js')),
+      loadContextModule(projectPath, options.context)
+    ])
+    return mergeLibraries({ app: { ...(appModule?.default || {}) }, ...context })
+  }
 
   const [
     appModule,
@@ -108,18 +208,7 @@ export const loadProject = async (projectPath) => {
     sharedLibraries: sharedLibsModule?.default || []
   }
 
-  // Pre-resolve string library references and merge into context
-  // so production builds have zero runtime overhead
-  if (result.sharedLibraries.length) {
-    const { resolveSharedLibraries, mergeSharedLibraries } = await import('@symbo.ls/utils')
-    const hasStrings = result.sharedLibraries.some(lib => typeof lib === 'string')
-    if (hasStrings) {
-      result.sharedLibraries = await resolveSharedLibraries(result.sharedLibraries)
-    }
-    mergeSharedLibraries(result, result.sharedLibraries)
-  }
-
-  return result
+  return mergeLibraries(result)
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbo.ls/brender",
-  "version": "3.14.664",
+  "version": "3.14.666",
   "license": "CC-BY-NC-4.0",
   "type": "module",
   "module": "./dist/esm/index.js",
@@ -46,18 +46,18 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@symbo.ls/css": "^3.14.777",
-    "@symbo.ls/default-config": "^3.14.785",
-    "@symbo.ls/element": "^3.14.803",
-    "@symbo.ls/fetch": "^3.14.664",
+    "@symbo.ls/css": "^3.14.779",
+    "@symbo.ls/default-config": "^3.14.787",
+    "@symbo.ls/element": "^3.14.805",
+    "@symbo.ls/fetch": "^3.14.666",
     "@symbo.ls/helmet": "^3.14.670",
-    "@symbo.ls/scratch": "^3.14.788",
-    "@symbo.ls/utils": "^3.14.786",
+    "@symbo.ls/scratch": "^3.14.789",
+    "@symbo.ls/utils": "^3.14.787",
     "esbuild": "^0.28.1",
     "linkedom": "^0.16.8"
   },
   "peerDependencies": {
-    "smbls": "^3.14.833"
+    "smbls": "^3.14.839"
   },
   "optionalDependencies": {
     "@symbo.ls/funcql": "^3.14.0"

package/prefetch.js

@@ -1,12 +1,13 @@
 /**
  * SSR data prefetching for brender.
  *
- * Walks a page definition tree, collects `fetch` declarations,
- * executes them against the configured DB adapter,
- * and returns the fetched data keyed by element path + `as` field.
+ * `fetchSSRTranslations` loads a project's table/RPC labels before a render.
  *
- * This allows brender to inject fetched data into element state
- * before rendering, so the SSR output matches the client-side SPA.
+ * `prefetchPageData` walks a page definition tree, collects `fetch`
+ * declarations, executes them against the configured DB adapter, and returns
+ * the fetched data keyed by element path + `as` field. render() does NOT use
+ * it: the fetch plugin loads a page's data during the render, with the real
+ * element (a `transform` here gets no element). Kept for direct callers.
  */
 
 const isFunction = (v) => typeof v === 'function'
@@ -192,6 +193,10 @@ const executeSingle = async (adapter, config) => {
 /**
  * Prefetch all data for a page route.
  *
+ * @deprecated render() and renderPage() no longer use it: the fetch plugin
+ * loads a page's data during the render, with the real element (a `transform`
+ * here gets none). The `prefetch` render option does not call it. Kept for
+ * direct callers; to be removed.
  * @param {object} data - Full project data (from loadProject)
  * @param {string} route - Route to prefetch for (e.g. '/', '/blog')
  * @param {object} [options]
@@ -235,13 +240,6 @@ export const prefetchPageData = async (data, route = '/', options = {}) => {
   return stateUpdates
 }
 
-/**
- * Inject prefetched data into a page definition's state objects.
- * Mutates the definition in place (caller should deep-clone first).
- *
- * @param {object} pageDef - Page definition (will be mutated)
- * @param {Map<string, object>} stateUpdates - Map from prefetchPageData
- */
 /**
  * Fetch polyglot translations from the DB for SSR use.
  * Returns a map of { [lang]: { key: text, ... } } for all configured languages.
@@ -254,6 +252,14 @@ export const fetchSSRTranslations = async (data) => {
   const config = data.config || {}
   const polyglot = config.polyglot || data.polyglot
   if (!polyglot?.fetch) return null
+  // A FUNCTION is the project's own loader — `(lang, version, el) => …`,
+  // called by the polyglot plugin. It runs inside the render, with the real
+  // root element (its el.call / el.getDB), and render() reads its labels back
+  // from the root state. This used to fall through to the RPC branch below
+  // with brender's default name, `get_translations_if_changed`: one request
+  // per language per route that the project never serves — 44 answered 404
+  // in one build (xma.info report, brender build item 11).
+  if (typeof polyglot.fetch === 'function') return null
 
   const dbConfig = config.fetch || data.fetch || config.db || data.db
   if (!dbConfig) return null
@@ -291,53 +297,19 @@ export const fetchSSRTranslations = async (data) => {
 }
 
 /**
- * Pre-evaluate children functions and replace them with static results.
- * During SSR, DOMQL's runtime state cascading and async re-render cycle
- * may not work correctly (trackSourcemapDeep stack overflows, etc.).
- * By pre-evaluating the children functions, we produce static element
- * definitions that DOMQL can render directly.
+ * Merge prefetched data into a page definition's element states. Mutates the
+ * definition in place (the caller deep-clones first).
+ *
+ * @deprecated render() no longer uses it (the fetch plugin loads a page's data
+ * during the render); kept for callers of prefetchPageData, to be removed.
+ *
+ * It used to go on and evaluate every `children` FUNCTION under the target
+ * with a stand-in element — whose call() answered 'ka' for any language and
+ * returned the enclosing arrow function's `arguments[1]` for a label — and
+ * freeze the result into a static array the real data could never replace
+ * (xma.info report, brender build items 5 and 13). A children function stays
+ * a function now: the render runs it with the real element.
  */
-const preEvaluateChildren = (def, inheritedState) => {
-  if (!def || typeof def !== 'object') return
-  for (const key in def) {
-    if (key === 'state' || key === 'fetch' || key === 'props' ||
-        key === 'attr' || key === 'on' || key === 'define' ||
-        key === 'childExtends' || key === 'childProps' || key === 'childrenAs') continue
-    if (key.charAt(0) >= 'A' && key.charAt(0) <= 'Z' && isObject(def[key])) {
-      const child = def[key]
-      // Determine effective state for this element (own state or inherited)
-      const effectiveState = child.state && typeof child.state === 'object'
-        ? { ...inheritedState, ...child.state }
-        : inheritedState
-
-      // Pre-evaluate children function
-      if (isFunction(child.children)) {
-        try {
-          const mockEl = {
-            state: effectiveState,
-                call: (fn) => {
-              if (fn === 'getActiveLang' || fn === 'getLang') return effectiveState?.lang || 'ka'
-              if (fn === 'polyglot') return arguments[1] || ''
-              return undefined
-            },
-            __ref: {}
-          }
-          const result = child.children(mockEl, effectiveState)
-          if (isArray(result) && result.length > 0) {
-            // Replace children function with static array
-            child.children = result
-          }
-        } catch {
-          // If evaluation fails, leave the function as-is
-        }
-      }
-
-      // Recurse deeper
-      preEvaluateChildren(child, effectiveState)
-    }
-  }
-}
-
 export const injectPrefetchedState = (pageDef, stateUpdates) => {
   if (!stateUpdates || !stateUpdates.size) return
 
@@ -358,10 +330,6 @@ export const injectPrefetchedState = (pageDef, stateUpdates) => {
         target.state = {}
       }
       Object.assign(target.state, data)
-
-      // Pre-evaluate children functions with the injected state
-      // so DOMQL gets static element definitions instead of functions
-      preEvaluateChildren(target, target.state)
     }
   }
 }