@xuda.io/runtime-bundle 1.0.1434 → 1.0.1436

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;
     }
@@ -1684,6 +1641,23 @@ func.runtime.platform = {
       return false;
     }
   },
+  get_cookie_item: function (key) {
+    if (!key) {
+      return null;
+    }
+    const doc = func.runtime.platform.get_document();
+    const cookie_string = doc?.cookie;
+    if (!cookie_string) {
+      return null;
+    }
+    const cookie_entry = cookie_string.split('; ').find(function (cookie) {
+      return cookie.startsWith(key + '=');
+    });
+    if (!cookie_entry) {
+      return null;
+    }
+    return cookie_entry.split('=').slice(1).join('=') || null;
+  },
   get_url_href: function () {
     return func.runtime.platform.get_location()?.href || '';
   },
@@ -1796,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;
@@ -1807,34 +1780,41 @@ 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();
+  const doc = func.runtime.platform.get_document();
+  if (!doc?.createElement || !doc?.head?.appendChild) {
+    if (callback) {
+      callback();
+    }
+    return;
   }
+  const script = doc.createElement('script');
+  script.src = url;
+  if (type) script.type = type;
+  script.onload = callback;
+  doc.head.appendChild(script);
 };
 func.runtime.platform.load_css = function (href) {
-  if (typeof document === 'undefined') return;
+  const doc = func.runtime.platform.get_document();
+  if (!doc?.createElement || !doc?.head) {
+    return;
+  }
   try {
-    if (document.querySelector('link[href="' + href + '"]')) return;
+    if (doc.querySelector('link[href="' + href + '"]')) return;
   } 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);
+  doc.head.insertBefore(link, doc.head.firstChild);
 };
 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]);
@@ -1842,15 +1822,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) {
@@ -2538,12 +2520,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) {
@@ -2573,12 +2579,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) {
@@ -2661,25 +2665,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) {
@@ -2690,7 +2721,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,
@@ -2699,14 +2730,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,
   };
@@ -3796,6 +3841,18 @@ func.common.fastHash = function (inputString) {
 };
 
 glb.new_xu_render = false;
+ func.runtime = func.runtime || {};
+func.runtime.platform = func.runtime.platform || {};
+
+func.runtime.platform.dispatch_document_event = function (name, data) {
+  if (typeof document === 'undefined' || typeof CustomEvent === 'undefined') {
+    return false;
+  }
+  document.dispatchEvent(new CustomEvent(name, {
+    detail: Array.isArray(data) ? data : [data],
+  }));
+  return true;
+};
  glb.DEBUG_INFO_OBJ = {};
 // var CONNECTION_ATTEMPTS = 0;
 glb.APP_INFO = {};
