npm - @symbo.ls/brender - Versions diffs - 3.8.0 → 3.8.2 - Mend

@symbo.ls/brender 3.8.0 → 3.8.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

package/dist/cjs/env.js CHANGED Viewed

@@ -71,10 +71,24 @@ const createEnv = (html = "<!DOCTYPE html><html><head></head><body></body></html
   if (!window.sessionStorage) window.sessionStorage = createStorage();
   if (!globalThis.localStorage) globalThis.localStorage = window.localStorage;
   if (!globalThis.sessionStorage) globalThis.sessionStorage = window.sessionStorage;
+  if (!window.MutationObserver) {
+    window.MutationObserver = class MutationObserver {
+      constructor() {
+      }
+      observe() {
+      }
+      disconnect() {
+      }
+      takeRecords() {
+        return [];
+      }
+    };
+  }
   globalThis.window = window;
   globalThis.document = document;
   globalThis.Node = window.Node || globalThis.Node;
   globalThis.HTMLElement = window.HTMLElement || globalThis.HTMLElement;
+  globalThis.MutationObserver = window.MutationObserver;
   globalThis.Window = window.constructor;
   return { window, document };
 };

package/dist/cjs/prefetch.js CHANGED Viewed

@@ -207,7 +207,8 @@ const fetchSSRTranslations = async (data) => {
         if (result.translations) {
           translations[lang] = result.translations;
         }
-      } catch {
+      } catch (e) {
+        console.warn("[brender] SSR translation fetch failed:", e.message);
       }
     })
   );

package/dist/cjs/render.js CHANGED Viewed

@@ -122,7 +122,7 @@ const safeJsonReplacer = () => {
     return value;
   };
 };
