@dooboostore/simple-web-component 1.0.17 → 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.
@@ -42,13 +42,13 @@ Registers the class as a custom element.
 | `observedAttributes` | `string[]` | (Optional) Extra attributes to observe. |
 | `window` | `Window` | (Optional) Custom window object (useful for SSR). |
 
-### 2. `@innerHtml(options?)`
-Defines the template for the component.
+### 2. `@onConnectedInnerHtml(options?)`
+Defines the template for the component. Executed when the component is connected to the DOM.
 
 ```typescript
 @elementDefine('my-el')
 class MyEl extends HTMLElement {
-  @innerHtml({ useShadow: true })
+  @onConnectedInnerHtml({ useShadow: true })
   render() {
     return `<style>:host { color: blue; }</style><div>Hello World</div>`;
   }
@@ -80,33 +80,28 @@ class MyCounter extends HTMLElement {
 ```
 
 ### 4. Powerful Queries (`@query`, `@queryAll`)
-Inject internal elements directly into properties. Supports the **`:host`** selector.
+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. |
-
-Inject elements directly into properties. Supports `:host` and scoped root control.
+#### 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
-@elementDefine('query-demo')
-class QueryDemo extends HTMLElement {
-  @query('.title') titleEl!: HTMLElement;
-  @queryAll('.items') list!: NodeListOf<HTMLElement>;
-  
-  // Reference the component itself
-  @query(':host') self!: HTMLElement;
-
-  // Root options: 'light' | 'shadow' | 'all' | 'auto' (default)
-  @query('.btn', { root: 'shadow' }) shadowBtn!: HTMLButtonElement;
-}
+// root options: 'light' | 'shadow' | 'all' | 'auto' (default)
+@query('.btn', { root: 'shadow' }) shadowBtn!: HTMLButtonElement;
 ```
 
 ### 5. Smart Event Binding (`@addEventListener`)
-Bind events declaratively with support for **Event Delegation**.
+Bind events declaratively with support for **Event Delegation** and special targets.
 
 ```typescript
 @elementDefine('event-demo')
