@dooboostore/simple-web-component 1.0.18 → 1.0.19

package/README.md

@@ -2,14 +2,14 @@
 
 > **"Pure, Standards-Compliant, and Blazing Fast Web Components Framework."**
 
-`simple-web-component` (SWC) is a minimalist library designed for building high-performance Web Components and Single Page Applications (SPA). It strips away heavy "magic" features like Proxy-based reactivity and continuous `MutationObserver` scans in favor of a **Pure Architecture** that stays out of your way while offering professional-grade Dependency Injection (DI) and Routing.
+`simple-web-component` (SWC) is a minimalist library designed for building high-performance Web Components and Single Page Applications (SPA). It strips away heavy "magic" features like Proxy-based reactivity and continuous `MutationObserver` scans in favor of a **Pure Architecture** that adheres strictly to browser standards.
 
 ---
 
 ## 🚀 Why SWC?
 
 - **Zero Magic**: No Proxy traps, no Virtual DOM diffing. Predictive and standard-compliant.
-- **Native Inheritance**: Inherit directly from `HTMLElement`, `HTMLDivElement`, etc.
+- **Native Inheritance**: Inherit directly from `HTMLElement`, `HTMLDivElement`, or `HTMLTemplateElement`.
 - **Extreme Performance**: Ideal for high-load UIs (1,000+ nodes) with minimal memory overhead.
 - **Micro-Frontend Ready**: Independent routing and DI containers for every component scope.
 - **Standard-First**: Works directly with native Custom Elements, Shadow DOM, and Slots.
