@symbo.ls/utils 3.14.787 → 3.14.788

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @symbo.ls/utils
 
+## 3.14.788
+
+### Patch Changes
+
+- Server renders run one at a time per process, and a page at /<lang>/… starts in that language.
+
+  - brender: `render()` (and `renderRoute` / `renderPage`) run one at a time per process; a per-render `timeout` (default 30 s, `0`/`false` turns it off) rejects with `BRENDER_RENDER_TIMEOUT`, puts the render's globals back and lets the next render start.
+  - brender + mermaid: before the app starts, the render stores the address's language (the first path segment, when it is one of the project's languages) under polyglot's key, so the fetch seed is recorded in the language the browser asks in; the served page's start-up script stores the page's language. One helper in utils (`polyglotAddressLang`, `polyglotStartupScript`).
+  - cli: the publish pre-render passes its route limit to brender's `timeout`; `symbols.json` `brender.timeout` sets each page's render limit for `smbls build` and `smbls brender`.
+
 ## 3.14.787
 
 ### Patch Changes

package/dist/cjs/polyglotLang.js

@@ -1 +1 @@
-"use strict";var o=Object.defineProperty;var L=Object.getOwnPropertyDescriptor;var r=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var l=(t,a)=>{for(var n in a)o(t,n,{get:a[n],enumerable:!0})},_=(t,a,n,s)=>{if(a&&typeof a=="object"||typeof a=="function")for(let e of r(a))!c.call(t,e)&&e!==n&&o(t,e,{get:()=>a[e],enumerable:!(s=L(a,e))||s.enumerable});return t};var p=t=>_(o({},"__esModule",{value:!0}),t);var K={};l(K,{POLYGLOT_LANG_STORAGE_KEY:()=>g,polyglotFallbackLang:()=>G,polyglotLangStorageKey:()=>x});module.exports=p(K);const g="smbls_lang",x=t=>t&&t.storageLangKey||g,G=(t,a)=>t||a&&a.defaultLang||"en";
+"use strict";var f=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var O=Object.getOwnPropertyNames;var p=Object.prototype.hasOwnProperty;var l=(t,e)=>{for(var r in e)f(t,r,{get:e[r],enumerable:!0})},x=(t,e,r,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of O(e))!p.call(t,n)&&n!==r&&f(t,n,{get:()=>e[n],enumerable:!(s=y(e,n))||s.enumerable});return t};var N=t=>x(f({},"__esModule",{value:!0}),t);var m={};l(m,{POLYGLOT_LANG_STORAGE_KEY:()=>u,polyglotAddressLang:()=>L,polyglotFallbackLang:()=>S,polyglotLangStorageKey:()=>$,polyglotStartupScript:()=>d});module.exports=N(m);const u="smbls_lang",$=t=>t&&t.storageLangKey||u,S=(t,e)=>t||e&&e.defaultLang||"en",L=(t,e)=>{if(!e)return null;const r=Array.isArray(e.languages)&&e.languages.length?e.languages:Object.keys(e.translations||{}),s=/^\/([^/?#]+)/.exec(String(t||""));if(!s)return null;const n=s[1].toLowerCase();for(const a of r)if(typeof a=="string"&&a.toLowerCase()===n)return a;return null},d=({polyglot:t,translations:e,lang:r,pathname:s,attrs:n=""}={})=>{if(!e||typeof e!="object")return"";const a=t&&t.storagePrefix||"",c=t&&t.storageLangKey||"",g=[];for(const i in e){const o=e[i];o&&typeof o=="object"&&g.push(`localStorage.setItem(${JSON.stringify(a+i)},${JSON.stringify(JSON.stringify(o))})`)}if(c){const i=r||L(s,t)||S(void 0,t);g.push(`if(!localStorage.getItem(${JSON.stringify(c)}))localStorage.setItem(${JSON.stringify(c)},${JSON.stringify(i)})`)}return g.length?`<script${n}>try{${g.join(";")}}catch(e){}<\/script>`:""};

package/dist/esm/polyglotLang.js

@@ -1 +1 @@
-const e="smbls_lang",n=t=>t&&t.storageLangKey||e,o=(t,a)=>t||a&&a.defaultLang||"en";export{e as POLYGLOT_LANG_STORAGE_KEY,o as polyglotFallbackLang,n as polyglotLangStorageKey};
+const f="smbls_lang",L=e=>e&&e.storageLangKey||f,u=(e,t)=>e||t&&t.defaultLang||"en",S=(e,t)=>{if(!t)return null;const g=Array.isArray(t.languages)&&t.languages.length?t.languages:Object.keys(t.translations||{}),r=/^\/([^/?#]+)/.exec(String(e||""));if(!r)return null;const i=r[1].toLowerCase();for(const n of g)if(typeof n=="string"&&n.toLowerCase()===i)return n;return null},y=({polyglot:e,translations:t,lang:g,pathname:r,attrs:i=""}={})=>{if(!t||typeof t!="object")return"";const n=e&&e.storagePrefix||"",c=e&&e.storageLangKey||"",s=[];for(const a in t){const o=t[a];o&&typeof o=="object"&&s.push(`localStorage.setItem(${JSON.stringify(n+a)},${JSON.stringify(JSON.stringify(o))})`)}if(c){const a=g||S(r,e)||u(void 0,e);s.push(`if(!localStorage.getItem(${JSON.stringify(c)}))localStorage.setItem(${JSON.stringify(c)},${JSON.stringify(a)})`)}return s.length?`<script${i}>try{${s.join(";")}}catch(e){}<\/script>`:""};export{f as POLYGLOT_LANG_STORAGE_KEY,S as polyglotAddressLang,u as polyglotFallbackLang,L as polyglotLangStorageKey,y as polyglotStartupScript};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@symbo.ls/utils",
-  "version": "3.14.787",
+  "version": "3.14.788",
   "license": "CC-BY-NC-4.0",
   "type": "module",
   "module": "./dist/esm/index.js",

package/polyglotLang.js

@@ -20,3 +20,65 @@ export const polyglotLangStorageKey = (polyglot) =>
  */
 export const polyglotFallbackLang = (stateLang, polyglot) =>
   stateLang || (polyglot && polyglot.defaultLang) || 'en'
+
+/**
+ * The language an address names: its first path segment, when that is one of
+ * the project's languages (`polyglot.languages`, else the keys of
+ * `polyglot.translations`) — `/en/about` with `['ka', 'en']` gives 'en'.
+ * Matched without regard to case, returned as configured; null for any other
+ * address. A server render (@symbo.ls/brender) starts in it, the way a page's
+ * pre-boot script starts the browser in it: stored under
+ * polyglotLangStorageKey before the app starts.
+ */
+export const polyglotAddressLang = (pathname, polyglot) => {
+  if (!polyglot) return null
+  const languages = Array.isArray(polyglot.languages) && polyglot.languages.length
+    ? polyglot.languages
+    : Object.keys(polyglot.translations || {})
+  const first = /^\/([^/?#]+)/.exec(String(pathname || ''))
+  if (!first) return null
+  const segment = first[1].toLowerCase()
+  for (const lang of languages) {
+    if (typeof lang === 'string' && lang.toLowerCase() === segment) return lang
+  }
+  return null
+}
+
+/**
+ * A pre-rendered page's polyglot start-up script, run before the app: the
+ * labels the server rendered with, each under `storagePrefix` + its language,
+ * and — for a visitor with no language stored yet (`storageLangKey`) — the
+ * language the page was rendered in (`lang`), else the language its address
+ * names (`pathname`), else the default (polyglotFallbackLang). So the client
+ * starts where the server did: on its markup, and on the requests the page's
+ * fetch seed recorded. '' without labels.
+ *
+ * Shared by every server that writes one — @symbo.ls/brender renderPage (an
+ * ISR page) and @symbo.ls/mermaid (a publish-time cache entry, a live render)
+ * — which each kept a copy that stored the default language.
+ *
+ * @param {object} options
+ * @param {object} [options.polyglot] - the project's polyglot config
+ * @param {object} [options.translations] - labels by language
+ * @param {string} [options.lang] - the language the page was rendered in
+ * @param {string} [options.pathname] - the page's address
+ * @param {string} [options.attrs] - attributes for the tag (` nonce="…"`)
+ * @returns {string}
+ */
+export const polyglotStartupScript = ({ polyglot, translations, lang, pathname, attrs = '' } = {}) => {
+  if (!translations || typeof translations !== 'object') return ''
+  const storagePrefix = (polyglot && polyglot.storagePrefix) || ''
+  const storageLangKey = (polyglot && polyglot.storageLangKey) || ''
+  const entries = []
+  for (const code in translations) {
+    const map = translations[code]
+    if (map && typeof map === 'object') {
+      entries.push(`localStorage.setItem(${JSON.stringify(storagePrefix + code)},${JSON.stringify(JSON.stringify(map))})`)
+    }
+  }
+  if (storageLangKey) {
+    const pageLang = lang || polyglotAddressLang(pathname, polyglot) || polyglotFallbackLang(undefined, polyglot)
+    entries.push(`if(!localStorage.getItem(${JSON.stringify(storageLangKey)}))localStorage.setItem(${JSON.stringify(storageLangKey)},${JSON.stringify(pageLang)})`)
+  }
+  return entries.length ? `<script${attrs}>try{${entries.join(';')}}catch(e){}</script>` : ''
+}