@@ -115,22 +110,83 @@ class EventDemo extends HTMLElement {
   @addEventListener('.static-btn', 'click')
   onStaticClick(event: MouseEvent) { ... }
 
-  // 2. Event Delegation (Works for dynamic nodes added LATER)
-  @addEventListener('.item', 'click', { delegate: true })
+  // 2. Event Delegation (Handles dynamic nodes)
+  @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
+  @addEventListener(':window', 'resize', { removeOnDisconnected: true })
+  onResize() { ... }
+}
+```
+
+### 6. `@replaceChildren(selector)`
+Surgically replaces the children of a target element with the method's return value (`string`, `Node`, or `Array<Node|string>`).
+
+```typescript
+@elementDefine('surgical-demo')
+class SurgicalDemo extends HTMLElement {
+  // Replaces all children of #display-area with a new HTML fragment
+  @replaceChildren('#display-area')
+  updateView(title: string) {
+    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**: `'firstChild'`, `'lastChild'` (default), `'nextSibling'`, `'previousSibling'`.
+
+```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 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
+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' }
+);
+```
+
+---
+
 ## 🌐 Powerful SPA & Routing
 
 SWC provides a revolutionary way to build SPAs where **each component scope is an independent application**.
 
 ### 1. Isolated App Scopes (Micro-Frontends)
-Use the `<swc-app>` tag to create an isolated universe. Each instance has its own **DI Container** and **Router**. You can run multiple independent SPAs on a single page without URL conflicts.
+Use the `<swc-app>` tag to create an isolated universe. Each instance has its own **DI Container** and **Router**.
 
 ```html
 <!-- index.html -->
@@ -147,35 +203,24 @@ Use the `<swc-app>` tag to create an isolated universe. Each instance has its ow
     };
   };
 
-  // 4. External Control (Anywhere in your JS)
+  // External Control
   function navigateFromOutside() {
       const app = document.querySelector('swc-app');
-      // Programmatically trigger routing from outside the component
       app.routing('/users/detail/2'); 
   }
 </script>
-
-<button onclick="navigateFromOutside()">External Link to User 2</button>
 ```
 
 ### 2. DI-Powered Routing
-Define routes using decorators. Components are automatically instantiated and managed by the DI container.
-
 ```typescript
-import { Router } from '@dooboostore/simple-boot/decorators/route/Router';
-import { Sim } from '@dooboostore/simple-boot/decorators/SimDecorator';
-
 @Sim
 @Router({
   path: '/users',
-  route: {
-    '/list': UserList,
-    '/detail/:id': UserDetail
-  }
+  route: { '/list': UserList, '/detail/:id': UserDetail }
 })
 @elementDefine('user-router')
 class UserRouter extends HTMLElement implements RouterAction.CanActivate {
-  @innerHtml({ useShadow: true })
+  @onConnectedInnerHtml({ useShadow: true })
   render() { 
     return `<header>User System</header><main><slot></slot></main>`; 
   }
@@ -185,21 +230,17 @@ class UserRouter extends HTMLElement implements RouterAction.CanActivate {
   }
 }
 
-// Pure Service (Business Logic)
 @Sim
 class UserService {
-  async getProfile(id: string) {
-    return { id, name: 'Standard User' };
-  }
+  async getProfile(id: string) { return { id, name: 'Standard User' }; }
 }
 
-// Example Page Components
 @Sim
 @elementDefine('user-list')
 class UserList extends HTMLElement {
   constructor(private router: Router, private userService: UserService) { super(); }
 
-  @innerHtml
+  @onConnectedInnerHtml
   render() { 
     return `
       <ul><li>User A</li><li>User B</li></ul>
@@ -220,63 +261,62 @@ class UserDetail extends HTMLElement {
      console.log('Viewing User:', profile.name);
   }
 
-  @innerHtml
+  @onConnectedInnerHtml
   render() { return `<div>User Detail View <button swc-on-click="$host.router.back()">Back</button></div>`; }
 }
 ```
 
-### 3. Lifecycle @Inject
-Inject services or component context directly into lifecycle methods. This is the ultimate way to handle side effects cleanly.
+---
 
-```typescript
-import { Inject } from '@dooboostore/simple-boot/decorators/inject/Inject';
-import { InjectSituationType, onConnected, HostSet } from '@dooboostore/simple-web-component';
-import { Router } from '@dooboostore/core-web/routers/Router';
+## ✉️ Integrated Messaging System
 
-@elementDefine('profile-page')
-class ProfilePage extends HTMLElement {
+SWC leverages its **Special Selectors** to provide a powerful, scoped messaging system using native browser events without any external manager.
 
-  @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();
-    // Navigate programmatically using injected router
-    if (!user) router.go('/login');
+### 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
+@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('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]`.
 
----
-
-## 🛠 Lifecycle Hooks
-Executed in **Parent -> Child** order.
-- `@onBeforeConnected` / `@onAfterConnected` (alias: `@onConnected`)
-- `@onBeforeDisconnected` / `@onAfterDisconnected` (alias: `@onDisconnected`)
-- `@onBeforeAdopted` / `@onAfterAdopted` (alias: `@onAdopted`)
-- `@onAddEventListener`
-
----
+### 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`**.
 
-## ⚡ Performance
-- **Zero "Deep Scan"**: Listeners 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.
-
----
+```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>
+```
 
 ---
 
@@ -291,7 +331,6 @@ SWC provides 4 core templates that empower your HTML without wrapper elements: `
 - **`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)
-Renders content only when the condition is truthy. Supports a fallback `swc-default` state.
 ```html
 <template is="swc-if" on-get-value="isAdmin">
   <template is="swc-default"><p>Please login as admin.</p></template>
@@ -300,7 +339,6 @@ Renders content only when the condition is truthy. Supports a fallback `swc-defa
 ```
 
 ### 2. `swc-loop` (High-Performance Iteration)
-Efficiently renders lists with surgical updates and index preservation.
 ```html
 <template is="swc-loop" on-get-value="users" 
     on-clone-node="if($isElement) $node.querySelector('.name').textContent = $item.name">
@@ -309,63 +347,12 @@ Efficiently renders lists with surgical updates and index preservation.
 </template>
 ```
 
-### 3. `swc-choose` (Switch-Case Logic)
-Selects the first matching `swc-when` or falls back to `swc-otherwise`.
-```html
-<template is="swc-choose" on-get-value="user.role">
-  <template is="swc-default">Please select a role.</template>
-  <template is="swc-when" value="admin">Admin Dashboard</template>
-  <template is="swc-when" value="user">User Home</template>
-  <template is="swc-otherwise">Access Denied</template>
-</template>
-```
-
-### 4. `swc-async` (Declarative Promises)
-Handles Promise states (Loading, Error, Success) without manual state management.
-```html
-<template is="swc-async" on-get-value="fetchData()">
-  <template is="swc-loading">🌀 Loading...</template>
-  <template is="swc-error">❌ Error: {{$error.message}}</template>
-  <template is="swc-success">✅ Data: {{$value.title}}</template>
-</template>
-```
-
-### Advanced: Integrated Portal Support
-All directives above support the **`on-get-portal`** attribute to render content elsewhere.
-```html
-<template is="swc-if" on-get-value="showModal" on-get-portal="'body'">
-  <div class="modal-overlay">I am rendered at the end of &lt;body&gt;!</div>
-</template>
-```
-
 ---
 
-## ⚡ Integrated Event & Query Selectors
-
-Both `@addEventListener` and `@query` support special selectors to navigate the environment and component hierarchy seamlessly.
-
-| Selector | Target Description |
-|---|---|
-| `:host` | The component itself (default for empty selector). |
-| `:parentHost` | The immediate parent SWC component. |
-| `:appHost` | The nearest parent `<swc-app>` instance. |
-| `:window` | The environment-aware global `window` object. |
-| `:document` | The environment-aware global `document` object. |
-| `:hosts` | Array of all SWC ancestors (Root -> Self). |
-
-### Global Event Example
-```typescript
-@elementDefine('auto-cleanup-demo')
-class CleanupDemo extends HTMLElement {
-  // Automatically attaches to window and REMOVES on disconnectedCallback
-  @addEventListener(':window', 'resize', { removeOnDisconnected: true })
-  onResize(event: UIEvent) {
-    console.log('Window resized!', this.id);
-  }
-}
-```
-
 ## ⚡ 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": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,MAAM,mBAAuC;AAAA,EAClD,CAAC,qBAAqB,GAAG;AAAA,EACzB,CAAC,mBAAmB,MAAM;AAAA,EAC1B,CAAC,oBAAoB,OAAO;AAAA,EAC5B,CAAC,mBAAmB,MAAM;AAAA,EAC1B,CAAC,qBAAqB,QAAQ;AAAA,EAC9B,CAAC,qBAAqB,QAAQ;AAAA,EAC9B,CAAC,mBAAmB,MAAM;AAAA,EAC1B,CAAC,uBAAuB,UAAU;AAAA,EAClC,CAAC,sBAAsB,SAAS;AAAA,EAChC,CAAC,qBAAqB,QAAQ;AAAA,EAC9B,CAAC,kBAAkB,KAAK;AAAA,EACxB,CAAC,oBAAoB,IAAI;AAAA,EACzB,CAAC,oBAAoB,OAAO;AAAA,EAC5B,CAAC,uBAAuB,UAAU;AAAA,EAClC,CAAC,mBAAmB,MAAM;AAAA,EAC1B,CAAC,iBAAiB,IAAI;AAAA,EACtB,CAAC,qBAAqB,QAAQ;AAAA,EAC9B,CAAC,oBAAoB,KAAK;AAAA,EAC1B,CAAC,oBAAoB,OAAO;AAAA,EAC5B,CAAC,oBAAoB,OAAO;AAAA,EAC5B,CAAC,qBAAqB,QAAQ;AAAA,EAC9B,CAAC,iBAAiB,IAAI;AAAA,EACtB,CAAC,mBAAmB,MAAM;AAAA,EAC1B,CAAC,kBAAkB,KAAK;AAAA,EACxB,CAAC,mBAAmB,MAAM;AAAA,EAC1B,CAAC,oBAAoB,OAAO;AAAA,EAC5B,CAAC,kBAAkB,KAAK;AAAA,EACxB,CAAC,qBAAqB,QAAQ;AAAA,EAC9B,CAAC,oBAAoB,IAAI;AAAA,EACzB,CAAC,uBAAuB,UAAU;AAAA,EAClC,CAAC,qBAAqB,QAAQ;AAAA,EAC9B,CAAC,qBAAqB,QAAQ;AAAA,EAC9B,CAAC,wBAAwB,GAAG;AAAA,EAC5B,CAAC,oBAAoB,OAAO;AAAA,EAC5B,CAAC,sBAAsB,SAAS;AAAA,EAChC,CAAC,kBAAkB,KAAK;AAAA,EACxB,CAAC,uBAAuB,UAAU;AAAA,EAClC,CAAC,oBAAoB,YAAY;AAAA,EACjC,CAAC,qBAAqB,QAAQ;AAAA,EAC9B,CAAC,qBAAqB,QAAQ;AAAA,EAC9B,CAAC,mBAAmB,MAAM;AAAA,EAC1B,CAAC,qBAAqB,QAAQ;AAAA,EAC9B,CAAC,mBAAmB,MAAM;AAAA,EAC1B,CAAC,oBAAoB,OAAO;AAAA,EAC5B,CAAC,oBAAoB,OAAO;AAAA,EAC5B,CAAC,2BAA2B,OAAO;AAAA,EACnC,CAAC,wBAAwB,IAAI;AAAA,EAC7B,CAAC,uBAAuB,UAAU;AAAA,EAClC,CAAC,uBAAuB,UAAU;AAAA,EAClC,CAAC,mBAAmB,MAAM;AAAA,EAC1B,CAAC,oBAAoB,OAAO;AAAA,EAC5B,CAAC,uBAAuB,IAAI;AAAA,EAC5B,CAAC,oBAAoB,OAAO;AAAA,EAC5B,CAAC,oBAAoB,IAAI;AAAA,EACzB,CAAC,oBAAoB,OAAO;AAAA,EAC5B,CAAC,sBAAsB,IAAI;AAAA,EAC3B,CAAC,mBAAmB,MAAM;AAC5B;AAEO,MAAM,kBAAkB,CAAC,SAAS,YAAY,aAAa,cAAc,cAAc,aAAa,YAAY,aAAa,WAAW,eAAe,WAAW,YAAY,SAAS,QAAQ,UAAU,SAAS,WAAW,YAAY,SAAS,WAAW,SAAS,UAAU,UAAU,UAAU,QAAQ,WAAW,aAAa,aAAa,YAAY,aAAa,QAAQ,QAAQ,OAAO,SAAS,SAAS,WAAW,kBAAkB,kBAAkB,WAAW,SAAS,SAAS,cAAc,kBAAkB,aAAa,SAAS,QAAQ,WAAW,YAAY,cAAc,UAAU,WAAW,WAAW,WAAW,cAAc,gBAAgB,WAAW,UAAU,UAAU,QAAQ,UAAU,cAAc,WAAW;",
+  "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

@@ -0,0 +1,92 @@
+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 appendChild_exports = {};
+__export(appendChild_exports, {
+  APPEND_CHILD_METADATA_KEY: () => APPEND_CHILD_METADATA_KEY,
+  appendChild: () => appendChild,
+  findAllAppendChildMetadata: () => findAllAppendChildMetadata
+});
+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");
+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 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);
+    }
+    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) => {
+  const result = /* @__PURE__ */ new Map();
+  const maps = import_ReflectUtils.ReflectUtils.findAllMetadata(APPEND_CHILD_METADATA_KEY, target);
+  maps.forEach((map) => {
+    if (map instanceof Map) {
+      map.forEach((v, k) => result.set(k, v));
+    }
+  });
+  return result;
+};
+//# sourceMappingURL=appendChild.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/decorators/appendChild.ts"],
+  "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": []
+}