@@ -80,23 +80,28 @@ class MyCounter extends HTMLElement {
 ```
 
 ### 4. Powerful Queries (`@query`, `@queryAll`)
-Inject internal elements directly into properties. Supports the **`:host`** selector and precise root control. Assigning `null` or `[]` to these properties will surgically remove the target elements from the DOM.
+Inject internal elements or host instances directly into properties. Assigning `null` or `[]` to these properties will surgically remove the target elements from the DOM.
 
-| Root Option | Description |
-|---|---|
-| `auto` (default) | Search in `shadowRoot` if exists, otherwise `this` (Light DOM). |
-| `shadow` | **Strictly** search in `shadowRoot`. Returns `null/[]` if no shadow. |
-| `light` | **Strictly** search in Light DOM (`this`). |
-| `all` | Search in **both** Shadow and Light DOM. |
+#### Usage with Special Targets:
+Special targets (starting with `:`) navigate the hierarchy and environment.
+```typescript
+@query(':host') self!: HTMLElement;
+@query(':parentHost') parent!: HTMLElement;
+@query(':appHost') app!: SwcAppInterface;
+@query(':window') win!: Window;
+@query(':document') doc!: Document;
+@queryAll(':hosts') ancestors!: HTMLElement[];
+```
 
+#### Usage with Selectors & Root Options:
+Standard CSS selectors support precise root control.
 ```typescript
-@query('.title') titleEl!: HTMLElement;
+// root options: 'light' | 'shadow' | 'all' | 'auto' (default)
 @query('.btn', { root: 'shadow' }) shadowBtn!: HTMLButtonElement;
-@query(':host') self!: HTMLElement; // References the component itself
 ```
 
 ### 5. Smart Event Binding (`@addEventListener`)
-Bind events declaratively with support for **Event Delegation** and special targets like `:window` and `:document`.
+Bind events declaratively with support for **Event Delegation** and special targets.
 
 ```typescript
 @elementDefine('event-demo')
@@ -106,9 +111,9 @@ class EventDemo extends HTMLElement {
   onStaticClick(event: MouseEvent) { ... }
 
   // 2. Event Delegation (Handles dynamic nodes)
-  @addEventListener('.item', 'click', { delegate: true })
+  @addEventListener('.dynamic-item', 'click', { delegate: true })
   onItemClick(event: MouseEvent, { $host }: HostSet, target: HTMLElement) {
-    console.log('Clicked dynamic item:', target.textContent);
+    console.log('Clicked in:', $host.tagName);
   }
 
   // 3. Global Events with Auto-Cleanup
@@ -123,17 +128,17 @@ Surgically replaces the children of a target element with the method's return va
 ```typescript
 @elementDefine('surgical-demo')
 class SurgicalDemo extends HTMLElement {
-  // Replaces all children of #display-area with the new content
+  // Replaces all children of #display-area with a new HTML fragment
   @replaceChildren('#display-area')
   updateView(title: string) {
-    return `<h2>${title}</h2><p>Updated successfully.</p>`;
+    return htmlFragment`<h2>${title}</h2><p>Updated successfully.</p>`;
   }
 }
 ```
 
 ### 7. `@appendChild(selector, options?)`
 Appends or inserts the method's return value relative to a target element.
-- **position**: `'lastChild'` (default), `'firstChild'`, `'nextSibling'`, `'previousSibling'`.
+- **position**: `'firstChild'`, `'lastChild'` (default), `'nextSibling'`, `'previousSibling'`.
 
 ```typescript
 @elementDefine('list-manager')
@@ -141,20 +146,37 @@ class ListManager extends HTMLElement {
   // Prepends a new item to the top of the #my-list element
   @appendChild('#my-list', { position: 'firstChild' })
   addNewItem(text: string) {
-    return `<li>${text}</li>`;
+    return htmlDivElement`<li>${text}</li>`;
   }
 }
 ```
 
+---
+
+## 🛠 Template Utilities
+
+SWC provides powerful utilities to create DOM nodes using Tagged Template Literals. These are perfect for use with surgical decorators like `@replaceChildren`.
+
+### 1. `htmlFragment` & `textNode`
+- **`htmlFragment\`...\``**: Returns a `DocumentFragment` from an HTML string.
+- **`textNode\`...\``**: Returns a pure `Text` node.
+
+### 2. Element Factories (`html***Element`)
+Specific factories for common tags like `htmlDivElement`, `htmlSpanElement`, `htmlButtonElement`, etc.
+
 ```typescript
-@elementDefine('list-manager')
-class ListManager extends HTMLElement {
-  // Prepends a new item to the top of the #my-list element
-  @appendChild('#my-list', { position: 'firstChild' })
-  addNewItem(text: string) {
-    return `<li>${text}</li>`;
-  }
-}
+import { htmlDivElement, htmlSpanElement } from '@dooboostore/simple-web-component';
+
+const el = htmlDivElement`<span>Hello ${name}</span>`; // Returns HTMLDivElement
+```
+
+### 3. `createElement(info, attributes)`
+Structured element creation.
+```typescript
+const el = createElement(
+  { tagName: 'div', innerHtml: '<b>Bold</b>' },
+  { class: 'my-class', 'data-id': '123' }
+);
 ```
 
 ---
@@ -171,6 +193,7 @@ Use the `<swc-app>` tag to create an isolated universe. Each instance has its ow
 <swc-app swc-get-application-config="myAppConfig(this)"></swc-app>
 
 <script>
+  // This function returns the configuration needed to bootstrap the SWC App
   window.myAppConfig = (host) => {
     return {
       rootRouter: RootRouter, // The entry point class (must be @Sim)
@@ -243,62 +266,75 @@ class UserDetail extends HTMLElement {
 }
 ```
 
-### 3. Lifecycle @Inject
+---
+
+## ✉️ Integrated Messaging System
+
+SWC leverages its **Special Selectors** to provide a powerful, scoped messaging system using native browser events without any external manager.
+
+### Scoped Messaging Example
+- **`:appHost`**: Communicate within the same Micro-App (Isolated scope).
+- **`:window` / `:document`**: Broadcast to the entire page (Global scope).
+- **`:parentHost`**: Send a direct message to the immediate parent host.
+- **`:firstHost` / `:firstAppHost`**: Target the absolute root component or the top-level SPA.
+
 ```typescript
-import { Inject } from '@dooboostore/simple-boot/decorators/inject/Inject';
-import { InjectSituationType, onConnected, HostSet } from '@dooboostore/simple-web-component';
+@elementDefine('message-sender')
+class Sender extends HTMLElement {
+  // Dispatches a message to the nearest parent <swc-app>
+  @emitCustomEvent(':appHost', 'user-login')
+  login() { return { id: 1, name: 'John' }; }
+}
 
-@elementDefine('profile-page')
-class ProfilePage extends HTMLElement {
-  @onConnected
-  async init(
-    @Inject({ situationType: InjectSituationType.HOST_SET }) hostSet: HostSet,
-    @Inject({ type: Router }) router: Router,
-    @Inject({ type: UserService }) api: UserService
-  ) {
-    console.log('App scope:', hostSet.$appHost);
-    const user = await api.getProfile();
-    if (!user) router.go('/login');
+@elementDefine('message-receiver')
+class Receiver extends HTMLElement {
+  // Listens for messages from the parent <swc-app>
+  @addEventListener(':appHost', 'user-login')
+  onLogin(e: CustomEvent) {
+    console.log('User logged in within my app:', e.detail.name);
   }
 }
 ```
 
 ---
 
-## 🏰 Host Hierarchy & Context
+## 🏰 Host Hierarchy & Context Hierarchy & Declarative Events
 SWC automatically traverses the DOM to provide meaningful context to your scripts and listeners:
 
 - **`$host`**: The current component Handling the event (**Self**).
 - **`$parentHost`**: The direct parent SWC component.
-- **`$appHost`**: The nearest parent `<swc-app>` (the SPA boundary).
+- **`$appHost`**: The nearest parent SPA boundary.
 - **`$hosts`**: Array of all SWC ancestors `[Root, ..., Parent, Self]`.
 
----
+### Declarative Inline Events (`swc-on-*`)
+Bind events directly in HTML. These scripts have full access to the context above and the actual element via **`$el`**.
 
-## 🛠 Lifecycle Hooks
-Executed in **Parent -> Child** order.
-- `@onBeforeConnected` / `@onAfterConnected` (alias: `@onConnected`)
-- `@onBeforeDisconnected` / `@onAfterDisconnected` (alias: `@onDisconnected`)
-- `@onBeforeAdopted` / `@onAfterAdopted` (alias: `@onAdopted`)
-- `@onAddEventListener`
+```html
+<template is="swc-loop" on-get-value="users">
+  <!-- The script can access $item, $index, $host, and $el -->
+  <button swc-on-click="console.log('Clicked:', $el); $host.deleteUser($index)">
+    Delete Item
+  </button>
+</template>
+```
 
 ---
 
 ## 🔄 Structural Directives (Advanced)
 
-SWC provides 4 core templates: `swc-loop`, `swc-if`, `swc-choose`, and `swc-async`.
+SWC provides 4 core templates that empower your HTML without wrapper elements: `swc-loop`, `swc-if`, `swc-choose`, and `swc-async`. They all share a consistent, high-performance API.
 
 ### Common Attributes:
-- **`on-get-value`**: Script to fetch data.
-- **`on-clone-nodes`**: Callback after a group of nodes is cloned.
-- **`on-clone-node`**: Callback for each individual node.
-- **`on-get-portal`**: Script that returns an `Element` or selector for portal rendering.
+- **`on-get-value`**: Script to fetch data (supports return-less expressions).
+- **`on-clone-nodes`**: Callback after a group of nodes is cloned (Args: `$index`, `$item`, `$nodes`, `$elements`, `$firstElement`, `$state`).
+- **`on-clone-node`**: Callback for each individual node (Args: `$node`, `$nodeIndex`, and all group args).
+- **`on-get-portal`**: Script that returns an `Element` or selector string to render content in a different part of the DOM.
 
 ### 1. `swc-if` (Conditional Rendering)
 ```html
 <template is="swc-if" on-get-value="isAdmin">
-  <template is="swc-default"><p>Please login.</p></template>
-  <div class="admin-panel">Welcome!</div>
+  <template is="swc-default"><p>Please login as admin.</p></template>
+  <div class="admin-panel">Welcome, Master!</div>
 </template>
 ```
 
@@ -311,31 +347,14 @@ SWC provides 4 core templates: `swc-loop`, `swc-if`, `swc-choose`, and `swc-asyn
 </template>
 ```
 
-### 3. `swc-choose` (Switch-Case Logic)
-```html
-<template is="swc-choose" on-get-value="user.role">
-  <template is="swc-default">Select a role.</template>
-  <template is="swc-when" value="admin">Admin Dashboard</template>
-  <template is="swc-otherwise">Access Denied</template>
-</template>
-```
-
-### 4. `swc-async` (Declarative Promises)
-```html
-<template is="swc-async" on-get-value="fetchData()"
-    on-clone-node="if($isElement && $node.className === 'content') $node.textContent = $value?.title || $error?.message">
-  <template is="swc-loading">🌀 Loading...</template>
-  <template is="swc-error"><div class="content"></div></template>
-  <template is="swc-success"><div class="content"></div></template>
-</template>
-```
-
 ---
 
-## ⚡ Performance
-- **Zero "Deep Scan"**: Listeners are only bound to specific selectors.
+## ⚡ Performance Features
+- **Zero "Deep Scan"**: Listeners and queries are only bound to specific selectors.
 - **Surgical Updates**: Manipulate DOM directly in `@changedAttribute` instead of full re-renders.
+- **Zero Background Overhead**: No polling, no background observers.
 - **Smart Delegation**: Host-level delegation with `__swc_handled` duplicate protection.
+- **Index-Preserving Removal**: `SwcLoop` maintains stable indices during item removal for maximum UI consistency.
 
 ---
 

package/dist/cjs/config/config.js

@@ -17,6 +17,7 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var config_exports = {};
 __export(config_exports, {
+  BROWSER_GLOBALS: () => BROWSER_GLOBALS,
   DOM_EVENT_NAMES: () => DOM_EVENT_NAMES,
   HTML_TAG_ENTRIES: () => HTML_TAG_ENTRIES
 });
@@ -81,4 +82,5 @@ const HTML_TAG_ENTRIES = [
   ["HTMLBodyElement", "body"]
 ];
 const DOM_EVENT_NAMES = ["click", "dblclick", "mousedown", "mouseenter", "mouseleave", "mousemove", "mouseout", "mouseover", "mouseup", "contextmenu", "keydown", "keypress", "keyup", "blur", "change", "focus", "focusin", "focusout", "input", "invalid", "reset", "search", "select", "submit", "drag", "dragend", "dragenter", "dragleave", "dragover", "dragstart", "drop", "copy", "cut", "paste", "abort", "canplay", "canplaythrough", "durationchange", "emptied", "ended", "error", "loadeddata", "loadedmetadata", "loadstart", "pause", "play", "playing", "progress", "ratechange", "seeked", "seeking", "stalled", "suspend", "timeupdate", "volumechange", "waiting", "scroll", "resize", "load", "unload", "hashchange", "connected"];
+const BROWSER_GLOBALS = ["window", "document", "Node", "Element", "HTMLElement", "DocumentFragment", "CustomEvent", "customElements", "NodeFilter", ...HTML_TAG_ENTRIES.map(([className]) => className)];
 //# sourceMappingURL=config.js.map

package/dist/cjs/config/config.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/config/config.ts"],
-  "sourcesContent": ["export const HTML_TAG_ENTRIES: [string, string][] = [\n  ['HTMLAnchorElement', 'a'],\n  ['HTMLAreaElement', 'area'],\n  ['HTMLAudioElement', 'audio'],\n  ['HTMLBaseElement', 'base'],\n  ['HTMLButtonElement', 'button'],\n  ['HTMLCanvasElement', 'canvas'],\n  ['HTMLDataElement', 'data'],\n  ['HTMLDataListElement', 'datalist'],\n  ['HTMLDetailsElement', 'details'],\n  ['HTMLDialogElement', 'dialog'],\n  ['HTMLDivElement', 'div'],\n  ['HTMLDListElement', 'dl'],\n  ['HTMLEmbedElement', 'embed'],\n  ['HTMLFieldSetElement', 'fieldset'],\n  ['HTMLFormElement', 'form'],\n  ['HTMLHRElement', 'hr'],\n  ['HTMLIFrameElement', 'iframe'],\n  ['HTMLImageElement', 'img'],\n  ['HTMLInputElement', 'input'],\n  ['HTMLLabelElement', 'label'],\n  ['HTMLLegendElement', 'legend'],\n  ['HTMLLIElement', 'li'],\n  ['HTMLLinkElement', 'link'],\n  ['HTMLMapElement', 'map'],\n  ['HTMLMetaElement', 'meta'],\n  ['HTMLMeterElement', 'meter'],\n  ['HTMLModElement', 'del'],\n  ['HTMLObjectElement', 'object'],\n  ['HTMLOListElement', 'ol'],\n  ['HTMLOptGroupElement', 'optgroup'],\n  ['HTMLOptionElement', 'option'],\n  ['HTMLOutputElement', 'output'],\n  ['HTMLParagraphElement', 'p'],\n  ['HTMLParamElement', 'param'],\n  ['HTMLPictureElement', 'picture'],\n  ['HTMLPreElement', 'pre'],\n  ['HTMLProgressElement', 'progress'],\n  ['HTMLQuoteElement', 'blockquote'],\n  ['HTMLScriptElement', 'script'],\n  ['HTMLSelectElement', 'select'],\n  ['HTMLSlotElement', 'slot'],\n  ['HTMLSourceElement', 'source'],\n  ['HTMLSpanElement', 'span'],\n  ['HTMLStyleElement', 'style'],\n  ['HTMLTableElement', 'table'],\n  ['HTMLTableSectionElement', 'tbody'],\n  ['HTMLTableCellElement', 'td'],\n  ['HTMLTemplateElement', 'template'],\n  ['HTMLTextAreaElement', 'textarea'],\n  ['HTMLTimeElement', 'time'],\n  ['HTMLTitleElement', 'title'],\n  ['HTMLTableRowElement', 'tr'],\n  ['HTMLTrackElement', 'track'],\n  ['HTMLUListElement', 'ul'],\n  ['HTMLVideoElement', 'video'],\n  ['HTMLHeadingElement', 'h1'],\n  ['HTMLBodyElement', 'body']\n];\n\nexport const DOM_EVENT_NAMES = ['click', 'dblclick', 'mousedown', 'mouseenter', 'mouseleave', 'mousemove', 'mouseout', 'mouseover', 'mouseup', 'contextmenu', 'keydown', 'keypress', 'keyup', 'blur', 'change', 'focus', 'focusin', 'focusout', 'input', 'invalid', 'reset', 'search', 'select', 'submit', 'drag', 'dragend', 'dragenter', 'dragleave', 'dragover', 'dragstart', 'drop', 'copy', 'cut', 'paste', 'abort', 'canplay', 'canplaythrough', 'durationchange', 'emptied', 'ended', 'error', 'loadeddata', 'loadedmetadata', 'loadstart', 'pause', 'play', 'playing', 'progress', 'ratechange', 'seeked', 'seeking', 'stalled', 'suspend', 'timeupdate', 'volumechange', 'waiting', 'scroll', 'resize', 'load', 'unload', 'hashchange', 'connected'];\n"],
-  "mappings": "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",
+  "sourcesContent": ["export const HTML_TAG_ENTRIES: [string, string][] = [\n  ['HTMLAnchorElement', 'a'],\n  ['HTMLAreaElement', 'area'],\n  ['HTMLAudioElement', 'audio'],\n  ['HTMLBaseElement', 'base'],\n  ['HTMLButtonElement', 'button'],\n  ['HTMLCanvasElement', 'canvas'],\n  ['HTMLDataElement', 'data'],\n  ['HTMLDataListElement', 'datalist'],\n  ['HTMLDetailsElement', 'details'],\n  ['HTMLDialogElement', 'dialog'],\n  ['HTMLDivElement', 'div'],\n  ['HTMLDListElement', 'dl'],\n  ['HTMLEmbedElement', 'embed'],\n  ['HTMLFieldSetElement', 'fieldset'],\n  ['HTMLFormElement', 'form'],\n  ['HTMLHRElement', 'hr'],\n  ['HTMLIFrameElement', 'iframe'],\n  ['HTMLImageElement', 'img'],\n  ['HTMLInputElement', 'input'],\n  ['HTMLLabelElement', 'label'],\n  ['HTMLLegendElement', 'legend'],\n  ['HTMLLIElement', 'li'],\n  ['HTMLLinkElement', 'link'],\n  ['HTMLMapElement', 'map'],\n  ['HTMLMetaElement', 'meta'],\n  ['HTMLMeterElement', 'meter'],\n  ['HTMLModElement', 'del'],\n  ['HTMLObjectElement', 'object'],\n  ['HTMLOListElement', 'ol'],\n  ['HTMLOptGroupElement', 'optgroup'],\n  ['HTMLOptionElement', 'option'],\n  ['HTMLOutputElement', 'output'],\n  ['HTMLParagraphElement', 'p'],\n  ['HTMLParamElement', 'param'],\n  ['HTMLPictureElement', 'picture'],\n  ['HTMLPreElement', 'pre'],\n  ['HTMLProgressElement', 'progress'],\n  ['HTMLQuoteElement', 'blockquote'],\n  ['HTMLScriptElement', 'script'],\n  ['HTMLSelectElement', 'select'],\n  ['HTMLSlotElement', 'slot'],\n  ['HTMLSourceElement', 'source'],\n  ['HTMLSpanElement', 'span'],\n  ['HTMLStyleElement', 'style'],\n  ['HTMLTableElement', 'table'],\n  ['HTMLTableSectionElement', 'tbody'],\n  ['HTMLTableCellElement', 'td'],\n  ['HTMLTemplateElement', 'template'],\n  ['HTMLTextAreaElement', 'textarea'],\n  ['HTMLTimeElement', 'time'],\n  ['HTMLTitleElement', 'title'],\n  ['HTMLTableRowElement', 'tr'],\n  ['HTMLTrackElement', 'track'],\n  ['HTMLUListElement', 'ul'],\n  ['HTMLVideoElement', 'video'],\n  ['HTMLHeadingElement', 'h1'],\n  ['HTMLBodyElement', 'body']\n];\n\nexport const DOM_EVENT_NAMES = ['click', 'dblclick', 'mousedown', 'mouseenter', 'mouseleave', 'mousemove', 'mouseout', 'mouseover', 'mouseup', 'contextmenu', 'keydown', 'keypress', 'keyup', 'blur', 'change', 'focus', 'focusin', 'focusout', 'input', 'invalid', 'reset', 'search', 'select', 'submit', 'drag', 'dragend', 'dragenter', 'dragleave', 'dragover', 'dragstart', 'drop', 'copy', 'cut', 'paste', 'abort', 'canplay', 'canplaythrough', 'durationchange', 'emptied', 'ended', 'error', 'loadeddata', 'loadedmetadata', 'loadstart', 'pause', 'play', 'playing', 'progress', 'ratechange', 'seeked', 'seeking', 'stalled', 'suspend', 'timeupdate', 'volumechange', 'waiting', 'scroll', 'resize', 'load', 'unload', 'hashchange', 'connected'];\n\nexport const BROWSER_GLOBALS = ['window', 'document', 'Node', 'Element', 'HTMLElement', 'DocumentFragment', 'CustomEvent', 'customElements', 'NodeFilter', ...HTML_TAG_ENTRIES.map(([className]) => className)];\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/cjs/decorators/addEventListener.js

@@ -24,15 +24,15 @@ __export(addEventListener_exports, {
 module.exports = __toCommonJS(addEventListener_exports);
 var import_ReflectUtils = require("@dooboostore/core/reflect/ReflectUtils");
 const ADD_EVENT_LISTENER_METADATA_KEY = Symbol("simple-web-component:add-event-listener");
-function addEventListener(selector, type, options = {}) {
-  return (target, propertyKey, descriptor) => {
-    const constructor = target.constructor;
+function addEventListener(selectorOrTarget, type, options = {}) {
+  return (targetObj, propertyKey, descriptor) => {
+    const constructor = targetObj.constructor;
     let listeners = import_ReflectUtils.ReflectUtils.getMetadata(ADD_EVENT_LISTENER_METADATA_KEY, constructor);
     if (!listeners) {
       listeners = [];
       import_ReflectUtils.ReflectUtils.defineMetadata(ADD_EVENT_LISTENER_METADATA_KEY, listeners, constructor);
     }
-    listeners.push({ selector, type, options, propertyKey });
+    listeners.push({ propertyKey, selector: selectorOrTarget, type, options });
   };
 }
 const getAddEventListenerMetadata = (target) => {

package/dist/cjs/decorators/addEventListener.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/decorators/addEventListener.ts"],
-  "sourcesContent": ["import { ReflectUtils } from '@dooboostore/core/reflect/ReflectUtils';\n\nexport interface AddEventListenerOptions extends EventListenerOptions {\n  root?: 'light' | 'shadow' | 'all' | 'auto';\n  capture?: boolean;\n  once?: boolean;\n  passive?: boolean;\n  stopPropagation?: boolean;\n  stopImmediatePropagation?: boolean;\n  preventDefault?: boolean;\n  delegate?: boolean;\n  removeOnDisconnected?: boolean;\n}\n\nexport interface AddEventListenerMetadata {\n  selector: string;\n  type: string;\n  options: AddEventListenerOptions;\n  propertyKey: string | symbol;\n}\n\nexport const ADD_EVENT_LISTENER_METADATA_KEY = Symbol('simple-web-component:add-event-listener');\n\n/**\n * @addEventListener decorator to bind events to elements.\n * Usage: @addEventListener('.btn', 'click') onClick() { ... }\n * Usage: @addEventListener('', 'scroll', { passive: true }) onScroll() { ... }\n */\nexport function addEventListener(selector: string, type: string, options: AddEventListenerOptions = {}): MethodDecorator {\n  return (target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => {\n    const constructor = target.constructor;\n\n    let listeners = ReflectUtils.getMetadata<AddEventListenerMetadata[]>(ADD_EVENT_LISTENER_METADATA_KEY, constructor);\n    if (!listeners) {\n      listeners = [];\n      ReflectUtils.defineMetadata(ADD_EVENT_LISTENER_METADATA_KEY, listeners, constructor);\n    }\n    listeners.push({ selector, type, options, propertyKey });\n  };\n}\n\nexport const getAddEventListenerMetadata = (target: any): AddEventListenerMetadata[] | undefined => {\n  const constructor = target instanceof Function ? target : target.constructor;\n  return ReflectUtils.getMetadata(ADD_EVENT_LISTENER_METADATA_KEY, constructor);\n};\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0BAA6B;AAqBtB,MAAM,kCAAkC,OAAO,yCAAyC;AAOxF,SAAS,iBAAiB,UAAkB,MAAc,UAAmC,CAAC,GAAoB;AACvH,SAAO,CAAC,QAAgB,aAA8B,eAAmC;AACvF,UAAM,cAAc,OAAO;AAE3B,QAAI,YAAY,iCAAa,YAAwC,iCAAiC,WAAW;AACjH,QAAI,CAAC,WAAW;AACd,kBAAY,CAAC;AACb,uCAAa,eAAe,iCAAiC,WAAW,WAAW;AAAA,IACrF;AACA,cAAU,KAAK,EAAE,UAAU,MAAM,SAAS,YAAY,CAAC;AAAA,EACzD;AACF;AAEO,MAAM,8BAA8B,CAAC,WAAwD;AAClG,QAAM,cAAc,kBAAkB,WAAW,SAAS,OAAO;AACjE,SAAO,iCAAa,YAAY,iCAAiC,WAAW;AAC9E;",
+  "sourcesContent": ["import { ReflectUtils } from '@dooboostore/core/reflect/ReflectUtils';\nimport { SpecialSelector, SwcQueryOptions } from '../types';\n\nexport interface AddEventListenerBaseOptions extends EventListenerOptions {\n  capture?: boolean;\n  once?: boolean;\n  passive?: boolean;\n  stopPropagation?: boolean;\n  stopImmediatePropagation?: boolean;\n  preventDefault?: boolean;\n  removeOnDisconnected?: boolean;\n  delegate?: boolean;\n}\n\nexport interface AddEventListenerMetadata {\n  propertyKey: string | symbol;\n  selector: string;\n  type: string;\n  options: AddEventListenerBaseOptions & SwcQueryOptions & { delegate?: boolean };\n}\n\nexport const ADD_EVENT_LISTENER_METADATA_KEY = Symbol('simple-web-component:add-event-listener');\n\nexport function addEventListener(target: SpecialSelector, type: string, options?: AddEventListenerBaseOptions): MethodDecorator;\nexport function addEventListener(selector: string, type: string, options?: AddEventListenerBaseOptions & SwcQueryOptions & { delegate?: boolean }): MethodDecorator;\n/**\n * @addEventListener decorator to bind events to elements.\n */\nexport function addEventListener(selectorOrTarget: string, type: string, options: any = {}): MethodDecorator {\n  return (targetObj: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => {\n    const constructor = targetObj.constructor;\n\n    let listeners = ReflectUtils.getMetadata<AddEventListenerMetadata[]>(ADD_EVENT_LISTENER_METADATA_KEY, constructor);\n    if (!listeners) {\n      listeners = [];\n      ReflectUtils.defineMetadata(ADD_EVENT_LISTENER_METADATA_KEY, listeners, constructor);\n    }\n\n    listeners.push({ propertyKey, selector: selectorOrTarget, type, options });\n  };\n}\n\nexport const getAddEventListenerMetadata = (target: any): AddEventListenerMetadata[] | undefined => {\n  const constructor = target instanceof Function ? target : target.constructor;\n  return ReflectUtils.getMetadata(ADD_EVENT_LISTENER_METADATA_KEY, constructor);\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0BAA6B;AAqBtB,MAAM,kCAAkC,OAAO,yCAAyC;AAOxF,SAAS,iBAAiB,kBAA0B,MAAc,UAAe,CAAC,GAAoB;AAC3G,SAAO,CAAC,WAAmB,aAA8B,eAAmC;AAC1F,UAAM,cAAc,UAAU;AAE9B,QAAI,YAAY,iCAAa,YAAwC,iCAAiC,WAAW;AACjH,QAAI,CAAC,WAAW;AACd,kBAAY,CAAC;AACb,uCAAa,eAAe,iCAAiC,WAAW,WAAW;AAAA,IACrF;AAEA,cAAU,KAAK,EAAE,aAAa,UAAU,kBAAkB,MAAM,QAAQ,CAAC;AAAA,EAC3E;AACF;AAEO,MAAM,8BAA8B,CAAC,WAAwD;AAClG,QAAM,cAAc,kBAAkB,WAAW,SAAS,OAAO;AACjE,SAAO,iCAAa,YAAY,iCAAiC,WAAW;AAC9E;",
   "names": []
 }

package/dist/cjs/decorators/appendChild.js

@@ -23,16 +23,60 @@ __export(appendChild_exports, {
 });
 module.exports = __toCommonJS(appendChild_exports);
 var import_ReflectUtils = require("@dooboostore/core/reflect/ReflectUtils");
+var import_elementDefine = require("./elementDefine");
 const APPEND_CHILD_METADATA_KEY = Symbol("simple-web-component:append-child");
-function appendChild(selector, options = { position: "lastChild" }) {
-  return (target, propertyKey) => {
+const normalizeNodes = (res, doc) => {
+  const items = Array.isArray(res) ? res : [res];
+  return items.map((it) => {
+    if (it instanceof Node)
+      return it;
+    return doc.createTextNode(it !== void 0 && it !== null ? String(it) : "");
+  });
+};
+function appendChild(selector, options = { position: "beforeEnd" }) {
+  return (target, propertyKey, descriptor) => {
     const constructor = target.constructor;
-    let meta = import_ReflectUtils.ReflectUtils.getOwnMetadata(APPEND_CHILD_METADATA_KEY, constructor);
-    if (!meta) {
-      meta = /* @__PURE__ */ new Map();
-      import_ReflectUtils.ReflectUtils.defineMetadata(APPEND_CHILD_METADATA_KEY, meta, constructor);
+    let metaList = import_ReflectUtils.ReflectUtils.getOwnMetadata(APPEND_CHILD_METADATA_KEY, constructor);
+    if (!metaList) {
+      metaList = /* @__PURE__ */ new Map();
+      import_ReflectUtils.ReflectUtils.defineMetadata(APPEND_CHILD_METADATA_KEY, metaList, constructor);
     }
-    meta.set(propertyKey, { propertyKey, selector, options });
+    metaList.set(propertyKey, { propertyKey, selector, options });
+    const original = descriptor.value;
+    descriptor.value = async function(...args) {
+      (0, import_elementDefine.ensureInit)(this);
+      const res = await original.apply(this, args);
+      if (res !== void 0) {
+        const conf = (0, import_elementDefine.getElementConfig)(this);
+        const currentWin = this._resolveWindow?.(conf) || (typeof window !== "undefined" ? window : void 0);
+        const currentDoc = currentWin.document;
+        let targetEl = null;
+        if (selector === ":host" || !selector) {
+          targetEl = this;
+        } else {
+          targetEl = (this.shadowRoot || this).querySelector(selector);
+        }
+        if (targetEl) {
+          const nodes = normalizeNodes(res, currentDoc);
+          const pos = options.position || "beforeEnd";
+          if (typeof res === "string") {
+            targetEl.insertAdjacentText(pos, res);
+          } else if (Array.isArray(res) && res.every((n) => typeof n === "string")) {
+            targetEl.insertAdjacentText(pos, res.join(""));
+          } else {
+            if (pos === "beforeEnd")
+              targetEl.append(...nodes);
+            else if (pos === "afterBegin")
+              targetEl.prepend(...nodes);
+            else if (pos === "beforeBegin")
+              targetEl.before(...nodes);
+            else if (pos === "afterEnd")
+              targetEl.after(...nodes);
+          }
+        }
+      }
+      return res;
+    };
   };
 }
 const findAllAppendChildMetadata = (target) => {

package/dist/cjs/decorators/appendChild.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/decorators/appendChild.ts"],
-  "sourcesContent": ["import { ReflectUtils } from '@dooboostore/core/reflect/ReflectUtils';\n\nexport type AppendChildPosition = 'firstChild' | 'lastChild' | 'nextSibling' | 'previousSibling';\n\nexport interface AppendChildOptions {\n  position?: AppendChildPosition;\n}\n\nexport interface AppendChildMetadata {\n  propertyKey: string | symbol;\n  selector: string;\n  options: AppendChildOptions;\n}\n\nexport const APPEND_CHILD_METADATA_KEY = Symbol('simple-web-component:append-child');\n\n/**\n * @appendChild decorator to surgically add nodes to a target element.\n * Usage: @appendChild('#list') addItem() { return '<li>New Item</li>'; }\n */\nexport function appendChild(selector: string, options: AppendChildOptions = { position: 'lastChild' }): MethodDecorator {\n  return (target: Object, propertyKey: string | symbol) => {\n    const constructor = target.constructor;\n    let meta = ReflectUtils.getOwnMetadata(APPEND_CHILD_METADATA_KEY, constructor) as Map<string | symbol, AppendChildMetadata>;\n    if (!meta) {\n      meta = new Map<string | symbol, AppendChildMetadata>();\n      ReflectUtils.defineMetadata(APPEND_CHILD_METADATA_KEY, meta, constructor);\n    }\n    meta.set(propertyKey, { propertyKey, selector, options });\n  };\n}\n\nexport const findAllAppendChildMetadata = (target: any): Map<string | symbol, AppendChildMetadata> => {\n  const result = new Map<string | symbol, AppendChildMetadata>();\n  const maps = ReflectUtils.findAllMetadata<Map<string | symbol, AppendChildMetadata>>(APPEND_CHILD_METADATA_KEY, target);\n  maps.forEach(map => {\n    if (map instanceof Map) {\n      map.forEach((v, k) => result.set(k, v));\n    }\n  });\n  return result;\n};\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,0BAA6B;AActB,MAAM,4BAA4B,OAAO,mCAAmC;AAM5E,SAAS,YAAY,UAAkB,UAA8B,EAAE,UAAU,YAAY,GAAoB;AACtH,SAAO,CAAC,QAAgB,gBAAiC;AACvD,UAAM,cAAc,OAAO;AAC3B,QAAI,OAAO,iCAAa,eAAe,2BAA2B,WAAW;AAC7E,QAAI,CAAC,MAAM;AACT,aAAO,oBAAI,IAA0C;AACrD,uCAAa,eAAe,2BAA2B,MAAM,WAAW;AAAA,IAC1E;AACA,SAAK,IAAI,aAAa,EAAE,aAAa,UAAU,QAAQ,CAAC;AAAA,EAC1D;AACF;AAEO,MAAM,6BAA6B,CAAC,WAA2D;AACpG,QAAM,SAAS,oBAAI,IAA0C;AAC7D,QAAM,OAAO,iCAAa,gBAA2D,2BAA2B,MAAM;AACtH,OAAK,QAAQ,SAAO;AAClB,QAAI,eAAe,KAAK;AACtB,UAAI,QAAQ,CAAC,GAAG,MAAM,OAAO,IAAI,GAAG,CAAC,CAAC;AAAA,IACxC;AAAA,EACF,CAAC;AACD,SAAO;AACT;",
+  "sourcesContent": ["import { ReflectUtils } from '@dooboostore/core/reflect/ReflectUtils';\nimport { ensureInit, getElementConfig } from './elementDefine';\n\nexport type AppendChildPosition = 'beforeBegin' | 'afterBegin' | 'beforeEnd' | 'afterEnd';\n\nexport interface AppendChildOptions {\n  position?: AppendChildPosition;\n}\n\nexport interface AppendChildMetadata {\n  propertyKey: string | symbol;\n  selector: string;\n  options: AppendChildOptions;\n}\n\nexport const APPEND_CHILD_METADATA_KEY = Symbol('simple-web-component:append-child');\n\nconst normalizeNodes = (res: any, doc: Document): Node[] => {\n  const items = Array.isArray(res) ? res : [res];\n  return items.map(it => {\n    if (it instanceof Node) return it;\n    return doc.createTextNode(it !== undefined && it !== null ? String(it) : '');\n  });\n};\n\n/**\n * @appendChild decorator to surgically add nodes to a target element.\n * Usage: @appendChild('#list') addItem() { return '<li>New Item</li>'; }\n */\nexport function appendChild(selector: string, options: AppendChildOptions = { position: 'beforeEnd' }): MethodDecorator {\n  return (target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => {\n    const constructor = target.constructor;\n    let metaList = ReflectUtils.getOwnMetadata(APPEND_CHILD_METADATA_KEY, constructor) as Map<string | symbol, AppendChildMetadata>;\n    if (!metaList) {\n      metaList = new Map<string | symbol, AppendChildMetadata>();\n      ReflectUtils.defineMetadata(APPEND_CHILD_METADATA_KEY, metaList, constructor);\n    }\n    metaList.set(propertyKey, { propertyKey, selector, options });\n\n    const original = descriptor.value;\n    descriptor.value = async function (...args: any[]) {\n      ensureInit(this);\n      const res = await original.apply(this, args);\n      if (res !== undefined) {\n        const conf = getElementConfig(this);\n        const currentWin = (this as any)._resolveWindow?.(conf) || ((typeof window !== 'undefined' ? window : undefined) as Window);\n        const currentDoc = currentWin.document;\n\n        let targetEl: HTMLElement | null = null;\n        if (selector === ':host' || !selector) {\n          targetEl = this as any;\n        } else {\n          targetEl = (this.shadowRoot || (this as any)).querySelector(selector);\n        }\n\n        if (targetEl) {\n          const nodes = normalizeNodes(res, currentDoc);\n          const pos = options.position || 'beforeEnd';\n\n          if (typeof res === 'string') {\n            targetEl.insertAdjacentText(pos as InsertPosition, res);\n          } else if (Array.isArray(res) && res.every(n => typeof n === 'string')) {\n            targetEl.insertAdjacentText(pos as InsertPosition, res.join(''));\n          } else {\n            if (pos === 'beforeEnd') targetEl.append(...nodes);\n            else if (pos === 'afterBegin') targetEl.prepend(...nodes);\n            else if (pos === 'beforeBegin') targetEl.before(...nodes);\n            else if (pos === 'afterEnd') targetEl.after(...nodes);\n          }\n        }\n      }\n      return res;\n    };\n  };\n}\n\nexport const findAllAppendChildMetadata = (target: any): Map<string | symbol, AppendChildMetadata> => {\n  const result = new Map<string | symbol, AppendChildMetadata>();\n  const maps = ReflectUtils.findAllMetadata<Map<string | symbol, AppendChildMetadata>>(APPEND_CHILD_METADATA_KEY, target);\n  maps.forEach(map => {\n    if (map instanceof Map) {\n      map.forEach((v, k) => result.set(k, v));\n    }\n  });\n  return result;\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;;;;;;;0BAA6B;AAC7B,2BAA6C;AActC,MAAM,4BAA4B,OAAO,mCAAmC;AAEnF,MAAM,iBAAiB,CAAC,KAAU,QAAyB;AACzD,QAAM,QAAQ,MAAM,QAAQ,GAAG,IAAI,MAAM,CAAC,GAAG;AAC7C,SAAO,MAAM,IAAI,QAAK;AACpB,QAAI,cAAc;AAAM,aAAO;AAC/B,WAAO,IAAI,eAAe,OAAO,UAAa,OAAO,OAAO,OAAO,EAAE,IAAI,EAAE;EAC7E,CAAC;AACH;AAMM,SAAU,YAAY,UAAkB,UAA8B,EAAE,UAAU,YAAW,GAAE;AACnG,SAAO,CAAC,QAAgB,aAA8B,eAAkC;AACtF,UAAM,cAAc,OAAO;AAC3B,QAAI,WAAW,iCAAa,eAAe,2BAA2B,WAAW;AACjF,QAAI,CAAC,UAAU;AACb,iBAAW,oBAAI,IAAG;AAClB,uCAAa,eAAe,2BAA2B,UAAU,WAAW;IAC9E;AACA,aAAS,IAAI,aAAa,EAAE,aAAa,UAAU,QAAO,CAAE;AAE5D,UAAM,WAAW,WAAW;AAC5B,eAAW,QAAQ,kBAAmB,MAAW;AAC/C,2CAAW,IAAI;AACf,YAAM,MAAM,MAAM,SAAS,MAAM,MAAM,IAAI;AAC3C,UAAI,QAAQ,QAAW;AACrB,cAAM,WAAO,uCAAiB,IAAI;AAClC,cAAM,aAAc,KAAa,iBAAiB,IAAI,MAAO,OAAO,WAAW,cAAc,SAAS;AACtG,cAAM,aAAa,WAAW;AAE9B,YAAI,WAA+B;AACnC,YAAI,aAAa,WAAW,CAAC,UAAU;AACrC,qBAAW;QACb,OAAO;AACL,sBAAY,KAAK,cAAe,MAAc,cAAc,QAAQ;QACtE;AAEA,YAAI,UAAU;AACZ,gBAAM,QAAQ,eAAe,KAAK,UAAU;AAC5C,gBAAM,MAAM,QAAQ,YAAY;AAEhC,cAAI,OAAO,QAAQ,UAAU;AAC3B,qBAAS,mBAAmB,KAAuB,GAAG;UACxD,WAAW,MAAM,QAAQ,GAAG,KAAK,IAAI,MAAM,OAAK,OAAO,MAAM,QAAQ,GAAG;AACtE,qBAAS,mBAAmB,KAAuB,IAAI,KAAK,EAAE,CAAC;UACjE,OAAO;AACL,gBAAI,QAAQ;AAAa,uBAAS,OAAO,GAAG,KAAK;qBACxC,QAAQ;AAAc,uBAAS,QAAQ,GAAG,KAAK;qBAC/C,QAAQ;AAAe,uBAAS,OAAO,GAAG,KAAK;qBAC/C,QAAQ;AAAY,uBAAS,MAAM,GAAG,KAAK;UACtD;QACF;MACF;AACA,aAAO;IACT;EACF;AACF;AAEO,MAAM,6BAA6B,CAAC,WAA0D;AACnG,QAAM,SAAS,oBAAI,IAAG;AACtB,QAAM,OAAO,iCAAa,gBAA2D,2BAA2B,MAAM;AACtH,OAAK,QAAQ,SAAM;AACjB,QAAI,eAAe,KAAK;AACtB,UAAI,QAAQ,CAAC,GAAG,MAAM,OAAO,IAAI,GAAG,CAAC,CAAC;IACxC;EACF,CAAC;AACD,SAAO;AACT;",
   "names": []
 }

package/dist/cjs/decorators/classList.js

@@ -0,0 +1,104 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var classList_exports = {};
+__export(classList_exports, {
+  CLASS_LIST_METADATA_KEY: () => CLASS_LIST_METADATA_KEY,
+  addClassList: () => addClassList,
+  findAllClassListMetadata: () => findAllClassListMetadata,
+  removeClassList: () => removeClassList,
+  setClassList: () => setClassList,
+  toggleClassList: () => toggleClassList,
+  updateClassList: () => updateClassList
+});
+module.exports = __toCommonJS(classList_exports);
+var import_ReflectUtils = require("@dooboostore/core/reflect/ReflectUtils");
+var import_elementDefine = require("./elementDefine");
+var import_Utils = require("../utils/Utils");
+const CLASS_LIST_METADATA_KEY = Symbol("simple-web-component:class-list");
+function createClassListDecorator(action) {
+  return (selector) => {
+    return (target, propertyKey, descriptor) => {
+      const constructor = target.constructor;
+      let metaList = import_ReflectUtils.ReflectUtils.getOwnMetadata(CLASS_LIST_METADATA_KEY, constructor);
+      if (!metaList) {
+        metaList = /* @__PURE__ */ new Map();
+        import_ReflectUtils.ReflectUtils.defineMetadata(CLASS_LIST_METADATA_KEY, metaList, constructor);
+      }
+      metaList.set(propertyKey, { propertyKey, selector, action });
+      const original = descriptor.value;
+      descriptor.value = async function(...args) {
+        (0, import_elementDefine.ensureInit)(this);
+        const res = await original.apply(this, args);
+        if (res !== void 0) {
+          const hostSet = import_Utils.SwcUtils.getHostSet(this);
+          let targetEl = null;
+          if (selector === ":host" || !selector) targetEl = this;
+          else if (selector === ":parentHost") targetEl = hostSet.$parentHost;
+          else if (selector === ":appHost") targetEl = hostSet.$appHost;
+          else targetEl = (this.shadowRoot || this).querySelector(selector);
+          if (targetEl) {
+            if (action === "set") {
+              let classes = "";
+              if (typeof res === "object" && res !== null && !Array.isArray(res)) {
+                classes = Object.entries(res).filter(([_, force]) => !!force).map(([cls]) => cls).join(" ");
+              } else {
+                classes = Array.isArray(res) ? res.join(" ") : String(res);
+              }
+              targetEl.className = classes;
+            } else if (action === "update") {
+              if (typeof res === "object" && res !== null && !Array.isArray(res)) {
+                Object.entries(res).forEach(([cls, force]) => {
+                  targetEl.classList.toggle(cls, !!force);
+                });
+              } else if (res !== void 0 && res !== null) {
+                const classes = Array.isArray(res) ? res.map(String) : [String(res)];
+                targetEl.classList.add(...classes);
+              }
+            } else if (action === "add") {
+              const classes = Array.isArray(res) ? res.map(String) : [String(res)];
+              targetEl.classList.add(...classes);
+            } else if (action === "remove") {
+              const classes = Array.isArray(res) ? res.map(String) : [String(res)];
+              targetEl.classList.remove(...classes);
+            } else if (action === "toggle") {
+              const classes = Array.isArray(res) ? res.map(String) : [String(res)];
+              classes.forEach((c) => targetEl.classList.toggle(c));
+            }
+          }
+        }
+        return res;
+      };
+    };
+  };
+}
+const setClassList = createClassListDecorator("set");
+const updateClassList = createClassListDecorator("update");
+const addClassList = createClassListDecorator("add");
+const removeClassList = createClassListDecorator("remove");
+const toggleClassList = createClassListDecorator("toggle");
+const findAllClassListMetadata = (target) => {
+  const result = /* @__PURE__ */ new Map();
+  const maps = import_ReflectUtils.ReflectUtils.findAllMetadata(CLASS_LIST_METADATA_KEY, target);
+  maps.forEach((map) => {
+    if (map instanceof Map) {
+      map.forEach((v, k) => result.set(k, v));
+    }
+  });
+  return result;
+};
+//# sourceMappingURL=classList.js.map

package/dist/cjs/decorators/classList.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/decorators/classList.ts"],
+  "sourcesContent": ["import { ReflectUtils } from '@dooboostore/core/reflect/ReflectUtils';\nimport { ensureInit } from './elementDefine';\nimport { SwcUtils } from '../utils/Utils';\n\nexport const CLASS_LIST_METADATA_KEY = Symbol('simple-web-component:class-list');\n\nexport type ClassListAction = 'set' | 'update' | 'add' | 'remove' | 'toggle';\n\nexport interface ClassListMetadata {\n  propertyKey: string | symbol;\n  selector: string;\n  action: ClassListAction;\n}\n\nfunction createClassListDecorator(action: ClassListAction) {\n  return (selector: string): MethodDecorator => {\n    return (target: Object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => {\n      const constructor = target.constructor;\n      let metaList = ReflectUtils.getOwnMetadata(CLASS_LIST_METADATA_KEY, constructor) as Map<string | symbol, ClassListMetadata>;\n      if (!metaList) {\n        metaList = new Map<string | symbol, ClassListMetadata>();\n        ReflectUtils.defineMetadata(CLASS_LIST_METADATA_KEY, metaList, constructor);\n      }\n      metaList.set(propertyKey, { propertyKey, selector, action });\n\n      const original = descriptor.value;\n      descriptor.value = async function (...args: any[]) {\n        ensureInit(this);\n        const res = await original.apply(this, args);\n        if (res !== undefined) {\n          const hostSet = SwcUtils.getHostSet(this as any);\n\n          let targetEl: HTMLElement | null = null;\n          if (selector === ':host' || !selector) targetEl = this as any;\n          else if (selector === ':parentHost') targetEl = hostSet.$parentHost;\n          else if (selector === ':appHost') targetEl = hostSet.$appHost;\n          else targetEl = (this.shadowRoot || (this as any)).querySelector(selector);\n\n          if (targetEl) {\n            if (action === 'set') {\n              let classes = '';\n              if (typeof res === 'object' && res !== null && !Array.isArray(res)) {\n                classes = Object.entries(res)\n                  .filter(([_, force]) => !!force)\n                  .map(([cls]) => cls)\n                  .join(' ');\n              } else {\n                classes = Array.isArray(res) ? res.join(' ') : String(res);\n              }\n              targetEl.className = classes;\n            } else if (action === 'update') {\n              if (typeof res === 'object' && res !== null && !Array.isArray(res)) {\n                Object.entries(res).forEach(([cls, force]) => {\n                  targetEl!.classList.toggle(cls, !!force);\n                });\n              } else if (res !== undefined && res !== null) {\n                const classes = Array.isArray(res) ? res.map(String) : [String(res)];\n                targetEl.classList.add(...classes);\n              }\n            } else if (action === 'add') {\n              const classes = Array.isArray(res) ? res.map(String) : [String(res)];\n              targetEl.classList.add(...classes);\n            } else if (action === 'remove') {\n              const classes = Array.isArray(res) ? res.map(String) : [String(res)];\n              targetEl.classList.remove(...classes);\n            } else if (action === 'toggle') {\n              const classes = Array.isArray(res) ? res.map(String) : [String(res)];\n              classes.forEach(c => targetEl!.classList.toggle(c));\n            }\n          }\n        }\n        return res;\n      };\n    };\n  };\n}\n\n/**\n * @setClassList decorator to surgically replace all classes on a target element.\n * Returns: string | string[]\n */\nexport const setClassList = createClassListDecorator('set');\n\n/**\n * @updateClassList decorator to surgically update specific classes.\n * Returns: Record<string, boolean> (toggle with force) | string | string[] (add)\n */\nexport const updateClassList = createClassListDecorator('update');\n\n/**\n * @addClassList decorator to surgically add classes to a target element.\n * Returns: string | string[]\n */\nexport const addClassList = createClassListDecorator('add');\n\n/**\n * @removeClassList decorator to surgically remove classes from a target element.\n * Returns: string | string[]\n */\nexport const removeClassList = createClassListDecorator('remove');\n\n/**\n * @toggleClassList decorator to surgically toggle classes on a target element.\n * Returns: string | string[]\n */\nexport const toggleClassList = createClassListDecorator('toggle');\n\nexport const findAllClassListMetadata = (target: any): Map<string | symbol, ClassListMetadata> => {\n  const result = new Map<string | symbol, ClassListMetadata>();\n  const maps = ReflectUtils.findAllMetadata<Map<string | symbol, ClassListMetadata>>(CLASS_LIST_METADATA_KEY, target);\n  maps.forEach(map => {\n    if (map instanceof Map) {\n      map.forEach((v, k) => result.set(k, v));\n    }\n  });\n  return result;\n};\n"],
+  "mappings": "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",
+  "names": []
+}