@dooboostore/simple-web-component 1.0.39 → 1.0.40

package/src/decorators/applyNode.ts

@@ -137,8 +137,6 @@ export function applyNode(selector: string, options: ApplyNodeOptions = {positio
         return targetRoot ? targetRoot.querySelector(selector) : null;
       };
 
-
-      console.log('fffffffffff')
       const targetEl = getTarget();
       const res = original.apply(this, args);
 
@@ -177,17 +175,6 @@ export function applyNode(selector: string, options: ApplyNodeOptions = {positio
   };
 }
 
-export const findAllApplyNodeMetadata = (target: any): Map<string | symbol, ApplyNodeMetadata> => {
-  const result = new Map<string | symbol, ApplyNodeMetadata>();
-  const maps = ReflectUtils.findAllMetadata<Map<string | symbol, ApplyNodeMetadata>>(APPLY_NODE_METADATA_KEY, target);
-  maps.forEach(map => {
-    if (map instanceof Map) {
-      map.forEach((v, k) => result.set(k, v));
-    }
-  });
-  return result;
-};
-
 export function applyNodeThis(options: ApplyNodeOptions): MethodDecorator;
 export function applyNodeThis(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
 export function applyNodeThis(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
@@ -197,111 +184,135 @@ export function applyNodeThis(targetOrOptions?: any, propertyKey?: string | symb
   return applyNode('$this', {...option, ...opt});
 }
 
-export function applyNodeThisReplaceChildren(options: Omit<ApplyNodeOptions, 'position'>): MethodDecorator;
-export function applyNodeThisReplaceChildren(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
-export function applyNodeThisReplaceChildren(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
+export function replaceChildrenNodeThis(options: Omit<ApplyNodeOptions, 'position'>): MethodDecorator;
+export function replaceChildrenNodeThis(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
+export function replaceChildrenNodeThis(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
   const option: ApplyNodeOptions = {position: 'replaceChildren'};
   if (propertyKey !== undefined) return applyNode('$this', option)(targetOrOptions, propertyKey, descriptor);
   const opt = targetOrOptions || {};
   return applyNode('$this', {...opt, ...option});
 }
 
-export function applyNodeThisReplaceChildrenLightDom(options: Omit<ApplyNodeOptions, 'position' | 'root'>): MethodDecorator;
-export function applyNodeThisReplaceChildrenLightDom(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
-export function applyNodeThisReplaceChildrenLightDom(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
-  const options: ApplyNodeOptions = {position: 'replaceChildren', root: 'light'};
-  if (propertyKey !== undefined) return applyNode('$this', options)(targetOrOptions, propertyKey, descriptor);
-  const opt = targetOrOptions || {};
-  return applyNode('$this', {...opt, ...options});
-}
 
-export function applyNodeThisBeforeEnd(options: Omit<ApplyNodeOptions, 'position'>): MethodDecorator;
-export function applyNodeThisBeforeEnd(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
-export function applyNodeThisBeforeEnd(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
+
+export function beforeEndNodeThis(options: Omit<ApplyNodeOptions, 'position'>): MethodDecorator;
+export function beforeEndNodeThis(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
+export function beforeEndNodeThis(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
   const options: ApplyNodeOptions = {position: 'beforeEnd'};
   if (propertyKey !== undefined) return applyNode('$this', options)(targetOrOptions, propertyKey, descriptor);
   const opt = targetOrOptions || {};
   return applyNode('$this', {...opt, ...options});
 }
 
-export function applyNodeThisBeforeEndLightDom(options: Omit<ApplyNodeOptions, 'position' | 'root'>): MethodDecorator;
-export function applyNodeThisBeforeEndLightDom(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
-export function applyNodeThisBeforeEndLightDom(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
+export function beforeEndLightNodeThis(options: Omit<ApplyNodeOptions, 'position' | 'root'>): MethodDecorator;
+export function beforeEndLightNodeThis(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
+export function beforeEndLightNodeThis(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
   const option: ApplyNodeOptions = {position: 'beforeEnd', root: 'light'}
   if (propertyKey !== undefined) return applyNode('$this', option)(targetOrOptions, propertyKey, descriptor);
   const opt = targetOrOptions || {};
   return applyNode('$this', {...opt, ...option});
 }
-export function applyNodeThisBeforeEndShadow(options: Omit<ApplyNodeOptions, 'position' | 'root'>): MethodDecorator;
-export function applyNodeThisBeforeEndShadow(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
-export function applyNodeThisBeforeEndShadow(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
+
+export function beforeEndShadowNodeThis(options: Omit<ApplyNodeOptions, 'position' | 'root'>): MethodDecorator;
+export function beforeEndShadowNodeThis(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
+export function beforeEndShadowNodeThis(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
   const option: ApplyNodeOptions = {position: 'beforeEnd', root: 'shadow'}
   if (propertyKey !== undefined) return applyNode('$this', option)(targetOrOptions, propertyKey, descriptor);
   const opt = targetOrOptions || {};
   return applyNode('$this', {...opt, ...option});
 }
 
-export function applyNodeThisAfterBegin(options: Omit<ApplyNodeOptions, 'position'>): MethodDecorator;
-export function applyNodeThisAfterBegin(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
-export function applyNodeThisAfterBegin(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
+export function afterBeginNodeThis(options: Omit<ApplyNodeOptions, 'position'>): MethodDecorator;
+export function afterBeginNodeThis(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
+export function afterBeginNodeThis(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
   const option: ApplyNodeOptions = {position: 'afterBegin'};
   if (propertyKey !== undefined) return applyNode('$this', option)(targetOrOptions, propertyKey, descriptor);
   const opt = targetOrOptions || {};
   return applyNode('$this', {...opt, ...option});
 }
 
-export function applyNodeThisAfterBeginLightDom(options: Omit<ApplyNodeOptions, 'position' | 'root'>): MethodDecorator;
-export function applyNodeThisAfterBeginLightDom(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
-export function applyNodeThisAfterBeginLightDom(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
+export function afterBeginLightNodeThis(options: Omit<ApplyNodeOptions, 'position' | 'root'>): MethodDecorator;
+export function afterBeginLightNodeThis(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
+export function afterBeginLightNodeThis(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
   const option: ApplyNodeOptions = {position: 'afterBegin', root: 'light'}
   if (propertyKey !== undefined) return applyNode('$this', option)(targetOrOptions, propertyKey, descriptor);
   const opt = targetOrOptions || {};
   return applyNode('$this', {...opt, ...option});
 }
 
-export function applyNodeThisInnerHtml(options: Omit<ApplyNodeOptions, 'position'>): MethodDecorator;
-export function applyNodeThisInnerHtml(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
-export function applyNodeThisInnerHtml(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
+export function innerHtmlNodeThis(options: Omit<ApplyNodeOptions, 'position'>): MethodDecorator;
+export function innerHtmlNodeThis(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
+export function innerHtmlNodeThis(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
   const option: ApplyNodeOptions = {position: 'innerHtml'}
   if (propertyKey !== undefined) return applyNode('$this', option)(targetOrOptions, propertyKey, descriptor);
   const opt = targetOrOptions || {};
   return applyNode('$this', {...opt, ...option});
 }
 
-export function applyThisInnerHtmlNodeLightDom(options: Omit<ApplyNodeOptions, 'position' | 'root'>): MethodDecorator;
-export function applyThisInnerHtmlNodeLightDom(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
-export function applyThisInnerHtmlNodeLightDom(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
+export function innerTextNodeThis(options: Omit<ApplyNodeOptions, 'position'>): MethodDecorator;
+export function innerTextNodeThis(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
+export function innerTextNodeThis(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
+  const option: ApplyNodeOptions = {position: 'innerText'}
+  if (propertyKey !== undefined) return applyNode('$this', option)(targetOrOptions, propertyKey, descriptor);
+  const opt = targetOrOptions || {};
+  return applyNode('$this', {...opt, ...option});
+}
+
+export function innerHtmlLightNodeThis(options: Omit<ApplyNodeOptions, 'position' | 'root'>): MethodDecorator;
+export function innerHtmlLightNodeThis(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
+export function innerHtmlLightNodeThis(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
   const option: ApplyNodeOptions = {position: 'innerHtml', root: 'light'};
   if (propertyKey !== undefined) return applyNode('$this', option)(targetOrOptions, propertyKey, descriptor);
   const opt = targetOrOptions || {};
   return applyNode('$this', {...opt, ...option});
 }
 
-export function applyThisReplaceChildrenNodeLightDom(options: Omit<ApplyNodeOptions, 'position' | 'root'>): MethodDecorator;
-export function applyThisReplaceChildrenNodeLightDom(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
-export function applyThisReplaceChildrenNodeLightDom(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
+export function replaceChildrenLightNodeThis(options: Omit<ApplyNodeOptions, 'position' | 'root'>): MethodDecorator;
+export function replaceChildrenLightNodeThis(target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor): void;
+export function replaceChildrenLightNodeThis(targetOrOptions?: any, propertyKey?: string | symbol, descriptor?: PropertyDescriptor): any {
   const option: ApplyNodeOptions = {position: 'replaceChildren', root: 'light'};
   if (propertyKey !== undefined) return applyNode('$this', option)(targetOrOptions, propertyKey, descriptor);
   const opt = targetOrOptions || {};
   return applyNode('$this', {...opt, ...option});
 }
 
-export function applyNodeReplaceChildren(selector: string, options: Omit<ApplyNodeOptions, 'position'> = {}): MethodDecorator {
+export function replaceChildrenNode(selector: string, options: Omit<ApplyNodeOptions, 'position'> = {}): MethodDecorator {
   return applyNode(selector, {...options, position: 'replaceChildren'});
 }
 
-export function applyNodeInnerHtml(selector: string, options: Omit<ApplyNodeOptions, 'position'> = {}): MethodDecorator {
+export function innerHtmlNode(selector: string, options: Omit<ApplyNodeOptions, 'position'> = {}): MethodDecorator {
   return applyNode(selector, {...options, position: 'innerHtml'});
 }
 
-// export function applyNodeInnerHtmlLightDom(selector: string, options: Omit<ApplyNodeOptions, 'position' | 'root'> = {}): MethodDecorator {
-//   return applyNode(selector, {...options, position: 'innerHtml', root: 'light'});
-// }
+export function innerHtmlLightNode(selector: string, options: Omit<ApplyNodeOptions, 'position' | 'root'> = {}): MethodDecorator {
+  return applyNode(selector, {...options, position: 'innerHtml', root: 'light'});
+}
+
+export function innerHtmlShadowNode(selector: string, options: Omit<ApplyNodeOptions, 'position' | 'root'> = {}): MethodDecorator {
+  return applyNode(selector, {...options, position: 'innerHtml', root: 'shadow'});
+}
 
-export function applyNodeInnerText(selector: string, options: Omit<ApplyNodeOptions, 'position'> = {}): MethodDecorator {
+export function innerTextNode(selector: string, options: Omit<ApplyNodeOptions, 'position'> = {}): MethodDecorator {
   return applyNode(selector, {...options, position: 'innerText'});
 }
 
-// export function applyNodeInnerTextLightDom(selector: string, options: Omit<ApplyNodeOptions, 'position' | 'root'> = {}): MethodDecorator {
-//   return applyNode(selector, {...options, position: 'innerText', root: 'light'});
-// }
+export function innerTextLightNode(selector: string, options: Omit<ApplyNodeOptions, 'position' | 'root'> = {}): MethodDecorator {
+  return applyNode(selector, {...options, position: 'innerText', root: 'light'});
+}
+
+export function innerTextShadowNode(selector: string, options: Omit<ApplyNodeOptions, 'position' | 'root'> = {}): MethodDecorator {
+  return applyNode(selector, {...options, position: 'innerText', root: 'shadow'});
+}
+
+
+
+export const findAllApplyNodeMetadata = (target: any): Map<string | symbol, ApplyNodeMetadata> => {
+  const result = new Map<string | symbol, ApplyNodeMetadata>();
+  const maps = ReflectUtils.findAllMetadata<Map<string | symbol, ApplyNodeMetadata>>(APPLY_NODE_METADATA_KEY, target);
+  maps.forEach(map => {
+    if (map instanceof Map) {
+      map.forEach((v, k) => result.set(k, v));
+    }
+  });
+  return result;
+};

package/src/decorators/applyProperty.ts

@@ -0,0 +1,302 @@
+import { ReflectUtils } from '@dooboostore/core';
+import { ensureInit, getElementConfig } from './elementDefine';
+import { SwcUtils } from '../utils/Utils';
+import { SwcQueryOptions, HelperHostSet } from '../types';
+
+export interface PropertyOptions extends SwcQueryOptions {
+  name?: string | symbol;
+  filter?: (target: HTMLElement, value: any, meta: {currentThis: any, helper: HelperHostSet}) => boolean;
+}
+
+export interface PropertyMetadata {
+  propertyKey: string | symbol;
+  selector: string;
+  targetPropertyKey: string | symbol;
+  options: PropertyOptions;
+  type: 'property' | 'method';
+}
+
+export const PROPERTY_METADATA_KEY = Symbol.for('simple-web-component:property');
+
+// ============================================
+// Utilities
+// ============================================
+
+/**
+ * Resolve target elements based on selector and options
+ * Handles special selectors ($this, $host, etc.) and CSS selectors
+ * Returns HTMLElement[] but can include Window and Document for property access
+ */
+export const resolvePropertyTargets = (inst: any, selector: string, options: PropertyOptions): any[] => {
+  const conf = getElementConfig(inst);
+  const currentWin = conf.window;
+  const r = options.root || 'auto';
+  const results: any[] = [];
+
+  const applyRoot = (target: any) => {
+    if (!target) return;
+    if (r === 'auto') {
+      results.push(target);
+    } else {
+      if (r === 'light' || r === 'all') results.push(target);
+      if ((r === 'shadow' || r === 'all') && target.shadowRoot) results.push(target.shadowRoot);
+    }
+  };
+
+  if (selector === '$this' || !selector) {
+    applyRoot(inst);
+  } else if (selector === '$window') {
+    results.push(currentWin);
+  } else if (selector === '$document') {
+    results.push(currentWin.document);
+  } else {
+    const hostSet = SwcUtils.getHostSet(inst);
+    if (selector === '$host') applyRoot(hostSet.$host);
+    else if (selector === '$parentHost') applyRoot(hostSet.$parentHost);
+    else if (selector === '$appHost') applyRoot(hostSet.$appHost as any);
+    else if (selector === '$firstHost') applyRoot(hostSet.$firstHost);
+    else if (selector === '$lastHost') applyRoot(hostSet.$lastHost);
+    else if (selector === '$firstAppHost') applyRoot(hostSet.$firstAppHost as any);
+    else if (selector === '$lastAppHost') applyRoot(hostSet.$lastAppHost as any);
+    else if (selector === '$hosts') hostSet.$hosts.forEach(applyRoot);
+    else if (selector === '$appHosts') hostSet.$appHosts.forEach(applyRoot);
+    else {
+      if (r === 'shadow') {
+        const found = inst.shadowRoot?.querySelectorAll(selector);
+        if (found) results.push(...found);
+      } else if (r === 'light') {
+        const found = inst.querySelectorAll(selector);
+        if (found) results.push(...found);
+      } else if (r === 'all') {
+        const sMatch = inst.shadowRoot?.querySelectorAll(selector);
+        const lMatch = inst.querySelectorAll(selector);
+        if (sMatch) results.push(...sMatch);
+        if (lMatch) results.push(...lMatch);
+      } else {
+        const found = (inst.shadowRoot || inst).querySelectorAll(selector);
+        if (found) results.push(...found);
+      }
+    }
+  }
+  return results;
+};
+
+/**
+ * @applyProperty decorator - set/get element properties
+ * 
+ * Usage:
+ * - @applyProperty('selector', 'propertyName') - Set property with explicit name
+ * - @applyProperty('selector') - Use property name as target property name
+ * - @applyProperty('selector', { name: 'propertyName' }) - Set property via options
+ * - Return null/undefined to skip setting
+ */
+export function applyProperty(selector: string, targetPropertyKey: string | symbol, options?: PropertyOptions): MethodDecorator & PropertyDecorator;
+export function applyProperty(selector: string, options?: PropertyOptions): MethodDecorator & PropertyDecorator;
+export function applyProperty(selector: string, targetPropertyKeyOrOptions?: string | symbol | PropertyOptions, options?: PropertyOptions): MethodDecorator & PropertyDecorator {
+  return (target: Object, propertyKey: string | symbol, descriptor?: PropertyDescriptor) => {
+    // ensureInit(target as any);
+    
+    const constructor = target.constructor;
+    const metaType: 'property' | 'method' = descriptor && typeof descriptor.value === 'function' ? 'method' : 'property';
+    
+    // Parse arguments
+    let finalOptions: PropertyOptions = {};
+    let targetPropertyKey: string | symbol;
+    
+    if (typeof targetPropertyKeyOrOptions === 'string' || typeof targetPropertyKeyOrOptions === 'symbol') {
+      // applyProperty('selector', 'propertyName', options?)
+      targetPropertyKey = targetPropertyKeyOrOptions;
+      finalOptions = options || {};
+    } else if (targetPropertyKeyOrOptions) {
+      // applyProperty('selector', options)
+      finalOptions = targetPropertyKeyOrOptions;
+      targetPropertyKey = finalOptions.name || propertyKey;
+    } else {
+      // applyProperty('selector')
+      targetPropertyKey = propertyKey;
+    }
+
+    // Store metadata
+    let metaList = ReflectUtils.getOwnMetadata(PROPERTY_METADATA_KEY, constructor) as PropertyMetadata[];
+    if (!metaList) {
+      metaList = [];
+      ReflectUtils.defineMetadata(PROPERTY_METADATA_KEY, metaList, constructor);
+    }
+    metaList.push({
+      propertyKey,
+      selector,
+      targetPropertyKey,
+      options: finalOptions,
+      type: metaType
+    });
+
+    // Helper: apply resolved value to targets
+    const applyValueToTargets = (inst: any, resolvedValue: any) => {
+      if (resolvedValue === undefined) return resolvedValue;
+
+      const targetEls = resolvePropertyTargets(inst, selector, finalOptions);
+      const conf = getElementConfig(inst);
+      const currentWin = conf.window;
+      const hostSet = SwcUtils.getHelperAndHostSet(currentWin, inst);
+
+      targetEls.forEach(targetEl => {
+        // Apply filter if provided
+        if (finalOptions.filter && !finalOptions.filter(targetEl, resolvedValue, { currentThis: inst, helper: hostSet })) {
+          return;
+        }
+
+        const resolvedRes = typeof resolvedValue === 'function' ? (resolvedValue as any)(targetEl, hostSet) : resolvedValue;
+        (targetEl as any)[targetPropertyKey] = resolvedRes;
+      });
+
+      return resolvedValue;
+    };
+
+    // Method decorator: wrap method to apply its return value to properties
+    if (descriptor && typeof descriptor.value === 'function') {
+      const original = descriptor.value;
+      descriptor.value = function (...args: any[]) {
+        ensureInit(this);
+        const res = (original as any).apply(this, args);
+
+        if (res instanceof Promise) {
+          return res.then((v: any) => { applyValueToTargets(this, v); return v; });
+        } else {
+          applyValueToTargets(this, res);
+          return res;
+        }
+      };
+      return;
+    }
+
+    // Property decorator: define getter/setter to proxy to element properties
+    Object.defineProperty(target, propertyKey, {
+      configurable: true,
+      enumerable: true,
+      get(this: any) {
+        ensureInit(this);
+        // Read from matched elements
+        const targetEls = resolvePropertyTargets(this, selector, finalOptions);
+        const conf = getElementConfig(this);
+        const currentWin = conf.window;
+        const hostSet = SwcUtils.getHelperAndHostSet(currentWin, this);
+
+        // Apply filter
+        const filtered = targetEls.filter(el => {
+          if (finalOptions.filter && !finalOptions.filter(el, (el as any)[targetPropertyKey], { currentThis: this, helper: hostSet })) {
+            return false;
+          }
+          return true;
+        });
+
+        const values = filtered.map(el => (el as any)[targetPropertyKey]);
+        return values.length === 1 ? values[0] : values;
+      },
+      set(this: any, value: any) {
+        ensureInit(this);
+        applyValueToTargets(this, value);
+      }
+    });
+  };
+}
+
+// ============================================
+// Convenience Aliases
+// ============================================
+
+/**
+ * @property - Alias for @applyProperty
+ */
+export function property(selector: string, targetPropertyKey: string | symbol, options?: PropertyOptions): MethodDecorator & PropertyDecorator;
+export function property(selector: string, options?: PropertyOptions): MethodDecorator & PropertyDecorator;
+export function property(selector: string, targetPropertyKeyOrOptions?: string | symbol | PropertyOptions, options?: PropertyOptions): MethodDecorator & PropertyDecorator {
+  return applyProperty(selector, targetPropertyKeyOrOptions as any, options);
+}
+
+/**
+ * @propertyThis - Apply property on $this element
+ * Can be used as: @propertyThis or @propertyThis('propertyName') or @propertyThis({ name: 'propertyName' })
+ */
+export function propertyThis(target: Object, propertyKey: string | symbol): void;
+export function propertyThis(targetPropertyKey: string | symbol, options?: PropertyOptions): MethodDecorator & PropertyDecorator;
+export function propertyThis(options?: PropertyOptions): MethodDecorator & PropertyDecorator;
+export function propertyThis(targetOrOptions?: any, propertyKeyOrOptions?: any, descriptor?: PropertyDescriptor): any {
+  // Direct decorator usage: @propertyThis
+  if (typeof targetOrOptions === 'object' && targetOrOptions !== null && !Array.isArray(targetOrOptions) && 
+      (typeof propertyKeyOrOptions === 'string' || typeof propertyKeyOrOptions === 'symbol')) {
+    // Called as @propertyThis (target, propertyKey)
+    return applyProperty('$this', undefined as any, {})(targetOrOptions, propertyKeyOrOptions, descriptor);
+  }
+  
+  // Called with parameters
+  if (typeof targetOrOptions === 'string' || typeof targetOrOptions === 'symbol') {
+    // @propertyThis('propertyName', options?)
+    return applyProperty('$this', targetOrOptions, propertyKeyOrOptions);
+  } else if (targetOrOptions && typeof targetOrOptions === 'object') {
+    // @propertyThis({ name: 'propertyName' })
+    return applyProperty('$this', undefined as any, targetOrOptions);
+  } else {
+    // @propertyThis() or @propertyThis
+    return applyProperty('$this', undefined as any, {});
+  }
+}
+
+/**
+ * @setProperty - Alias for @applyProperty (method-decorator semantics)
+ */
+export function setProperty(selector: string, targetPropertyKey: string | symbol, options?: PropertyOptions): MethodDecorator;
+export function setProperty(selector: string, options?: PropertyOptions): MethodDecorator;
+export function setProperty(selector: string, targetPropertyKeyOrOptions?: string | symbol | PropertyOptions, options?: PropertyOptions): MethodDecorator {
+  return applyProperty(selector, targetPropertyKeyOrOptions as any, options) as MethodDecorator;
+}
+
+/**
+ * @setPropertyThis - Set property on $this element
+ * Can be used as: @setPropertyThis or @setPropertyThis('propertyName') or @setPropertyThis({ name: 'propertyName' })
+ */
+export function setPropertyThis(target: Object, propertyKey: string | symbol): void;
+export function setPropertyThis(targetPropertyKey: string | symbol, options?: PropertyOptions): MethodDecorator;
+export function setPropertyThis(options?: PropertyOptions): MethodDecorator;
+export function setPropertyThis(targetOrOptions?: any, propertyKeyOrOptions?: any, descriptor?: PropertyDescriptor): any {
+  // Direct decorator usage: @setPropertyThis
+  if (typeof targetOrOptions === 'object' && targetOrOptions !== null && !Array.isArray(targetOrOptions) && 
+      (typeof propertyKeyOrOptions === 'string' || typeof propertyKeyOrOptions === 'symbol')) {
+    // Called as @setPropertyThis (target, propertyKey)
+    return applyProperty('$this', undefined as any, {})(targetOrOptions, propertyKeyOrOptions, descriptor);
+  }
+  
+  // Called with parameters
+  if (typeof targetOrOptions === 'string' || typeof targetOrOptions === 'symbol') {
+    // @setPropertyThis('propertyName', options?)
+    return applyProperty('$this', targetOrOptions, propertyKeyOrOptions) as MethodDecorator;
+  } else if (targetOrOptions && typeof targetOrOptions === 'object') {
+    // @setPropertyThis({ name: 'propertyName' })
+    return applyProperty('$this', undefined as any, targetOrOptions) as MethodDecorator;
+  } else {
+    // @setPropertyThis() or @setPropertyThis
+    return applyProperty('$this', undefined as any, {}) as MethodDecorator;
+  }
+}
+
+
+
+// ============================================
+// Metadata Helpers
+// ============================================
+
+export const findAllPropertyMetadata = (target: any): PropertyMetadata[] => {
+  const actualTarget = target instanceof Function ? target : target.constructor;
+  return ReflectUtils.findAllMetadata<PropertyMetadata[]>(PROPERTY_METADATA_KEY, actualTarget).flat();
+};
+
+// Backward compatibility alias
+export const findAllPropertyApplyMetadata = (target: any): Map<string | symbol, PropertyMetadata> => {
+  const result = new Map<string | symbol, PropertyMetadata>();
+  findAllPropertyMetadata(target).forEach(meta => {
+    result.set(meta.propertyKey, meta);
+  });
+  return result;
+};
+
+
+export default applyProperty;

package/src/decorators/applySlot.ts

@@ -89,6 +89,7 @@ const applyToDom = (swcId: string, id: string, pos: ApplySlotPosition, nodes: No
     nodeSlot.clear(id);
   }
 }
+
 /**
  * @applyNode decorator to surgically add/replace nodes to a target element.
  */
@@ -96,7 +97,7 @@ export function applySlot(targetId: string, opt: OptionalType<ApplySlotOptions,
   return (targetObj: Object, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<any>) => {
 
 
-    const options: ApplySlotOptions = {position: 'replaceChildrenHtml', ...opt};
+    const options: ApplySlotOptions = {position: 'replaceChildren', ...opt};
 
 
     const constructor = targetObj.constructor;
@@ -147,7 +148,7 @@ export function applySlot(targetId: string, opt: OptionalType<ApplySlotOptions,
       if (res instanceof Promise) {
         return res.then(asyncRes => {
           const nodes = resToNodes(asyncRes)
-          fallbackNodes.forEach((it: any)=>it.remove());
+          fallbackNodes.forEach((it: any) => it.remove());
           applyToDom(swcId, targetId, options.position, nodes);
         })
       } else {
@@ -158,42 +159,48 @@ export function applySlot(targetId: string, opt: OptionalType<ApplySlotOptions,
   };
 }
 
-// export const findAllApplySlotMetadata = (target: any): Map<string | symbol, ApplySlotMetadata> => {
-export const findAllApplySlotMetadata = (target: any): ApplySlotMetadata[] => {
-  const constructor = target instanceof Function ? target : target.constructor;
-  return ReflectUtils.getMetadata(APPLY_SLOT_METADATA_KEY, constructor);
-};
-
-export function applySlotClear(targetId: string): MethodDecorator {
+export function clearSlot(targetId: string): MethodDecorator {
   return applySlot(targetId, {position: 'clear'});
 }
 
-export function applySlotPrependHtml(targetId: string): MethodDecorator {
+export function prependHtmlSlot(targetId: string): MethodDecorator {
   return applySlot(targetId, {position: 'prependHtml'});
 }
 
-export const applySlotPrepend = applySlotPrependHtml;
+export function prependSlot(targetId: string): MethodDecorator {
+  return applySlot(targetId, {position: 'prepend'});
+}
 
-export function applySlotPrependText(targetId: string): MethodDecorator {
+export function prependTextSlot(targetId: string): MethodDecorator {
   return applySlot(targetId, {position: 'prependText'});
 }
 
-export function applySlotAppendHtml(targetId: string): MethodDecorator {
+export function appendHtmlSlot(targetId: string): MethodDecorator {
   return applySlot(targetId, {position: 'appendHtml'});
 }
 
-export function applySlotAppendText(targetId: string): MethodDecorator {
+export function appendTextSlot(targetId: string): MethodDecorator {
   return applySlot(targetId, {position: 'appendText'});
 }
 
-export const applySlotAppend = applySlotAppendHtml;
+export function appendSlot(targetId: string): MethodDecorator {
+  return applySlot(targetId, {position: 'append'});
+}
 
-export function applySlotReplaceChildrenHtml(targetId: string): MethodDecorator {
+export function replaceChildrenHtmlSlot(targetId: string): MethodDecorator {
   return applySlot(targetId, {position: 'replaceChildrenHtml'});
 }
 
-export const applySlotReplaceChildren = applySlotReplaceChildrenHtml;
+export function replaceChildrenSlot(targetId: string): MethodDecorator {
+  return applySlot(targetId, {position: 'replaceChildren'});
+}
 
-export function applySlotReplaceChildrenText(targetId: string): MethodDecorator {
+export function replaceChildrenTextSlot(targetId: string): MethodDecorator {
   return applySlot(targetId, {position: 'replaceChildrenText'});
 }
+
+// export const findAllApplySlotMetadata = (target: any): Map<string | symbol, ApplySlotMetadata> => {
+export const findAllApplySlotMetadata = (target: any): ApplySlotMetadata[] => {
+  const constructor = target instanceof Function ? target : target.constructor;
+  return ReflectUtils.getMetadata(APPLY_SLOT_METADATA_KEY, constructor);
+};

package/src/decorators/changedAttributeThis.ts

@@ -2,7 +2,7 @@ import { ReflectUtils } from '@dooboostore/core';
 
 export const ON_ATTRIBUTE_CHANGED_METADATA_KEY = Symbol.for('simple-web-component:on-attribute-changed');
 
-export interface ChangedAttributeThisOptions {
+export interface ChangedAttributeThisOptions  {
   type?: typeof Number | typeof Boolean | typeof String;
   while?: 'connected';
 }