-const _require = (0, import_module.createRequire)(import_meta.url);
+const _brenderRequire = (0, import_module.createRequire)(import_meta.url);
 const detectWorkspace = () => {
   const brenderDir = (0, import_fs.realpathSync)(new URL(".", import_meta.url).pathname);
   const monorepoRoot = (0, import_path.resolve)(brenderDir, "../..");
@@ -132,53 +132,68 @@ const detectWorkspace = () => {
   }
   let smblsRoot;
   try {
-    const smblsPkg = _require.resolve("smbls/package.json");
+    const smblsPkg = _brenderRequire.resolve("smbls/package.json");
     smblsRoot = (0, import_path.dirname)(smblsPkg);
   } catch {
-    let dir = brenderDir;
-    while (dir !== (0, import_path.dirname)(dir)) {
-      const candidate = (0, import_path.resolve)(dir, "node_modules", "smbls");
+    let dir2 = brenderDir;
+    while (dir2 !== (0, import_path.dirname)(dir2)) {
+      const candidate = (0, import_path.resolve)(dir2, "node_modules", "smbls");
       if ((0, import_fs.existsSync)((0, import_path.resolve)(candidate, "package.json"))) {
         smblsRoot = candidate;
         break;
       }
-      dir = (0, import_path.dirname)(dir);
+      dir2 = (0, import_path.dirname)(dir2);
     }
   }
-  return { isMonorepo: false, smblsRoot, brenderDir };
-};
-const resolvePackagePath = (ws, pkgName, ...subpath) => {
-  if (ws.isMonorepo) {
-    return (0, import_path.resolve)(ws.monorepoRoot, "packages", pkgName, ...subpath);
+  let _smblsRequire = _brenderRequire;
+  if (smblsRoot) {
+    try {
+      _smblsRequire = (0, import_module.createRequire)((0, import_path.resolve)(smblsRoot, "package.json"));
+    } catch {
+    }
   }
-  try {
-    const pkgJson = _require.resolve(`${pkgName}/package.json`);
-    return (0, import_path.resolve)((0, import_path.dirname)(pkgJson), ...subpath);
-  } catch {
+  let projectRoot;
+  let dir = process.cwd();
+  while (dir !== (0, import_path.dirname)(dir)) {
+    if ((0, import_fs.existsSync)((0, import_path.resolve)(dir, "package.json"))) {
+      projectRoot = dir;
+      break;
+    }
+    dir = (0, import_path.dirname)(dir);
   }
-  const scopedNames = {
-    "domql": "domql",
-    "css-in-props": "css-in-props",
-    "attrs-in-props": "attrs-in-props"
-  };
-  if (scopedNames[pkgName]) {
+  let _projectRequire = _smblsRequire;
+  if (projectRoot) {
     try {
-      const pkgJson = _require.resolve(`${pkgName}/package.json`);
-      return (0, import_path.resolve)((0, import_path.dirname)(pkgJson), ...subpath);
+      _projectRequire = (0, import_module.createRequire)((0, import_path.resolve)(projectRoot, "package.json"));
     } catch {
     }
   }
+  return { isMonorepo: false, smblsRoot, brenderDir, projectRoot, _smblsRequire, _projectRequire };
+};
+const tryRequireResolve = (ws, specifier) => {
+  const requireFns = ws.isMonorepo ? [_brenderRequire] : [ws._smblsRequire, ws._projectRequire, _brenderRequire].filter(Boolean);
+  for (const req of requireFns) {
+    try {
+      return req.resolve(specifier);
+    } catch {
+    }
+  }
+  return null;
+};
+const resolvePackagePath = (ws, pkgName, ...subpath) => {
+  if (ws.isMonorepo) {
+    return (0, import_path.resolve)(ws.monorepoRoot, "packages", pkgName, ...subpath);
+  }
+  const pkgJson = tryRequireResolve(ws, `${pkgName}/package.json`);
+  if (pkgJson) return (0, import_path.resolve)((0, import_path.dirname)(pkgJson), ...subpath);
   return null;
 };
 const resolvePluginPath = (ws, pluginName, ...subpath) => {
   if (ws.isMonorepo) {
     return (0, import_path.resolve)(ws.monorepoRoot, "plugins", pluginName, ...subpath);
   }
-  try {
-    const pkgJson = _require.resolve(`@symbo.ls/${pluginName}/package.json`);
-    return (0, import_path.resolve)((0, import_path.dirname)(pkgJson), ...subpath);
-  } catch {
-  }
+  const pkgJson = tryRequireResolve(ws, `@symbo.ls/${pluginName}/package.json`);
+  if (pkgJson) return (0, import_path.resolve)((0, import_path.dirname)(pkgJson), ...subpath);
   return null;
 };
 const resolveSymbolsPackage = (ws, pkg, ...subpath) => {
@@ -189,22 +204,16 @@ const resolveSymbolsPackage = (ws, pkg, ...subpath) => {
     }
     return null;
   }
-  try {
-    const pkgJson = _require.resolve(`@symbo.ls/${pkg}/package.json`);
-    return (0, import_path.resolve)((0, import_path.dirname)(pkgJson), ...subpath);
-  } catch {
-  }
+  const pkgJson = tryRequireResolve(ws, `@symbo.ls/${pkg}/package.json`);
+  if (pkgJson) return (0, import_path.resolve)((0, import_path.dirname)(pkgJson), ...subpath);
   return null;
 };
 const resolveDomqlPackage = (ws, pkg, ...subpath) => {
   if (ws.isMonorepo) {
     return (0, import_path.resolve)(ws.monorepoRoot, "packages", "domql", "packages", pkg, ...subpath);
   }
-  try {
-    const pkgJson = _require.resolve(`@domql/${pkg}/package.json`);
-    return (0, import_path.resolve)((0, import_path.dirname)(pkgJson), ...subpath);
-  } catch {
-  }
+  const pkgJson = tryRequireResolve(ws, `@domql/${pkg}/package.json`);
+  if (pkgJson) return (0, import_path.resolve)((0, import_path.dirname)(pkgJson), ...subpath);
   return null;
 };
 let _cachedCreateDomql = null;
@@ -307,10 +316,8 @@ const bundleCreateDomql = async () => {
         if (ws.isMonorepo) {
           base = (0, import_path.resolve)(ws.monorepoRoot, "packages", "css-in-props");
         } else {
-          try {
-            base = (0, import_path.dirname)(_require.resolve("css-in-props/package.json"));
-          } catch {
-          }
+          const pkgJson = tryRequireResolve(ws, "css-in-props/package.json");
+          if (pkgJson) base = (0, import_path.dirname)(pkgJson);
         }
         if (!base) return;
         const subpath = args.path.replace(/^css-in-props\/?/, "");
@@ -329,11 +336,9 @@ const bundleCreateDomql = async () => {
         if (ws.isMonorepo) {
           nm = (0, import_path.resolve)(ws.monorepoRoot, "node_modules", args.path);
         } else {
-          try {
-            nm = (0, import_path.dirname)(_require.resolve(`${args.path}/package.json`));
-          } catch {
-            return;
-          }
+          const pkgJson = tryRequireResolve(ws, `${args.path}/package.json`);
+          if (!pkgJson) return;
+          nm = (0, import_path.dirname)(pkgJson);
         }
         if ((0, import_fs.existsSync)(nm)) {
           const pkg = (0, import_path.resolve)(nm, "package.json");
@@ -407,7 +412,11 @@ const bundleCreateDomql = async () => {
     write: true,
     logLevel: "warning",
     plugins: [workspacePlugin],
-    nodePaths: ws.isMonorepo ? [(0, import_path.resolve)(ws.monorepoRoot, "node_modules")] : [(0, import_path.resolve)(ws.smblsRoot, "node_modules"), (0, import_path.resolve)(ws.smblsRoot, "..", "..", "node_modules")].filter((p) => (0, import_fs.existsSync)(p)),
+    nodePaths: ws.isMonorepo ? [(0, import_path.resolve)(ws.monorepoRoot, "node_modules")] : [
+      ...ws.smblsRoot ? [(0, import_path.resolve)(ws.smblsRoot, "node_modules")] : [],
+      ...ws.projectRoot ? [(0, import_path.resolve)(ws.projectRoot, "node_modules")] : [],
+      ...ws.smblsRoot ? [(0, import_path.resolve)(ws.smblsRoot, "..", "..", "node_modules")] : []
+    ].filter((p) => (0, import_fs.existsSync)(p)),
     supported: { "import-attributes": false },
     external: [
       "fs",
@@ -561,7 +570,8 @@ const render = async (data, options = {}) => {
   if (prefetch) {
     try {
       ssrTranslations = await (0, import_prefetch.fetchSSRTranslations)(data);
-    } catch {
+    } catch (e) {
+      console.warn("[brender] SSR translation fetch failed:", e.message);
     }
   }
   if (_prevLocPrefetch !== void 0) globalThis.location = _prevLocPrefetch;
@@ -836,6 +846,11 @@ const generateGlobalCSS = async (ds, config) => {
       write: true,
       logLevel: "silent",
       plugins: [workspacePlugin],
+      nodePaths: ws.isMonorepo ? [(0, import_path.resolve)(ws.monorepoRoot, "node_modules")] : [
+        ...ws.smblsRoot ? [(0, import_path.resolve)(ws.smblsRoot, "node_modules")] : [],
+        ...ws.projectRoot ? [(0, import_path.resolve)(ws.projectRoot, "node_modules")] : [],
+        ...ws.smblsRoot ? [(0, import_path.resolve)(ws.smblsRoot, "..", "..", "node_modules")] : []
+      ].filter((p) => existsSync2(p)),
       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", "color-contrast-checker"]
     });
     const mod = await import(`file://${tmpOut}`);

package/dist/esm/env.js CHANGED Viewed

@@ -49,10 +49,24 @@ const createEnv = (html = "<!DOCTYPE html><html><head></head><body></body></html
   if (!window.sessionStorage) window.sessionStorage = createStorage();
   if (!globalThis.localStorage) globalThis.localStorage = window.localStorage;
   if (!globalThis.sessionStorage) globalThis.sessionStorage = window.sessionStorage;
+  if (!window.MutationObserver) {
+    window.MutationObserver = class MutationObserver {
+      constructor() {
+      }
+      observe() {
+      }
+      disconnect() {
+      }
+      takeRecords() {
+        return [];
+      }
+    };
+  }
   globalThis.window = window;
   globalThis.document = document;
   globalThis.Node = window.Node || globalThis.Node;
   globalThis.HTMLElement = window.HTMLElement || globalThis.HTMLElement;
+  globalThis.MutationObserver = window.MutationObserver;
   globalThis.Window = window.constructor;
   return { window, document };
 };

package/dist/esm/prefetch.js CHANGED Viewed

@@ -173,7 +173,8 @@ const fetchSSRTranslations = async (data) => {
         if (result.translations) {
           translations[lang] = result.translations;
         }
-      } catch {
+      } catch (e) {
+        console.warn("[brender] SSR translation fetch failed:", e.message);
       }
     })
   );

package/dist/esm/render.js CHANGED Viewed

@@ -83,7 +83,7 @@ const safeJsonReplacer = () => {
     return value;
   };
 };
-const _require = createRequire(import.meta.url);
+const _brenderRequire = createRequire(import.meta.url);
 const detectWorkspace = () => {
   const brenderDir = realpathSync(new URL(".", import.meta.url).pathname);
   const monorepoRoot = resolve(brenderDir, "../..");
@@ -93,53 +93,68 @@ const detectWorkspace = () => {
   }
   let smblsRoot;
   try {
-    const smblsPkg = _require.resolve("smbls/package.json");
+    const smblsPkg = _brenderRequire.resolve("smbls/package.json");
     smblsRoot = dirname(smblsPkg);
   } catch {
-    let dir = brenderDir;
-    while (dir !== dirname(dir)) {
-      const candidate = resolve(dir, "node_modules", "smbls");
+    let dir2 = brenderDir;
+    while (dir2 !== dirname(dir2)) {
+      const candidate = resolve(dir2, "node_modules", "smbls");
       if (existsSync(resolve(candidate, "package.json"))) {
         smblsRoot = candidate;
         break;
       }
-      dir = dirname(dir);
+      dir2 = dirname(dir2);
     }
   }
-  return { isMonorepo: false, smblsRoot, brenderDir };
-};
-const resolvePackagePath = (ws, pkgName, ...subpath) => {
-  if (ws.isMonorepo) {
-    return resolve(ws.monorepoRoot, "packages", pkgName, ...subpath);
+  let _smblsRequire = _brenderRequire;
+  if (smblsRoot) {
+    try {
+      _smblsRequire = createRequire(resolve(smblsRoot, "package.json"));
+    } catch {
+    }
   }
-  try {
-    const pkgJson = _require.resolve(`${pkgName}/package.json`);
-    return resolve(dirname(pkgJson), ...subpath);
-  } catch {
+  let projectRoot;
+  let dir = process.cwd();
+  while (dir !== dirname(dir)) {
+    if (existsSync(resolve(dir, "package.json"))) {
+      projectRoot = dir;
+      break;
+    }
+    dir = dirname(dir);
   }
-  const scopedNames = {
-    "domql": "domql",
-    "css-in-props": "css-in-props",
-    "attrs-in-props": "attrs-in-props"
-  };
-  if (scopedNames[pkgName]) {
+  let _projectRequire = _smblsRequire;
+  if (projectRoot) {
     try {
-      const pkgJson = _require.resolve(`${pkgName}/package.json`);
-      return resolve(dirname(pkgJson), ...subpath);
+      _projectRequire = createRequire(resolve(projectRoot, "package.json"));
     } catch {
     }
   }
+  return { isMonorepo: false, smblsRoot, brenderDir, projectRoot, _smblsRequire, _projectRequire };
+};
+const tryRequireResolve = (ws, specifier) => {
+  const requireFns = ws.isMonorepo ? [_brenderRequire] : [ws._smblsRequire, ws._projectRequire, _brenderRequire].filter(Boolean);
+  for (const req of requireFns) {
+    try {
+      return req.resolve(specifier);
+    } catch {
+    }
+  }
+  return null;
+};
+const resolvePackagePath = (ws, pkgName, ...subpath) => {
+  if (ws.isMonorepo) {
+    return resolve(ws.monorepoRoot, "packages", pkgName, ...subpath);
+  }
+  const pkgJson = tryRequireResolve(ws, `${pkgName}/package.json`);
+  if (pkgJson) return resolve(dirname(pkgJson), ...subpath);
   return null;
 };
 const resolvePluginPath = (ws, pluginName, ...subpath) => {
   if (ws.isMonorepo) {
     return resolve(ws.monorepoRoot, "plugins", pluginName, ...subpath);
   }
-  try {
-    const pkgJson = _require.resolve(`@symbo.ls/${pluginName}/package.json`);
-    return resolve(dirname(pkgJson), ...subpath);
-  } catch {
-  }
+  const pkgJson = tryRequireResolve(ws, `@symbo.ls/${pluginName}/package.json`);
+  if (pkgJson) return resolve(dirname(pkgJson), ...subpath);
   return null;
 };
 const resolveSymbolsPackage = (ws, pkg, ...subpath) => {
@@ -150,22 +165,16 @@ const resolveSymbolsPackage = (ws, pkg, ...subpath) => {
     }
     return null;
   }
-  try {
-    const pkgJson = _require.resolve(`@symbo.ls/${pkg}/package.json`);
-    return resolve(dirname(pkgJson), ...subpath);
-  } catch {
-  }
+  const pkgJson = tryRequireResolve(ws, `@symbo.ls/${pkg}/package.json`);
+  if (pkgJson) return resolve(dirname(pkgJson), ...subpath);
   return null;
 };
 const resolveDomqlPackage = (ws, pkg, ...subpath) => {
   if (ws.isMonorepo) {
     return resolve(ws.monorepoRoot, "packages", "domql", "packages", pkg, ...subpath);
   }
-  try {
-    const pkgJson = _require.resolve(`@domql/${pkg}/package.json`);
-    return resolve(dirname(pkgJson), ...subpath);
-  } catch {
-  }
+  const pkgJson = tryRequireResolve(ws, `@domql/${pkg}/package.json`);
+  if (pkgJson) return resolve(dirname(pkgJson), ...subpath);
   return null;
 };
 let _cachedCreateDomql = null;
@@ -268,10 +277,8 @@ const bundleCreateDomql = async () => {
         if (ws.isMonorepo) {
           base = resolve(ws.monorepoRoot, "packages", "css-in-props");
         } else {
-          try {
-            base = dirname(_require.resolve("css-in-props/package.json"));
-          } catch {
-          }
+          const pkgJson = tryRequireResolve(ws, "css-in-props/package.json");
+          if (pkgJson) base = dirname(pkgJson);
         }
         if (!base) return;
         const subpath = args.path.replace(/^css-in-props\/?/, "");
@@ -290,11 +297,9 @@ const bundleCreateDomql = async () => {
         if (ws.isMonorepo) {
           nm = resolve(ws.monorepoRoot, "node_modules", args.path);
         } else {
-          try {
-            nm = dirname(_require.resolve(`${args.path}/package.json`));
-          } catch {
-            return;
-          }
+          const pkgJson = tryRequireResolve(ws, `${args.path}/package.json`);
+          if (!pkgJson) return;
+          nm = dirname(pkgJson);
         }
         if (existsSync(nm)) {
           const pkg = resolve(nm, "package.json");
@@ -368,7 +373,11 @@ const bundleCreateDomql = async () => {
     write: true,
     logLevel: "warning",
     plugins: [workspacePlugin],
-    nodePaths: ws.isMonorepo ? [resolve(ws.monorepoRoot, "node_modules")] : [resolve(ws.smblsRoot, "node_modules"), resolve(ws.smblsRoot, "..", "..", "node_modules")].filter((p) => existsSync(p)),
+    nodePaths: ws.isMonorepo ? [resolve(ws.monorepoRoot, "node_modules")] : [
+      ...ws.smblsRoot ? [resolve(ws.smblsRoot, "node_modules")] : [],
+      ...ws.projectRoot ? [resolve(ws.projectRoot, "node_modules")] : [],
+      ...ws.smblsRoot ? [resolve(ws.smblsRoot, "..", "..", "node_modules")] : []
+    ].filter((p) => existsSync(p)),
     supported: { "import-attributes": false },
     external: [
       "fs",
@@ -522,7 +531,8 @@ const render = async (data, options = {}) => {
   if (prefetch) {
     try {
       ssrTranslations = await fetchSSRTranslations(data);
-    } catch {
+    } catch (e) {
+      console.warn("[brender] SSR translation fetch failed:", e.message);
     }
   }
   if (_prevLocPrefetch !== void 0) globalThis.location = _prevLocPrefetch;
@@ -797,6 +807,11 @@ const generateGlobalCSS = async (ds, config) => {
       write: true,
       logLevel: "silent",
       plugins: [workspacePlugin],
+      nodePaths: ws.isMonorepo ? [resolve(ws.monorepoRoot, "node_modules")] : [
+        ...ws.smblsRoot ? [resolve(ws.smblsRoot, "node_modules")] : [],
+        ...ws.projectRoot ? [resolve(ws.projectRoot, "node_modules")] : [],
+        ...ws.smblsRoot ? [resolve(ws.smblsRoot, "..", "..", "node_modules")] : []
+      ].filter((p) => existsSync2(p)),
       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", "color-contrast-checker"]
     });
     const mod = await import(`file://${tmpOut}`);

package/env.js CHANGED Viewed

@@ -48,12 +48,23 @@ export const createEnv = (html = '<!DOCTYPE html><html><head></head><body></body
   if (!globalThis.localStorage) globalThis.localStorage = window.localStorage
   if (!globalThis.sessionStorage) globalThis.sessionStorage = window.sessionStorage
+  // Stub MutationObserver for SSR (not provided by linkedom)
+  if (!window.MutationObserver) {
+    window.MutationObserver = class MutationObserver {
+      constructor () {}
+      observe () {}
+      disconnect () {}
+      takeRecords () { return [] }
+    }
+  }
   // Expose linkedom constructors on globalThis so @domql/utils isDOMNode
   // can use instanceof checks (it reads from globalThis.Node, etc.)
   globalThis.window = window
   globalThis.document = document
   globalThis.Node = window.Node || globalThis.Node
   globalThis.HTMLElement = window.HTMLElement || globalThis.HTMLElement
+  globalThis.MutationObserver = window.MutationObserver
   globalThis.Window = window.constructor
   return { window, document }

package/load.js CHANGED Viewed

@@ -38,9 +38,9 @@ const bundleAndImport = async (entryPath) => {
     return mod
   } catch {
     // Fallback: try raw import
-    try { return await import(entryPath) } catch { return null }
+    try { return await import(entryPath) } catch { return null } // fallback: module not found via this resolver, trying next
   } finally {
-    try { unlinkSync(outFile) } catch {}
+    try { unlinkSync(outFile) } catch {} // cleanup: ignore if temp file already removed
   }
 }

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@symbo.ls/brender",
-  "version": "3.8.0",
+  "version": "3.8.2",
   "license": "CC-BY-NC-4.0",
   "type": "module",
   "module": "./dist/esm/index.js",
@@ -36,7 +36,7 @@
     "dev:rita": "node examples/serve-rita.js"
   },
   "dependencies": {
-    "@symbo.ls/helmet": "^3.8.0",
+    "@symbo.ls/helmet": "^3.8.1",
     "linkedom": "^0.16.8"
   },
   "devDependencies": {

package/prefetch.js CHANGED Viewed

@@ -278,7 +278,9 @@ export const fetchSSRTranslations = async (data) => {
         if (result.translations) {
           translations[lang] = result.translations
         }
-      } catch {}
+      } catch (e) {
+        console.warn('[brender] SSR translation fetch failed:', e.message)
+      }
     })
   )

package/render.js CHANGED Viewed

@@ -104,7 +104,7 @@ const safeJsonReplacer = () => {
 // ── Workspace detection ──────────────────────────────────────────────────────
 // Detect whether brender is running inside the monorepo or as an installed
 // npm package, and resolve paths accordingly.
-const _require = createRequire(import.meta.url)
+const _brenderRequire = createRequire(import.meta.url)
 const detectWorkspace = () => {
   const brenderDir = realpathSync(new URL('.', import.meta.url).pathname)
@@ -121,7 +121,7 @@ const detectWorkspace = () => {
   // Find the smbls package root via require.resolve
   let smblsRoot
   try {
-    const smblsPkg = _require.resolve('smbls/package.json')
+    const smblsPkg = _brenderRequire.resolve('smbls/package.json')
     smblsRoot = dirname(smblsPkg)
   } catch {
     // Fallback: walk up from brenderDir looking for node_modules/smbls
@@ -136,7 +136,48 @@ const detectWorkspace = () => {
     }
   }
-  return { isMonorepo: false, smblsRoot, brenderDir }
+  // Create a require function from smbls root so we can resolve its dependencies
+  // (e.g. @symbo.ls/scratch, @symbo.ls/default-config which are deps of smbls, not brender)
+  let _smblsRequire = _brenderRequire
+  if (smblsRoot) {
+    try {
+      _smblsRequire = createRequire(resolve(smblsRoot, 'package.json'))
+    } catch {} // fallback: module not found via this resolver, trying next
+  }
+  // Also find the project root (where the user's package.json is)
+  let projectRoot
+  let dir = process.cwd()
+  while (dir !== dirname(dir)) {
+    if (existsSync(resolve(dir, 'package.json'))) {
+      projectRoot = dir
+      break
+    }
+    dir = dirname(dir)
+  }
+  // Create a require from project root for hoisted deps
+  let _projectRequire = _smblsRequire
+  if (projectRoot) {
+    try {
+      _projectRequire = createRequire(resolve(projectRoot, 'package.json'))
+    } catch {} // fallback: module not found via this resolver, trying next
+  }
+  return { isMonorepo: false, smblsRoot, brenderDir, projectRoot, _smblsRequire, _projectRequire }
+}
+// Try multiple require functions to resolve a package (brender scope, smbls scope, project scope)
+const tryRequireResolve = (ws, specifier) => {
+  const requireFns = ws.isMonorepo
+    ? [_brenderRequire]
+    : [ws._smblsRequire, ws._projectRequire, _brenderRequire].filter(Boolean)
+  for (const req of requireFns) {
+    try {
+      return req.resolve(specifier)
+    } catch {} // fallback: module not found via this resolver, trying next
+  }
+  return null
 }
 // Resolve a package path — monorepo layout or node_modules
@@ -144,23 +185,8 @@ const resolvePackagePath = (ws, pkgName, ...subpath) => {
   if (ws.isMonorepo) {
     return resolve(ws.monorepoRoot, 'packages', pkgName, ...subpath)
   }
-  // npm context: try require.resolve
-  try {
-    const pkgJson = _require.resolve(`${pkgName}/package.json`)
-    return resolve(dirname(pkgJson), ...subpath)
-  } catch {}
-  // Try scoped name
-  const scopedNames = {
-    'domql': 'domql',
-    'css-in-props': 'css-in-props',
-    'attrs-in-props': 'attrs-in-props'
-  }
-  if (scopedNames[pkgName]) {
-    try {
-      const pkgJson = _require.resolve(`${pkgName}/package.json`)
-      return resolve(dirname(pkgJson), ...subpath)
-    } catch {}
-  }
+  const pkgJson = tryRequireResolve(ws, `${pkgName}/package.json`)
+  if (pkgJson) return resolve(dirname(pkgJson), ...subpath)
   return null
 }
@@ -168,10 +194,8 @@ const resolvePluginPath = (ws, pluginName, ...subpath) => {
   if (ws.isMonorepo) {
     return resolve(ws.monorepoRoot, 'plugins', pluginName, ...subpath)
   }
-  try {
-    const pkgJson = _require.resolve(`@symbo.ls/${pluginName}/package.json`)
-    return resolve(dirname(pkgJson), ...subpath)
-  } catch {}
+  const pkgJson = tryRequireResolve(ws, `@symbo.ls/${pluginName}/package.json`)
+  if (pkgJson) return resolve(dirname(pkgJson), ...subpath)
   return null
 }
@@ -183,10 +207,8 @@ const resolveSymbolsPackage = (ws, pkg, ...subpath) => {
     }
     return null
   }
-  try {
-    const pkgJson = _require.resolve(`@symbo.ls/${pkg}/package.json`)
-    return resolve(dirname(pkgJson), ...subpath)
-  } catch {}
+  const pkgJson = tryRequireResolve(ws, `@symbo.ls/${pkg}/package.json`)
+  if (pkgJson) return resolve(dirname(pkgJson), ...subpath)
   return null
 }
@@ -194,10 +216,8 @@ const resolveDomqlPackage = (ws, pkg, ...subpath) => {
   if (ws.isMonorepo) {
     return resolve(ws.monorepoRoot, 'packages', 'domql', 'packages', pkg, ...subpath)
   }
-  try {
-    const pkgJson = _require.resolve(`@domql/${pkg}/package.json`)
-    return resolve(dirname(pkgJson), ...subpath)
-  } catch {}
+  const pkgJson = tryRequireResolve(ws, `@domql/${pkg}/package.json`)
+  if (pkgJson) return resolve(dirname(pkgJson), ...subpath)
   return null
 }
@@ -273,7 +293,7 @@ const bundleCreateDomql = async () => {
             const pkgJson = _require.resolve('domql/package.json')
             const r = tryResolve(dirname(pkgJson))
             if (r) return { path: r }
-          } catch {}
+          } catch {} // fallback: module not found via this resolver, trying next
         }
       })
       // Resolve @symbo.ls/* packages (skip sync — stubbed above)
@@ -322,9 +342,8 @@ const bundleCreateDomql = async () => {
         if (ws.isMonorepo) {
           base = resolve(ws.monorepoRoot, 'packages', 'css-in-props')
         } else {
-          try {
-            base = dirname(_require.resolve('css-in-props/package.json'))
-          } catch {}
+          const pkgJson = tryRequireResolve(ws, 'css-in-props/package.json')
+          if (pkgJson) base = dirname(pkgJson)
         }
         if (!base) return
         const subpath = args.path.replace(/^css-in-props\/?/, '')
@@ -344,11 +363,9 @@ const bundleCreateDomql = async () => {
         if (ws.isMonorepo) {
           nm = resolve(ws.monorepoRoot, 'node_modules', args.path)
         } else {
-          try {
-            nm = dirname(_require.resolve(`${args.path}/package.json`))
-          } catch {
-            return
-          }
+          const pkgJson = tryRequireResolve(ws, `${args.path}/package.json`)
+          if (!pkgJson) return
+          nm = dirname(pkgJson)
         }
         if (existsSync(nm)) {
           const pkg = resolve(nm, 'package.json')
@@ -357,7 +374,7 @@ const bundleCreateDomql = async () => {
               const p = JSON.parse(readFileSync(pkg, 'utf8'))
               const main = p.module || p.main || 'dist/emotion-css.esm.js'
               return { path: resolve(nm, main) }
-            } catch {}
+            } catch {} // expected: value is not a valid JSON
           }
           return { path: nm }
         }
@@ -436,7 +453,11 @@ const bundleCreateDomql = async () => {
     plugins: [workspacePlugin],
     nodePaths: ws.isMonorepo
       ? [resolve(ws.monorepoRoot, 'node_modules')]
-      : [resolve(ws.smblsRoot, 'node_modules'), resolve(ws.smblsRoot, '..', '..', 'node_modules')].filter(p => existsSync(p)),
+      : [
+        ...(ws.smblsRoot ? [resolve(ws.smblsRoot, 'node_modules')] : []),
+        ...(ws.projectRoot ? [resolve(ws.projectRoot, 'node_modules')] : []),
+        ...(ws.smblsRoot ? [resolve(ws.smblsRoot, '..', '..', 'node_modules')] : [])
+      ].filter(p => existsSync(p)),
     supported: { 'import-attributes': false },
     external: [
       'fs', 'path', 'os', 'crypto', 'url', 'http', 'https', 'stream',
@@ -449,7 +470,7 @@ const bundleCreateDomql = async () => {
   })
   const mod = await import(`file://${outFile}`)
-  try { unlinkSync(outFile) } catch {}
+  try { unlinkSync(outFile) } catch {} // cleanup: ignore if temp file already removed
   _cachedCreateDomql = mod
   return mod
@@ -522,6 +543,40 @@ const UIKIT_STUBS = {
   Text: { tag: 'span' }
 }
+// ── BR path registry ─────────────────────────────────────────────────────────
+/**
+ * Walks a DOMQL element tree (after mapKeysToElements has set __brKey on each
+ * element) and returns a plain object mapping "element path" → "data-br key".
+ *
+ * The path is a dot-separated chain of element keys from root to leaf:
+ *   '' (root element itself) → '__root'
+ *   'Header'                 → 'Header'
+ *   'Header.Nav'             → 'Header.Nav'
+ *
+ * The registry is serialized into the pre-rendered HTML so the browser can
+ * assign the correct brKey to each skeleton element during true hydration.
+ */
+const buildPathRegistry = (element, path = '') => {
+  if (!element || !element.__ref) return {}
+  const registry = {}
+  const brKey = element.__ref.__brKey
+  if (brKey) registry[path === '' ? '__root' : path] = brKey
+  if (element.__ref.__children) {
+    for (const childKey of element.__ref.__children) {
+      const child = element[childKey]
+      if (child && child.__ref) {
+        const childPath = path === '' ? childKey : `${path}.${childKey}`
+        Object.assign(registry, buildPathRegistry(child, childPath))
+      }
+    }
+  }
+  return registry
+}
 /**
  * Renders a Symbols/DOMQL project to HTML on the server.
  *
@@ -595,7 +650,9 @@ export const render = async (data, options = {}) => {
   if (prefetch) {
     try {
       ssrTranslations = await fetchSSRTranslations(data)
-    } catch {}
+    } catch (e) {
+      console.warn('[brender] SSR translation fetch failed:', e.message)
+    }
   }
   // Restore location/window before createEnv sets them properly
@@ -717,6 +774,10 @@ export const render = async (data, options = {}) => {
   const registry = mapKeysToElements(element)
+  // Build element path → brKey registry for client-side true hydration.
+  // Walks the element tree after mapKeysToElements has set __brKey on each element.
+  const brRegistry = buildPathRegistry(element)
   // Extract metadata for the rendered route
   // Pass the rendered element and its state so function-valued metadata
   // (e.g. detail page titles from fetched data) can be resolved
@@ -786,7 +847,7 @@ export const render = async (data, options = {}) => {
   if (_prevLoc !== undefined) globalThis.location = _prevLoc
   else delete globalThis.location
-  return { html, metadata, registry, element, emotionCSS, document, window, ssrTranslations, prefetchedPages }
+  return { html, metadata, registry, brRegistry, element, emotionCSS, document, window, ssrTranslations, prefetchedPages }
 }
 /**
@@ -980,13 +1041,20 @@ const generateGlobalCSS = async (ds, config) => {
       write: true,
       logLevel: 'silent',
       plugins: [workspacePlugin],
+      nodePaths: ws.isMonorepo
+        ? [resolve(ws.monorepoRoot, 'node_modules')]
+        : [
+          ...(ws.smblsRoot ? [resolve(ws.smblsRoot, 'node_modules')] : []),
+          ...(ws.projectRoot ? [resolve(ws.projectRoot, 'node_modules')] : []),
+          ...(ws.smblsRoot ? [resolve(ws.smblsRoot, '..', '..', 'node_modules')] : [])
+        ].filter(p => existsSync(p)),
       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', 'color-contrast-checker']
     })
     const mod = await import(`file://${tmpOut}`)
     const data = mod.default || {}
-    try { unlinkSync(tmpEntry) } catch {}
-    try { unlinkSync(tmpOut) } catch {}
+    try { unlinkSync(tmpEntry) } catch {} // cleanup: ignore if temp file already removed
+    try { unlinkSync(tmpOut) } catch {} // cleanup: ignore if temp file already removed
     const cssVars = data.CSS_VARS || {}
     const cssMediaVars = data.CSS_MEDIA_VARS || {}
@@ -1141,6 +1209,7 @@ export const renderRoute = async (data, options = {}) => {
     fontLinks: generateFontLinks(ds),
     metadata: result.metadata || extractMetadata(data, route),
     brKeyCount: result.registry ? Object.keys(result.registry).length : 0,
+    brRegistry: result.brRegistry || {},
     ssrTranslations: result.ssrTranslations,
     prefetchedState,
     activeLang
@@ -1235,7 +1304,14 @@ export const renderPage = async (data, route = '/', options = {}) => {
           translationSeed = `<script>try{${seedEntries.join(';')}}catch(e){}</script>\n`
         }
       }
-      isrBody = `${translationSeed}<script>window.__BRENDER__ = true</script>
+      // Embed BR registry for true DOM-adoption hydration
+      const brRegistryJson = result.brRegistry && Object.keys(result.brRegistry).length
+        ? JSON.stringify(result.brRegistry)
+        : null
+      const brRegistryScript = brRegistryJson
+        ? `<script>window.__BR_REGISTRY__=${brRegistryJson}</script>\n`
+        : ''
+      isrBody = `${translationSeed}${brRegistryScript}<script>window.__BRENDER__=true</script>
 <script type="module" src="${prefix}${isr.clientScript}"></script>`
     } else {
       // Legacy swap mode: SPA creates new DOM, MutationObserver removes brender nodes