@@ -5708,8 +5765,9 @@ func.datasource.clean = function (SESSION_ID, screenIdP) {
   var arr = [];
   for (const [key, val] of Object.entries(SESSION_OBJ[SESSION_ID].DS_GLB)) {
     try {
-      const _screen_el = val.screenId ? document.getElementById(val.screenId) : null;
-      const screen_parent_id = _screen_el?.parentElement?.id || null;
+      const screen_parent_id = val.screenId && func.runtime?.ui?.get_parent_element_id
+        ? func.runtime.ui.get_parent_element_id(val.screenId)
+        : null;
       if (
         Number(key) > 0 &&
         (val.screenId === screenIdP ||
@@ -5718,7 +5776,7 @@ func.datasource.clean = function (SESSION_ID, screenIdP) {
           (val && val.parentDataSourceNo && arr.includes(val.parentDataSourceNo.toString())))
       ) {
         arr.push(key);
-        if (val.screenId) func.UI.utils.screen_blocker(false, val.screenId);
+        if (val.screenId && func.UI?.utils?.screen_blocker) func.UI.utils.screen_blocker(false, val.screenId);
       }
     } catch (err) {
       console.warn('func.datasource.clean failed');
@@ -9265,11 +9323,14 @@ func.runtime.ui.create_screen_host = function (SESSION_ID, screen_type, params,
   };
 };
 func.runtime.ui.find_xu_ui_in_root = function (SESSION_ID, xu_ui_id) {
+  if (!SESSION_ID || !xu_ui_id) {
+    return func.runtime.ui._wrap_matches([]);
+  }
   if (func.runtime.ui.get_refresh_indexed_element_by_ui_id) {
     const elm = func.runtime.ui.get_refresh_indexed_element_by_ui_id(SESSION_ID, xu_ui_id);
     return func.runtime.ui._wrap_matches(elm ? [elm] : []);
   }
-  return func.runtime.ui.find_in_root(SESSION_ID, `[xu-ui-id=${xu_ui_id}]`);
+  return func.runtime.ui.find_in_root(SESSION_ID, `[xu-ui-id="${xu_ui_id}"]`);
 };
 func.runtime.ui.find_panel_wrapper_in_root = function (SESSION_ID, xu_ui_id) {
   if (func.runtime.ui.get_refresh_indexed_panel_wrapper_by_id) {
@@ -9292,7 +9353,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);
@@ -9306,7 +9367,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);
@@ -9390,6 +9451,14 @@ func.runtime.ui.find_element_by_id = function (element_id) {
   }
   return null;
 };
+func.runtime.ui.get_parent_element_id = function (element_id) {
+  if (!element_id) {
+    return null;
+  }
+  const clean_id = element_id.startsWith('#') ? element_id.substring(1) : element_id;
+  const element = func.runtime.ui.find_element_by_id(clean_id);
+  return element?.parentElement?.id || null;
+};
 func.runtime.ui.get_session_root = function (SESSION_ID) {
   if (typeof document !== 'undefined') {
     return document.getElementById('embed_' + SESSION_ID) || null;
@@ -9405,40 +9474,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;
   }
@@ -9456,9 +9499,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 {};
@@ -9939,12 +9983,23 @@ func.runtime.ui.build_xu_ui_id_seed = function (nodeP, dsSessionP, key_path, cur
   const elem_key = `${nodeId}-${key_path}-${currentRecordId}`;
   return `${nodeP.id}-${elem_key}-${dsSessionP?.toString() || ''}`;
 };
+func.runtime.ui.build_container_key_path = function (container_xu_data, keyP, parent_infoP, nodeP, parent_nodeP) {
+  const key_segment = typeof keyP === 'undefined' || keyP === null ? '0' : `${keyP}`;
+  let key_path = `${container_xu_data?.key_path || '0'}-${key_segment}`;
+  const parent_identity = parent_nodeP?.xu_tree_id || parent_nodeP?.id;
+  const node_identity = nodeP?.xu_tree_id || nodeP?.id;
+  const is_iterated_clone = !!(parent_infoP?.iterate_info && parent_identity && node_identity && parent_identity === node_identity);
+  if (is_iterated_clone) {
+    key_path += '-iter';
+  }
+  return key_path;
+};
 func.runtime.ui.generate_xu_ui_id = async function (SESSION_ID, nodeP, $container, paramsP, keyP, precomputed = {}) {
   const dsSessionP = paramsP.dsSessionP;
   const _ds = SESSION_OBJ[SESSION_ID].DS_GLB[dsSessionP];
   const containerXuData = precomputed.container_xu_data || func.runtime.ui.get_data($container)?.xuData;
   const currentRecordId = typeof precomputed.currentRecordId !== 'undefined' ? precomputed.currentRecordId : containerXuData?.recordid || _ds?.currentRecordId || '';
-  const key_path = precomputed.key_path || `${containerXuData?.key_path || '0'}-${keyP || '0'}`;
+  const key_path = precomputed.key_path || func.runtime.ui.build_container_key_path(containerXuData, keyP, precomputed.parent_infoP, nodeP, precomputed.parent_nodeP);
   const ui_id = func.runtime.ui.build_xu_ui_id_seed(nodeP, dsSessionP, key_path, currentRecordId);
 
   if (func.runtime.ui.ui_id_hash_cache.has(ui_id)) {
@@ -9973,13 +10028,15 @@ func.runtime.ui.create_container = async function (options) {
   const currentRecordId = container_xu_data?.recordid || (_ds ? _ds.currentRecordId : '');
 
   try {
-    const key_path = `${container_xu_data?.key_path || '0'}-${options.keyP || '0'}`;
+    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 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,
       key_path,
+      parent_infoP: options.parent_infoP,
+      parent_nodeP: options.parent_nodeP,
     });
 
     func.runtime.ui.apply_container_meta($div, {
@@ -10311,9 +10368,7 @@ func.UI.utils.get_url_attribute = function (SESSION_ID, key) {
   const root_attribute = func.runtime.ui.get_attr(_session.root_element, key);
   const option_param = _session.opt?.params?.[key];
   const option_value = _session.opt?.[key];
-  const cookie_value = (typeof document !== 'undefined' && document.cookie)
-    ? (document.cookie.split('; ').find(c => c.startsWith(key + '='))?.split('=').slice(1).join('=') || null)
-    : null;
+  const cookie_value = platform.get_cookie_item(key);
   const storage_value = platform.get_storage_item(key, 'local');
 
   return url_param || root_attribute || option_param || option_value || cookie_value || storage_value;
@@ -11570,8 +11625,40 @@ func.UI.worker.execute = async function (SESSION_ID, queue_obj) {
     get_live_element_context: function (elem_key, fallback_$elm, context = {}) {
       let raw_$elm = elem_key ? fx.get_element_by_ui_id(elem_key) : fallback_$elm;
       let $elm = func.runtime?.ui?.get_preferred_live_element ? func.runtime.ui.get_preferred_live_element(raw_$elm) : raw_$elm;
+      const matches_context = function (node_xu_data, allow_loose_match = false) {
+        if (!node_xu_data) {
+          return false;
+        }
+        if (context.node_id && node_xu_data.nodeid !== context.node_id) {
+          return false;
+        }
+        if (typeof context.key !== 'undefined' && context.key !== null && node_xu_data.key !== context.key) {
+          return false;
+        }
+        if (context.key_path && node_xu_data.key_path !== context.key_path) {
+          return false;
+        }
+        if (context.recordid && node_xu_data.recordid !== context.recordid) {
+          return false;
+        }
+        if (!allow_loose_match) {
+          if (context.prog_id && node_xu_data.paramsP?.prog_id !== context.prog_id) {
+            return false;
+          }
+          if (context.parent_element_ui_id && node_xu_data.parent_element_ui_id !== context.parent_element_ui_id) {
+            return false;
+          }
+        }
+        if (node_xu_data.pending_to_delete) {
+          return false;
+        }
+        return true;
+      };
+      const resolved_node = func.runtime.ui.get_first_node($elm);
+      const resolved_data = resolved_node ? func.runtime.ui.get_data(resolved_node)?.xuData : null;
+      const has_matching_resolved_node = matches_context(resolved_data);
 
-      if (context.node_id) {
+      if (context.node_id && !has_matching_resolved_node) {
         const $root = func.UI.worker.get_session_root(SESSION_ID);
         const runtime_nodes = func.runtime?.ui?.get_refresh_index_elements
           ? func.runtime.ui.get_refresh_index_elements(SESSION_ID, $root).toArray()
@@ -11582,22 +11669,7 @@ func.UI.worker.execute = async function (SESSION_ID, queue_obj) {
           const node = runtime_nodes[index];
           const node_data = func.runtime.ui.get_data(node);
           const node_xu_data = node_data?.xuData;
-          if (!node_xu_data) {
-            continue;
-          }
-          if (node_xu_data.nodeid !== context.node_id) {
-            continue;
-          }
-          if (context.recordid && node_xu_data.recordid !== context.recordid) {
-            continue;
-          }
-          if (context.prog_id && node_xu_data.paramsP?.prog_id !== context.prog_id) {
-            continue;
-          }
-          if (context.parent_element_ui_id && node_xu_data.parent_element_ui_id !== context.parent_element_ui_id) {
-            continue;
-          }
-          if (node_xu_data.pending_to_delete) {
+          if (!matches_context(node_xu_data)) {
             continue;
           }
           matching_nodes.push(node);
@@ -11608,16 +11680,7 @@ func.UI.worker.execute = async function (SESSION_ID, queue_obj) {
             const node = runtime_nodes[index];
             const node_data = func.runtime.ui.get_data(node);
             const node_xu_data = node_data?.xuData;
-            if (!node_xu_data) {
-              continue;
-            }
-            if (node_xu_data.nodeid !== context.node_id) {
-              continue;
-            }
-            if (context.recordid && node_xu_data.recordid !== context.recordid) {
-              continue;
-            }
-            if (node_xu_data.pending_to_delete) {
+            if (!matches_context(node_xu_data, true)) {
               continue;
             }
             matching_nodes.push(node);
@@ -11735,10 +11798,10 @@ func.UI.worker.execute = async function (SESSION_ID, queue_obj) {
       const iterate_info = options.iterate_info;
       const iterate_key = iterate_info
         ? [
-            iterate_info.iterator_key || '',
-            iterate_info.iterator_val || '',
-            iterate_info._key || '',
-            iterate_info._val || '',
+            iterate_info.iterator_key ?? '',
+            iterate_info.iterator_val ?? '',
+            iterate_info._key ?? '',
+            iterate_info._val ?? '',
           ].join('::')
         : '';
 
@@ -12877,7 +12940,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;
 };
@@ -13707,7 +13770,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)) {
@@ -14688,6 +14751,8 @@ func.runtime.ui.build_refresh_job_obj = function (options, elem_key, elem_val, e
     fields_arr: options.fields_arr,
     elem_key,
     node_id: elm_data?.xuData?.nodeid,
+    key: elm_data?.xuData?.key,
+    key_path: elm_data?.xuData?.key_path,
     recordid: elm_data?.xuData?.recordid,
     parent_element_ui_id: elm_data?.xuData?.parent_element_ui_id,
     prog_id: elm_data?.xuData?.paramsP?.prog_id,
@@ -16194,6 +16259,43 @@ func.runtime.render.scope_css_to_xu_ui = function ($elm, cssText) {
   return parser.getCSSForEditor(parsed);
 };
 func.runtime.render.bind_xu_event = function (options) {
+  const decode_html_entities = function (value) {
+    if (typeof value !== 'string' || value.indexOf('&') === -1) {
+      return value;
+    }
+
+    if (typeof document !== 'undefined') {
+      const textarea = document.createElement('textarea');
+      textarea.innerHTML = value;
+      return textarea.value;
+    }
+
+    return value
+      .replaceAll('&quot;', '"')
+      .replaceAll('&#34;', '"')
+      .replaceAll('&#39;', "'")
+      .replaceAll('&#039;', "'")
+      .replaceAll('&lt;', '<')
+      .replaceAll('&gt;', '>')
+      .replaceAll('&amp;', '&');
+  };
+  const normalize_event_handlers = function (raw_handlers) {
+    if (typeof raw_handlers !== 'string') {
+      return raw_handlers;
+    }
+
+    const decoded_value = decode_html_entities(raw_handlers).trim();
+    if (!decoded_value) {
+      return [];
+    }
+
+    try {
+      return JSON5.parse(decoded_value);
+    } catch (error) {
+      console.error('XUDA RUNTIME', `xu-on has invalid workflow syntax: ${decoded_value}`, error);
+      return [];
+    }
+  };
   CLIENT_ACTIVITY_TS = Date.now();
   const trigger = options.val.key.split('xu-on:')[1].toLowerCase();
   const handler_key = `_xuda_xuOn_${trigger.replace(/[^a-z0-9_]/gi, '_')}`;
@@ -16205,27 +16307,33 @@ func.runtime.render.bind_xu_event = function (options) {
     const _$elm = evt.currentTarget;
     const elm_data = func.runtime.ui.get_data(_$elm);
     const xuAttributes = elm_data?.xuAttributes;
-    const event_handlers = xuAttributes?.['xu-on:' + evt.type];
+    const event_attr_key = 'xu-on:' + evt.type;
+    const event_handlers = normalize_event_handlers(xuAttributes?.[event_attr_key]);
+    if (xuAttributes && event_handlers !== xuAttributes?.[event_attr_key]) {
+      xuAttributes[event_attr_key] = event_handlers;
+    }
     if (xu_isEmpty(xuAttributes) || xu_isEmpty(event_handlers)) return;
     const handler_keys = Object.keys(event_handlers);
 
     for (let handler_index = 0; handler_index < handler_keys.length; handler_index++) {
       const val = event_handlers[handler_keys[handler_index]];
-      if (!xu_isEmpty(val.props.condition)) {
-        const expCond = await func.expression.get(options.SESSION_ID, val.props.condition, options.paramsP.dsSessionP, 'condition', options.paramsP.recordid);
+      const handler_props = val?.props || {};
+      if (!xu_isEmpty(handler_props.condition)) {
+        const expCond = await func.expression.get(options.SESSION_ID, handler_props.condition, options.paramsP.dsSessionP, 'condition', options.paramsP.recordid);
         if (!expCond.result) continue;
       }
 
-      if (val.event_modifiers && evt[val.event_modifiers]) {
+      if (val?.event_modifiers && evt[val.event_modifiers]) {
         evt[val.event_modifiers]();
       }
 
-      const workflow = val.workflow || val.event;
+      const workflow = val?.workflow || val?.event;
       if (workflow) {
         const workflow_keys = Object.keys(workflow);
         for (let workflow_index = 0; workflow_index < workflow_keys.length; workflow_index++) {
           const val2 = workflow[workflow_keys[workflow_index]];
-          if (!val2.data.enabled) continue;
+          if (!val2?.data?.action) continue;
+          if (val2.data.enabled === false) continue;
 
           func.events.add_to_queue(
             options.SESSION_ID,
@@ -16478,7 +16586,12 @@ func.runtime.widgets.render_node = async function (options) {
       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');
     }
@@ -16539,7 +16652,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);
@@ -17569,7 +17688,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 =
@@ -17949,18 +18068,12 @@ func.runtime.render.handle_xu_for = async function (options) {
       }
     }
 
-    // Strip xu-ui-id from template elements before removal so that
-    // delete_meta does not destroy the meta entry shared by iteration-0
-    // (the template and first iteration child share the same xu-ui-id
-    // because their key_path values collide).
     const _live_node = func.runtime.ui.get_first_node($live_elm);
     if (_live_node) {
-      _live_node.removeAttribute('xu-ui-id');
       func.runtime.ui.remove($live_elm);
     }
     const _options_node = func.runtime.ui.get_first_node(options.$elm);
     if (_options_node && _options_node !== _live_node) {
-      _options_node.removeAttribute('xu-ui-id');
       func.runtime.ui.remove(options.$elm);
     }
     return { abort: true, consume_placeholder: true };
@@ -18556,10 +18669,31 @@ func.runtime.widgets = func.runtime.widgets || {};
 // Browser-only common xu handler factories live here so registry composition can stay small.
 
 func.runtime.render.build_base_xu_handlers = function (options, _ds) {
+  const decode_html_entities = function (value) {
+    if (typeof value !== 'string' || value.indexOf('&') === -1) {
+      return value;
+    }
+
+    if (typeof document !== 'undefined') {
+      const textarea = document.createElement('textarea');
+      textarea.innerHTML = value;
+      return textarea.value;
+    }
+
+    return value
+      .replaceAll('&quot;', '"')
+      .replaceAll('&#34;', '"')
+      .replaceAll('&#39;', "'")
+      .replaceAll('&#039;', "'")
+      .replaceAll('&lt;', '<')
+      .replaceAll('&gt;', '>')
+      .replaceAll('&amp;', '&');
+  };
   const parse_object_value = function (attr_name, val, shape = 'object') {
     let parsed_value = val?.value;
     if (typeof parsed_value === 'string') {
-      const trimmed_value = parsed_value.trim();
+      const decoded_value = decode_html_entities(parsed_value);
+      const trimmed_value = decoded_value.trim();
       const wrapped_candidate =
         trimmed_value.startsWith('(') && trimmed_value.endsWith(')')
           ? trimmed_value.slice(1, -1).trim()
@@ -19712,6 +19846,7 @@ func.events.execute = async function (
     },
     execute_native_javascript: async function () {
       const module = await func.common.get_module(SESSION_ID, 'xuda-event-javascript-module.mjs');
+      const resolved_element_expr = `(func.runtime.ui && func.runtime.ui.find_xu_ui_in_root && func.runtime.ui.get_first_node ? func.runtime.ui.get_first_node(func.runtime.ui.find_xu_ui_in_root(SESSION_ID, ${JSON.stringify(elementP)})) : null)`;
 
       const result = await module.run_javascript(
         SESSION_ID,
@@ -19719,7 +19854,7 @@ func.events.execute = async function (
         dsSession,
         `(async function(el,evt) {
           ${refIdP.value}
-          })(document.querySelector(\`[xu-ui-id="${elementP}"]\`),evt)`,
+          })(${resolved_element_expr},evt)`,
         null,
         null,
         null,
@@ -19732,6 +19867,7 @@ func.events.execute = async function (
     },
     execute_evaluate_javascript: async function () {
       const module = await func.common.get_module(SESSION_ID, 'xuda-event-javascript-module.mjs');
+      const resolved_element_expr = `(func.runtime.ui && func.runtime.ui.find_xu_ui_in_root && func.runtime.ui.get_first_node ? func.runtime.ui.get_first_node(func.runtime.ui.find_xu_ui_in_root(SESSION_ID, ${JSON.stringify(elementP)})) : null)`;
 
       const result = await module.run_javascript(
         SESSION_ID,
@@ -19739,7 +19875,7 @@ func.events.execute = async function (
         dsSession,
         `(async function(el,evt) {
           ${refIdP.value}
-          })(document.querySelector(\`[xu-ui-id="${elementP}"]\`),evt)`,
+          })(${resolved_element_expr},evt)`,
         true,
         null,
         null,