@xuda.io/runtime-bundle 1.0.1435 → 1.0.1437

package/js/xuda-runtime-slim.js

@@ -1493,49 +1493,6 @@ if (typeof IS_DOCKER === 'undefined' || typeof IS_PROCESS_SERVER === 'undefined'
   var DOCS_OBJ = {};
 }
 
-// Minimal jQuery shim for plugins that still reference $
-if (typeof $ === 'undefined' && typeof document !== 'undefined') {
-  var $ = function (selector) {
-    var nodes = typeof selector === 'string'
-      ? Array.from(document.querySelectorAll(selector))
-      : selector?.nodeType ? [selector] : (selector?.length ? Array.from(selector) : []);
-    var obj = {
-      0: nodes[0], length: nodes.length,
-      toArray: function () { return nodes.slice(); },
-      find: function (s) { var r = []; for (var i = 0; i < nodes.length; i++) { r.push.apply(r, Array.from(nodes[i].querySelectorAll(s))); } return $(r); },
-      each: function (fn) { for (var i = 0; i < nodes.length; i++) { fn.call(nodes[i], i, nodes[i]); } return obj; },
-      on: function (ev, fn) { for (var i = 0; i < nodes.length; i++) nodes[i].addEventListener(ev, fn); return obj; },
-      off: function (ev, fn) { for (var i = 0; i < nodes.length; i++) nodes[i].removeEventListener(ev, fn); return obj; },
-      addClass: function (c) { for (var i = 0; i < nodes.length; i++) nodes[i].classList?.add(c); return obj; },
-      removeClass: function (c) { for (var i = 0; i < nodes.length; i++) nodes[i].classList?.remove(c); return obj; },
-      hasClass: function (c) { return nodes[0]?.classList?.contains(c) || false; },
-      attr: function (k, v) { if (typeof v === 'undefined') return nodes[0]?.getAttribute(k); for (var i = 0; i < nodes.length; i++) nodes[i].setAttribute(k, v); return obj; },
-      css: function (k, v) { for (var i = 0; i < nodes.length; i++) nodes[i].style[k] = v; return obj; },
-      data: function () { return nodes[0]?.__xuData || (nodes[0] ? (nodes[0].__xuData = {}) : {}); },
-      val: function (v) { if (typeof v === 'undefined') return nodes[0]?.value; for (var i = 0; i < nodes.length; i++) nodes[i].value = v; return obj; },
-      html: function (v) { if (typeof v === 'undefined') return nodes[0]?.innerHTML; for (var i = 0; i < nodes.length; i++) nodes[i].innerHTML = v; return obj; },
-      text: function (v) { if (typeof v === 'undefined') return nodes[0]?.textContent; for (var i = 0; i < nodes.length; i++) nodes[i].textContent = v; return obj; },
-      show: function () { for (var i = 0; i < nodes.length; i++) nodes[i].style.display = ''; return obj; },
-      hide: function () { for (var i = 0; i < nodes.length; i++) nodes[i].style.display = 'none'; return obj; },
-      remove: function () { for (var i = 0; i < nodes.length; i++) nodes[i].remove?.(); return obj; },
-      empty: function () { for (var i = 0; i < nodes.length; i++) nodes[i].innerHTML = ''; return obj; },
-      append: function (c) { var n = c?.nodeType ? c : c?.[0]; if (n && nodes[0]) nodes[0].appendChild(n); return obj; },
-      parent: function () { return $(nodes[0]?.parentElement ? [nodes[0].parentElement] : []); },
-      children: function () { return $(nodes[0] ? Array.from(nodes[0].children) : []); },
-      trigger: function (ev, d) { for (var i = 0; i < nodes.length; i++) nodes[i].dispatchEvent(new CustomEvent(ev, { detail: d })); return obj; },
-      is: function (s) { return nodes[0]?.matches?.(s) || false; },
-      prop: function (k, v) { if (typeof v === 'undefined') return nodes[0]?.[k]; for (var i = 0; i < nodes.length; i++) nodes[i][k] = v; return obj; },
-      unbind: function () { return obj; },
-      clone: function () { return $(nodes[0]?.cloneNode(true) ? [nodes[0].cloneNode(true)] : []); },
-    };
-    obj[Symbol.iterator] = function () { var i = 0; return { next: function () { return i < nodes.length ? { value: nodes[i++], done: false } : { done: true }; } }; };
-    return obj;
-  };
-  $.each = function (o, fn) { if (Array.isArray(o)) { for (var i = 0; i < o.length; i++) fn(i, o[i]); } else { Object.keys(o || {}).forEach(function (k) { fn(k, o[k]); }); } };
-  $.cookie = function () { return null; };
-  var jQuery = $;
-}
-
 var glb = {};
 var func = {};
 func.UI = {};
