@symbo.ls/brender 3.14.678 → 3.14.680

package/index.js

@@ -16,6 +16,9 @@ import { trimSpriteToPage, classRulesForPage, markupClasses, trimVariablesToPage
 // page's faces name (`smbls build` maps file: URLs into its output) marks the
 // sheet again.
 import { markFacesSheet, facesSheetMarks } from './faces.js'
+// The faces a page's elements draw (XMA r12 results, item 2): `smbls build`
+// inlines and awaits only those.
+import { drawnFaces } from './drawnFaces.js'
 
 export {
   createEnv,
@@ -48,7 +51,8 @@ export {
   trimVariablesToPage,
   stylesheetRules,
   markFacesSheet,
-  facesSheetMarks
+  facesSheetMarks,
+  drawnFaces
 }
 
 export default {
@@ -82,5 +86,6 @@ export default {
   trimVariablesToPage,
   stylesheetRules,
   markFacesSheet,
-  facesSheetMarks
+  facesSheetMarks,
+  drawnFaces
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbo.ls/brender",
-  "version": "3.14.678",
+  "version": "3.14.680",
   "license": "CC-BY-NC-4.0",
   "type": "module",
   "module": "./dist/esm/index.js",
@@ -30,6 +30,11 @@
       "development": "./faces.js",
       "import": "./dist/esm/faces.js",
       "default": "./dist/esm/faces.js"
+    },
+    "./drawnFaces": {
+      "development": "./drawnFaces.js",
+      "import": "./dist/esm/drawnFaces.js",
+      "default": "./dist/esm/drawnFaces.js"
     }
   },
   "source": "index.js",
@@ -52,17 +57,17 @@
   },
   "dependencies": {
     "@symbo.ls/css": "^3.14.782",
-    "@symbo.ls/default-config": "^3.14.789",
-    "@symbo.ls/element": "^3.14.818",
-    "@symbo.ls/fetch": "^3.14.674",
-    "@symbo.ls/helmet": "^3.14.673",
-    "@symbo.ls/scratch": "^3.14.796",
-    "@symbo.ls/utils": "^3.14.854",
+    "@symbo.ls/default-config": "^3.14.794",
+    "@symbo.ls/element": "^3.14.823",
+    "@symbo.ls/fetch": "^3.14.678",
+    "@symbo.ls/helmet": "^3.14.674",
+    "@symbo.ls/scratch": "^3.14.799",
+    "@symbo.ls/utils": "^3.14.859",
     "esbuild": "^0.28.1",
     "linkedom": "^0.16.8"
   },
   "peerDependencies": {
-    "smbls": "^3.14.860"
+    "smbls": "^3.14.869"
   },
   "optionalDependencies": {
     "@symbo.ls/funcql": "^3.14.0"

package/render.js

@@ -1063,6 +1063,19 @@ const renderTimeoutOf = (value) => {
   return Math.min(value, TIMER_MAX)
 }
 
+// `options.search`: the query of the address the page is rendered at (S1,
+// final-landing 2026-10-28: the landing's agent view, `?view=agent`, read by
+// its app at init). '?a=b', or 'a=b'; undefined, null, '' or '?' for none —
+// then the location is as it was before the option, byte for byte. A hash
+// is no part of it.
+const renderSearchOf = (value) => {
+  if (value === undefined || value === null || value === '' || value === '?') return ''
+  if (typeof value !== 'string' || value.includes('#')) {
+    throw new TypeError(`brender: options.search is a query string ('?view=agent'), without a hash — not ${JSON.stringify(value)}`)
+  }
+  return value.charAt(0) === '?' ? value : '?' + value
+}
+
 const renderTimeoutError = (options, timeout) => {
   const route = options.route || '/'
   const pathname = options.pathname || route
@@ -1105,6 +1118,8 @@ const once = (fn) => {
  * @param {object} [options]
  * @param {string} [options.route='/'] - The route/page to render
  * @param {string} [options.pathname] - The address the page is rendered at (default: the route)
+ * @param {string} [options.search] - That address's query ('?view=agent'): the
+ *   render's location.search (and href); none by default
  * @param {object} [options.state] - State overrides
  * @param {object} [options.context] - Additional context overrides
  * @param {boolean} [options.prefetch=false] - Fetch table/RPC labels first and wait for the page's requests
@@ -1116,6 +1131,7 @@ export const render = (data, options = {}) => {
   let timeout
   try {
     timeout = renderTimeoutOf(options.timeout)
+    renderSearchOf(options.search)
   } catch (err) {
     return Promise.reject(err)
   }
@@ -1148,18 +1164,20 @@ const renderOnce = async (data, options, turn) => {
   const { route = '/', pathname, state: stateOverrides, context: contextOverrides, prefetch = false, lazyGroups } = options
   // pathname is the actual URL path (e.g. /podcast/abc-123), route is the page pattern (e.g. /podcast/:id)
   const locationPath = pathname || route
+  // its query ('' for none; checked in render())
+  const locationSearch = renderSearchOf(options.search)
 
   // This render's diagnostics (see `DIAG`), open before its first request.
   trackFetches()
   const diag = openRenderRecord(DIAG, () => ({ failures: [], labelKeys: new Set(), tainted: false }))
   try {
-    return await renderWithDiagnostics(withRevivedDefaultLang(data), { route, locationPath, stateOverrides, contextOverrides, prefetch, lazyGroups }, diag.record, turn)
+    return await renderWithDiagnostics(withRevivedDefaultLang(data), { route, locationPath, locationSearch, stateOverrides, contextOverrides, prefetch, lazyGroups }, diag.record, turn)
   } finally {
     diag.close()
   }
 }
 
-const renderWithDiagnostics = async (data, { route, locationPath, stateOverrides, contextOverrides, prefetch, lazyGroups }, diag, turn) => {
+const renderWithDiagnostics = async (data, { route, locationPath, locationSearch, stateOverrides, contextOverrides, prefetch, lazyGroups }, diag, turn) => {
   // After every wait: a render abandoned at its timeout stops here (see
   // "One render at a time").
   const live = () => {
@@ -1199,6 +1217,13 @@ const renderWithDiagnostics = async (data, { route, locationPath, stateOverrides
 
   // Set route on location so the router picks it up
   window.location.pathname = locationPath
+  // The address's query (`options.search`): page code reads it as in a
+  // browser at that address — location.search, and href with it. None: the
+  // location as before (href stays the origin's).
+  if (locationSearch) {
+    window.location.search = locationSearch
+    window.location.href = window.location.origin + locationPath + locationSearch
+  }
 
   // globalThis.document/location for the bundled smbls code (which uses
   // `window = globalThis`) during SSR, and the render's own storage behind
@@ -1894,6 +1919,7 @@ export const replaceEmotionCSS = (html, newCSS) => {
  * @param {object} data - Full project data
  * @param {object} [options]
  * @param {string} [options.route='/'] - Route to render
+ * @param {string} [options.search] - The query of the address (see render())
  * @param {number|false} [options.timeout] - render()'s time limit (30 s by default)
  * @returns {Promise<{ html: string, css: string, resetCss: string, fontLinks: string, metadata: object, brKeyCount: number }>}
  */
@@ -1901,11 +1927,11 @@ export const renderRoute = async (data, options = {}) => {
   // `prefetch: false` fetches no table/RPC labels first and does not wait for
   // the page's requests — the publish-time pre-render (smbls publish →
   // ssrCache) renders data-free.
-  const { route = '/', pathname, prefetch = true, timeout } = options
+  const { route = '/', pathname, search, prefetch = true, timeout } = options
 
   // Use the full render pipeline which handles polyglot, prefetch, emotion, etc.
   // Pass pathname so the virtual DOM location reflects the actual URL (for dynamic routes)
-  const result = await render(data, { route, pathname, prefetch, timeout })
+  const result = await render(data, { route, pathname, search, prefetch, timeout })
   if (!result) return null
 
   const ds = data.designSystem || {}
@@ -2011,6 +2037,8 @@ const collectFetchedState = (element) => {
  *   The result then carries `shell: true`.
  * @param {number|false} [options.timeout] - render()'s time limit (30 s by
  *   default; 0 or false: none) — see render()
+ * @param {string} [options.search] - The query of the address the page is
+ *   rendered at ('?view=agent'; see render()); none by default
  * @param {string|number} [options.stamp] - The build's data stamp, written into
  *   the page (see buildStamp); default: the render time as an ISO string
  * @param {number} [options.time] - The build time in ms (see buildStamp);
@@ -2039,7 +2067,7 @@ const collectFetchedState = (element) => {
  * @returns {Promise<{ html: string, route: string, brKeyCount: number, shell?: true }>}
  */
 export const renderPage = async (data, route = '/', options = {}) => {
-  const { lang, themeColor, isr, hydrate = true, prefetch = true, shell, adoptDom = false, pathname, eagerImages = EAGER_IMAGES_DEFAULT, preloadScripts = true, nonce, timeout, stamp, time, spriteIcons = 'all', cssClasses = 'all', cssVariables = 'all', registryFormat = 'paths', lazyGroups, paint } = options
+  const { lang, themeColor, isr, hydrate = true, prefetch = true, shell, adoptDom = false, pathname, search, eagerImages = EAGER_IMAGES_DEFAULT, preloadScripts = true, nonce, timeout, stamp, time, spriteIcons = 'all', cssClasses = 'all', cssVariables = 'all', registryFormat = 'paths', lazyGroups, paint } = options
   const whole = paintsWhole(paint)
   const nonceAttr = nonceAttribute(nonce)
 
@@ -2054,7 +2082,7 @@ export const renderPage = async (data, route = '/', options = {}) => {
   // canonical/og:url built from it read it. Without it a route was rendered
   // at its own pattern: the `/*` page wrote a `/*` canonical into 404.html
   // (xma.info report, brender build item 7).
-  const result = await render(data, { route, pathname, prefetch, timeout, lazyGroups })
+  const result = await render(data, { route, pathname, search, prefetch, timeout, lazyGroups })
   if (!result) return null
 
   const metadata = { ...result.metadata }