@dooboostore/simple-web-component 1.0.16 → 1.0.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dooboostore/simple-web-component",
-  "version": "1.0.16",
+  "version": "1.0.17",
   "license": "MIT",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -14,6 +14,13 @@
     }
   },
   "description": "Simple Web Component library based on dom-render philosophy",
+  "sideEffects": [
+    "./dist/esm/elements/*.js",
+    "./dist/esm/elements/is/*.js",
+    "./dist/cjs/elements/*.js",
+    "./dist/cjs/elements/is/*.js",
+    "*.ts"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/dooboostore-develop/packages.git",
@@ -81,9 +88,9 @@
     "webpack-cli": "^5.1.4",
     "webpack-dev-server": "^5.2.0",
     "@dooboostore/core": "1.0.28",
-    "@dooboostore/simple-boot": "1.0.53",
+    "@dooboostore/core-node": "1.0.10",
     "@dooboostore/core-web": "1.0.9",
-    "@dooboostore/core-node": "1.0.10"
+    "@dooboostore/simple-boot": "1.0.53"
   },
   "scripts": {
     "clean": "rm -rf dist",

package/src/decorators/addEventListener.ts

@@ -9,6 +9,7 @@ export interface AddEventListenerOptions extends EventListenerOptions {
   stopImmediatePropagation?: boolean;
   preventDefault?: boolean;
   delegate?: boolean;
+  removeOnDisconnected?: boolean;
 }
 
 export interface AddEventListenerMetadata {

package/src/decorators/elementDefine.ts

@@ -1,4 +1,5 @@
 import { ReflectUtils } from '@dooboostore/core/reflect/ReflectUtils';
+import { FunctionUtils } from '@dooboostore/core/function/FunctionUtils';
 import { getInnerHtmlMetadataList } from './innerHtml';
 import { getQueryMetadata } from './query';
 import { getQueryAllMetadata } from './queryAll';
@@ -11,9 +12,11 @@ import { SwcUtils } from '../utils/Utils';
 import { HTML_TAG_ENTRIES, DOM_EVENT_NAMES } from '../config/config';
 import { SituationType, SituationTypeContainer, SituationTypeContainers } from '@dooboostore/simple-boot/decorators/inject/Inject';
 import { ConstructorType } from '@dooboostore/core/types';
+import { SimpleApplication } from '@dooboostore/simple-boot/SimpleApplication';
+import { Router } from '@dooboostore/core-web/routers/Router';
 import { InjectSituationType, HostSet, SwcAppInterface } from '../types';
 
-// --- Core Interfaces & Types (Integrated) ---
+// --- Core Interfaces & Types ---
 
 export interface ElementConfig {
   name: string;
@@ -25,6 +28,9 @@ export interface ElementConfig {
 
 export const ELEMENT_CONFIG_KEY = Symbol('simple-web-component:element-config');
 
+// Shared state for global delegation to prevent multiple listeners on the same root
+const globalDelegatedRoots = new WeakSet<Node>();
+
 // --- Environment Initialization Helper ---
 
 function buildEnv(configWindow?: Window) {
@@ -36,14 +42,7 @@ function buildEnv(configWindow?: Window) {
     if (win?.[cls]) builtInTagMap.set(win[cls], tag);
   }
 
-  const domHelpers = {
-    $d: doc,
-    $w: win,
-    $q: (sel: string, root?: Element | Document | ShadowRoot) => (root ?? doc).querySelector(sel),
-    $qa: (sel: string, root?: Element | Document | ShadowRoot) => Array.from((root ?? doc).querySelectorAll(sel)),
-    $qi: (id: string, root?: Document | ShadowRoot) => (root ?? doc).getElementById(id)
-  } as const;
-
+  const domHelpers = SwcUtils.getHelperSet(win);
   return { win, doc, builtInTagMap, domHelpers };
 }
 
@@ -58,8 +57,6 @@ export const elementDefine =
     const config: ElementConfig = typeof inConfig === 'string' ? { name: inConfig } : inConfig;
     const { win, doc, builtInTagMap: BUILT_IN_TAG_MAP, domHelpers: SWC_DOM_HELPERS } = buildEnv(config.window);
     config.window = win;
-    const SWC_DOM_HELPER_KEYS = Object.keys(SWC_DOM_HELPERS) as (keyof typeof SWC_DOM_HELPERS)[];
-    const SWC_DOM_HELPER_VALS = () => SWC_DOM_HELPER_KEYS.map(k => (SWC_DOM_HELPERS as any)[k]);
 
     let extendsTagName = config.extends;
     if (!extendsTagName) {
@@ -86,15 +83,14 @@ export const elementDefine =
     const NewClass = class extends (constructor as any) {
       private _swcId = Math.random().toString(36).substring(2, 11);
       private _emitHandlers = new Map<string, EventListener>();
+      private _boundListeners: Array<{ target: EventTarget; type: string; handler: EventListener; options?: any }> = [];
 
       private _executeSwcScript(attrName: string, hostSet: HostSet, extraArgs: Record<string, any> = {}) {
         const script = this.getAttribute(attrName);
         if (script) {
           try {
             const args = { ...hostSet, ...SWC_DOM_HELPERS, ...extraArgs };
-            const argNames = Object.keys(args);
-            const argValues = Object.values(args);
-            new Function(...argNames, script).apply(this, argValues);
+            FunctionUtils.execute({ script, context: this, args });
           } catch (e) {
             console.error(`[SWC] Failed to execute ${attrName}:`, e);
           }
@@ -142,9 +138,13 @@ export const elementDefine =
 
         const handler = (event: any) => {
           const hostSet = SwcUtils.getHostSet(el);
-          const argNames = Object.keys(hostSet);
-          const argValues = Object.values(hostSet);
-          new Function('event', '$data', ...argNames, ...SWC_DOM_HELPER_KEYS, script).call(el, event, (event as CustomEvent).detail, ...argValues, ...SWC_DOM_HELPER_VALS());
+          const args = {
+            event,
+            $data: (event as CustomEvent).detail,
+            ...hostSet,
+            ...SWC_DOM_HELPERS
+          };
+          FunctionUtils.execute({ script, context: el, args });
         };
 
         el.addEventListener(eventName, handler);
@@ -166,6 +166,10 @@ export const elementDefine =
       }
 
       async connectedCallback() {
+        const conf = getElementConfig(this);
+        const currentWin = conf?.window || window;
+        const currentDoc = currentWin.document;
+
         const hostSet = SwcUtils.getHostSet(this as any);
 
         this._executeSwcScript('swc-on-before-connected', hostSet);
@@ -190,77 +194,141 @@ export const elementDefine =
           if (lContent) this.innerHTML = lContent;
         }
 
-        // --- @addEventListener binding ---
+        // --- Optimized Host Delegation ---
+        const createDelegationHandler = (delegateHost: any) => (event: Event) => {
+          if ((event as any).__swc_handled) return;
+
+          const path = event.composedPath();
+          const type = event.type;
+          const attrName = `swc-on-${type}`;
+
+          for (const node of path) {
+            if (node === delegateHost) break;
+            if (!(node instanceof HTMLElement)) continue;
+
+            const script = node.getAttribute?.(attrName);
+            if (script && !getElementConfig(node)) {
+              const host = SwcUtils.findNearestSwcHost(node);
+              if (host) {
+                const childHostSet = SwcUtils.getHostSet(node);
+                const args = {
+                  event,
+                  $data: (event as CustomEvent).detail,
+                  ...childHostSet,
+                  ...SWC_DOM_HELPERS
+                };
+                FunctionUtils.execute({ script, context: node, args });
+                (event as any).__swc_handled = true;
+                break;
+              }
+            }
+          }
+        };
+
+        // 1. Local Delegation (To itself)
+        DOM_EVENT_NAMES.forEach(type => {
+          this.addEventListener(type, createDelegationHandler(this));
+          this._boundListeners.push({ target: this as any, type, handler: createDelegationHandler(this) });
+        });
+
+        // 2. Structural/Global Delegation (If no parent host exists)
+        const hasParentHost = SwcUtils.findAllSwcHosts(this as any).length > 0;
+        if (!hasParentHost) {
+          const root = this.getRootNode();
+          if (!globalDelegatedRoots.has(root)) {
+            DOM_EVENT_NAMES.forEach(type => {
+              const handler = createDelegationHandler(root);
+              root.addEventListener(type, handler);
+            });
+            globalDelegatedRoots.add(root);
+          }
+        }
+
+        // --- @addEventListener binding (Direct/Delegate/Global) ---
         addEventListenerList.forEach(meta => {
           const { selector, type, options } = meta;
-          const { root, capture, once, passive, stopPropagation, stopImmediatePropagation, preventDefault, delegate } = options;
-
-          if (delegate && selector && selector !== ':host') {
+          const { root, capture, once, passive, stopPropagation, stopImmediatePropagation, preventDefault, delegate, removeOnDisconnected } = options;
+          const opts = { capture, once, passive };
+
+          const bindTargets: EventTarget[] = [];
+
+          if (selector === ':window') {
+            bindTargets.push(currentWin);
+          } else if (selector === ':document') {
+            bindTargets.push(currentDoc);
+          } else if (selector === ':parentHost') {
+            if (hostSet.$parentHost) bindTargets.push(hostSet.$parentHost);
+          } else if (selector === ':appHost') {
+            if (hostSet.$appHost) bindTargets.push(hostSet.$appHost);
+          } else if (selector === ':firstHost') {
+            if (hostSet.$firstHost) bindTargets.push(hostSet.$firstHost);
+          } else if (selector === ':lastHost') {
+            if (hostSet.$lastHost) bindTargets.push(hostSet.$lastHost);
+          } else if (selector === ':firstAppHost') {
+            if (hostSet.$firstAppHost) bindTargets.push(hostSet.$firstAppHost);
+          } else if (selector === ':lastAppHost') {
+            if (hostSet.$lastAppHost) bindTargets.push(hostSet.$lastAppHost);
+          } else if (!selector || selector === ':host') {
+            bindTargets.push(this as any);
+          } else if (delegate) {
             const bindRoots: (HTMLElement | ShadowRoot)[] = [];
             const r = root || 'auto';
-            if (r === 'auto') {
-              bindRoots.push(this.shadowRoot || (this as any));
-            } else if (r === 'light') {
-              bindRoots.push(this as any);
-            } else if (r === 'shadow') {
+            if (r === 'auto') bindRoots.push(this.shadowRoot || (this as any));
+            else if (r === 'light') bindRoots.push(this as any);
+            else if (r === 'shadow') {
               if (this.shadowRoot) bindRoots.push(this.shadowRoot as any);
             } else if (r === 'all') {
               bindRoots.push(this as any);
               if (this.shadowRoot) bindRoots.push(this.shadowRoot as any);
             }
 
-            bindRoots.forEach(bindRoot => {
+            bindRoots.forEach(br => {
               const handler = (event: Event) => {
-                const target = event.target as HTMLElement;
-                const matchedEl = target.closest(selector);
-                if (matchedEl && (bindRoot as any).contains(matchedEl)) {
+                const matchedEl = (event.target as HTMLElement).closest(selector);
+                if (matchedEl && (br as any).contains(matchedEl)) {
                   if (stopPropagation) event.stopPropagation();
                   if (stopImmediatePropagation) event.stopImmediatePropagation();
                   if (preventDefault) event.preventDefault();
-
-                  const hostSet = SwcUtils.getHostSet(this as any);
-                  this._invokeLifecycleMethod(meta.propertyKey, hostSet, [event, hostSet, matchedEl]);
+                  const currentHostSet = SwcUtils.getHostSet(this as any);
+                  this._invokeLifecycleMethod(meta.propertyKey, currentHostSet, [event, currentHostSet, matchedEl]);
                 }
               };
-              bindRoot.addEventListener(type, handler, { capture, once, passive });
+              br.addEventListener(type, handler, opts);
+              const self: any = this;
+              if (removeOnDisconnected === true || (br !== self && br !== self.shadowRoot)) {
+                this._boundListeners.push({ target: br, type, handler, options: opts });
+              }
             });
           } else {
-            const targetEls: (HTMLElement | Element | Document | ShadowRoot | Window)[] = [];
-            if (!selector || selector === ':host') {
-              targetEls.push(this as any);
-            } else {
-              const searchRoots: (HTMLElement | ShadowRoot)[] = [];
-              const r = root || 'auto';
-              if (r === 'auto') {
-                searchRoots.push((this.shadowRoot || (this as any)) as any);
-              } else if (r === 'light') {
-                searchRoots.push(this as any);
-              } else if (r === 'shadow') {
-                if (this.shadowRoot) searchRoots.push(this.shadowRoot as any);
-              } else if (r === 'all') {
-                searchRoots.push(this as any);
-                if (this.shadowRoot) searchRoots.push(this.shadowRoot as any);
-              }
-
-              searchRoots.forEach(sr => {
-                const found = sr.querySelectorAll(selector);
-                found.forEach(el => targetEls.push(el as any));
-              });
+            const searchRoots: (HTMLElement | ShadowRoot)[] = [];
+            const r = root || 'auto';
+            if (r === 'auto') searchRoots.push((this.shadowRoot || (this as any)) as any);
+            else if (r === 'light') searchRoots.push(this as any);
+            else if (r === 'shadow') {
+              if (this.shadowRoot) searchRoots.push(this.shadowRoot as any);
+            } else if (r === 'all') {
+              searchRoots.push(this as any);
+              if (this.shadowRoot) searchRoots.push(this.shadowRoot as any);
             }
 
-            targetEls.forEach(el => {
-              const handler = (event: Event) => {
-                if (stopPropagation) event.stopPropagation();
-                if (stopImmediatePropagation) event.stopImmediatePropagation();
-                if (preventDefault) event.preventDefault();
-
-                const hostSet = SwcUtils.getHostSet(this as any);
-                this._invokeLifecycleMethod(meta.propertyKey, hostSet, [event, hostSet]);
-              };
-              const opts = { capture, once, passive };
-              el.addEventListener(type, handler, opts);
+            searchRoots.forEach(sr => {
+              sr.querySelectorAll(selector).forEach(el => bindTargets.push(el));
             });
           }
+
+          bindTargets.forEach(target => {
+            const handler = (event: Event) => {
+              if (stopPropagation) event.stopPropagation();
+              if (stopImmediatePropagation) event.stopImmediatePropagation();
+              if (preventDefault) event.preventDefault();
+              const currentHostSet = SwcUtils.getHostSet(this as any);
+              this._invokeLifecycleMethod(meta.propertyKey, currentHostSet, [event, currentHostSet]);
+            };
+            target.addEventListener(type, handler, opts);
+            if (removeOnDisconnected === true || target === currentWin || target === currentDoc) {
+              this._boundListeners.push({ target, type, handler, options: opts });
+            }
+          });
         });
 
         if (super.connectedCallback) await super.connectedCallback();
@@ -279,6 +347,9 @@ export const elementDefine =
         const bMethods = findAllLifecycleMetadata(this, ON_BEFORE_DISCONNECTED_METADATA_KEY);
         if (bMethods) bMethods.forEach(m => this._invokeLifecycleMethod(m, hostSet));
 
+        this._boundListeners.forEach(l => l.target.removeEventListener(l.type, l.handler, l.options));
+        this._boundListeners = [];
+
         if (super.disconnectedCallback) super.disconnectedCallback();
 
         const aMethods = findAllLifecycleMetadata(this, ON_AFTER_DISCONNECTED_METADATA_KEY);

package/src/decorators/query.ts

@@ -1,4 +1,6 @@
 import { ReflectUtils } from '@dooboostore/core/reflect/ReflectUtils';
+import { getElementConfig } from './elementDefine';
+import { SwcUtils } from '../utils/Utils';
 
 export interface QueryOptions {
   root?: 'light' | 'shadow' | 'all' | 'auto';
@@ -14,8 +16,6 @@ export const QUERY_METADATA_KEY = Symbol('simple-web-component:query');
 
 /**
  * @query decorator to inject a single element into a class property.
- * Usage: @query('.my-class') myEl!: HTMLElement;
- * Usage: @query('#my-id', { root: 'shadow' }) myEl!: HTMLElement;
  */
 export function query(selector: string, options: QueryOptions = {}): PropertyDecorator {
   return (target: Object, propertyKey: string | symbol, descriptor?: never): void => {
@@ -33,7 +33,25 @@ export function query(selector: string, options: QueryOptions = {}): PropertyDec
 
     Object.defineProperty(target, propertyKey, {
       get(this: HTMLElement) {
+        // --- Special Selectors: HostSet ---
+        const hostSet = SwcUtils.getHostSet(this);
+        if (selector === ':parentHost') return hostSet.$parentHost;
+        if (selector === ':appHost') return hostSet.$appHost;
+        if (selector === ':firstHost') return hostSet.$firstHost;
+        if (selector === ':lastHost') return hostSet.$lastHost;
+        if (selector === ':firstAppHost') return hostSet.$firstAppHost;
+        if (selector === ':lastAppHost') return hostSet.$lastAppHost;
+
+        // --- Special Selectors: Env ---
+        const config = getElementConfig(this);
+        const win = config?.window || window;
+        const doc = win.document;
+
+        if (selector === ':window') return win;
+        if (selector === ':document') return doc;
         if (!selector || selector === ':host') return this;
+
+        // --- Standard Selectors ---
         const r = options.root || 'auto';
 
         if (r === 'shadow') {

package/src/decorators/queryAll.ts

@@ -1,4 +1,6 @@
 import { ReflectUtils } from '@dooboostore/core/reflect/ReflectUtils';
+import { getElementConfig } from './elementDefine';
+import { SwcUtils } from '../utils/Utils';
 
 export interface QueryAllOptions {
   root?: 'light' | 'shadow' | 'all' | 'auto';
@@ -14,8 +16,6 @@ export const QUERY_ALL_METADATA_KEY = Symbol('simple-web-component:query-all');
 
 /**
  * @queryAll decorator to inject a list of elements into a class property.
- * Usage: @queryAll('.items') list!: NodeListOf<HTMLElement>;
- * Usage: @queryAll('li', { root: 'shadow' }) list!: HTMLElement[];
  */
 export function queryAll(selector: string, options: QueryAllOptions = {}): PropertyDecorator {
   return (target: Object, propertyKey: string | symbol, descriptor?: never): void => {
@@ -33,7 +33,21 @@ export function queryAll(selector: string, options: QueryAllOptions = {}): Prope
 
     Object.defineProperty(target, propertyKey, {
       get(this: HTMLElement) {
+        // --- Special Selectors: HostSet ---
+        const hostSet = SwcUtils.getHostSet(this);
+        if (selector === ':hosts') return hostSet.$hosts;
+        if (selector === ':appHosts') return hostSet.$appHosts;
+
+        // --- Special Selectors: Env ---
+        const config = getElementConfig(this);
+        const win = config?.window || window;
+        const doc = win.document;
+
+        if (selector === ':window') return [win];
+        if (selector === ':document') return [doc];
         if (!selector || selector === ':host') return [this];
+
+        // --- Standard Selectors ---
         const r = options.root || 'auto';
 
         if (r === 'shadow') {

package/src/elements/SwcAppEngine.ts

@@ -6,6 +6,7 @@ import { SimOption } from '@dooboostore/simple-boot/SimOption';
 import { Router, RouterEventType } from '@dooboostore/core-web/routers/Router';
 import { Subscription } from '@dooboostore/core/message/Subscription';
 import { ConstructorType, Optional } from '@dooboostore/core/types';
+import { FunctionUtils } from '@dooboostore/core/function/FunctionUtils';
 
 export type SwcConfigType = {
   rootRouter: ConstructorType<any>;
@@ -35,7 +36,7 @@ export class SwcAppEngine {
     if (!configStr) return;
 
     try {
-      const userConfig: SwcAttributeConfigType = new Function(`return ${configStr}`).apply(this.host);
+      const userConfig: SwcAttributeConfigType = FunctionUtils.executeReturn({ script: configStr, context: this.host });
       if (userConfig && userConfig.rootRouter) {
         const _config: SwcConfigType = {
           routeType: 'element',

package/src/elements/SwcAsync.ts

@@ -0,0 +1,163 @@
+import { elementDefine } from '../decorators/elementDefine';
+import { changedAttribute } from '../decorators/changedAttribute';
+import { SwcUtils } from '../utils/Utils';
+import { FunctionUtils } from '@dooboostore/core/function/FunctionUtils';
+import { SwcLoading, SwcError, SwcSuccess, SwcDefault } from './SwcSubTemplates';
+
+@elementDefine({ name: 'swc-async', extends: 'template' })
+export class SwcAsync extends HTMLTemplateElement {
+  private _nodes: Node[] = [];
+  private _currentPromise: Promise<any> | null = null;
+  private _value: any = null;
+
+  get value(): any {
+    return this._value;
+  }
+
+  set value(nv: any) {
+    if (nv instanceof Promise) {
+      this.handlePromise(nv);
+    } else {
+      this._value = nv;
+      this.render(nv === null ? 'default' : 'success', nv);
+    }
+  }
+
+  @changedAttribute('on-get-value')
+  private refresh(newValue?: string | null) {
+    const script = newValue !== undefined ? newValue : this.getAttribute('on-get-value');
+    if (!script) {
+      this.value = null; // Triggers default render
+      return;
+    }
+    if (!this.parentElement) return;
+
+    const helperHostSet = SwcUtils.getHelperAndHostSet(window, this);
+    try {
+      const result = FunctionUtils.executeReturn({
+        script,
+        context: this,
+        args: helperHostSet
+      });
+
+      if (result instanceof Promise) {
+        this.handlePromise(result);
+      } else {
+        this.value = result;
+      }
+    } catch (e) {
+      this.render('error', e);
+    }
+  }
+
+  private async handlePromise(promise: Promise<any>) {
+    this._currentPromise = promise;
+    this.render('loading');
+
+    try {
+      const result = await promise;
+      if (this._currentPromise !== promise) return;
+      this._value = result;
+      this.render('success', result);
+    } catch (e) {
+      if (this._currentPromise !== promise) return;
+      this.render('error', e);
+    }
+  }
+
+  private render(state: 'loading' | 'error' | 'success' | 'default', data?: any) {
+    this.cleanup();
+    if (!this.parentElement) return;
+
+    let fragment: DocumentFragment;
+    const ctx: any = {
+      $nodes: [],
+      $elements: [],
+      $state: state,
+      $value: null,
+      $error: null
+    };
+
+    if (state === 'default') {
+      const t = this.content.querySelector('template[is="swc-default"]') as HTMLTemplateElement;
+      fragment = t ? (t.content.cloneNode(true) as DocumentFragment) : document.createDocumentFragment();
+    } else if (state === 'loading') {
+      const t = this.content.querySelector('template[is="swc-loading"]') as HTMLTemplateElement;
+      fragment = t ? (t.content.cloneNode(true) as DocumentFragment) : document.createDocumentFragment();
+    } else if (state === 'error') {
+      const t = this.content.querySelector('template[is="swc-error"]') as HTMLTemplateElement;
+      ctx.$error = data;
+      fragment = t ? (t.content.cloneNode(true) as DocumentFragment) : document.createDocumentFragment();
+    } else {
+      // Success
+      const t = this.content.querySelector('template[is="swc-success"]') as HTMLTemplateElement;
+      ctx.$value = data;
+      if (t) {
+        fragment = t.content.cloneNode(true) as DocumentFragment;
+      } else {
+        const clone = this.content.cloneNode(true) as DocumentFragment;
+        Array.from(clone.querySelectorAll('template[is="swc-loading"], template[is="swc-error"], template[is="swc-success"], template[is="swc-default"]')).forEach(tmp => tmp.remove());
+        fragment = clone;
+      }
+    }
+
+    this.mount(fragment, ctx);
+  }
+
+  private mount(fragment: DocumentFragment, ctx: any) {
+    const nodes = Array.from(fragment.childNodes);
+    const elements = nodes.filter(n => n.nodeType === 1) as HTMLElement[];
+
+    Object.assign(ctx, {
+      $nodes: nodes,
+      $elements: elements,
+      $firstNode: nodes[0],
+      $lastNode: nodes[nodes.length - 1],
+      $firstElement: elements[0],
+      $lastElement: elements[elements.length - 1]
+    });
+
+    // Execution Callbacks
+    this._executeCallback('on-clone-nodes', ctx);
+    nodes.forEach((node, nodeIndex) => {
+      if (node instanceof HTMLElement) {
+        (node as any).__swc_host = this;
+      }
+      this._executeCallback('on-clone-node', {
+        ...ctx,
+        $node: node,
+        $nodeIndex: nodeIndex,
+        $isElement: node.nodeType === 1
+      });
+    });
+
+    this._nodes = nodes;
+    this.parentElement?.insertBefore(fragment, this.nextSibling);
+  }
+
+  private _executeCallback(attrName: string, extraArgs: Record<string, any>) {
+    const script = this.getAttribute(attrName);
+    if (!script) return;
+    const helperHostSet = SwcUtils.getHelperAndHostSet(window, this);
+    try {
+      FunctionUtils.execute({ script, context: this, args: { ...helperHostSet, ...extraArgs } });
+    } catch (e) {
+      console.error(`[SwcAsync] Error in ${attrName}:`, e);
+    }
+  }
+
+  private cleanup() {
+    this._nodes.forEach(n => {
+      if (n.parentElement) n.parentElement.removeChild(n);
+    });
+    this._nodes = [];
+  }
+
+  connectedCallback() {
+    this.refresh();
+  }
+
+  disconnectedCallback() {
+    this.cleanup();
+  }
+}