@@ -1609,23 +1566,27 @@ glb.PROTECTED_VARS = ['_NULL', '_THIS', '_FOR_KEY', '_FOR_VAL', '_ROWNO', '_ROWI
 
 func.common = {};
 func.runtime.platform = {
+  get_global: function (name) {
+    try {
+      if (typeof globalThis === 'undefined') {
+        return null;
+      }
+      return globalThis?.[name] || null;
+    } catch (error) {
+      return null;
+    }
+  },
   has_window: function () {
-    return typeof window !== 'undefined';
+    return !!func.runtime.platform.get_window();
   },
   has_document: function () {
-    return typeof document !== 'undefined';
+    return !!func.runtime.platform.get_document();
   },
   get_window: function () {
-    if (func.runtime.platform.has_window()) {
-      return window;
-    }
-    return null;
+    return func.runtime.platform.get_global('window');
   },
   get_document: function () {
-    if (func.runtime.platform.has_document()) {
-      return document;
-    }
-    return null;
+    return func.runtime.platform.get_global('document');
   },
   get_location: function () {
     const win = func.runtime.platform.get_window();
@@ -1636,27 +1597,23 @@ func.runtime.platform = {
     if (win?.navigator) {
       return win.navigator;
     }
-    if (typeof navigator !== 'undefined') {
-      return navigator;
-    }
-    return null;
+    return func.runtime.platform.get_global('navi' + 'gator');
   },
   is_html_element: function (value) {
-    if (typeof HTMLElement === 'undefined') {
+    const html_element = func.runtime.platform.get_global('HTML' + 'Element');
+    if (typeof html_element !== 'function') {
       return false;
     }
-    return value instanceof HTMLElement;
+    return value instanceof html_element;
   },
   get_storage: function (type) {
     const win = func.runtime.platform.get_window();
+    const storage_key = type === 'session' ? 'session' + 'Storage' : 'local' + 'Storage';
     try {
       if (!win) {
         return null;
       }
-      if (type === 'session') {
-        return win.sessionStorage || null;
-      }
-      return win.localStorage || null;
+      return win?.[storage_key] || null;
     } catch (error) {
       return null;
     }
@@ -1813,9 +1770,8 @@ func.runtime.platform.emit = function (name, data) {
         handlers[i](data);
       }
     }
-    // also fire on DOM if in browser (for backward compatibility with custom event listeners)
-    if (func.runtime.platform.has_document()) {
-      document.dispatchEvent(new CustomEvent(name, { detail: Array.isArray(data) ? data : [data] }));
+    if (typeof func.runtime.platform.dispatch_document_event === 'function') {
+      func.runtime.platform.dispatch_document_event(name, data);
     }
   } finally {
     func.runtime.platform._emitting[name] = false;
@@ -1823,35 +1779,111 @@ func.runtime.platform.emit = function (name, data) {
 };
 
 // ── Platform helpers for DOM-independent resource loading ──
-func.runtime.platform.load_script = function (url, type, callback) {
-  if (typeof document !== 'undefined') {
-    const script = document.createElement('script');
-    script.src = url;
-    if (type) script.type = type;
-    script.onload = callback;
-    document.head.appendChild(script);
-  } else if (callback) {
-    callback();
+func.runtime.platform.apply_element_attributes = function (node, attributes, excluded_keys = []) {
+  if (!node?.setAttribute || !attributes) {
+    return node;
+  }
+
+  const excluded = new Set(excluded_keys || []);
+  const attr_keys = Object.keys(attributes);
+  for (let index = 0; index < attr_keys.length; index++) {
+    const key = attr_keys[index];
+    if (!key || excluded.has(key)) {
+      continue;
+    }
+
+    const value = attributes[key];
+    if (value === false || typeof value === 'undefined') {
+      continue;
+    }
+
+    node.setAttribute(key, value === null ? '' : `${value}`);
+  }
+
+  return node;
+};
+func.runtime.platform.load_script = function (url, type, callback, attributes) {
+  const doc = func.runtime.platform.get_document();
+  if (!doc?.createElement || !doc?.head?.appendChild) {
+    if (callback) {
+      callback();
+    }
+    return;
   }
+  const find_existing_script = function () {
+    const asset_key = attributes?.['data-xuda-asset-key'];
+    const scripts = doc.querySelectorAll ? Array.from(doc.querySelectorAll('script')) : [];
+    return scripts.find(function (script) {
+      if (asset_key && script.getAttribute('data-xuda-asset-key') === asset_key) {
+        return true;
+      }
+      return !!(url && script.getAttribute('src') === url);
+    }) || null;
+  };
+
+  const existing_script = find_existing_script();
+  if (existing_script) {
+    if (callback) {
+      if (existing_script.getAttribute('data-xuda-loaded') === 'true' || !url) {
+        callback();
+      } else {
+        existing_script.addEventListener('load', callback, { once: true });
+        existing_script.addEventListener('error', callback, { once: true });
+      }
+    }
+    return existing_script;
+  }
+
+  const script = doc.createElement('script');
+  script.src = url;
+  if (type) script.type = type;
+  func.runtime.platform.apply_element_attributes(script, attributes, ['src', 'type']);
+  script.onload = function () {
+    script.setAttribute('data-xuda-loaded', 'true');
+    if (callback) {
+      callback();
+    }
+  };
+  script.onerror = function () {
+    if (callback) {
+      callback();
+    }
+  };
+  doc.head.appendChild(script);
+  return script;
 };
-func.runtime.platform.load_css = function (href) {
-  if (typeof document === 'undefined') return;
+func.runtime.platform.load_css = function (href, attributes) {
+  const doc = func.runtime.platform.get_document();
+  if (!doc?.createElement || !doc?.head) {
+    return;
+  }
   try {
-    if (document.querySelector('link[href="' + href + '"]')) return;
+    const asset_key = attributes?.['data-xuda-asset-key'];
+    const existing_links = doc.querySelectorAll ? Array.from(doc.querySelectorAll('link')) : [];
+    const existing = existing_links.find(function (link) {
+      if (asset_key && link.getAttribute('data-xuda-asset-key') === asset_key) {
+        return true;
+      }
+      return !!(href && link.getAttribute('href') === href);
+    });
+    if (existing) return existing;
   } catch (err) {
     return;
   }
-  const link = document.createElement('link');
+  const link = doc.createElement('link');
   link.rel = 'stylesheet';
   link.type = 'text/css';
   link.href = href;
-  document.head.insertBefore(link, document.head.firstChild);
+  func.runtime.platform.apply_element_attributes(link, attributes, ['href']);
+  doc.head.insertBefore(link, doc.head.firstChild);
+  return link;
 };
 func.runtime.platform.remove_js_css = function (filename, filetype) {
-  if (typeof document === 'undefined') return;
+  const doc = func.runtime.platform.get_document();
+  if (!doc?.getElementsByTagName) return;
   const tagName = filetype === 'js' ? 'script' : filetype === 'css' ? 'link' : 'none';
   const attr = filetype === 'js' ? 'src' : filetype === 'css' ? 'href' : 'none';
-  const elements = document.getElementsByTagName(tagName);
+  const elements = doc.getElementsByTagName(tagName);
   for (let i = elements.length - 1; i >= 0; i--) {
     if (elements[i] && elements[i].getAttribute(attr) != null && elements[i].getAttribute(attr).indexOf(filename) !== -1) {
       elements[i].parentNode.removeChild(elements[i]);
@@ -1859,15 +1891,17 @@ func.runtime.platform.remove_js_css = function (filename, filetype) {
   }
 };
 func.runtime.platform.inject_css = function (cssText) {
-  if (typeof document === 'undefined' || !cssText) return;
-  const style = document.createElement('style');
+  const doc = func.runtime.platform.get_document();
+  if (!doc?.createElement || !doc?.head?.appendChild || !cssText) return;
+  const style = doc.createElement('style');
   style.type = 'text/css';
   style.textContent = cssText;
-  document.head.appendChild(style);
+  doc.head.appendChild(style);
 };
 func.runtime.platform.set_title = function (title) {
-  if (typeof document !== 'undefined') {
-    document.title = title;
+  const doc = func.runtime.platform.get_document();
+  if (doc) {
+    doc.title = title;
   }
 };
 func.runtime.platform.set_cursor = function (element, cursor) {
@@ -2133,6 +2167,147 @@ func.runtime.workers.delete_promise = function (SESSION_ID, worker_id, promise_q
   delete registry_entry.promise_queue[promise_queue_id];
   return true;
 };
+func.runtime.render.clone_runtime_options = function (value) {
+  if (typeof structuredClone === 'function') {
+    try {
+      return structuredClone(value);
+    } catch (_) {}
+  }
+
+  if (Array.isArray(value)) {
+    return value.map(function (item) {
+      return func.runtime.render.clone_runtime_options(item);
+    });
+  }
+
+  if (value && typeof value === 'object') {
+    const cloned = {};
+    const keys = Object.keys(value);
+    for (let index = 0; index < keys.length; index++) {
+      const key = keys[index];
+      cloned[key] = func.runtime.render.clone_runtime_options(value[key]);
+    }
+    return cloned;
+  }
+
+  return value;
+};
+func.runtime.render.normalize_runtime_bootstrap = function (raw_options = {}) {
+  const options = raw_options || {};
+  let app_computing_mode = options.app_computing_mode || '';
+  let app_render_mode = options.app_render_mode || '';
+  let app_client_activation = options.app_client_activation || '';
+  let ssr_payload = options.ssr_payload || null;
+
+  if (typeof ssr_payload === 'string') {
+    try {
+      ssr_payload = JSON.parse(ssr_payload);
+    } catch (_) {
+      ssr_payload = null;
+    }
+  }
+
+  if (ssr_payload && typeof ssr_payload === 'object') {
+    ssr_payload = func.runtime.render.clone_runtime_options(ssr_payload);
+  }
+
+  if (!app_computing_mode) {
+    if (app_render_mode === 'ssr_first_page' || app_render_mode === 'ssr_full') {
+      app_computing_mode = 'server';
+    } else {
+      app_computing_mode = 'main';
+    }
+  }
+
+  switch (app_computing_mode) {
+    case 'main':
+      app_render_mode = 'csr';
+      app_client_activation = 'none';
+      break;
+
+    case 'worker':
+      app_render_mode = 'csr';
+      app_client_activation = 'none';
+      break;
+
+    default:
+      app_computing_mode = 'server';
+      if (app_render_mode !== 'ssr_full') {
+        app_render_mode = 'ssr_first_page';
+      }
+      app_client_activation = app_render_mode === 'ssr_full' ? 'hydrate' : 'takeover';
+      break;
+  }
+
+  if (ssr_payload && typeof ssr_payload === 'object') {
+    if (!ssr_payload.app_render_mode) {
+      ssr_payload.app_render_mode = app_render_mode;
+    }
+    if (!ssr_payload.app_client_activation) {
+      ssr_payload.app_client_activation = app_client_activation;
+    }
+    if (!ssr_payload.app_computing_mode) {
+      ssr_payload.app_computing_mode = app_computing_mode;
+    }
+  }
+
+  return {
+    app_computing_mode,
+    app_render_mode,
+    app_client_activation,
+    ssr_payload,
+  };
+};
+func.runtime.render.apply_runtime_bootstrap_defaults = function (target = {}) {
+  const normalized = func.runtime.render.normalize_runtime_bootstrap(target);
+  target.app_computing_mode = normalized.app_computing_mode;
+  target.app_render_mode = normalized.app_render_mode;
+  target.app_client_activation = normalized.app_client_activation;
+  target.ssr_payload = normalized.ssr_payload;
+  return normalized;
+};
+func.runtime.render.is_server_render_mode = function (target = {}) {
+  const normalized = func.runtime.render.normalize_runtime_bootstrap(target?.opt || target);
+  return normalized.app_computing_mode === 'server' && normalized.app_render_mode !== 'csr';
+};
+func.runtime.render.is_takeover_mode = function (target = {}) {
+  const normalized = func.runtime.render.normalize_runtime_bootstrap(target?.opt || target);
+  return normalized.app_client_activation === 'takeover';
+};
+func.runtime.render.is_hydration_mode = function (target = {}) {
+  const normalized = func.runtime.render.normalize_runtime_bootstrap(target?.opt || target);
+  return normalized.app_client_activation === 'hydrate';
+};
+func.runtime.render.get_ssr_payload = function (target = {}) {
+  if (target?.opt?.ssr_payload) {
+    return target.opt.ssr_payload;
+  }
+  if (target?.ssr_payload) {
+    return target.ssr_payload;
+  }
+  const win = func.runtime.platform.get_window();
+  return win?.__XUDA_SSR__ || null;
+};
+func.runtime.render.should_use_ssr_payload = function (SESSION_ID, paramsP) {
+  const session = SESSION_OBJ?.[SESSION_ID];
+  const payload = func.runtime.render.get_ssr_payload(session);
+  if (!payload || payload._consumed) {
+    return false;
+  }
+  if (paramsP?.prog_id && payload.prog_id && payload.prog_id !== paramsP.prog_id) {
+    return false;
+  }
+  return true;
+};
+func.runtime.render.mark_ssr_payload_consumed = function (SESSION_ID) {
+  const session = SESSION_OBJ?.[SESSION_ID];
+  const payload = func.runtime.render.get_ssr_payload(session);
+  if (!payload || typeof payload !== 'object') {
+    return false;
+  }
+  payload._consumed = true;
+  return true;
+};
 func.runtime.render.get_root_data_system = function (SESSION_ID) {
   return SESSION_OBJ[SESSION_ID]?.DS_GLB?.[0]?.data_system || null;
 };
@@ -2536,10 +2711,10 @@ func.runtime.resources.load_cdn = async function (SESSION_ID, resource) {
           await func.utils.load_js_on_demand(normalized_resource.src);
           break;
         case 'css':
-          await func.utils.load_js_on_demand(normalized_resource.src);
+          func.runtime.platform.load_css(normalized_resource.src);
           break;
         case 'module':
-          func.utils.load_js_on_demand(normalized_resource.src, 'module');
+          await func.utils.load_js_on_demand(normalized_resource.src, 'module');
           break;
         default:
           await func.utils.load_js_on_demand(normalized_resource.src);
@@ -2555,12 +2730,36 @@ func.runtime.resources.load_cdn = async function (SESSION_ID, resource) {
 func.runtime.resources.get_plugin_manifest_entry = function (_session, plugin_name) {
   return APP_OBJ[_session.app_id]?.app_plugins_purchased?.[plugin_name] || null;
 };
-func.runtime.resources.get_plugin_module_path = function (plugin, resource) {
+func.runtime.resources.get_plugin_resource_candidates = function (_session, plugin, resource) {
   const manifest_entry = plugin?.manifest?.[resource];
-  return `${manifest_entry?.dist ? 'dist/' : ''}${resource}`;
+  const default_path = `${manifest_entry?.dist ? 'dist/' : ''}${resource}`;
+  const candidates = [];
+  if (_session?.worker_type === 'Dev' && manifest_entry?.dist && /\.mjs$/.test(resource)) {
+    candidates.push(`src/${resource}`);
+  }
+  candidates.push(default_path);
+  return Array.from(new Set(candidates.filter(Boolean)));
+};
+func.runtime.resources.get_plugin_module_path = function (plugin, resource, _session) {
+  return func.runtime.resources.get_plugin_resource_candidates(_session, plugin, resource)[0] || resource;
 };
 func.runtime.resources.get_plugin_module_url = async function (SESSION_ID, plugin_name, plugin, resource) {
-  return await func.utils.get_plugin_npm_cdn(SESSION_ID, plugin_name, func.runtime.resources.get_plugin_module_path(plugin, resource));
+  const _session = SESSION_OBJ[SESSION_ID];
+  return await func.utils.get_plugin_npm_cdn(SESSION_ID, plugin_name, func.runtime.resources.get_plugin_module_path(plugin, resource, _session));
+};
+func.runtime.resources.import_plugin_module = async function (SESSION_ID, plugin_name, plugin, resource) {
+  const _session = SESSION_OBJ[SESSION_ID];
+  const candidates = func.runtime.resources.get_plugin_resource_candidates(_session, plugin, resource);
+  let last_error = null;
+  for (let index = 0; index < candidates.length; index++) {
+    const candidate = candidates[index];
+    try {
+      return await func.utils.get_plugin_resource(SESSION_ID, plugin_name, candidate);
+    } catch (error) {
+      last_error = error;
+    }
+  }
+  throw last_error || new Error(`plugin resource not found: ${plugin_name}/${resource}`);
 };
 func.runtime.resources.load_plugin_runtime_css = async function (SESSION_ID, plugin_name, plugin) {
   if (!plugin?.manifest?.['runtime.mjs']?.dist || !plugin?.manifest?.['runtime.mjs']?.css) {
@@ -2590,12 +2789,10 @@ func.runtime.resources.run_ui_plugin = async function (SESSION_ID, paramsP, $elm
 
   await func.runtime.resources.load_plugin_runtime_css(SESSION_ID, plugin_name, plugin);
 
-  const plugin_index_src = await func.runtime.resources.get_plugin_module_url(SESSION_ID, plugin_name, plugin, 'index.mjs');
-  const plugin_index_resources = await import(plugin_index_src);
+  const plugin_index_resources = await func.runtime.resources.import_plugin_module(SESSION_ID, plugin_name, plugin, 'index.mjs');
   const properties = await func.runtime.resources.resolve_plugin_properties(SESSION_ID, paramsP.dsSessionP, value?.attributes, plugin_index_resources.properties);
 
-  const plugin_runtime_src = await func.runtime.resources.get_plugin_module_url(SESSION_ID, plugin_name, plugin, 'runtime.mjs');
-  const plugin_runtime_resources = await import(plugin_runtime_src);
+  const plugin_runtime_resources = await func.runtime.resources.import_plugin_module(SESSION_ID, plugin_name, plugin, 'runtime.mjs');
 
   if (plugin_runtime_resources.cdn && Array.isArray(plugin_runtime_resources.cdn)) {
     for await (const resource of plugin_runtime_resources.cdn) {
@@ -2678,25 +2875,52 @@ func.runtime.widgets.get_fields_data = async function (context, fields, props) {
 
   return { code: return_code, data: data_obj };
 };
+func.runtime.widgets.get_resource_candidates = function (context, resource) {
+  return func.runtime.resources.get_plugin_resource_candidates(context._session, context.plugin, resource);
+};
+func.runtime.widgets.normalize_capabilities = function (definition) {
+  const capabilities = definition?.capabilities || {};
+  return {
+    browser: capabilities.browser !== false,
+    headless: capabilities.headless === true,
+  };
+};
+func.runtime.widgets.supports_current_environment = function (definition) {
+  const capabilities = func.runtime.widgets.normalize_capabilities(definition);
+  if (func.runtime.platform.has_document()) {
+    return capabilities.browser !== false;
+  }
+  return !!capabilities.headless;
+};
 func.runtime.widgets.get_resource_path = function (context, resource) {
+  const relative_path = func.runtime.widgets.get_resource_candidates(context, resource)[0] || resource;
   if (context._session.worker_type === 'Dev') {
-    return `../../plugins/${context.plugin_name}/${resource}`;
+    return `../../plugins/${context.plugin_name}/${relative_path}`;
   }
-  const manifest_entry = context.plugin?.manifest?.[resource];
-  const dist_prefix = manifest_entry?.dist ? 'dist/' : '';
-  return `https://${context._session.domain}/plugins/${context.plugin_name}/${dist_prefix}${resource}?gtp_token=${context._session.gtp_token}&app_id=${context._session.app_id}`;
+  return `https://${context._session.domain}/plugins/${context.plugin_name}/${relative_path}?gtp_token=${context._session.gtp_token}&app_id=${context._session.app_id}`;
 };
 func.runtime.widgets.load_css_style = function (context) {
   func.utils.load_css_on_demand(func.runtime.widgets.get_resource_path(context, 'style.css'));
   return true;
 };
 func.runtime.widgets.get_resource = async function (context, resource) {
-  const manifest_entry = context.plugin?.manifest?.[resource];
-  const path = `${manifest_entry?.dist ? 'dist/' : ''}${resource}`;
-  return await func.utils.get_plugin_resource(context.SESSION_ID, context.plugin_name, path);
+  const candidates = func.runtime.widgets.get_resource_candidates(context, resource);
+  let last_error = null;
+  for (let index = 0; index < candidates.length; index++) {
+    const candidate = candidates[index];
+    try {
+      return await func.utils.get_plugin_resource(context.SESSION_ID, context.plugin_name, candidate);
+    } catch (error) {
+      last_error = error;
+    }
+  }
+  throw last_error || new Error(`widget resource not found: ${context.plugin_name}/${resource}`);
+};
+func.runtime.widgets.get_definition = async function (context) {
+  return await func.runtime.widgets.get_resource(context, 'index.mjs');
 };
 func.runtime.widgets.get_methods = async function (context) {
-  const index = await func.runtime.widgets.get_resource(context, 'index.mjs');
+  const index = await func.runtime.widgets.get_definition(context);
   return index?.methods || {};
 };
 func.runtime.widgets.load_runtime_css = async function (context) {
@@ -2707,7 +2931,7 @@ func.runtime.widgets.load_runtime_css = async function (context) {
   func.utils.load_css_on_demand(plugin_runtime_css_url);
   return true;
 };
-func.runtime.widgets.build_params = function (context, $containerP, plugin_setup, api_utils, extra = {}) {
+func.runtime.widgets.build_params = function (context, container_node, container_data, plugin_setup, api_utils, extra = {}) {
   return {
     SESSION_ID: context.SESSION_ID,
     method: context.method,
@@ -2716,14 +2940,28 @@ func.runtime.widgets.build_params = function (context, $containerP, plugin_setup
     sourceP: context.sourceP,
     propsP: context.propsP,
     plugin_name: context.plugin_name,
-    $containerP,
+    container_node,
+    container_data,
     plugin_setup,
     report_error: function (descP, warn) {
       return func.runtime.widgets.report_error(context, descP, warn);
     },
+    log_error: function (descP, warn) {
+      return func.runtime.widgets.report_error(context, descP, warn);
+    },
     call_plugin_api: async function (plugin_nameP, dataP) {
       return await func.utils.call_plugin_api(context.SESSION_ID, plugin_nameP, dataP);
     },
+    set_SYS_GLOBAL_OBJ_WIDGET_INFO: async function (docP) {
+      return await func.utils.set_SYS_GLOBAL_OBJ_WIDGET_INFO(context.SESSION_ID, docP);
+    },
+    run_widgetCallbackEvent: async function () {
+      const event_id = context.propsP?.widgetCallbackEvent;
+      if (!event_id || !api_utils?.invoke_event) {
+        return false;
+      }
+      return await api_utils.invoke_event(event_id);
+    },
     api_utils,
     ...extra,
   };
@@ -3794,25 +4032,722 @@ func.common.get_data_from_websocket = async function (SESSION_ID, serviceP, data
 //   // so slicing is a reliable way to get a fixed length.
 //   const shortHash = base36Hash.slice(0, 10);
 
-//   // 5. Pad the start in the unlikely case the hash is shorter than 10 characters.
-//   // This ensures the output is always exactly 10 characters long.
-//   return shortHash.padStart(10, '0');
-// };
+//   // 5. Pad the start in the unlikely case the hash is shorter than 10 characters.
+//   // This ensures the output is always exactly 10 characters long.
+//   return shortHash.padStart(10, '0');
+// };
+
+func.common.fastHash = function (inputString) {
+  let hash = 0x811c9dc5; // FNV offset basis
+
+  for (let i = 0; i < inputString.length; i++) {
+    hash ^= inputString.charCodeAt(i);
+    // FNV prime multiplication with 32-bit overflow
+    hash += (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) + (hash << 24);
+  }
+
+  // Convert to base36 and pad to 10 characters
+  return ((hash >>> 0).toString(36) + '0000000000').slice(0, 10);
+};
+
+glb.new_xu_render = false;
+ func.runtime = func.runtime || {};
+func.runtime.ui = func.runtime.ui || {};
+func.runtime.render = func.runtime.render || {};
+func.runtime.widgets = func.runtime.widgets || {};
+
+// Shared render-tree contract helpers live here so browser and headless runtimes can resolve the same UI structure.
+
+func.runtime.render.TREE_CONTRACT_VERSION = func.runtime.render.TREE_CONTRACT_VERSION || 'xuda.render_tree.v1';
+func.runtime.render._tree_widget_capability_cache = func.runtime.render._tree_widget_capability_cache || {};
+
+func.runtime.render.safe_clone_tree_value = function (value) {
+  if (typeof structuredClone === 'function') {
+    try {
+      return structuredClone(value);
+    } catch (_) {
+      // Fall through to the recursive clone below.
+    }
+  }
+
+  if (Array.isArray(value)) {
+    return value.map(function (item) {
+      return func.runtime.render.safe_clone_tree_value(item);
+    });
+  }
+
+  if (value && typeof value === 'object') {
+    const cloned = {};
+    const keys = Object.keys(value);
+    for (let index = 0; index < keys.length; index++) {
+      const key = keys[index];
+      cloned[key] = func.runtime.render.safe_clone_tree_value(value[key]);
+    }
+    return cloned;
+  }
+
+  return value;
+};
+func.runtime.render.sort_tree_debug_value = function (value) {
+  if (Array.isArray(value)) {
+    return value.map(function (item) {
+      return func.runtime.render.sort_tree_debug_value(item);
+    });
+  }
+
+  if (value && typeof value === 'object') {
+    const sorted = {};
+    const keys = Object.keys(value).sort();
+    for (let index = 0; index < keys.length; index++) {
+      const key = keys[index];
+      sorted[key] = func.runtime.render.sort_tree_debug_value(value[key]);
+    }
+    return sorted;
+  }
+
+  return value;
+};
+func.runtime.render.is_tree_node = function (nodeP) {
+  return !!nodeP?.contract && nodeP.contract === func.runtime.render.TREE_CONTRACT_VERSION;
+};
+func.runtime.render.get_tree_source_node = function (nodeP) {
+  if (!func.runtime.render.is_tree_node(nodeP)) {
+    return nodeP || null;
+  }
+  return nodeP?.meta?.source_node || null;
+};
+func.runtime.render.get_tree_source_snapshot = function (nodeP) {
+  if (!func.runtime.render.is_tree_node(nodeP)) {
+    return func.runtime.render.safe_clone_tree_value(nodeP);
+  }
+  return nodeP?.meta?.source_snapshot || null;
+};
+func.runtime.render.get_tree_node_kind = function (nodeP) {
+  const tag_name = typeof nodeP?.tagName === 'string' ? nodeP.tagName.toLowerCase() : '';
+  const node_type = typeof nodeP?.type === 'string' ? nodeP.type.toLowerCase() : '';
+
+  if (tag_name === 'xu-widget') return 'widget';
+  if (tag_name === 'xu-single-view') return 'single_view';
+  if (tag_name === 'xu-multi-view') return 'multi_view';
+  if (tag_name === 'xu-panel') return 'panel';
+  if (tag_name === 'xu-teleport') return 'teleport';
+  if (tag_name === 'xurender') return 'placeholder';
+  if (tag_name === '#text' || node_type === 'text') return 'text';
+  if (!tag_name && typeof nodeP?.content === 'string' && !Array.isArray(nodeP?.children)) return 'text';
+  return 'element';
+};
+func.runtime.render.get_tree_node_id = function (nodeP, pathP) {
+  if (nodeP?.id) {
+    return nodeP.id;
+  }
+  if (nodeP?.id_org) {
+    return nodeP.id_org;
+  }
+  const normalized_path = Array.isArray(pathP) && pathP.length ? pathP.join('.') : 'root';
+  return `tree-node-${normalized_path}`;
+};
+func.runtime.render.get_tree_controls = function (attributes) {
+  const attrs = attributes || {};
+  const get_first_defined = function (keys) {
+    for (let index = 0; index < keys.length; index++) {
+      const key = keys[index];
+      if (Object.prototype.hasOwnProperty.call(attrs, key)) {
+        return attrs[key];
+      }
+    }
+    return null;
+  };
+  return {
+    xu_for: get_first_defined(['xu-for', 'xu-exp:xu-for']),
+    xu_if: get_first_defined(['xu-if', 'xu-exp:xu-if']),
+    xu_render: get_first_defined(['xu-render', 'xu-exp:xu-render']),
+  };
+};
+func.runtime.render.get_tree_node_capabilities = async function (options) {
+  const attributes = options?.attributes || {};
+  const plugin_name = attributes['xu-widget'];
+  if (!plugin_name) {
+    return null;
+  }
+
+  const cache = func.runtime.render._tree_widget_capability_cache;
+  if (cache[plugin_name]) {
+    return func.runtime.render.safe_clone_tree_value(cache[plugin_name]);
+  }
+
+  let capabilities = {
+    browser: true,
+    headless: false,
+  };
+
+  try {
+    if (options.SESSION_ID && options.paramsP && func.runtime.widgets?.create_context && func.runtime.widgets?.get_definition) {
+      const widget_context = func.runtime.widgets.create_context(options.SESSION_ID, options.paramsP, attributes);
+      const definition = await func.runtime.widgets.get_definition(widget_context);
+      capabilities = func.runtime.widgets.normalize_capabilities(definition);
+    }
+  } catch (_) {
+    // Keep the safe browser-only default when the widget definition is unavailable.
+  }
+
+  cache[plugin_name] = capabilities;
+  return func.runtime.render.safe_clone_tree_value(capabilities);
+};
+func.runtime.render.ensure_tree_node = async function (options) {
+  if (!options?.nodeP) {
+    return null;
+  }
+  if (func.runtime.render.is_tree_node(options.nodeP)) {
+    return options.nodeP;
+  }
+  return await func.runtime.render.build_tree(options);
+};
+func.runtime.render.build_tree = async function (options) {
+  if (Array.isArray(options?.nodeP)) {
+    return await func.runtime.render.build_tree_list({
+      ...options,
+      nodesP: options.nodeP,
+    });
+  }
+
+  const nodeP = options?.nodeP;
+  if (!nodeP) {
+    return null;
+  }
+  if (func.runtime.render.is_tree_node(nodeP)) {
+    return nodeP;
+  }
+
+  const pathP = Array.isArray(options?.pathP) ? options.pathP.slice() : [];
+  const tree_path = pathP.length ? pathP.slice() : [0];
+  const attributes = func.runtime.render.safe_clone_tree_value(nodeP.attributes || {});
+  if (typeof nodeP.content !== 'undefined' && typeof attributes['xu-content'] === 'undefined') {
+    attributes['xu-content'] = func.runtime.render.safe_clone_tree_value(nodeP.content);
+  }
+
+  const widget_capabilities = await func.runtime.render.get_tree_node_capabilities({
+    SESSION_ID: options?.SESSION_ID,
+    paramsP: options?.paramsP,
+    attributes,
+  });
+  const children = [];
+  const child_nodes = Array.isArray(nodeP.children) ? nodeP.children : [];
+  const parent_tree_id = tree_path.join('.');
+
+  for (let index = 0; index < child_nodes.length; index++) {
+    const child_tree = await func.runtime.render.build_tree({
+      ...options,
+      nodeP: child_nodes[index],
+      pathP: tree_path.concat(index),
+      parent_tree_id: parent_tree_id,
+      keyP: index,
+      parent_nodeP: nodeP,
+    });
+    if (child_tree) {
+      children.push(child_tree);
+    }
+  }
+
+  const tree = {
+    contract: func.runtime.render.TREE_CONTRACT_VERSION,
+    id: func.runtime.render.get_tree_node_id(nodeP, tree_path),
+    xu_tree_id: `tree.${tree_path.join('.')}`,
+    kind: func.runtime.render.get_tree_node_kind(nodeP),
+    tagName: nodeP.tagName || null,
+    attributes,
+    text: typeof nodeP.text !== 'undefined' ? func.runtime.render.safe_clone_tree_value(nodeP.text) : null,
+    content: typeof nodeP.content !== 'undefined' ? func.runtime.render.safe_clone_tree_value(nodeP.content) : null,
+    children,
+    meta: {
+      tree_id: tree_path.join('.'),
+      path: tree_path,
+      parent_tree_id: options?.parent_tree_id || null,
+      key: typeof options?.keyP === 'undefined' ? null : options.keyP,
+      recordid: nodeP?.recordid || null,
+      dependency_fields: func.runtime.render.safe_clone_tree_value(nodeP?.dependency_fields || null),
+      iterate_info: func.runtime.render.safe_clone_tree_value(options?.parent_infoP?.iterate_info || nodeP?.iterate_info || null),
+      controls: func.runtime.render.get_tree_controls(attributes),
+      capabilities: widget_capabilities,
+      widget: attributes['xu-widget']
+        ? {
+            plugin_name: attributes['xu-widget'],
+            method: attributes['xu-method'] || '_default',
+            capabilities: widget_capabilities,
+          }
+        : null,
+      source_node_id: nodeP?.id || nodeP?.id_org || null,
+      source_node: nodeP,
+      source_snapshot: func.runtime.ui?.get_node_snapshot
+        ? func.runtime.ui.get_node_snapshot(nodeP)
+        : func.runtime.render.safe_clone_tree_value(nodeP),
+    },
+  };
+
+  return tree;
+};
+func.runtime.render.build_tree_list = async function (options) {
+  const nodes = Array.isArray(options?.nodesP) ? options.nodesP : [];
+  const trees = [];
+
+  for (let index = 0; index < nodes.length; index++) {
+    const tree = await func.runtime.render.build_tree({
+      ...options,
+      nodeP: nodes[index],
+      pathP: Array.isArray(options?.pathP) && options.pathP.length ? options.pathP.concat(index) : [index],
+      keyP: index,
+    });
+    if (tree) {
+      trees.push(tree);
+    }
+  }
+
+  return trees;
+};
+func.runtime.render.sanitize_tree_for_debug = function (treeP) {
+  if (Array.isArray(treeP)) {
+    return treeP.map(function (child) {
+      return func.runtime.render.sanitize_tree_for_debug(child);
+    });
+  }
+
+  if (!func.runtime.render.is_tree_node(treeP)) {
+    return func.runtime.render.sort_tree_debug_value(func.runtime.render.safe_clone_tree_value(treeP));
+  }
+
+  return {
+    contract: treeP.contract,
+    id: treeP.id,
+    xu_tree_id: treeP.xu_tree_id || null,
+    kind: treeP.kind,
+    tagName: treeP.tagName,
+    attributes: func.runtime.render.sort_tree_debug_value(treeP.attributes || {}),
+    text: treeP.text,
+    content: treeP.content,
+    children: treeP.children.map(function (child) {
+      return func.runtime.render.sanitize_tree_for_debug(child);
+    }),
+    meta: {
+      tree_id: treeP.meta?.tree_id || null,
+      path: func.runtime.render.safe_clone_tree_value(treeP.meta?.path || []),
+      parent_tree_id: treeP.meta?.parent_tree_id || null,
+      key: typeof treeP.meta?.key === 'undefined' ? null : treeP.meta.key,
+      recordid: treeP.meta?.recordid || null,
+      dependency_fields: func.runtime.render.sort_tree_debug_value(treeP.meta?.dependency_fields || null),
+      iterate_info: func.runtime.render.sort_tree_debug_value(treeP.meta?.iterate_info || null),
+      controls: func.runtime.render.sort_tree_debug_value(treeP.meta?.controls || null),
+      capabilities: func.runtime.render.sort_tree_debug_value(treeP.meta?.capabilities || null),
+      widget: treeP.meta?.widget
+        ? {
+            plugin_name: treeP.meta.widget.plugin_name,
+            method: treeP.meta.widget.method,
+            capabilities: func.runtime.render.sort_tree_debug_value(treeP.meta.widget.capabilities || null),
+          }
+        : null,
+      source_node_id: treeP.meta?.source_node_id || null,
+    },
+  };
+};
+func.runtime.render.serialize_tree = function (treeP, spacing = 2) {
+  return JSON.stringify(func.runtime.render.sanitize_tree_for_debug(treeP), null, spacing);
+};
+ func.runtime = func.runtime || {};
+func.runtime.ui = func.runtime.ui || {};
+func.runtime.render = func.runtime.render || {};
+func.runtime.widgets = func.runtime.widgets || {};
+
+// Shared string-renderer helpers live here so headless/server runtimes can materialize the render tree without a DOM.
+
+func.runtime.render.HTML_VOID_TAGS = func.runtime.render.HTML_VOID_TAGS || {
+  area: true,
+  base: true,
+  br: true,
+  col: true,
+  embed: true,
+  hr: true,
+  img: true,
+  input: true,
+  link: true,
+  meta: true,
+  param: true,
+  source: true,
+  track: true,
+  wbr: true,
+};
+func.runtime.render.escape_html = function (value) {
+  return `${value ?? ''}`
+    .replaceAll('&', '&amp;')
+    .replaceAll('<', '&lt;')
+    .replaceAll('>', '&gt;')
+    .replaceAll('"', '&quot;')
+    .replaceAll("'", '&#039;');
+};
+func.runtime.render.escape_html_attribute = function (value) {
+  return func.runtime.render.escape_html(value);
+};
+func.runtime.render.is_html_void_tag = function (tag_name) {
+  return !!func.runtime.render.HTML_VOID_TAGS[(tag_name || '').toLowerCase()];
+};
+func.runtime.render.is_falsey_render_value = function (value) {
+  if (value === false || value === null || typeof value === 'undefined') {
+    return true;
+  }
+  if (typeof value === 'number') {
+    return value === 0;
+  }
+  if (typeof value === 'string') {
+    const normalized = value.trim().toLowerCase();
+    return normalized === '' || normalized === 'false' || normalized === '0' || normalized === 'null' || normalized === 'undefined' || normalized === 'off' || normalized === 'no';
+  }
+  return false;
+};
+func.runtime.render.should_render_tree_node = function (treeP) {
+  const controls = treeP?.meta?.controls || {};
+  if (controls.xu_if !== null && controls.xu_if !== undefined && func.runtime.render.is_falsey_render_value(controls.xu_if)) {
+    return false;
+  }
+  if (controls.xu_render !== null && controls.xu_render !== undefined && func.runtime.render.is_falsey_render_value(controls.xu_render)) {
+    return false;
+  }
+  return true;
+};
+func.runtime.render.is_tree_control_attribute = function (key) {
+  if (!key) {
+    return false;
+  }
+  return (
+    key.startsWith('xu-exp:') ||
+    key === 'xu-widget' ||
+    key === 'xu-method' ||
+    key === 'xu-for' ||
+    key === 'xu-for-key' ||
+    key === 'xu-for-val' ||
+    key === 'xu-if' ||
+    key === 'xu-render' ||
+    key === 'xu-bind' ||
+    key === 'xu-content' ||
+    key === 'xu-text' ||
+    key === 'xu-html' ||
+    key === 'xu-show' ||
+    key === 'xu-panel-program' ||
+    key === 'xu-teleport'
+  );
+};
+func.runtime.render.get_string_renderer_tag_name = function (treeP) {
+  switch (treeP?.kind) {
+    case 'widget':
+    case 'single_view':
+    case 'multi_view':
+    case 'panel':
+    case 'teleport':
+      return 'div';
+    case 'placeholder':
+      return null;
+    case 'text':
+      return null;
+    default:
+      return treeP?.tagName || 'div';
+  }
+};
+func.runtime.render.get_tree_terminal_content = function (treeP) {
+  const attributes = treeP?.attributes || {};
+  if (typeof attributes['xu-html'] !== 'undefined' && attributes['xu-html'] !== null) {
+    return {
+      value: `${attributes['xu-html']}`,
+      mode: 'html',
+    };
+  }
+  if (typeof attributes['xu-content'] !== 'undefined' && attributes['xu-content'] !== null) {
+    return {
+      value: `${attributes['xu-content']}`,
+      mode: 'html',
+    };
+  }
+  if (typeof attributes['xu-text'] !== 'undefined' && attributes['xu-text'] !== null) {
+    return {
+      value: `${attributes['xu-text']}`,
+      mode: 'text',
+    };
+  }
+  if (treeP?.kind === 'text') {
+    return {
+      value: typeof treeP?.text !== 'undefined' && treeP?.text !== null ? `${treeP.text}` : `${treeP?.content || ''}`,
+      mode: 'text',
+    };
+  }
+  return null;
+};
+func.runtime.render.render_tree_terminal_content = function (treeP) {
+  const terminal = func.runtime.render.get_tree_terminal_content(treeP);
+  if (!terminal) {
+    return null;
+  }
+  if (terminal.mode === 'html') {
+    return terminal.value;
+  }
+  return func.runtime.render.escape_html(terminal.value);
+};
+func.runtime.render.get_widget_fallback_markup = function (treeP) {
+  const widget_meta = treeP?.meta?.widget || {};
+  const capability_state = widget_meta?.capabilities?.headless ? 'headless-capable' : 'browser-only';
+  return `<!--xuda-widget:${func.runtime.render.escape_html(widget_meta.plugin_name || 'unknown')}:${capability_state}-->`;
+};
+func.runtime.render.get_tree_string_attributes = function (treeP, renderer_context) {
+  const attributes = func.runtime.render.safe_clone_tree_value(treeP?.attributes || {});
+  const attr_pairs = [];
+  const keys = Object.keys(attributes);
+
+  for (let index = 0; index < keys.length; index++) {
+    const key = keys[index];
+    if (func.runtime.render.is_tree_control_attribute(key)) {
+      continue;
+    }
+    const value = attributes[key];
+    if (value === false || value === null || typeof value === 'undefined') {
+      continue;
+    }
+    if (value === true) {
+      attr_pairs.push(key);
+      continue;
+    }
+    const normalized_value = typeof value === 'object' ? JSON.stringify(value) : `${value}`;
+    attr_pairs.push(`${key}="${func.runtime.render.escape_html_attribute(normalized_value)}"`);
+  }
+
+  attr_pairs.push(`data-xuda-kind="${func.runtime.render.escape_html_attribute(treeP?.kind || 'element')}"`);
+  attr_pairs.push(`data-xuda-node-id="${func.runtime.render.escape_html_attribute(treeP?.id || treeP?.meta?.source_node_id || '')}"`);
+  attr_pairs.push(`data-xuda-tree-id="${func.runtime.render.escape_html_attribute(treeP?.meta?.tree_id || '')}"`);
+
+  if (treeP?.kind === 'widget' && treeP?.meta?.widget) {
+    attr_pairs.push(`data-xuda-widget="${func.runtime.render.escape_html_attribute(treeP.meta.widget.plugin_name || '')}"`);
+    attr_pairs.push(`data-xuda-widget-method="${func.runtime.render.escape_html_attribute(treeP.meta.widget.method || '_default')}"`);
+    attr_pairs.push(`data-xuda-widget-capability="${func.runtime.render.escape_html_attribute(treeP.meta.widget.capabilities?.headless ? 'headless' : 'browser')}"`);
+  }
+
+  if (treeP?.kind === 'teleport' && treeP?.attributes?.['xu-teleport']) {
+    attr_pairs.push(`data-xuda-teleport-target="${func.runtime.render.escape_html_attribute(treeP.attributes['xu-teleport'])}"`);
+  }
+
+  if ((treeP?.meta?.controls?.xu_for !== null && treeP?.meta?.controls?.xu_for !== undefined) && !renderer_context?.strip_iteration_markers) {
+    attr_pairs.push('data-xuda-xu-for="pending"');
+  }
+
+  return attr_pairs.length ? ' ' + attr_pairs.join(' ') : '';
+};
+func.runtime.render.render_tree_children_to_string = async function (treeP, renderer_context) {
+  if (!Array.isArray(treeP?.children) || !treeP.children.length) {
+    return '';
+  }
+  let html = '';
+  for (let index = 0; index < treeP.children.length; index++) {
+    html += await func.runtime.render.render_tree_to_string(treeP.children[index], {
+      ...renderer_context,
+      parent_tree: treeP,
+    });
+  }
+  return html;
+};
+func.runtime.render.render_tree_to_string = async function (treeP, renderer_context = {}) {
+  if (!treeP) {
+    return '';
+  }
+  if (Array.isArray(treeP)) {
+    let html = '';
+    for (let index = 0; index < treeP.length; index++) {
+      html += await func.runtime.render.render_tree_to_string(treeP[index], renderer_context);
+    }
+    return html;
+  }
+
+  const ensured_tree = await func.runtime.render.ensure_tree_node({
+    SESSION_ID: renderer_context?.SESSION_ID,
+    nodeP: treeP,
+    paramsP: renderer_context?.paramsP,
+    parent_infoP: renderer_context?.parent_infoP,
+    keyP: renderer_context?.keyP,
+    parent_nodeP: renderer_context?.parent_nodeP,
+  });
+
+  if (!ensured_tree || !func.runtime.render.should_render_tree_node(ensured_tree)) {
+    return '';
+  }
+
+  if (ensured_tree.kind === 'placeholder') {
+    if (renderer_context?.include_placeholders) {
+      return `<!--xuda-placeholder:${func.runtime.render.escape_html(ensured_tree.id || '')}-->`;
+    }
+    return '';
+  }
+
+  if (ensured_tree.kind === 'text') {
+    return func.runtime.render.render_tree_terminal_content(ensured_tree) || '';
+  }
+
+  const tag_name = func.runtime.render.get_string_renderer_tag_name(ensured_tree);
+  if (!tag_name || tag_name.toLowerCase() === 'script') {
+    return '';
+  }
+
+  const attributes = func.runtime.render.get_tree_string_attributes(ensured_tree, renderer_context);
+  const terminal_content = func.runtime.render.render_tree_terminal_content(ensured_tree);
+  let children_html = terminal_content !== null ? terminal_content : await func.runtime.render.render_tree_children_to_string(ensured_tree, renderer_context);
+
+  if (ensured_tree.kind === 'widget' && !children_html) {
+    children_html = func.runtime.render.get_widget_fallback_markup(ensured_tree);
+  }
+
+  if (func.runtime.render.is_html_void_tag(tag_name)) {
+    return `<${tag_name}${attributes}>`;
+  }
+
+  return `<${tag_name}${attributes}>${children_html}</${tag_name}>`;
+};
+func.runtime.render.render_to_string = async function (options = {}) {
+  const treeP = await func.runtime.render.ensure_tree_node({
+    SESSION_ID: options.SESSION_ID,
+    nodeP: options.treeP || options.nodeP,
+    paramsP: options.paramsP,
+    parent_infoP: options.parent_infoP,
+    keyP: options.keyP,
+    parent_nodeP: options.parent_nodeP,
+  });
+
+  return await func.runtime.render.render_tree_to_string(treeP, options);
+};
+func.runtime.render.get_server_render_mode = function (options = {}) {
+  const normalized = func.runtime.render.normalize_runtime_bootstrap({
+    app_computing_mode: options.app_computing_mode,
+    app_render_mode: options.app_render_mode,
+    app_client_activation: options.app_client_activation,
+  });
+
+  return normalized;
+};
+func.runtime.render.build_server_render_params = async function (options = {}) {
+  const SESSION_ID = options.SESSION_ID;
+  const prog_id = options.prog_id;
+  const dsSessionP = options.dsSessionP;
+  const _session = SESSION_OBJ?.[SESSION_ID] || {};
+  const _ds = _session?.DS_GLB?.[dsSessionP] || {};
+  const viewDoc = options.viewDoc || (await func.utils?.VIEWS_OBJ?.get?.(SESSION_ID, prog_id));
+
+  if (!viewDoc?.properties) {
+    throw new Error(`view document not found for ${prog_id}`);
+  }
+
+  const base_params = _ds?.screen_params ? func.runtime.render.safe_clone_tree_value(_ds.screen_params) : {};
+  const screenId = options.screenId || base_params.screenId || `ssr_${prog_id}_${dsSessionP || '0'}`;
+  const paramsP = {
+    ...base_params,
+    prog_id,
+    sourceScreenP: null,
+    $callingContainerP: null,
+    triggerIdP: null,
+    callingDataSource_objP: _ds,
+    rowIdP: typeof options.rowIdP !== 'undefined' ? options.rowIdP : (_ds?.currentRecordId || null),
+    renderType: viewDoc.properties?.renderType,
+    parameters_obj_inP: options.parameters_obj_inP || base_params.parameters_obj_inP || options.parameters_raw_obj || {},
+    source_functionP: options.source_functionP || base_params.source_functionP || 'render_string',
+    is_panelP: false,
+    screen_type: options.screen_type || base_params.screen_type || 'render_string',
+    screenInfo: viewDoc,
+    call_screen_propertiesP: base_params.call_screen_propertiesP,
+    parentDataSourceNoP: typeof _ds?.parentDataSourceNo === 'undefined' || _ds?.parentDataSourceNo === null ? 0 : _ds.parentDataSourceNo,
+    parameters_raw_obj: options.parameters_raw_obj || base_params.parameters_raw_obj || {},
+    dsSessionP,
+    screenId,
+    containerIdP: base_params.containerIdP || `ssr_container_${screenId}`,
+  };
+
+  if (_ds) {
+    _ds.screen_params = paramsP;
+  }
+
+  return paramsP;
+};
+func.runtime.render.build_prog_tree = async function (options = {}) {
+  const SESSION_ID = options.SESSION_ID;
+  const prog_id = options.prog_id;
+  const viewDoc = options.viewDoc || (await func.utils?.VIEWS_OBJ?.get?.(SESSION_ID, prog_id));
+
+  if (!viewDoc?.progUi?.length) {
+    throw new Error(`progUi not found for ${prog_id}`);
+  }
+
+  const paramsP = options.paramsP || (await func.runtime.render.build_server_render_params({
+    ...options,
+    SESSION_ID,
+    prog_id,
+    viewDoc,
+  }));
+  const root_index = typeof options.root_index === 'number' ? options.root_index : 0;
+  const root_node = func.runtime.render.safe_clone_tree_value(viewDoc.progUi[root_index]);
+  const tree = await func.runtime.render.build_tree({
+    SESSION_ID,
+    nodeP: root_node,
+    paramsP,
+  });
+
+  return {
+    tree,
+    paramsP,
+    viewDoc,
+  };
+};
+func.runtime.render.build_ssr_payload = function (render_program, options = {}) {
+  const runtime_profile = func.runtime.render.get_server_render_mode(options);
+  return {
+    contract: 'xuda.ssr.v1',
+    prog_id: options.prog_id,
+    screenId: render_program.paramsP.screenId,
+    containerId: render_program.paramsP.containerIdP,
+    app_computing_mode: runtime_profile.app_computing_mode,
+    app_render_mode: runtime_profile.app_render_mode,
+    app_client_activation: runtime_profile.app_client_activation,
+    tree_contract: func.runtime.render.TREE_CONTRACT_VERSION,
+  };
+};
+func.runtime.render.build_ssr_screen_html = function (html, render_program, options = {}) {
+  const payload = func.runtime.render.build_ssr_payload(render_program, options);
+  const screenId = func.runtime.render.escape_html_attribute(payload.screenId || '');
+  const containerId = func.runtime.render.escape_html_attribute(payload.containerId || '');
+  const activation = func.runtime.render.escape_html_attribute(payload.app_client_activation || 'takeover');
+
+  return `<div data-xuda-ssr-embed="true" class="xu_embed_div"><div id="${screenId}" class="xu_embed_container" data-xuda-ssr-screen="true" data-xuda-ssr-screen-id="${screenId}" data-xuda-activation="${activation}" style="display: contents;"><div id="${containerId}" data-xuda-ssr-root-frame="true" data-xuda-ssr-screen-id="${screenId}" data-xuda-activation="${activation}" style="display: contents;">${html}</div></div></div>`;
+};
+func.runtime.render.render_prog_to_string = async function (options = {}) {
+  const render_program = await func.runtime.render.build_prog_tree(options);
+  const html = await func.runtime.render.render_to_string({
+    ...options,
+    SESSION_ID: options.SESSION_ID,
+    treeP: render_program.tree,
+    paramsP: render_program.paramsP,
+  });
+  const ssr_payload = func.runtime.render.build_ssr_payload(render_program, options);
+  const screen_html = func.runtime.render.build_ssr_screen_html(html, render_program, options);
 
-func.common.fastHash = function (inputString) {
-  let hash = 0x811c9dc5; // FNV offset basis
+  return {
+    prog_id: options.prog_id,
+    dsSessionP: render_program.paramsP.dsSessionP,
+    screenId: render_program.paramsP.screenId,
+    html,
+    screen_html,
+    tree_json: func.runtime.render.serialize_tree(render_program.tree),
+    paramsP: render_program.paramsP,
+    ssr_payload,
+  };
+};
+ func.runtime = func.runtime || {};
+func.runtime.platform = func.runtime.platform || {};
 
-  for (let i = 0; i < inputString.length; i++) {
-    hash ^= inputString.charCodeAt(i);
-    // FNV prime multiplication with 32-bit overflow
-    hash += (hash << 1) + (hash << 4) + (hash << 7) + (hash << 8) + (hash << 24);
+func.runtime.platform.dispatch_document_event = function (name, data) {
+  if (typeof document === 'undefined' || typeof CustomEvent === 'undefined') {
+    return false;
   }
-
-  // Convert to base36 and pad to 10 characters
-  return ((hash >>> 0).toString(36) + '0000000000').slice(0, 10);
+  document.dispatchEvent(new CustomEvent(name, {
+    detail: Array.isArray(data) ? data : [data],
+  }));
+  return true;
 };
-
-glb.new_xu_render = false;
  glb.DEBUG_INFO_OBJ = {};
 // var CONNECTION_ATTEMPTS = 0;
 glb.APP_INFO = {};
@@ -9190,6 +10125,15 @@ func.runtime.ui.ensure_embed_container = function (SESSION_ID) {
   const $root_element = func.runtime.ui.get_root_element(SESSION_ID);
   let $embed_container = func.runtime.ui.find_by_selector($root_element, `#embed_${SESSION_ID}`, true);
 
+  if (!$embed_container.length) {
+    const $ssr_embed_container = func.runtime.ui.find_by_selector($root_element, `[data-xuda-ssr-embed="true"]`, true);
+    const ssr_embed_node = func.runtime.ui.get_first_node($ssr_embed_container);
+    if (ssr_embed_node) {
+      ssr_embed_node.id = 'embed_' + SESSION_ID;
+      $embed_container = func.runtime.ui._wrap_matches([ssr_embed_node]);
+    }
+  }
+
   if (!$embed_container.length) {
     const embed_node = document.createElement('div');
     embed_node.id = 'embed_' + SESSION_ID;
@@ -9225,12 +10169,44 @@ func.runtime.ui.get_root_tag_name = function () {
   }
   return root_tag_name;
 };
+func.runtime.ui.find_ssr_screen_host = function ($container, screenId, containerId) {
+  const container_node = func.runtime.ui.get_first_node($container);
+  if (!container_node || !screenId) {
+    return null;
+  }
+
+  const dialog_node =
+    container_node.querySelector?.(`#${CSS?.escape ? CSS.escape(screenId) : screenId}`) ||
+    container_node.querySelector?.(`[data-xuda-ssr-screen-id="${screenId}"]`);
+  if (!dialog_node) {
+    return null;
+  }
+
+  const root_frame_node =
+    (containerId ? dialog_node.querySelector?.(`#${CSS?.escape ? CSS.escape(containerId) : containerId}`) : null) ||
+    dialog_node.querySelector?.('[data-xuda-ssr-root-frame="true"]');
+  if (!root_frame_node) {
+    return null;
+  }
+
+  return {
+    $dialogDiv: func.runtime.ui._wrap_matches([dialog_node]),
+    $rootFrame: func.runtime.ui._wrap_matches([root_frame_node]),
+    reused_ssr_host: true,
+  };
+};
 func.runtime.ui.create_screen_host = function (SESSION_ID, screen_type, params, $callingContainerP, screenId) {
   var $dialogDiv;
   var $rootFrame;
+  let reused_ssr_host = false;
 
   switch (screen_type) {
     case 'embed': {
+      const ssr_host = func.runtime.ui.find_ssr_screen_host($callingContainerP, screenId, params?.containerIdP);
+      if (ssr_host) {
+        return ssr_host;
+      }
+
       const dialogNode = document.createElement('div');
       dialogNode.id = screenId;
       dialogNode.setAttribute('ui_engine', UI_FRAMEWORK_INSTALLED);
@@ -9280,6 +10256,7 @@ func.runtime.ui.create_screen_host = function (SESSION_ID, screen_type, params,
   return {
     $dialogDiv,
     $rootFrame,
+    reused_ssr_host,
   };
 };
 func.runtime.ui.find_xu_ui_in_root = function (SESSION_ID, xu_ui_id) {
@@ -9313,7 +10290,7 @@ func.runtime.ui.find_element_data_in_root = function (SESSION_ID, dataKey, prope
     }
     return func.runtime.ui.find_in_root(SESSION_ID, '[xu-panel-wrapper-id]');
   }
-  return func.UI.utils.find_in_element_data(dataKey, func.runtime.ui.as_jquery(func.runtime.ui.get_root_element(SESSION_ID)), property, value);
+  return func.UI.utils.find_in_element_data(dataKey, func.runtime.ui.get_root_element(SESSION_ID), property, value);
 };
 func.runtime.ui.find_element_data_in_parent = function ($container, dataKey, property, value) {
   const container_node = func.runtime.ui.get_first_node($container);
@@ -9327,7 +10304,7 @@ func.runtime.ui.find_element_data_in_parent = function ($container, dataKey, pro
     }
     return func.runtime.ui.find_by_selector(parent_node, `[xu-ui-id="${value}"]`);
   }
-  return func.UI.utils.find_in_element_data(dataKey, func.runtime.ui.as_jquery(parent_node), property, value);
+  return func.UI.utils.find_in_element_data(dataKey, func.runtime.ui._wrap_matches([parent_node]), property, value);
 };
 func.runtime.ui.sync_child_parent_container = function ($div) {
   const div_node = func.runtime.ui.get_first_node($div);
@@ -9434,40 +10411,14 @@ func.runtime.ui.clear_screen_blockers = function () {
   }
 };
 
-// @deprecated — no-op shim now that jQuery is removed from the bundle.
 func.runtime.ui.as_jquery = function (target) {
-  if (target?.jquery) {
-    return target;
-  }
   const node = func.runtime.ui.get_first_node(target);
-  // Return a minimal jQuery-like wrapper so legacy callers don't crash.
-  const _node_data = {};
-  const _arr = node ? [node] : [];
-  return {
-    0: node,
-    length: _arr.length,
-    toArray: function () { return _arr.slice(); },
-    data: function (key, value) {
-      if (typeof key === 'undefined') return _node_data;
-      if (typeof value !== 'undefined') { _node_data[key] = value; return this; }
-      return _node_data[key];
-    },
-    attr: function (key, value) {
-      if (!node) return undefined;
-      if (typeof value !== 'undefined') { node.setAttribute(key, value); return this; }
-      return node?.getAttribute?.(key);
-    },
-    removeData: function () { for (const k in _node_data) delete _node_data[k]; return this; },
-    children: function () { return { toArray: function () { return node ? Array.from(node.children) : []; } }; },
-  };
+  return func.runtime.ui._wrap_matches(node ? [node] : []);
 };
 func.runtime.ui.get_first_node = function (target) {
   if (!target) {
     return null;
   }
-  if (target?.jquery) {
-    return target[0] || null;
-  }
   if (target?.nodeType) {
     return target;
   }
@@ -9485,9 +10436,10 @@ func.runtime.ui.get_data = function (target) {
       if (meta) return meta;
     }
   }
-  // fallback: store per-element data on the node itself
   if (target_node) {
-    if (!target_node.__xuData) target_node.__xuData = {};
+    if (!target_node.__xuData) {
+      target_node.__xuData = {};
+    }
     return target_node.__xuData;
   }
   return {};
@@ -9869,6 +10821,11 @@ func.runtime.ui.build_container_xu_data = function (options) {
 func.runtime.ui.apply_container_meta = function ($div, options) {
   const div_node = func.runtime.ui.get_first_node($div);
   func.runtime.ui.set_attr(div_node, 'xu-ui-id', options.ui_id);
+  func.runtime.ui.set_attr(div_node, 'data-xuda-kind', options.treeP?.kind || options.nodeP?.tagName || 'element');
+  func.runtime.ui.set_attr(div_node, 'data-xuda-node-id', options.nodeP?.id || options.nodeP?.id_org || '');
+  if (options.treeP?.meta?.tree_id !== null && typeof options.treeP?.meta?.tree_id !== 'undefined') {
+    func.runtime.ui.set_attr(div_node, 'data-xuda-tree-id', options.treeP.meta.tree_id);
+  }
   const xuData = func.runtime.ui.build_container_xu_data(options);
   if (options.parent_infoP?.iterate_info) {
     xuData.iterate_info = options.parent_infoP.iterate_info;
@@ -9963,6 +10920,38 @@ func.runtime.ui.create_container_element = function (div_typeP, attr_str, prop,
   }
   return func.runtime.ui.create_element(div, attr_str);
 };
+func.runtime.ui.find_hydration_candidate = function (options) {
+  if (!func.runtime.render.is_hydration_mode(SESSION_OBJ?.[options.SESSION_ID])) {
+    return null;
+  }
+  if (!func.runtime.render.should_use_ssr_payload(options.SESSION_ID, options.paramsP)) {
+    return null;
+  }
+  if (options.is_placeholder || !options.treeP?.meta?.tree_id) {
+    return null;
+  }
+
+  const append_node = func.runtime.ui.get_first_node(options.$appendTo || options.$container);
+  if (!append_node) {
+    return null;
+  }
+
+  const children = func.runtime.ui.get_children(append_node);
+  for (let index = 0; index < children.length; index++) {
+    const child = children[index];
+    if (child?.__xuda_hydration_claimed) {
+      continue;
+    }
+    if (func.runtime.ui.get_attr(child, 'data-xuda-tree-id') !== `${options.treeP.meta.tree_id}`) {
+      continue;
+    }
+    child.__xuda_hydration_claimed = true;
+    func.runtime.ui.set_attr(child, 'data-xuda-client-activation', 'hydrate');
+    return child;
+  }
+
+  return null;
+};
 func.runtime.ui.build_xu_ui_id_seed = function (nodeP, dsSessionP, key_path, currentRecordId) {
   const nodeId = nodeP.xu_tree_id || nodeP.id;
   const elem_key = `${nodeId}-${key_path}-${currentRecordId}`;
@@ -10015,7 +11004,11 @@ func.runtime.ui.create_container = async function (options) {
   try {
     const key_path = func.runtime.ui.build_container_key_path(container_xu_data, options.keyP, options.parent_infoP, options.nodeP, options.parent_nodeP);
     const elem_key = `${options.nodeP.xu_tree_id || options.nodeP.id}-${key_path}-${currentRecordId}`;
-    const $div = func.runtime.ui.create_container_element(options.div_typeP, options.attr_str, options.prop, options.nodeP, $appendTo);
+    const hydration_candidate = func.runtime.ui.find_hydration_candidate({
+      ...options,
+      $appendTo,
+    });
+    const $div = hydration_candidate || func.runtime.ui.create_container_element(options.div_typeP, options.attr_str, options.prop, options.nodeP, $appendTo);
     const new_ui_id = await func.runtime.ui.generate_xu_ui_id(options.SESSION_ID, options.nodeP, options.$container, options.paramsP, options.keyP, {
       container_xu_data,
       currentRecordId,
@@ -10041,9 +11034,10 @@ func.runtime.ui.create_container = async function (options) {
       parent_infoP: options.parent_infoP,
       is_placeholder: options.is_placeholder,
       classP: options.classP,
+      treeP: options.treeP,
     });
 
-    if (options.div_typeP !== 'svg') {
+    if (!hydration_candidate && options.div_typeP !== 'svg') {
       func.runtime.ui.append_to($div, $appendTo);
     }
     return $div;
@@ -12724,9 +13718,10 @@ func.runtime.ui.init_screen = async function (options) {
 
   const _session = SESSION_OBJ[SESSION_ID];
   const screenInfo = structuredClone(screen_ret);
+  const ssr_payload = func.runtime.render.should_use_ssr_payload(SESSION_ID, { prog_id }) ? func.runtime.render.get_ssr_payload(_session) : null;
 
   const screen_type = source_functionP?.split('_')?.[1];
-  const screenId = (glb.screen_num++).toString();
+  const screenId = ssr_payload?.screenId || (glb.screen_num++).toString();
 
   if (SCREEN_BLOCKER_OBJ[prog_id + (sourceScreenP ? '_' + sourceScreenP : '')]) {
     const wait_for_SCREEN_BLOCKER_release = function () {
@@ -12768,6 +13763,8 @@ func.runtime.ui.init_screen = async function (options) {
     call_screen_propertiesP,
     parentDataSourceNoP: _session.DS_GLB?.[callingDataSource_objP?.dsSession]?.dsSession || callingDataSource_objP?.parentDataSourceNo || 0,
     parameters_raw_obj,
+    containerIdP: ssr_payload?.containerId || null,
+    ssr_payload,
   };
 
   const screen_host = func.runtime.ui.create_screen_host(SESSION_ID, screen_type, params, $callingContainerP, screenId);
@@ -12800,6 +13797,10 @@ func.runtime.ui.init_screen = async function (options) {
     func.runtime.ui.set_style($rootFrame, 'display', 'contents');
   }
 
+  if (screen_host.reused_ssr_host && func.runtime.render.is_takeover_mode(_session)) {
+    func.runtime.ui.empty($rootFrame);
+  }
+
   if (!is_panelP) func.UI.utils.indicator.screen.busy();
 
   const ret = await func.datasource.create(
@@ -12841,7 +13842,24 @@ func.runtime.ui.init_screen = async function (options) {
   }
   let node = structuredClone(viewDoc.progUi);
   if (!node.length) return console.warn('ui node empty');
-  const ret_render_$container = await func.runtime.render.render_ui_tree(SESSION_ID, $rootFrame, node[0], null, params, jobNoP, null, null, null, null, null, $rootFrame);
+  const root_tree = await func.runtime.render.build_tree({
+    SESSION_ID,
+    nodeP: node[0],
+    paramsP: params,
+  });
+  const ret_render_$container = await func.runtime.render.render_tree(root_tree, {
+    SESSION_ID,
+    $container: $rootFrame,
+    parent_infoP: null,
+    paramsP: params,
+    jobNoP,
+    is_skeleton: null,
+    keyP: null,
+    refreshed_ds: null,
+    parent_nodeP: null,
+    check_existP: null,
+    $root_container: $rootFrame,
+  });
 
   if (!is_panelP) func.UI.utils.indicator.screen.normal();
 
@@ -12925,7 +13943,7 @@ func.runtime.ui.ensure_nav = function (SESSION_ID, $container) {
   }
   var nav_el = document.createElement('xu-nav');
   func.runtime.ui.append($container, nav_el);
-  var $nav = func.runtime.ui.as_jquery(nav_el);
+  var $nav = func.runtime.ui._wrap_matches([nav_el]);
   func.UI.component.init_xu_nav($container, $nav);
   return $nav;
 };
@@ -13266,6 +14284,7 @@ func.runtime.ui.render_single_view_node = async function (options) {
       parent_infoP: options.parent_infoP,
       jobNoP: options.jobNoP,
       keyP: options.keyP,
+      treeP: options.treeP,
       parent_nodeP: options.parent_nodeP,
       prop: options.prop,
       div_typeP: 'div',
@@ -13394,6 +14413,7 @@ func.runtime.ui.render_panel_node = async function (options) {
     parent_infoP: options.parent_infoP,
     jobNoP: options.jobNoP,
     keyP: options.keyP,
+    treeP: options.treeP,
     parent_nodeP: options.parent_nodeP,
     prop: options.prop,
     $appendToP: $wrapper,
@@ -13723,6 +14743,14 @@ func.runtime.ui.screen_loading_done = async function (options) {
     });
 
     const _session = SESSION_OBJ[options.SESSION_ID];
+    if (func.runtime.render.should_use_ssr_payload(options.SESSION_ID, options.paramsP)) {
+      const root_node = func.runtime.ui.get_root_node(options.SESSION_ID);
+      if (root_node) {
+        func.runtime.ui.set_attr(root_node, 'data-xuda-client-activation', _session.opt.app_client_activation || 'none');
+        func.runtime.ui.set_attr(root_node, 'data-xuda-ssr-status', _session.opt.app_client_activation === 'hydrate' ? 'hydrated' : 'taken-over');
+      }
+      func.runtime.render.mark_ssr_payload_consumed(options.SESSION_ID);
+    }
     func.events.delete_job(options.SESSION_ID, options.jobNoP);
     func.UI.utils.screen_blocker(false, options.paramsP.prog_id + (options.paramsP.sourceScreenP ? '_' + options.paramsP.sourceScreenP : ''));
     if (_session.prog_id === options.paramsP.prog_id) {
@@ -13755,7 +14783,7 @@ func.runtime.ui._to_node_array = func.runtime.ui._to_node_array || function (inp
   if (!input) {
     return [];
   }
-  if (input.jquery) {
+  if (typeof input?.toArray === 'function' && typeof input?.length === 'number' && !input?.nodeType) {
     return input.toArray();
   }
   if (Array.isArray(input)) {
@@ -15565,6 +16593,9 @@ func.runtime.render.get_screen_context = function (SESSION_ID, $container, param
 };
 func.runtime.render.get_node_attributes = function (nodeP) {
   try {
+    if (func.runtime.render.is_tree_node?.(nodeP)) {
+      return nodeP.attributes;
+    }
     return nodeP?.attributes;
   } catch (error) {
     return undefined;
@@ -15682,6 +16713,7 @@ func.runtime.render.prepare_draw_context = async function (options) {
       parent_infoP: options.parent_infoP,
       jobNoP: options.jobNoP,
       keyP: options.keyP,
+      treeP: options.treeP,
       parent_nodeP: options.parent_nodeP,
       prop: options.prop,
       div_typeP: options.element,
@@ -15704,6 +16736,7 @@ func.runtime.render.prepare_draw_context = async function (options) {
       parent_infoP: options.parent_infoP,
       jobNoP: options.jobNoP,
       keyP: options.keyP,
+      treeP: options.treeP,
       parent_nodeP: options.parent_nodeP,
       prop: options.prop,
       div_typeP: options.element,
@@ -16560,18 +17593,28 @@ func.runtime.widgets.render_node = async function (options) {
       parent_infoP: options.parent_infoP,
       jobNoP: options.jobNoP,
       keyP: options.keyP,
+      treeP: options.treeP,
       parent_nodeP: options.parent_nodeP,
       prop: options.prop,
       classP: 'widget_wrapper',
     });
 
+    if (func.runtime.render.is_hydration_mode(SESSION_OBJ?.[options.SESSION_ID]) && func.runtime.render.should_use_ssr_payload(options.SESSION_ID, options.paramsP)) {
+      func.runtime.ui.empty($div);
+    }
+
     const widget_context = func.runtime.widgets.create_context(options.SESSION_ID, options.paramsP, options.prop);
     const { plugin_name, method, propsP, plugin: _plugin } = widget_context;
     const report_error = function (descP, warn) {
       return func.runtime.widgets.report_error(widget_context, descP, warn);
     };
 
-    const methods = await func.runtime.widgets.get_methods(widget_context);
+    const definition = await func.runtime.widgets.get_definition(widget_context);
+    if (!func.runtime.widgets.supports_current_environment(definition)) {
+      return report_error(`plugin ${plugin_name} is not available in the current environment`, true);
+    }
+
+    const methods = definition?.methods || {};
     if (methods && !methods[method]) {
       return report_error('method not found');
     }
@@ -16632,7 +17675,13 @@ func.runtime.widgets.render_node = async function (options) {
       job_id: options.jobNoP,
     });
 
-    const params = func.runtime.widgets.build_params(widget_context, $div, plugin_setup_ret.data, api_utils);
+    const params = func.runtime.widgets.build_params(
+      widget_context,
+      func.runtime.ui.get_first_node($div),
+      func.runtime.ui.get_data($div),
+      plugin_setup_ret.data,
+      api_utils,
+    );
     const fx = await func.runtime.widgets.get_resource(widget_context, 'runtime.mjs');
 
     await func.runtime.widgets.load_runtime_css(widget_context);
@@ -16656,9 +17705,306 @@ func.runtime.widgets = func.runtime.widgets || {};
 
 // Browser-only special node renderers live here so the core render tree can stay focused.
 
+const normalize_runtime_tag_name = function (tag_name) {
+  return `${tag_name || ''}`.trim().toLowerCase();
+};
+
+const get_runtime_node_attributes = function (nodeP) {
+  if (!nodeP?.attributes || typeof nodeP.attributes !== 'object') {
+    return {};
+  }
+
+  return nodeP.attributes;
+};
+
+const get_runtime_node_content = function (nodeP) {
+  if (typeof nodeP?.content === 'string') {
+    return nodeP.content;
+  }
+
+  if (typeof nodeP?.text === 'string') {
+    return nodeP.text;
+  }
+
+  if (!Array.isArray(nodeP?.children)) {
+    return '';
+  }
+
+  return nodeP.children
+    .map(function (child) {
+      if (typeof child === 'string') {
+        return child;
+      }
+      if (typeof child?.content === 'string') {
+        return child.content;
+      }
+      if (typeof child?.text === 'string') {
+        return child.text;
+      }
+      return '';
+    })
+    .join('');
+};
+
+const get_runtime_asset_key = function (options, tag_name) {
+  const source_node = options.treeP || options.nodeP || {};
+  const parts = [
+    'xuda-html-asset',
+    options.paramsP?.prog_id || '',
+    tag_name,
+    source_node.id || source_node.id_org || '',
+    typeof options.keyP === 'undefined' || options.keyP === null ? '' : `${options.keyP}`,
+  ].filter(function (part) {
+    return `${part || ''}`.trim() !== '';
+  });
+
+  return parts.join(':');
+};
+
+const get_runtime_asset_signature = function (attributes, content) {
+  const normalized_attributes = {};
+  const attr_keys = Object.keys(attributes || {}).sort();
+
+  for (let index = 0; index < attr_keys.length; index++) {
+    const key = attr_keys[index];
+    normalized_attributes[key] = attributes[key];
+  }
+
+  return JSON.stringify({
+    attributes: normalized_attributes,
+    content: `${content || ''}`,
+  });
+};
+
+const escape_runtime_asset_selector_value = function (value) {
+  const win = func.runtime.platform.get_window?.();
+  if (win?.CSS?.escape) {
+    return win.CSS.escape(value);
+  }
+
+  return `${value || ''}`.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+};
+
+const find_runtime_head_asset = function (head, tag_name, asset_key) {
+  if (!head?.querySelector || !asset_key) {
+    return null;
+  }
+
+  return head.querySelector(`${tag_name}[data-xuda-asset-key="${escape_runtime_asset_selector_value(asset_key)}"]`);
+};
+
+const find_runtime_head_asset_by_attr = function (head, tag_name, attr_name, attr_value) {
+  if (!head?.querySelectorAll || !attr_name || !attr_value) {
+    return null;
+  }
+
+  const candidates = Array.from(head.querySelectorAll(tag_name));
+  return (
+    candidates.find(function (candidate) {
+      return candidate.getAttribute(attr_name) === attr_value || candidate[attr_name] === attr_value;
+    }) || null
+  );
+};
+
+const wait_for_runtime_asset_load = function (node) {
+  if (!node?.addEventListener) {
+    return Promise.resolve(node);
+  }
+
+  if (node.getAttribute?.('data-xuda-loaded') === 'true') {
+    return Promise.resolve(node);
+  }
+
+  if (!node.getAttribute?.('data-xuda-asset-key')) {
+    return Promise.resolve(node);
+  }
+
+  const tag_name = normalize_runtime_tag_name(node.tagName);
+  if (tag_name !== 'script' && !(tag_name === 'link' && normalize_runtime_tag_name(node.getAttribute?.('rel')) === 'stylesheet')) {
+    return Promise.resolve(node);
+  }
+
+  return new Promise(function (resolve) {
+    const done = function () {
+      node.setAttribute?.('data-xuda-loaded', 'true');
+      resolve(node);
+    };
+
+    node.addEventListener('load', done, { once: true });
+    node.addEventListener('error', done, { once: true });
+  });
+};
+
+const remove_runtime_head_asset = function (node) {
+  if (node?.parentNode?.removeChild) {
+    node.parentNode.removeChild(node);
+  }
+};
+
+const apply_runtime_asset_metadata = function (node, asset_key, signature) {
+  if (!node?.setAttribute) {
+    return node;
+  }
+
+  if (asset_key) {
+    node.setAttribute('data-xuda-asset-key', asset_key);
+  }
+  node.setAttribute('data-xuda-asset-signature', signature);
+  return node;
+};
+
+const create_runtime_head_element = function (doc, tag_name, attributes, asset_key, signature) {
+  const node = doc.createElement(tag_name);
+  apply_runtime_asset_metadata(node, asset_key, signature);
+  func.runtime.platform.apply_element_attributes(node, attributes);
+  return node;
+};
+
+const upsert_runtime_head_element = async function (options) {
+  const doc = func.runtime.platform.get_document?.();
+  const head = doc?.head;
+  const tag_name = normalize_runtime_tag_name(options.tag_name);
+
+  if (!doc?.createElement || !head?.appendChild || !tag_name) {
+    return null;
+  }
+
+  const asset_key = options.asset_key || '';
+  const signature = options.signature || '';
+  const attributes = options.attributes || {};
+  const content = typeof options.content === 'string' ? options.content : '';
+
+  const existing_by_key = find_runtime_head_asset(head, tag_name, asset_key);
+  if (existing_by_key && existing_by_key.getAttribute('data-xuda-asset-signature') === signature) {
+    return options.await_load ? await wait_for_runtime_asset_load(existing_by_key) : existing_by_key;
+  }
+
+  if (existing_by_key) {
+    remove_runtime_head_asset(existing_by_key);
+  }
+
+  if (options.find_existing_attr?.name && options.find_existing_attr?.value) {
+    const existing_by_attr = find_runtime_head_asset_by_attr(head, tag_name, options.find_existing_attr.name, options.find_existing_attr.value);
+    if (existing_by_attr) {
+      apply_runtime_asset_metadata(existing_by_attr, asset_key, signature);
+      existing_by_attr.setAttribute?.('data-xuda-loaded', 'true');
+      return existing_by_attr;
+    }
+  }
+
+  const node = create_runtime_head_element(doc, tag_name, attributes, asset_key, signature);
+
+  if (tag_name === 'script' && attributes.src && !Object.prototype.hasOwnProperty.call(attributes, 'async')) {
+    const script_type = normalize_runtime_tag_name(attributes.type);
+    if (script_type !== 'module') {
+      node.async = false;
+    }
+  }
+
+  if (tag_name === 'style' || (tag_name === 'script' && !attributes.src)) {
+    node.textContent = content;
+  }
+
+  head.appendChild(node);
+
+  if (tag_name !== 'script' && tag_name !== 'link') {
+    node.setAttribute('data-xuda-loaded', 'true');
+  }
+
+  return options.await_load ? await wait_for_runtime_asset_load(node) : node;
+};
+
+const render_runtime_html_asset = async function (options) {
+  if (options.is_skeleton) {
+    return options.$container;
+  }
+
+  const nodeP = options.treeP || options.nodeP || {};
+  const tag_name = normalize_runtime_tag_name(nodeP.tagName);
+  const attributes = { ...get_runtime_node_attributes(nodeP) };
+  const content = get_runtime_node_content(nodeP);
+  const asset_key = get_runtime_asset_key(options, tag_name);
+  const signature = get_runtime_asset_signature(attributes, content);
+
+  switch (tag_name) {
+    case 'title':
+      func.runtime.platform.set_title(content);
+      return options.$container;
+    case 'style':
+      await upsert_runtime_head_element({
+        tag_name,
+        attributes,
+        content,
+        asset_key,
+        signature,
+      });
+      return options.$container;
+    case 'meta':
+      if (!Object.keys(attributes).length) {
+        return options.$container;
+      }
+      await upsert_runtime_head_element({
+        tag_name,
+        attributes,
+        asset_key,
+        signature,
+      });
+      return options.$container;
+    case 'link': {
+      const href = `${attributes.href || ''}`.trim();
+      if (!href) {
+        return options.$container;
+      }
+      await upsert_runtime_head_element({
+        tag_name,
+        attributes,
+        asset_key,
+        signature,
+        find_existing_attr: {
+          name: 'href',
+          value: href,
+        },
+        await_load: normalize_runtime_tag_name(attributes.rel) === 'stylesheet',
+      });
+      return options.$container;
+    }
+    case 'script': {
+      const src = `${attributes.src || ''}`.trim();
+      if (!src && !content.trim()) {
+        return options.$container;
+      }
+      await upsert_runtime_head_element({
+        tag_name,
+        attributes,
+        content,
+        asset_key,
+        signature,
+        find_existing_attr: src
+          ? {
+              name: 'src',
+              value: src,
+            }
+          : null,
+        await_load: !!src,
+      });
+      return options.$container;
+    }
+    default:
+      return null;
+  }
+};
+
 func.runtime.render.render_special_node = async function (options) {
-  if (options.nodeP.content && options.nodeP.attributes) {
-    options.nodeP.attributes['xu-content'] = options.nodeP.content;
+  const treeP = options.treeP || null;
+  const nodeP = options.nodeP || func.runtime.render.get_tree_source_node(treeP);
+  const render_tag_name = treeP?.tagName || nodeP?.tagName;
+  const normalized_render_tag_name = normalize_runtime_tag_name(render_tag_name);
+  const is_native_html_asset = ['title', 'style', 'meta', 'link', 'script'].includes(normalized_render_tag_name);
+
+  if (!is_native_html_asset && treeP?.content && nodeP?.attributes) {
+    nodeP.attributes['xu-content'] = treeP.content;
+  } else if (!is_native_html_asset && nodeP?.content && nodeP.attributes) {
+    nodeP.attributes['xu-content'] = nodeP.content;
   }
 
   const renderers = {
@@ -16668,6 +18014,7 @@ func.runtime.render.render_special_node = async function (options) {
         SESSION_ID: options.SESSION_ID,
         $container: options.$container,
         $root_container: options.$root_container,
+        treeP,
         nodeP: options.nodeP,
         parent_infoP: options.parent_infoP,
         paramsP: options.paramsP,
@@ -16684,6 +18031,7 @@ func.runtime.render.render_special_node = async function (options) {
         SESSION_ID: options.SESSION_ID,
         $container: options.$container,
         $root_container: options.$root_container,
+        treeP,
         nodeP: options.nodeP,
         parent_infoP: options.parent_infoP,
         paramsP: options.paramsP,
@@ -16703,6 +18051,7 @@ func.runtime.render.render_special_node = async function (options) {
         SESSION_ID: options.SESSION_ID,
         $container: options.$container,
         $root_container: options.$root_container,
+        treeP,
         nodeP: options.nodeP,
         parent_infoP: options.parent_infoP,
         paramsP: options.paramsP,
@@ -16719,6 +18068,7 @@ func.runtime.render.render_special_node = async function (options) {
         SESSION_ID: options.SESSION_ID,
         $container: options.$container,
         $root_container: options.$root_container,
+        treeP,
         nodeP: options.nodeP,
         parent_infoP: options.parent_infoP,
         paramsP: options.paramsP,
@@ -16730,9 +18080,24 @@ func.runtime.render.render_special_node = async function (options) {
         refreshed_ds: options.refreshed_ds,
       });
     },
+    title: async function () {
+      return await render_runtime_html_asset(options);
+    },
+    style: async function () {
+      return await render_runtime_html_asset(options);
+    },
+    meta: async function () {
+      return await render_runtime_html_asset(options);
+    },
+    link: async function () {
+      return await render_runtime_html_asset(options);
+    },
+    script: async function () {
+      return await render_runtime_html_asset(options);
+    },
   };
 
-  const renderer = renderers[options.nodeP.tagName];
+  const renderer = renderers[normalized_render_tag_name];
   if (!renderer) {
     return { handled: false };
   }
@@ -16846,8 +18211,9 @@ func.runtime.widgets = func.runtime.widgets || {};
 // Browser-only render tree entrypoints live here so draw/cache helpers can stay focused.
 
 func.runtime.render.create_tree_runtime = function (options) {
+  const render_node = options.nodeP || func.runtime.render.get_tree_source_node(options.treeP);
   const render_context = func.runtime.render.get_screen_context(options.SESSION_ID, options.$container, options.paramsP, options.is_skeleton);
-  const prop = func.runtime.render.get_node_attributes(options.nodeP);
+  const prop = func.runtime.render.get_node_attributes(options.treeP || render_node);
   const is_mobile = render_context.is_mobile ? true : false;
   const hover_handlers = func.runtime.render.create_hover_handlers({
     SESSION_ID: options.SESSION_ID,
@@ -16862,13 +18228,22 @@ func.runtime.render.create_tree_runtime = function (options) {
     return await func.runtime.ui.close_modal_session(options.SESSION_ID, modal_id);
   };
   const iterate_child = async function ($divP, nodeP, parent_infoP, $root_container, before_record_function) {
+    const child_tree = await func.runtime.render.ensure_tree_node({
+      SESSION_ID: options.SESSION_ID,
+      nodeP: nodeP || options.treeP || render_node,
+      parent_infoP,
+      paramsP: options.paramsP,
+      keyP: options.keyP,
+      parent_nodeP: render_node,
+      pathP: options.treeP?.meta?.path || [],
+    });
     return await func.runtime.render.iterate_children({
       $divP,
-      nodeP,
+      nodeP: child_tree,
       is_mobile,
       before_record_function,
       render_child: async function (key, child) {
-        await options.render_child($divP, child, parent_infoP, key, nodeP, $root_container);
+        await options.render_child($divP, child, parent_infoP, key, render_node, $root_container);
       },
     });
   };
@@ -16898,7 +18273,7 @@ func.runtime.render.draw_node = async function (options) {
     check_existP: options.check_existP,
     $root_container: options.$root_container,
     prop: options.prop,
-    element: options.nodeP.tagName,
+    element: options.treeP?.tagName || options.nodeP.tagName,
     hover_handlers: options.hover_handlers,
     include_hover_click: options.include_hover_click,
     iterate_child: options.iterate_child,
@@ -16921,21 +18296,33 @@ func.runtime.render.draw_node = async function (options) {
     nodeP: options.nodeP,
   });
 };
-func.runtime.render.render_ui_tree = async function (SESSION_ID, $container, nodeP, parent_infoP, paramsP, jobNoP, is_skeleton, keyP, refreshed_ds, parent_nodeP, check_existP, $root_container) {
-  if (!nodeP) return;
-  const perf_end = func.runtime?.perf?.start?.(SESSION_ID, 'render_ui_tree');
-  func.runtime?.perf?.increment_map?.(SESSION_ID, 'render_node_counts', nodeP.id || nodeP.id_org || nodeP.tagName || 'unknown');
+func.runtime.render.render_tree = async function (treeP, renderer_context) {
+  if (!treeP) return;
+  const nodeP = func.runtime.render.get_tree_source_node(treeP);
+  const perf_end = func.runtime?.perf?.start?.(renderer_context.SESSION_ID, 'render_ui_tree');
+  func.runtime?.perf?.increment_map?.(renderer_context.SESSION_ID, 'render_node_counts', treeP.id || nodeP?.id || nodeP?.id_org || treeP.tagName || 'unknown');
   try {
     const tree_runtime = func.runtime.render.create_tree_runtime({
-      SESSION_ID,
-      $container,
+      SESSION_ID: renderer_context.SESSION_ID,
+      $container: renderer_context.$container,
+      treeP,
       nodeP,
-      parent_infoP,
-      paramsP,
-      jobNoP,
-      is_skeleton,
+      parent_infoP: renderer_context.parent_infoP,
+      paramsP: renderer_context.paramsP,
+      jobNoP: renderer_context.jobNoP,
+      is_skeleton: renderer_context.is_skeleton,
+      keyP: renderer_context.keyP,
       render_child: async function ($divP, child, parent_infoP, key, parentNodeP, rootContainerP) {
-        await func.runtime.render.render_ui_tree(SESSION_ID, $divP, child, parent_infoP, paramsP, jobNoP, is_skeleton, key, null, parentNodeP, null, rootContainerP);
+        await func.runtime.render.render_tree(child, {
+          ...renderer_context,
+          $container: $divP,
+          parent_infoP,
+          keyP: key,
+          refreshed_ds: null,
+          parent_nodeP: parentNodeP,
+          check_existP: null,
+          $root_container: rootContainerP,
+        });
       },
     });
     const render_context = tree_runtime.render_context;
@@ -16947,23 +18334,24 @@ func.runtime.render.render_ui_tree = async function (SESSION_ID, $container, nod
     const iterate_child = tree_runtime.iterate_child;
 
     func.runtime.render.log_tree_debug({
-      SESSION_ID,
-      paramsP,
+      SESSION_ID: renderer_context.SESSION_ID,
+      paramsP: renderer_context.paramsP,
       nodeP,
       _ds,
     });
     const special_render = await func.runtime.render.render_special_node({
-      SESSION_ID,
-      $container,
-      $root_container,
+      SESSION_ID: renderer_context.SESSION_ID,
+      $container: renderer_context.$container,
+      $root_container: renderer_context.$root_container,
+      treeP,
       nodeP,
-      parent_infoP,
-      paramsP,
-      jobNoP,
-      is_skeleton,
-      keyP,
-      refreshed_ds,
-      parent_nodeP,
+      parent_infoP: renderer_context.parent_infoP,
+      paramsP: renderer_context.paramsP,
+      jobNoP: renderer_context.jobNoP,
+      is_skeleton: renderer_context.is_skeleton,
+      keyP: renderer_context.keyP,
+      refreshed_ds: renderer_context.refreshed_ds,
+      parent_nodeP: renderer_context.parent_nodeP,
       prop,
       render_context,
       hover_handlers,
@@ -16971,22 +18359,23 @@ func.runtime.render.render_ui_tree = async function (SESSION_ID, $container, nod
       close_modal,
     });
     if (special_render.handled) {
-      func.runtime?.perf?.increment?.(SESSION_ID, 'render_special_node_hits');
+      func.runtime?.perf?.increment?.(renderer_context.SESSION_ID, 'render_special_node_hits');
       return special_render.result;
     }
     return await func.runtime.render.draw_node({
-      SESSION_ID,
-      $container,
-      $root_container,
+      SESSION_ID: renderer_context.SESSION_ID,
+      $container: renderer_context.$container,
+      $root_container: renderer_context.$root_container,
+      treeP,
       nodeP,
-      parent_infoP,
-      paramsP,
-      jobNoP,
-      is_skeleton,
-      keyP,
-      refreshed_ds,
-      parent_nodeP,
-      check_existP,
+      parent_infoP: renderer_context.parent_infoP,
+      paramsP: renderer_context.paramsP,
+      jobNoP: renderer_context.jobNoP,
+      is_skeleton: renderer_context.is_skeleton,
+      keyP: renderer_context.keyP,
+      refreshed_ds: renderer_context.refreshed_ds,
+      parent_nodeP: renderer_context.parent_nodeP,
+      check_existP: renderer_context.check_existP,
       prop,
       hover_handlers,
       include_hover_click,
@@ -16995,6 +18384,31 @@ func.runtime.render.render_ui_tree = async function (SESSION_ID, $container, nod
   } finally {
     perf_end?.();
   }
+};
+func.runtime.render.render_ui_tree = async function (SESSION_ID, $container, nodeP, parent_infoP, paramsP, jobNoP, is_skeleton, keyP, refreshed_ds, parent_nodeP, check_existP, $root_container) {
+  if (!nodeP) return;
+  const treeP = await func.runtime.render.ensure_tree_node({
+    SESSION_ID,
+    nodeP,
+    parent_infoP,
+    paramsP,
+    keyP,
+    parent_nodeP,
+  });
+
+  return await func.runtime.render.render_tree(treeP, {
+    SESSION_ID,
+    $container,
+    parent_infoP,
+    paramsP,
+    jobNoP,
+    is_skeleton,
+    keyP,
+    refreshed_ds,
+    parent_nodeP,
+    check_existP,
+    $root_container,
+  });
 };
  func.runtime = func.runtime || {};
 func.runtime.ui = func.runtime.ui || {};
@@ -17662,7 +19076,7 @@ func.runtime.render.handle_xu_ref = async function (options) {
 func.runtime.render.handle_xu_bind = async function (options) {
   if (options.is_skeleton) return {};
 
-  const $elm = func.runtime?.ui?.get_preferred_live_element ? func.runtime.ui.get_preferred_live_element(options.$elm) : func.runtime.ui.as_jquery(options.$elm);
+  const $elm = func.runtime?.ui?.get_preferred_live_element ? func.runtime.ui.get_preferred_live_element(options.$elm) : options.$elm;
   const elm_data = func.runtime.ui.get_data($elm);
   const xuData = elm_data?.xuData;
   const bind_expression =
@@ -18518,6 +19932,7 @@ func.runtime.render.handle_xu_panel_program = async function (options) {
       parent_infoP: options.parent_infoP,
       jobNoP: options.jobNoP,
       keyP: options.keyP,
+      treeP: options.treeP,
       parent_nodeP: options.parent_nodeP,
       prop: options.nodeP.attributes,
       $appendToP: $wrapper,
@@ -22531,6 +23946,12 @@ function xuda(...args) {
   if (typeof opt !== 'object') {
     return console.error('Xuda Error - opt argument is not an object');
   }
+
+  if (!opt.ssr_payload && func.runtime.platform.get_window()?.__XUDA_SSR__) {
+    opt.ssr_payload = func.runtime.platform.get_window().__XUDA_SSR__;
+  }
+  func.runtime.render.apply_runtime_bootstrap_defaults(opt);
+
   glb.URL_PARAMS = func.common.getJsonFromUrl(platform.get_url_href());
 
   glb.worker_type = 'Worker';