@alwatr/synapse 1.1.17 → 1.1.19

package/CHANGELOG.md

@@ -3,6 +3,20 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.1.19](https://github.com/Alwatr/nanolib/compare/@alwatr/synapse@1.1.18...@alwatr/synapse@1.1.19) (2025-11-06)
+
+### 🐛 Bug Fixes
+
+* rename update_ method to init_ and call super.init_ in CopyButtonDirective ([66ec105](https://github.com/Alwatr/nanolib/commit/66ec10508385d3bdc5e7e19d53d48294d48ed865))
+
+## [1.1.18](https://github.com/Alwatr/nanolib/compare/@alwatr/synapse@1.1.17...@alwatr/synapse@1.1.18) (2025-11-04)
+
+### 🔨 Code Refactoring
+
+* enhance documentation and structure of DirectiveBase class ([b2cf694](https://github.com/Alwatr/nanolib/commit/b2cf6941ffdf56adfc0a357331a1f155f782943e))
+* simplify update and destroy methods in DirectiveBase class ([e8a906d](https://github.com/Alwatr/nanolib/commit/e8a906d5e4346eda808fc3013287e620e31ef4e3))
+* update property types in query decorators to ensure proper null handling ([bc250dd](https://github.com/Alwatr/nanolib/commit/bc250dde37c72f9469d11ec6a49b9567f3d81d38))
+
 ## [1.1.17](https://github.com/Alwatr/nanolib/compare/@alwatr/synapse@1.1.16...@alwatr/synapse@1.1.17) (2025-10-06)
 
 ### 🔗 Dependencies update

package/README.md

@@ -59,7 +59,8 @@ import {directive, DirectiveBase} from '@alwatr/synapse';
 export class CopyButtonDirective extends DirectiveBase {
   private originalText!: string;
 
-  protected update_(): void {
+  protected override init_(): void {
+    super.init_();
     this.originalText = this.element_.textContent ?? 'Copy';
     this.element_.addEventListener('click', () => this.handleClick());
   }

package/dist/directiveClass.d.ts

@@ -1,38 +1,88 @@
 /**
- * Base class for creating directives that attach behavior to DOM elements.
- * Extend this class to define custom directives.
+ * @package @alwatr/synapse
+ *
+ * This file defines the `DirectiveBase` class, which is the foundation for creating custom directives
+ * in the Alwatr Synapse library. Directives are used to attach behavior and logic to DOM elements
+ * declaratively.
+ */
+/**
+ * The abstract base class for all directives.
+ *
+ * Extend this class to create a new directive that can be registered with the `@directive` decorator.
+ * It provides the core functionality for linking a TypeScript class to a DOM element and managing its lifecycle.
+ *
+ * @example
+ * ```ts
+ * import {DirectiveBase, directive} from '@alwatr/synapse';
+ *
+ * @directive('[my-directive]')
+ * export class MyDirective extends DirectiveBase {
+ *   protected override init_(): void {
+ *     super.init_(); // فراخوانی متد والد برای حفظ سازگاری با نسخه‌های قبل ضروری است
+ *     this.element_.textContent = 'Hello from MyDirective!';
+ *     this.element_.addEventListener('click', () => this.log('Element clicked!'));
+ *   }
+ * }
+ * ```
  */
 export declare abstract class DirectiveBase {
     /**
-     * The CSS selector for the directive.
+     * The CSS selector that this directive is associated with.
+     * This is the selector string provided to the `@directive` decorator.
      */
     protected readonly selector_: string;
     /**
-     * Logger instance for the directive.
+     * A dedicated logger instance for this directive, pre-configured with a context like `directive:[selector]`.
+     * Use this for logging to provide clear, contextual messages.
      */
     protected readonly logger_: import("@alwatr/logger").AlwatrLogger;
     /**
-     * The target DOM element this directive is attached to.
+     * The DOM element to which this directive instance is attached.
+     * All directive logic operates on this element.
      */
     protected readonly element_: HTMLElement;
     /**
-     * Constructor to initialize the directive with the target element.
-     * @param element - The DOM element this directive is attached to.
-     * @param selector - The CSS selector for the directive.
+     * Initializes the directive. This constructor is called by the Synapse bootstrap process and should not be
+     * overridden in subclasses.
+     *
+     * It sets up the logger, element, and selector, and then schedules the `init_` and `update_` lifecycle methods
+     * to run in the next microtask.
+     *
+     * @param element The DOM element to which this directive is attached.
+     * @param selector The CSS selector that matched this directive.
      */
     constructor(element: HTMLElement, selector: string);
     /**
-     * Called to update the directive's state or behavior.
-     * Must be implemented by subclasses.
+     * Called once automatically after the directive is initialized.
+     *
+     * This method serves as the main entry point for your directive's logic,
+     * such as modifying the element or setting up event listeners.
+     *
+     * **Note:** Do not call this method directly. It is designed to be called only once by the framework.
      */
-    protected abstract update_(): Awaitable<void>;
     protected init_(): Awaitable<void>;
-    protected destroy_(): Awaitable<void>;
     /**
      * Dispatches a custom event from the target element.
-     * @param eventName - The name of the event.
-     * @param detail - Optional data to include in the event.
+     *
+     * This is a convenience method for firing events that can be listened to by other parts of the application.
+     * The event bubbles up through the DOM.
+     *
+     * @param eventName The name of the custom event.
+     * @param detail Optional data to include in the event's `detail` property.
+     *
+     * @example
+     * ```ts
+     * this.dispatch_('user-action', {action: 'save', id: 123});
+     * ```
      */
     protected dispatch_(eventName: string, detail?: unknown): void;
+    /**
+     * Cleans up the directive's resources.
+     *
+     * This method removes the element from the DOM and nullifies the internal reference to it,
+     * helping with garbage collection. It can be extended by subclasses to perform additional cleanup,
+     * such as removing event listeners.
+     */
+    protected destroy_(): Awaitable<void>;
 }
 //# sourceMappingURL=directiveClass.d.ts.map

package/dist/directiveClass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"directiveClass.d.ts","sourceRoot":"","sources":["../src/directiveClass.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,8BAAsB,aAAa;IACjC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,SAAC;IAE7B;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,wCAAC;IAE3B;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAEzC;;;;OAIG;gBACS,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM;IAclD;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,IAAI,SAAS,CAAC,IAAI,CAAC;IAE7C,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,IAAI,CAAC;IAIlC,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC;IAOrC;;;;OAIG;IACH,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;CAI/D"}
+{"version":3,"file":"directiveClass.d.ts","sourceRoot":"","sources":["../src/directiveClass.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,8BAAsB,aAAa;IACjC;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,SAAS,SAAC;IAE7B;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,wCAAC;IAE3B;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAEzC;;;;;;;;;OASG;gBACS,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM;IAalD;;;;;;;OAOG;IACH,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,IAAI,CAAC;IAOlC;;;;;;;;;;;;;OAaG;IACH,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAK9D;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,IAAI,SAAS,CAAC,IAAI,CAAC;CAMtC"}

package/dist/main.cjs

@@ -1,4 +1,4 @@
-/** 📦 @alwatr/synapse v1.1.17 */
-__dev_mode__: console.debug("📦 @alwatr/synapse v1.1.17");
-"use strict";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 main_exports={};__export(main_exports,{DirectiveBase:()=>DirectiveBase,bootstrapDirectives:()=>bootstrapDirectives,directive:()=>directive,query:()=>query,queryAll:()=>queryAll});module.exports=__toCommonJS(main_exports);var import_logger=require("@alwatr/logger");var logger=(0,import_logger.createLogger)("alwatr/synapse");var directiveRegistry_=[];var initializedAttribute="_synapseConnected";function bootstrapDirectives(rootElement=document.body){logger.logMethod?.("bootstrapDirectives");for(const{selector,constructor}of directiveRegistry_){try{const uninitializedSelector=`${selector}:not([${initializedAttribute}])`;const elements=rootElement.querySelectorAll(uninitializedSelector);if(elements.length===0)continue;logger.logOther?.(`Found ${elements.length} new element(s) for directive "${selector}"`);elements.forEach(element=>{element.setAttribute(initializedAttribute,"true");new constructor(element,selector)})}catch(err){logger.error("bootstrapDirectives","directive_instantiation_error",err,{selector})}}}function directive(selector){logger.logMethodArgs?.("@directive",selector);return function(constructor){directiveRegistry_.push({selector,constructor})}}var import_delay=require("@alwatr/delay");var import_logger2=require("@alwatr/logger");var DirectiveBase=class{constructor(element,selector){this.logger_=(0,import_logger2.createLogger)(`directive:${selector}`);this.logger_.logMethodArgs?.("new",{selector,element});this.selector_=selector;this.element_=element;(async()=>{await import_delay.delay.nextMicrotask();await this.init_();await this.update_()})()}init_(){this.logger_.logMethod?.("init")}destroy_(){this.logger_.logMethod?.("destroy");this.element_.remove();this.element_=null}dispatch_(eventName,detail){this.logger_.logMethodArgs?.("dispatch_",{eventName,detail});this.element_.dispatchEvent(new CustomEvent(eventName,{detail,bubbles:true}))}};function query(selector,cache=true){return function(target,propertyKey){const privateKey=Symbol(`${String(propertyKey)}__`);Object.defineProperty(target,propertyKey,{get(){if(cache===false||this[privateKey]===void 0){this[privateKey]=this.element_.querySelector(selector)}return this[privateKey]},configurable:true,enumerable:true})}}function queryAll(selector,cache=true){return function(target,propertyKey){const privateKey=Symbol(`${String(propertyKey)}__`);Object.defineProperty(target,propertyKey,{get(){if(cache===false||this[privateKey]===void 0){this[privateKey]=this.element_.querySelectorAll(selector)}return this[privateKey]},configurable:true,enumerable:true})}}0&&(module.exports={DirectiveBase,bootstrapDirectives,directive,query,queryAll});
+/** 📦 @alwatr/synapse v1.1.19 */
+__dev_mode__: console.debug("📦 @alwatr/synapse v1.1.19");
+"use strict";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 main_exports={};__export(main_exports,{DirectiveBase:()=>DirectiveBase,bootstrapDirectives:()=>bootstrapDirectives,directive:()=>directive,query:()=>query,queryAll:()=>queryAll});module.exports=__toCommonJS(main_exports);var import_logger=require("@alwatr/logger");var logger=(0,import_logger.createLogger)("alwatr/synapse");var directiveRegistry_=[];var initializedAttribute="_synapseConnected";function bootstrapDirectives(rootElement=document.body){logger.logMethod?.("bootstrapDirectives");for(const{selector,constructor}of directiveRegistry_){try{const uninitializedSelector=`${selector}:not([${initializedAttribute}])`;const elements=rootElement.querySelectorAll(uninitializedSelector);if(elements.length===0)continue;logger.logOther?.(`Found ${elements.length} new element(s) for directive "${selector}"`);elements.forEach(element=>{element.setAttribute(initializedAttribute,"true");new constructor(element,selector)})}catch(err){logger.error("bootstrapDirectives","directive_instantiation_error",err,{selector})}}}function directive(selector){logger.logMethodArgs?.("@directive",selector);return function(constructor){directiveRegistry_.push({selector,constructor})}}var import_delay=require("@alwatr/delay");var import_logger2=require("@alwatr/logger");var DirectiveBase=class{constructor(element,selector){this.logger_=(0,import_logger2.createLogger)(`directive:${selector}`);this.logger_.logMethodArgs?.("new",{selector,element});this.selector_=selector;this.element_=element;(async()=>{await import_delay.delay.nextMicrotask();await this.init_()})()}init_(){this.logger_.logMethod?.("init_");this.update_?.()}dispatch_(eventName,detail){this.logger_.logMethodArgs?.("dispatch_",{eventName,detail});this.element_.dispatchEvent(new CustomEvent(eventName,{detail,bubbles:true}))}destroy_(){this.logger_.logMethod?.("destroy_");this.element_.remove();this.element_=null}};function query(selector,cache=true){return function(target,propertyKey){const privateKey=Symbol(`${String(propertyKey)}__`);Object.defineProperty(target,propertyKey,{get(){if(cache===false||this[privateKey]===void 0){this[privateKey]=this.element_.querySelector(selector)}return this[privateKey]},configurable:true,enumerable:true})}}function queryAll(selector,cache=true){return function(target,propertyKey){const privateKey=Symbol(`${String(propertyKey)}__`);Object.defineProperty(target,propertyKey,{get(){if(cache===false||this[privateKey]===void 0){this[privateKey]=this.element_.querySelectorAll(selector)}return this[privateKey]},configurable:true,enumerable:true})}}0&&(module.exports={DirectiveBase,bootstrapDirectives,directive,query,queryAll});
 //# sourceMappingURL=main.cjs.map

package/dist/main.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/main.ts", "../src/lib.ts", "../src/bootstrap.ts", "../src/directiveDecorator.ts", "../src/directiveClass.ts", "../src/queryDecorator.ts"],
-  "sourcesContent": ["export * from './bootstrap.js';\nexport * from './directiveDecorator.js';\nexport * from './directiveClass.js';\nexport * from './queryDecorator.js';\n", "import {createLogger} from '@alwatr/logger';\n\nimport type {DirectiveConstructor} from './directiveDecorator.js';\nimport type {} from '@alwatr/type-helper';\n\n/**\n * Alwatr Synapse Logger.\n */\nexport const logger = createLogger('alwatr/synapse');\n\n/**\n * The registry for all directives.\n */\nexport const directiveRegistry_: {selector: string; constructor: DirectiveConstructor}[] = [];\n", "import {directiveRegistry_, logger} from './lib.js';\n\nconst initializedAttribute = '_synapseConnected';\n\n/**\n * Initializes all registered directives within a given root element.\n * If no root element is provided, it scans the entire body.\n *\n * This function is idempotent; it will not re-initialize a directive on an element\n * that has already been processed.\n *\n * @param rootElement The element to scan for directives. Defaults to `document.body`.\n *\n * @example\n * ```ts\n * // Initialize directives on the whole page after the DOM is loaded.\n * document.addEventListener('DOMContentLoaded', () => bootstrapDirectives());\n *\n * // Or, initialize directives on a dynamically added part of the page.\n * const newContent = document.createElement('div');\n * newContent.innerHTML = '<div class=\"my-button\">Click Me</div>';\n * document.body.appendChild(newContent);\n *\n * bootstrapDirectives(newContent);\n * ```\n */\nexport function bootstrapDirectives(rootElement: Element | Document = document.body): void {\n  logger.logMethod?.('bootstrapDirectives');\n\n  for (const {selector, constructor} of directiveRegistry_) {\n    try {\n      const uninitializedSelector = `${selector}:not([${initializedAttribute}])`;\n      const elements = rootElement.querySelectorAll<HTMLElement>(uninitializedSelector);\n      if (elements.length === 0) continue;\n\n      logger.logOther?.(`Found ${elements.length} new element(s) for directive \"${selector}\"`);\n      elements.forEach((element) => {\n        // Mark the element as processed before creating an instance\n        element.setAttribute(initializedAttribute, 'true');\n        // Instantiate the directive with the element.\n        new constructor(element, selector);\n      });\n    }\n    catch (err) {\n      logger.error('bootstrapDirectives', 'directive_instantiation_error', err, {selector});\n    }\n  }\n}\n", "import {directiveRegistry_, logger} from './lib.js';\n\nimport type {DirectiveBase} from './directiveClass.js';\n\n/**\n * Type definition for a directive constructor.\n * A directive class must have a constructor that accepts an HTMLElement.\n */\nexport type DirectiveConstructor<T extends DirectiveBase = DirectiveBase> = new (element: HTMLElement, selector: string) => T;\n\n/**\n * A class decorator that registers a class as a directive.\n *\n * @param selector The CSS selector to which this directive will be attached.\n *\n * @example\n * ```ts\n * @directive('.my-button')\n * class MyButtonDirective extends DirectiveBase {\n *   protected update_(): void {\n *     this.element_.addEventListener('click', () => console.log('Button clicked!'));\n *   }\n * }\n * ```\n */\nexport function directive(selector: string) {\n  logger.logMethodArgs?.('@directive', selector);\n\n  /**\n   * The decorator function that receives the class constructor.\n   * @param constructor The class to be registered as a directive.\n   */\n  return function (constructor: DirectiveConstructor): void {\n    directiveRegistry_.push({selector, constructor});\n  };\n}\n", "import {delay} from '@alwatr/delay';\nimport {createLogger} from '@alwatr/logger';\n\n/**\n * Base class for creating directives that attach behavior to DOM elements.\n * Extend this class to define custom directives.\n */\nexport abstract class DirectiveBase {\n  /**\n   * The CSS selector for the directive.\n   */\n  protected readonly selector_;\n\n  /**\n   * Logger instance for the directive.\n   */\n  protected readonly logger_;\n\n  /**\n   * The target DOM element this directive is attached to.\n   */\n  protected readonly element_: HTMLElement;\n\n  /**\n   * Constructor to initialize the directive with the target element.\n   * @param element - The DOM element this directive is attached to.\n   * @param selector - The CSS selector for the directive.\n   */\n  constructor(element: HTMLElement, selector: string) {\n    this.logger_ = createLogger(`directive:${selector}`);\n    this.logger_.logMethodArgs?.('new', {selector, element});\n\n    this.selector_ = selector;\n    this.element_ = element;\n\n    (async () => {\n      await delay.nextMicrotask();\n      await this.init_();\n      await this.update_();\n    })();\n  }\n\n  /**\n   * Called to update the directive's state or behavior.\n   * Must be implemented by subclasses.\n   */\n  protected abstract update_(): Awaitable<void>;\n\n  protected init_(): Awaitable<void> {\n    this.logger_.logMethod?.('init');\n  }\n\n  protected destroy_(): Awaitable<void> {\n    this.logger_.logMethod?.('destroy');\n    this.element_.remove();\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this as any).element_ = null;\n  }\n\n  /**\n   * Dispatches a custom event from the target element.\n   * @param eventName - The name of the event.\n   * @param detail - Optional data to include in the event.\n   */\n  protected dispatch_(eventName: string, detail?: unknown): void {\n    this.logger_.logMethodArgs?.('dispatch_', {eventName, detail});\n    this.element_.dispatchEvent(new CustomEvent(eventName, {detail, bubbles: true}));\n  }\n}\n", "/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type {DirectiveBase} from './directiveClass.js';\n\n/**\n * A property decorator that queries the directive's element for a selector.\n * The query is performed once and the result is cached.\n *\n * @param selector The CSS selector to query for.\n * @param cache Whether to cache the result on first access. Defaults is true.\n *\n * @example\n * ```ts\n * @directive('[my-directive]')\n * class MyDirective extends DirectiveBase {\n *   @query('.my-element')\n *   protected myElement?: HTMLDivElement;\n * }\n * ```\n */\nexport function query(selector: string, cache = true) {\n  return function (target: DirectiveBase, propertyKey: string): void {\n    const privateKey = Symbol(`${String(propertyKey)}__`);\n\n    Object.defineProperty(target, propertyKey, {\n      get(this: DirectiveBase) {\n        if (cache === false || (this as any)[privateKey] === undefined) {\n          (this as any)[privateKey] = this.element_.querySelector(selector);\n        }\n        return (this as any)[privateKey];\n      },\n      configurable: true,\n      enumerable: true,\n    });\n  };\n}\n\n/**\n * A property decorator that queries the directive's element for all selectors.\n * The queries are performed once and the result is cached.\n *\n * @param selector The CSS selector to query for.\n *\n * @example\n * ```ts\n * @directive('[my-directive]')\n * class MyDirective extends DirectiveBase {\n *   @queryAll('.my-elements')\n *   protected myElements?: NodeListOf<HTMLDivElement>;\n * }\n * ```\n */\nexport function queryAll(selector: string, cache = true) {\n  return function (target: DirectiveBase, propertyKey: string): void {\n    const privateKey = Symbol(`${String(propertyKey)}__`);\n\n    Object.defineProperty(target, propertyKey, {\n      get(this: DirectiveBase) {\n        if (cache === false || (this as any)[privateKey] === undefined) {\n          (this as any)[privateKey] = this.element_.querySelectorAll(selector);\n        }\n        return (this as any)[privateKey];\n      },\n      configurable: true,\n      enumerable: true,\n    });\n  };\n}\n"],
-  "mappings": ";;qqBAAA,iOCAA,kBAA2B,0BAQpB,IAAM,UAAS,4BAAa,gBAAgB,EAK5C,IAAM,mBAA8E,CAAC,ECX5F,IAAM,qBAAuB,oBAwBtB,SAAS,oBAAoB,YAAkC,SAAS,KAAY,CACzF,OAAO,YAAY,qBAAqB,EAExC,SAAW,CAAC,SAAU,WAAW,IAAK,mBAAoB,CACxD,GAAI,CACF,MAAM,sBAAwB,GAAG,QAAQ,SAAS,oBAAoB,KACtE,MAAM,SAAW,YAAY,iBAA8B,qBAAqB,EAChF,GAAI,SAAS,SAAW,EAAG,SAE3B,OAAO,WAAW,SAAS,SAAS,MAAM,kCAAkC,QAAQ,GAAG,EACvF,SAAS,QAAS,SAAY,CAE5B,QAAQ,aAAa,qBAAsB,MAAM,EAEjD,IAAI,YAAY,QAAS,QAAQ,CACnC,CAAC,CACH,OACO,IAAK,CACV,OAAO,MAAM,sBAAuB,gCAAiC,IAAK,CAAC,QAAQ,CAAC,CACtF,CACF,CACF,CCtBO,SAAS,UAAU,SAAkB,CAC1C,OAAO,gBAAgB,aAAc,QAAQ,EAM7C,OAAO,SAAU,YAAyC,CACxD,mBAAmB,KAAK,CAAC,SAAU,WAAW,CAAC,CACjD,CACF,CCnCA,iBAAoB,yBACpB,IAAAA,eAA2B,0BAMpB,IAAe,cAAf,KAA6B,CAqBlC,YAAY,QAAsB,SAAkB,CAClD,KAAK,WAAU,6BAAa,aAAa,QAAQ,EAAE,EACnD,KAAK,QAAQ,gBAAgB,MAAO,CAAC,SAAU,OAAO,CAAC,EAEvD,KAAK,UAAY,SACjB,KAAK,SAAW,SAEf,SAAY,CACX,MAAM,mBAAM,cAAc,EAC1B,MAAM,KAAK,MAAM,EACjB,MAAM,KAAK,QAAQ,CACrB,GAAG,CACL,CAQU,OAAyB,CACjC,KAAK,QAAQ,YAAY,MAAM,CACjC,CAEU,UAA4B,CACpC,KAAK,QAAQ,YAAY,SAAS,EAClC,KAAK,SAAS,OAAO,EAEpB,KAAa,SAAW,IAC3B,CAOU,UAAU,UAAmB,OAAwB,CAC7D,KAAK,QAAQ,gBAAgB,YAAa,CAAC,UAAW,MAAM,CAAC,EAC7D,KAAK,SAAS,cAAc,IAAI,YAAY,UAAW,CAAC,OAAQ,QAAS,IAAI,CAAC,CAAC,CACjF,CACF,ECjDO,SAAS,MAAM,SAAkB,MAAQ,KAAM,CACpD,OAAO,SAAU,OAAuB,YAA2B,CACjE,MAAM,WAAa,OAAO,GAAG,OAAO,WAAW,CAAC,IAAI,EAEpD,OAAO,eAAe,OAAQ,YAAa,CACzC,KAAyB,CACvB,GAAI,QAAU,OAAU,KAAa,UAAU,IAAM,OAAW,CAC7D,KAAa,UAAU,EAAI,KAAK,SAAS,cAAc,QAAQ,CAClE,CACA,OAAQ,KAAa,UAAU,CACjC,EACA,aAAc,KACd,WAAY,IACd,CAAC,CACH,CACF,CAiBO,SAAS,SAAS,SAAkB,MAAQ,KAAM,CACvD,OAAO,SAAU,OAAuB,YAA2B,CACjE,MAAM,WAAa,OAAO,GAAG,OAAO,WAAW,CAAC,IAAI,EAEpD,OAAO,eAAe,OAAQ,YAAa,CACzC,KAAyB,CACvB,GAAI,QAAU,OAAU,KAAa,UAAU,IAAM,OAAW,CAC7D,KAAa,UAAU,EAAI,KAAK,SAAS,iBAAiB,QAAQ,CACrE,CACA,OAAQ,KAAa,UAAU,CACjC,EACA,aAAc,KACd,WAAY,IACd,CAAC,CACH,CACF",
+  "sourcesContent": ["export * from './bootstrap.js';\nexport * from './directiveDecorator.js';\nexport * from './directiveClass.js';\nexport * from './queryDecorator.js';\n", "import {createLogger} from '@alwatr/logger';\n\nimport type {DirectiveConstructor} from './directiveDecorator.js';\nimport type {} from '@alwatr/type-helper';\n\n/**\n * Alwatr Synapse Logger.\n */\nexport const logger = createLogger('alwatr/synapse');\n\n/**\n * The registry for all directives.\n */\nexport const directiveRegistry_: {selector: string; constructor: DirectiveConstructor}[] = [];\n", "import {directiveRegistry_, logger} from './lib.js';\n\nconst initializedAttribute = '_synapseConnected';\n\n/**\n * Initializes all registered directives within a given root element.\n * If no root element is provided, it scans the entire body.\n *\n * This function is idempotent; it will not re-initialize a directive on an element\n * that has already been processed.\n *\n * @param rootElement The element to scan for directives. Defaults to `document.body`.\n *\n * @example\n * ```ts\n * // Initialize directives on the whole page after the DOM is loaded.\n * document.addEventListener('DOMContentLoaded', () => bootstrapDirectives());\n *\n * // Or, initialize directives on a dynamically added part of the page.\n * const newContent = document.createElement('div');\n * newContent.innerHTML = '<div class=\"my-button\">Click Me</div>';\n * document.body.appendChild(newContent);\n *\n * bootstrapDirectives(newContent);\n * ```\n */\nexport function bootstrapDirectives(rootElement: Element | Document = document.body): void {\n  logger.logMethod?.('bootstrapDirectives');\n\n  for (const {selector, constructor} of directiveRegistry_) {\n    try {\n      const uninitializedSelector = `${selector}:not([${initializedAttribute}])`;\n      const elements = rootElement.querySelectorAll<HTMLElement>(uninitializedSelector);\n      if (elements.length === 0) continue;\n\n      logger.logOther?.(`Found ${elements.length} new element(s) for directive \"${selector}\"`);\n      elements.forEach((element) => {\n        // Mark the element as processed before creating an instance\n        element.setAttribute(initializedAttribute, 'true');\n        // Instantiate the directive with the element.\n        new constructor(element, selector);\n      });\n    }\n    catch (err) {\n      logger.error('bootstrapDirectives', 'directive_instantiation_error', err, {selector});\n    }\n  }\n}\n", "import {directiveRegistry_, logger} from './lib.js';\n\nimport type {DirectiveBase} from './directiveClass.js';\n\n/**\n * Type definition for a directive constructor.\n * A directive class must have a constructor that accepts an HTMLElement.\n */\nexport type DirectiveConstructor<T extends DirectiveBase = DirectiveBase> = new (element: HTMLElement, selector: string) => T;\n\n/**\n * A class decorator that registers a class as a directive.\n *\n * @param selector The CSS selector to which this directive will be attached.\n *\n * @example\n * ```ts\n * @directive('.my-button')\n * class MyButtonDirective extends DirectiveBase {\n *   protected update_(): void {\n *     this.element_.addEventListener('click', () => console.log('Button clicked!'));\n *   }\n * }\n * ```\n */\nexport function directive(selector: string) {\n  logger.logMethodArgs?.('@directive', selector);\n\n  /**\n   * The decorator function that receives the class constructor.\n   * @param constructor The class to be registered as a directive.\n   */\n  return function (constructor: DirectiveConstructor): void {\n    directiveRegistry_.push({selector, constructor});\n  };\n}\n", "/**\n * @package @alwatr/synapse\n *\n * This file defines the `DirectiveBase` class, which is the foundation for creating custom directives\n * in the Alwatr Synapse library. Directives are used to attach behavior and logic to DOM elements\n * declaratively.\n */\n\nimport {delay} from '@alwatr/delay';\nimport {createLogger} from '@alwatr/logger';\n\n/**\n * The abstract base class for all directives.\n *\n * Extend this class to create a new directive that can be registered with the `@directive` decorator.\n * It provides the core functionality for linking a TypeScript class to a DOM element and managing its lifecycle.\n *\n * @example\n * ```ts\n * import {DirectiveBase, directive} from '@alwatr/synapse';\n *\n * @directive('[my-directive]')\n * export class MyDirective extends DirectiveBase {\n *   protected override init_(): void {\n *     super.init_(); // فراخوانی متد والد برای حفظ سازگاری با نسخه‌های قبل ضروری است\n *     this.element_.textContent = 'Hello from MyDirective!';\n *     this.element_.addEventListener('click', () => this.log('Element clicked!'));\n *   }\n * }\n * ```\n */\nexport abstract class DirectiveBase {\n  /**\n   * The CSS selector that this directive is associated with.\n   * This is the selector string provided to the `@directive` decorator.\n   */\n  protected readonly selector_;\n\n  /**\n   * A dedicated logger instance for this directive, pre-configured with a context like `directive:[selector]`.\n   * Use this for logging to provide clear, contextual messages.\n   */\n  protected readonly logger_;\n\n  /**\n   * The DOM element to which this directive instance is attached.\n   * All directive logic operates on this element.\n   */\n  protected readonly element_: HTMLElement;\n\n  /**\n   * Initializes the directive. This constructor is called by the Synapse bootstrap process and should not be\n   * overridden in subclasses.\n   *\n   * It sets up the logger, element, and selector, and then schedules the `init_` and `update_` lifecycle methods\n   * to run in the next microtask.\n   *\n   * @param element The DOM element to which this directive is attached.\n   * @param selector The CSS selector that matched this directive.\n   */\n  constructor(element: HTMLElement, selector: string) {\n    this.logger_ = createLogger(`directive:${selector}`);\n    this.logger_.logMethodArgs?.('new', {selector, element});\n\n    this.selector_ = selector;\n    this.element_ = element;\n\n    (async () => {\n      await delay.nextMicrotask();\n      await this.init_();\n    })();\n  }\n\n  /**\n   * Called once automatically after the directive is initialized.\n   *\n   * This method serves as the main entry point for your directive's logic,\n   * such as modifying the element or setting up event listeners.\n   *\n   * **Note:** Do not call this method directly. It is designed to be called only once by the framework.\n   */\n  protected init_(): Awaitable<void> {\n    this.logger_.logMethod?.('init_');\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this as any).update_?.(); // backward compatibility\n  }\n\n  /**\n   * Dispatches a custom event from the target element.\n   *\n   * This is a convenience method for firing events that can be listened to by other parts of the application.\n   * The event bubbles up through the DOM.\n   *\n   * @param eventName The name of the custom event.\n   * @param detail Optional data to include in the event's `detail` property.\n   *\n   * @example\n   * ```ts\n   * this.dispatch_('user-action', {action: 'save', id: 123});\n   * ```\n   */\n  protected dispatch_(eventName: string, detail?: unknown): void {\n    this.logger_.logMethodArgs?.('dispatch_', {eventName, detail});\n    this.element_.dispatchEvent(new CustomEvent(eventName, {detail, bubbles: true}));\n  }\n\n  /**\n   * Cleans up the directive's resources.\n   *\n   * This method removes the element from the DOM and nullifies the internal reference to it,\n   * helping with garbage collection. It can be extended by subclasses to perform additional cleanup,\n   * such as removing event listeners.\n   */\n  protected destroy_(): Awaitable<void> {\n    this.logger_.logMethod?.('destroy_');\n    this.element_.remove();\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this as any).element_ = null;\n  }\n}\n", "/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type {DirectiveBase} from './directiveClass.js';\n\n/**\n * A property decorator that queries the directive's element for a selector.\n * The query is performed once and the result is cached.\n *\n * @param selector The CSS selector to query for.\n * @param cache Whether to cache the result on first access. Defaults is true.\n *\n * @example\n * ```ts\n * @directive('[my-directive]')\n * class MyDirective extends DirectiveBase {\n *   @query('.my-element')\n *   protected myElement: HTMLDivElement | null;\n * }\n * ```\n */\nexport function query(selector: string, cache = true) {\n  return function (target: DirectiveBase, propertyKey: string): void {\n    const privateKey = Symbol(`${String(propertyKey)}__`);\n\n    Object.defineProperty(target, propertyKey, {\n      get(this: DirectiveBase) {\n        if (cache === false || (this as any)[privateKey] === undefined) {\n          (this as any)[privateKey] = this.element_.querySelector(selector);\n        }\n        return (this as any)[privateKey];\n      },\n      configurable: true,\n      enumerable: true,\n    });\n  };\n}\n\n/**\n * A property decorator that queries the directive's element for all selectors.\n * The queries are performed once and the result is cached.\n *\n * @param selector The CSS selector to query for.\n *\n * @example\n * ```ts\n * @directive('[my-directive]')\n * class MyDirective extends DirectiveBase {\n *   @queryAll('.my-elements')\n *   protected myElements: NodeListOf<HTMLDivElement>;\n * }\n * ```\n */\nexport function queryAll(selector: string, cache = true) {\n  return function (target: DirectiveBase, propertyKey: string): void {\n    const privateKey = Symbol(`${String(propertyKey)}__`);\n\n    Object.defineProperty(target, propertyKey, {\n      get(this: DirectiveBase) {\n        if (cache === false || (this as any)[privateKey] === undefined) {\n          (this as any)[privateKey] = this.element_.querySelectorAll(selector);\n        }\n        return (this as any)[privateKey];\n      },\n      configurable: true,\n      enumerable: true,\n    });\n  };\n}\n"],
+  "mappings": ";;qqBAAA,iOCAA,kBAA2B,0BAQpB,IAAM,UAAS,4BAAa,gBAAgB,EAK5C,IAAM,mBAA8E,CAAC,ECX5F,IAAM,qBAAuB,oBAwBtB,SAAS,oBAAoB,YAAkC,SAAS,KAAY,CACzF,OAAO,YAAY,qBAAqB,EAExC,SAAW,CAAC,SAAU,WAAW,IAAK,mBAAoB,CACxD,GAAI,CACF,MAAM,sBAAwB,GAAG,QAAQ,SAAS,oBAAoB,KACtE,MAAM,SAAW,YAAY,iBAA8B,qBAAqB,EAChF,GAAI,SAAS,SAAW,EAAG,SAE3B,OAAO,WAAW,SAAS,SAAS,MAAM,kCAAkC,QAAQ,GAAG,EACvF,SAAS,QAAS,SAAY,CAE5B,QAAQ,aAAa,qBAAsB,MAAM,EAEjD,IAAI,YAAY,QAAS,QAAQ,CACnC,CAAC,CACH,OACO,IAAK,CACV,OAAO,MAAM,sBAAuB,gCAAiC,IAAK,CAAC,QAAQ,CAAC,CACtF,CACF,CACF,CCtBO,SAAS,UAAU,SAAkB,CAC1C,OAAO,gBAAgB,aAAc,QAAQ,EAM7C,OAAO,SAAU,YAAyC,CACxD,mBAAmB,KAAK,CAAC,SAAU,WAAW,CAAC,CACjD,CACF,CC3BA,iBAAoB,yBACpB,IAAAA,eAA2B,0BAsBpB,IAAe,cAAf,KAA6B,CA6BlC,YAAY,QAAsB,SAAkB,CAClD,KAAK,WAAU,6BAAa,aAAa,QAAQ,EAAE,EACnD,KAAK,QAAQ,gBAAgB,MAAO,CAAC,SAAU,OAAO,CAAC,EAEvD,KAAK,UAAY,SACjB,KAAK,SAAW,SAEf,SAAY,CACX,MAAM,mBAAM,cAAc,EAC1B,MAAM,KAAK,MAAM,CACnB,GAAG,CACL,CAUU,OAAyB,CACjC,KAAK,QAAQ,YAAY,OAAO,EAG/B,KAAa,UAAU,CAC1B,CAgBU,UAAU,UAAmB,OAAwB,CAC7D,KAAK,QAAQ,gBAAgB,YAAa,CAAC,UAAW,MAAM,CAAC,EAC7D,KAAK,SAAS,cAAc,IAAI,YAAY,UAAW,CAAC,OAAQ,QAAS,IAAI,CAAC,CAAC,CACjF,CASU,UAA4B,CACpC,KAAK,QAAQ,YAAY,UAAU,EACnC,KAAK,SAAS,OAAO,EAEpB,KAAa,SAAW,IAC3B,CACF,ECrGO,SAAS,MAAM,SAAkB,MAAQ,KAAM,CACpD,OAAO,SAAU,OAAuB,YAA2B,CACjE,MAAM,WAAa,OAAO,GAAG,OAAO,WAAW,CAAC,IAAI,EAEpD,OAAO,eAAe,OAAQ,YAAa,CACzC,KAAyB,CACvB,GAAI,QAAU,OAAU,KAAa,UAAU,IAAM,OAAW,CAC7D,KAAa,UAAU,EAAI,KAAK,SAAS,cAAc,QAAQ,CAClE,CACA,OAAQ,KAAa,UAAU,CACjC,EACA,aAAc,KACd,WAAY,IACd,CAAC,CACH,CACF,CAiBO,SAAS,SAAS,SAAkB,MAAQ,KAAM,CACvD,OAAO,SAAU,OAAuB,YAA2B,CACjE,MAAM,WAAa,OAAO,GAAG,OAAO,WAAW,CAAC,IAAI,EAEpD,OAAO,eAAe,OAAQ,YAAa,CACzC,KAAyB,CACvB,GAAI,QAAU,OAAU,KAAa,UAAU,IAAM,OAAW,CAC7D,KAAa,UAAU,EAAI,KAAK,SAAS,iBAAiB,QAAQ,CACrE,CACA,OAAQ,KAAa,UAAU,CACjC,EACA,aAAc,KACd,WAAY,IACd,CAAC,CACH,CACF",
   "names": ["import_logger"]
 }

package/dist/main.mjs

@@ -1,4 +1,4 @@
-/** 📦 @alwatr/synapse v1.1.17 */
-__dev_mode__: console.debug("📦 @alwatr/synapse v1.1.17");
-import{createLogger}from"@alwatr/logger";var logger=createLogger("alwatr/synapse");var directiveRegistry_=[];var initializedAttribute="_synapseConnected";function bootstrapDirectives(rootElement=document.body){logger.logMethod?.("bootstrapDirectives");for(const{selector,constructor}of directiveRegistry_){try{const uninitializedSelector=`${selector}:not([${initializedAttribute}])`;const elements=rootElement.querySelectorAll(uninitializedSelector);if(elements.length===0)continue;logger.logOther?.(`Found ${elements.length} new element(s) for directive "${selector}"`);elements.forEach(element=>{element.setAttribute(initializedAttribute,"true");new constructor(element,selector)})}catch(err){logger.error("bootstrapDirectives","directive_instantiation_error",err,{selector})}}}function directive(selector){logger.logMethodArgs?.("@directive",selector);return function(constructor){directiveRegistry_.push({selector,constructor})}}import{delay}from"@alwatr/delay";import{createLogger as createLogger2}from"@alwatr/logger";var DirectiveBase=class{constructor(element,selector){this.logger_=createLogger2(`directive:${selector}`);this.logger_.logMethodArgs?.("new",{selector,element});this.selector_=selector;this.element_=element;(async()=>{await delay.nextMicrotask();await this.init_();await this.update_()})()}init_(){this.logger_.logMethod?.("init")}destroy_(){this.logger_.logMethod?.("destroy");this.element_.remove();this.element_=null}dispatch_(eventName,detail){this.logger_.logMethodArgs?.("dispatch_",{eventName,detail});this.element_.dispatchEvent(new CustomEvent(eventName,{detail,bubbles:true}))}};function query(selector,cache=true){return function(target,propertyKey){const privateKey=Symbol(`${String(propertyKey)}__`);Object.defineProperty(target,propertyKey,{get(){if(cache===false||this[privateKey]===void 0){this[privateKey]=this.element_.querySelector(selector)}return this[privateKey]},configurable:true,enumerable:true})}}function queryAll(selector,cache=true){return function(target,propertyKey){const privateKey=Symbol(`${String(propertyKey)}__`);Object.defineProperty(target,propertyKey,{get(){if(cache===false||this[privateKey]===void 0){this[privateKey]=this.element_.querySelectorAll(selector)}return this[privateKey]},configurable:true,enumerable:true})}}export{DirectiveBase,bootstrapDirectives,directive,query,queryAll};
+/** 📦 @alwatr/synapse v1.1.19 */
+__dev_mode__: console.debug("📦 @alwatr/synapse v1.1.19");
+import{createLogger}from"@alwatr/logger";var logger=createLogger("alwatr/synapse");var directiveRegistry_=[];var initializedAttribute="_synapseConnected";function bootstrapDirectives(rootElement=document.body){logger.logMethod?.("bootstrapDirectives");for(const{selector,constructor}of directiveRegistry_){try{const uninitializedSelector=`${selector}:not([${initializedAttribute}])`;const elements=rootElement.querySelectorAll(uninitializedSelector);if(elements.length===0)continue;logger.logOther?.(`Found ${elements.length} new element(s) for directive "${selector}"`);elements.forEach(element=>{element.setAttribute(initializedAttribute,"true");new constructor(element,selector)})}catch(err){logger.error("bootstrapDirectives","directive_instantiation_error",err,{selector})}}}function directive(selector){logger.logMethodArgs?.("@directive",selector);return function(constructor){directiveRegistry_.push({selector,constructor})}}import{delay}from"@alwatr/delay";import{createLogger as createLogger2}from"@alwatr/logger";var DirectiveBase=class{constructor(element,selector){this.logger_=createLogger2(`directive:${selector}`);this.logger_.logMethodArgs?.("new",{selector,element});this.selector_=selector;this.element_=element;(async()=>{await delay.nextMicrotask();await this.init_()})()}init_(){this.logger_.logMethod?.("init_");this.update_?.()}dispatch_(eventName,detail){this.logger_.logMethodArgs?.("dispatch_",{eventName,detail});this.element_.dispatchEvent(new CustomEvent(eventName,{detail,bubbles:true}))}destroy_(){this.logger_.logMethod?.("destroy_");this.element_.remove();this.element_=null}};function query(selector,cache=true){return function(target,propertyKey){const privateKey=Symbol(`${String(propertyKey)}__`);Object.defineProperty(target,propertyKey,{get(){if(cache===false||this[privateKey]===void 0){this[privateKey]=this.element_.querySelector(selector)}return this[privateKey]},configurable:true,enumerable:true})}}function queryAll(selector,cache=true){return function(target,propertyKey){const privateKey=Symbol(`${String(propertyKey)}__`);Object.defineProperty(target,propertyKey,{get(){if(cache===false||this[privateKey]===void 0){this[privateKey]=this.element_.querySelectorAll(selector)}return this[privateKey]},configurable:true,enumerable:true})}}export{DirectiveBase,bootstrapDirectives,directive,query,queryAll};
 //# sourceMappingURL=main.mjs.map

package/dist/main.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/lib.ts", "../src/bootstrap.ts", "../src/directiveDecorator.ts", "../src/directiveClass.ts", "../src/queryDecorator.ts"],
-  "sourcesContent": ["import {createLogger} from '@alwatr/logger';\n\nimport type {DirectiveConstructor} from './directiveDecorator.js';\nimport type {} from '@alwatr/type-helper';\n\n/**\n * Alwatr Synapse Logger.\n */\nexport const logger = createLogger('alwatr/synapse');\n\n/**\n * The registry for all directives.\n */\nexport const directiveRegistry_: {selector: string; constructor: DirectiveConstructor}[] = [];\n", "import {directiveRegistry_, logger} from './lib.js';\n\nconst initializedAttribute = '_synapseConnected';\n\n/**\n * Initializes all registered directives within a given root element.\n * If no root element is provided, it scans the entire body.\n *\n * This function is idempotent; it will not re-initialize a directive on an element\n * that has already been processed.\n *\n * @param rootElement The element to scan for directives. Defaults to `document.body`.\n *\n * @example\n * ```ts\n * // Initialize directives on the whole page after the DOM is loaded.\n * document.addEventListener('DOMContentLoaded', () => bootstrapDirectives());\n *\n * // Or, initialize directives on a dynamically added part of the page.\n * const newContent = document.createElement('div');\n * newContent.innerHTML = '<div class=\"my-button\">Click Me</div>';\n * document.body.appendChild(newContent);\n *\n * bootstrapDirectives(newContent);\n * ```\n */\nexport function bootstrapDirectives(rootElement: Element | Document = document.body): void {\n  logger.logMethod?.('bootstrapDirectives');\n\n  for (const {selector, constructor} of directiveRegistry_) {\n    try {\n      const uninitializedSelector = `${selector}:not([${initializedAttribute}])`;\n      const elements = rootElement.querySelectorAll<HTMLElement>(uninitializedSelector);\n      if (elements.length === 0) continue;\n\n      logger.logOther?.(`Found ${elements.length} new element(s) for directive \"${selector}\"`);\n      elements.forEach((element) => {\n        // Mark the element as processed before creating an instance\n        element.setAttribute(initializedAttribute, 'true');\n        // Instantiate the directive with the element.\n        new constructor(element, selector);\n      });\n    }\n    catch (err) {\n      logger.error('bootstrapDirectives', 'directive_instantiation_error', err, {selector});\n    }\n  }\n}\n", "import {directiveRegistry_, logger} from './lib.js';\n\nimport type {DirectiveBase} from './directiveClass.js';\n\n/**\n * Type definition for a directive constructor.\n * A directive class must have a constructor that accepts an HTMLElement.\n */\nexport type DirectiveConstructor<T extends DirectiveBase = DirectiveBase> = new (element: HTMLElement, selector: string) => T;\n\n/**\n * A class decorator that registers a class as a directive.\n *\n * @param selector The CSS selector to which this directive will be attached.\n *\n * @example\n * ```ts\n * @directive('.my-button')\n * class MyButtonDirective extends DirectiveBase {\n *   protected update_(): void {\n *     this.element_.addEventListener('click', () => console.log('Button clicked!'));\n *   }\n * }\n * ```\n */\nexport function directive(selector: string) {\n  logger.logMethodArgs?.('@directive', selector);\n\n  /**\n   * The decorator function that receives the class constructor.\n   * @param constructor The class to be registered as a directive.\n   */\n  return function (constructor: DirectiveConstructor): void {\n    directiveRegistry_.push({selector, constructor});\n  };\n}\n", "import {delay} from '@alwatr/delay';\nimport {createLogger} from '@alwatr/logger';\n\n/**\n * Base class for creating directives that attach behavior to DOM elements.\n * Extend this class to define custom directives.\n */\nexport abstract class DirectiveBase {\n  /**\n   * The CSS selector for the directive.\n   */\n  protected readonly selector_;\n\n  /**\n   * Logger instance for the directive.\n   */\n  protected readonly logger_;\n\n  /**\n   * The target DOM element this directive is attached to.\n   */\n  protected readonly element_: HTMLElement;\n\n  /**\n   * Constructor to initialize the directive with the target element.\n   * @param element - The DOM element this directive is attached to.\n   * @param selector - The CSS selector for the directive.\n   */\n  constructor(element: HTMLElement, selector: string) {\n    this.logger_ = createLogger(`directive:${selector}`);\n    this.logger_.logMethodArgs?.('new', {selector, element});\n\n    this.selector_ = selector;\n    this.element_ = element;\n\n    (async () => {\n      await delay.nextMicrotask();\n      await this.init_();\n      await this.update_();\n    })();\n  }\n\n  /**\n   * Called to update the directive's state or behavior.\n   * Must be implemented by subclasses.\n   */\n  protected abstract update_(): Awaitable<void>;\n\n  protected init_(): Awaitable<void> {\n    this.logger_.logMethod?.('init');\n  }\n\n  protected destroy_(): Awaitable<void> {\n    this.logger_.logMethod?.('destroy');\n    this.element_.remove();\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this as any).element_ = null;\n  }\n\n  /**\n   * Dispatches a custom event from the target element.\n   * @param eventName - The name of the event.\n   * @param detail - Optional data to include in the event.\n   */\n  protected dispatch_(eventName: string, detail?: unknown): void {\n    this.logger_.logMethodArgs?.('dispatch_', {eventName, detail});\n    this.element_.dispatchEvent(new CustomEvent(eventName, {detail, bubbles: true}));\n  }\n}\n", "/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type {DirectiveBase} from './directiveClass.js';\n\n/**\n * A property decorator that queries the directive's element for a selector.\n * The query is performed once and the result is cached.\n *\n * @param selector The CSS selector to query for.\n * @param cache Whether to cache the result on first access. Defaults is true.\n *\n * @example\n * ```ts\n * @directive('[my-directive]')\n * class MyDirective extends DirectiveBase {\n *   @query('.my-element')\n *   protected myElement?: HTMLDivElement;\n * }\n * ```\n */\nexport function query(selector: string, cache = true) {\n  return function (target: DirectiveBase, propertyKey: string): void {\n    const privateKey = Symbol(`${String(propertyKey)}__`);\n\n    Object.defineProperty(target, propertyKey, {\n      get(this: DirectiveBase) {\n        if (cache === false || (this as any)[privateKey] === undefined) {\n          (this as any)[privateKey] = this.element_.querySelector(selector);\n        }\n        return (this as any)[privateKey];\n      },\n      configurable: true,\n      enumerable: true,\n    });\n  };\n}\n\n/**\n * A property decorator that queries the directive's element for all selectors.\n * The queries are performed once and the result is cached.\n *\n * @param selector The CSS selector to query for.\n *\n * @example\n * ```ts\n * @directive('[my-directive]')\n * class MyDirective extends DirectiveBase {\n *   @queryAll('.my-elements')\n *   protected myElements?: NodeListOf<HTMLDivElement>;\n * }\n * ```\n */\nexport function queryAll(selector: string, cache = true) {\n  return function (target: DirectiveBase, propertyKey: string): void {\n    const privateKey = Symbol(`${String(propertyKey)}__`);\n\n    Object.defineProperty(target, propertyKey, {\n      get(this: DirectiveBase) {\n        if (cache === false || (this as any)[privateKey] === undefined) {\n          (this as any)[privateKey] = this.element_.querySelectorAll(selector);\n        }\n        return (this as any)[privateKey];\n      },\n      configurable: true,\n      enumerable: true,\n    });\n  };\n}\n"],
-  "mappings": ";;AAAA,OAAQ,iBAAmB,iBAQpB,IAAM,OAAS,aAAa,gBAAgB,EAK5C,IAAM,mBAA8E,CAAC,ECX5F,IAAM,qBAAuB,oBAwBtB,SAAS,oBAAoB,YAAkC,SAAS,KAAY,CACzF,OAAO,YAAY,qBAAqB,EAExC,SAAW,CAAC,SAAU,WAAW,IAAK,mBAAoB,CACxD,GAAI,CACF,MAAM,sBAAwB,GAAG,QAAQ,SAAS,oBAAoB,KACtE,MAAM,SAAW,YAAY,iBAA8B,qBAAqB,EAChF,GAAI,SAAS,SAAW,EAAG,SAE3B,OAAO,WAAW,SAAS,SAAS,MAAM,kCAAkC,QAAQ,GAAG,EACvF,SAAS,QAAS,SAAY,CAE5B,QAAQ,aAAa,qBAAsB,MAAM,EAEjD,IAAI,YAAY,QAAS,QAAQ,CACnC,CAAC,CACH,OACO,IAAK,CACV,OAAO,MAAM,sBAAuB,gCAAiC,IAAK,CAAC,QAAQ,CAAC,CACtF,CACF,CACF,CCtBO,SAAS,UAAU,SAAkB,CAC1C,OAAO,gBAAgB,aAAc,QAAQ,EAM7C,OAAO,SAAU,YAAyC,CACxD,mBAAmB,KAAK,CAAC,SAAU,WAAW,CAAC,CACjD,CACF,CCnCA,OAAQ,UAAY,gBACpB,OAAQ,gBAAAA,kBAAmB,iBAMpB,IAAe,cAAf,KAA6B,CAqBlC,YAAY,QAAsB,SAAkB,CAClD,KAAK,QAAUA,cAAa,aAAa,QAAQ,EAAE,EACnD,KAAK,QAAQ,gBAAgB,MAAO,CAAC,SAAU,OAAO,CAAC,EAEvD,KAAK,UAAY,SACjB,KAAK,SAAW,SAEf,SAAY,CACX,MAAM,MAAM,cAAc,EAC1B,MAAM,KAAK,MAAM,EACjB,MAAM,KAAK,QAAQ,CACrB,GAAG,CACL,CAQU,OAAyB,CACjC,KAAK,QAAQ,YAAY,MAAM,CACjC,CAEU,UAA4B,CACpC,KAAK,QAAQ,YAAY,SAAS,EAClC,KAAK,SAAS,OAAO,EAEpB,KAAa,SAAW,IAC3B,CAOU,UAAU,UAAmB,OAAwB,CAC7D,KAAK,QAAQ,gBAAgB,YAAa,CAAC,UAAW,MAAM,CAAC,EAC7D,KAAK,SAAS,cAAc,IAAI,YAAY,UAAW,CAAC,OAAQ,QAAS,IAAI,CAAC,CAAC,CACjF,CACF,ECjDO,SAAS,MAAM,SAAkB,MAAQ,KAAM,CACpD,OAAO,SAAU,OAAuB,YAA2B,CACjE,MAAM,WAAa,OAAO,GAAG,OAAO,WAAW,CAAC,IAAI,EAEpD,OAAO,eAAe,OAAQ,YAAa,CACzC,KAAyB,CACvB,GAAI,QAAU,OAAU,KAAa,UAAU,IAAM,OAAW,CAC7D,KAAa,UAAU,EAAI,KAAK,SAAS,cAAc,QAAQ,CAClE,CACA,OAAQ,KAAa,UAAU,CACjC,EACA,aAAc,KACd,WAAY,IACd,CAAC,CACH,CACF,CAiBO,SAAS,SAAS,SAAkB,MAAQ,KAAM,CACvD,OAAO,SAAU,OAAuB,YAA2B,CACjE,MAAM,WAAa,OAAO,GAAG,OAAO,WAAW,CAAC,IAAI,EAEpD,OAAO,eAAe,OAAQ,YAAa,CACzC,KAAyB,CACvB,GAAI,QAAU,OAAU,KAAa,UAAU,IAAM,OAAW,CAC7D,KAAa,UAAU,EAAI,KAAK,SAAS,iBAAiB,QAAQ,CACrE,CACA,OAAQ,KAAa,UAAU,CACjC,EACA,aAAc,KACd,WAAY,IACd,CAAC,CACH,CACF",
+  "sourcesContent": ["import {createLogger} from '@alwatr/logger';\n\nimport type {DirectiveConstructor} from './directiveDecorator.js';\nimport type {} from '@alwatr/type-helper';\n\n/**\n * Alwatr Synapse Logger.\n */\nexport const logger = createLogger('alwatr/synapse');\n\n/**\n * The registry for all directives.\n */\nexport const directiveRegistry_: {selector: string; constructor: DirectiveConstructor}[] = [];\n", "import {directiveRegistry_, logger} from './lib.js';\n\nconst initializedAttribute = '_synapseConnected';\n\n/**\n * Initializes all registered directives within a given root element.\n * If no root element is provided, it scans the entire body.\n *\n * This function is idempotent; it will not re-initialize a directive on an element\n * that has already been processed.\n *\n * @param rootElement The element to scan for directives. Defaults to `document.body`.\n *\n * @example\n * ```ts\n * // Initialize directives on the whole page after the DOM is loaded.\n * document.addEventListener('DOMContentLoaded', () => bootstrapDirectives());\n *\n * // Or, initialize directives on a dynamically added part of the page.\n * const newContent = document.createElement('div');\n * newContent.innerHTML = '<div class=\"my-button\">Click Me</div>';\n * document.body.appendChild(newContent);\n *\n * bootstrapDirectives(newContent);\n * ```\n */\nexport function bootstrapDirectives(rootElement: Element | Document = document.body): void {\n  logger.logMethod?.('bootstrapDirectives');\n\n  for (const {selector, constructor} of directiveRegistry_) {\n    try {\n      const uninitializedSelector = `${selector}:not([${initializedAttribute}])`;\n      const elements = rootElement.querySelectorAll<HTMLElement>(uninitializedSelector);\n      if (elements.length === 0) continue;\n\n      logger.logOther?.(`Found ${elements.length} new element(s) for directive \"${selector}\"`);\n      elements.forEach((element) => {\n        // Mark the element as processed before creating an instance\n        element.setAttribute(initializedAttribute, 'true');\n        // Instantiate the directive with the element.\n        new constructor(element, selector);\n      });\n    }\n    catch (err) {\n      logger.error('bootstrapDirectives', 'directive_instantiation_error', err, {selector});\n    }\n  }\n}\n", "import {directiveRegistry_, logger} from './lib.js';\n\nimport type {DirectiveBase} from './directiveClass.js';\n\n/**\n * Type definition for a directive constructor.\n * A directive class must have a constructor that accepts an HTMLElement.\n */\nexport type DirectiveConstructor<T extends DirectiveBase = DirectiveBase> = new (element: HTMLElement, selector: string) => T;\n\n/**\n * A class decorator that registers a class as a directive.\n *\n * @param selector The CSS selector to which this directive will be attached.\n *\n * @example\n * ```ts\n * @directive('.my-button')\n * class MyButtonDirective extends DirectiveBase {\n *   protected update_(): void {\n *     this.element_.addEventListener('click', () => console.log('Button clicked!'));\n *   }\n * }\n * ```\n */\nexport function directive(selector: string) {\n  logger.logMethodArgs?.('@directive', selector);\n\n  /**\n   * The decorator function that receives the class constructor.\n   * @param constructor The class to be registered as a directive.\n   */\n  return function (constructor: DirectiveConstructor): void {\n    directiveRegistry_.push({selector, constructor});\n  };\n}\n", "/**\n * @package @alwatr/synapse\n *\n * This file defines the `DirectiveBase` class, which is the foundation for creating custom directives\n * in the Alwatr Synapse library. Directives are used to attach behavior and logic to DOM elements\n * declaratively.\n */\n\nimport {delay} from '@alwatr/delay';\nimport {createLogger} from '@alwatr/logger';\n\n/**\n * The abstract base class for all directives.\n *\n * Extend this class to create a new directive that can be registered with the `@directive` decorator.\n * It provides the core functionality for linking a TypeScript class to a DOM element and managing its lifecycle.\n *\n * @example\n * ```ts\n * import {DirectiveBase, directive} from '@alwatr/synapse';\n *\n * @directive('[my-directive]')\n * export class MyDirective extends DirectiveBase {\n *   protected override init_(): void {\n *     super.init_(); // فراخوانی متد والد برای حفظ سازگاری با نسخه‌های قبل ضروری است\n *     this.element_.textContent = 'Hello from MyDirective!';\n *     this.element_.addEventListener('click', () => this.log('Element clicked!'));\n *   }\n * }\n * ```\n */\nexport abstract class DirectiveBase {\n  /**\n   * The CSS selector that this directive is associated with.\n   * This is the selector string provided to the `@directive` decorator.\n   */\n  protected readonly selector_;\n\n  /**\n   * A dedicated logger instance for this directive, pre-configured with a context like `directive:[selector]`.\n   * Use this for logging to provide clear, contextual messages.\n   */\n  protected readonly logger_;\n\n  /**\n   * The DOM element to which this directive instance is attached.\n   * All directive logic operates on this element.\n   */\n  protected readonly element_: HTMLElement;\n\n  /**\n   * Initializes the directive. This constructor is called by the Synapse bootstrap process and should not be\n   * overridden in subclasses.\n   *\n   * It sets up the logger, element, and selector, and then schedules the `init_` and `update_` lifecycle methods\n   * to run in the next microtask.\n   *\n   * @param element The DOM element to which this directive is attached.\n   * @param selector The CSS selector that matched this directive.\n   */\n  constructor(element: HTMLElement, selector: string) {\n    this.logger_ = createLogger(`directive:${selector}`);\n    this.logger_.logMethodArgs?.('new', {selector, element});\n\n    this.selector_ = selector;\n    this.element_ = element;\n\n    (async () => {\n      await delay.nextMicrotask();\n      await this.init_();\n    })();\n  }\n\n  /**\n   * Called once automatically after the directive is initialized.\n   *\n   * This method serves as the main entry point for your directive's logic,\n   * such as modifying the element or setting up event listeners.\n   *\n   * **Note:** Do not call this method directly. It is designed to be called only once by the framework.\n   */\n  protected init_(): Awaitable<void> {\n    this.logger_.logMethod?.('init_');\n\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this as any).update_?.(); // backward compatibility\n  }\n\n  /**\n   * Dispatches a custom event from the target element.\n   *\n   * This is a convenience method for firing events that can be listened to by other parts of the application.\n   * The event bubbles up through the DOM.\n   *\n   * @param eventName The name of the custom event.\n   * @param detail Optional data to include in the event's `detail` property.\n   *\n   * @example\n   * ```ts\n   * this.dispatch_('user-action', {action: 'save', id: 123});\n   * ```\n   */\n  protected dispatch_(eventName: string, detail?: unknown): void {\n    this.logger_.logMethodArgs?.('dispatch_', {eventName, detail});\n    this.element_.dispatchEvent(new CustomEvent(eventName, {detail, bubbles: true}));\n  }\n\n  /**\n   * Cleans up the directive's resources.\n   *\n   * This method removes the element from the DOM and nullifies the internal reference to it,\n   * helping with garbage collection. It can be extended by subclasses to perform additional cleanup,\n   * such as removing event listeners.\n   */\n  protected destroy_(): Awaitable<void> {\n    this.logger_.logMethod?.('destroy_');\n    this.element_.remove();\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    (this as any).element_ = null;\n  }\n}\n", "/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type {DirectiveBase} from './directiveClass.js';\n\n/**\n * A property decorator that queries the directive's element for a selector.\n * The query is performed once and the result is cached.\n *\n * @param selector The CSS selector to query for.\n * @param cache Whether to cache the result on first access. Defaults is true.\n *\n * @example\n * ```ts\n * @directive('[my-directive]')\n * class MyDirective extends DirectiveBase {\n *   @query('.my-element')\n *   protected myElement: HTMLDivElement | null;\n * }\n * ```\n */\nexport function query(selector: string, cache = true) {\n  return function (target: DirectiveBase, propertyKey: string): void {\n    const privateKey = Symbol(`${String(propertyKey)}__`);\n\n    Object.defineProperty(target, propertyKey, {\n      get(this: DirectiveBase) {\n        if (cache === false || (this as any)[privateKey] === undefined) {\n          (this as any)[privateKey] = this.element_.querySelector(selector);\n        }\n        return (this as any)[privateKey];\n      },\n      configurable: true,\n      enumerable: true,\n    });\n  };\n}\n\n/**\n * A property decorator that queries the directive's element for all selectors.\n * The queries are performed once and the result is cached.\n *\n * @param selector The CSS selector to query for.\n *\n * @example\n * ```ts\n * @directive('[my-directive]')\n * class MyDirective extends DirectiveBase {\n *   @queryAll('.my-elements')\n *   protected myElements: NodeListOf<HTMLDivElement>;\n * }\n * ```\n */\nexport function queryAll(selector: string, cache = true) {\n  return function (target: DirectiveBase, propertyKey: string): void {\n    const privateKey = Symbol(`${String(propertyKey)}__`);\n\n    Object.defineProperty(target, propertyKey, {\n      get(this: DirectiveBase) {\n        if (cache === false || (this as any)[privateKey] === undefined) {\n          (this as any)[privateKey] = this.element_.querySelectorAll(selector);\n        }\n        return (this as any)[privateKey];\n      },\n      configurable: true,\n      enumerable: true,\n    });\n  };\n}\n"],
+  "mappings": ";;AAAA,OAAQ,iBAAmB,iBAQpB,IAAM,OAAS,aAAa,gBAAgB,EAK5C,IAAM,mBAA8E,CAAC,ECX5F,IAAM,qBAAuB,oBAwBtB,SAAS,oBAAoB,YAAkC,SAAS,KAAY,CACzF,OAAO,YAAY,qBAAqB,EAExC,SAAW,CAAC,SAAU,WAAW,IAAK,mBAAoB,CACxD,GAAI,CACF,MAAM,sBAAwB,GAAG,QAAQ,SAAS,oBAAoB,KACtE,MAAM,SAAW,YAAY,iBAA8B,qBAAqB,EAChF,GAAI,SAAS,SAAW,EAAG,SAE3B,OAAO,WAAW,SAAS,SAAS,MAAM,kCAAkC,QAAQ,GAAG,EACvF,SAAS,QAAS,SAAY,CAE5B,QAAQ,aAAa,qBAAsB,MAAM,EAEjD,IAAI,YAAY,QAAS,QAAQ,CACnC,CAAC,CACH,OACO,IAAK,CACV,OAAO,MAAM,sBAAuB,gCAAiC,IAAK,CAAC,QAAQ,CAAC,CACtF,CACF,CACF,CCtBO,SAAS,UAAU,SAAkB,CAC1C,OAAO,gBAAgB,aAAc,QAAQ,EAM7C,OAAO,SAAU,YAAyC,CACxD,mBAAmB,KAAK,CAAC,SAAU,WAAW,CAAC,CACjD,CACF,CC3BA,OAAQ,UAAY,gBACpB,OAAQ,gBAAAA,kBAAmB,iBAsBpB,IAAe,cAAf,KAA6B,CA6BlC,YAAY,QAAsB,SAAkB,CAClD,KAAK,QAAUA,cAAa,aAAa,QAAQ,EAAE,EACnD,KAAK,QAAQ,gBAAgB,MAAO,CAAC,SAAU,OAAO,CAAC,EAEvD,KAAK,UAAY,SACjB,KAAK,SAAW,SAEf,SAAY,CACX,MAAM,MAAM,cAAc,EAC1B,MAAM,KAAK,MAAM,CACnB,GAAG,CACL,CAUU,OAAyB,CACjC,KAAK,QAAQ,YAAY,OAAO,EAG/B,KAAa,UAAU,CAC1B,CAgBU,UAAU,UAAmB,OAAwB,CAC7D,KAAK,QAAQ,gBAAgB,YAAa,CAAC,UAAW,MAAM,CAAC,EAC7D,KAAK,SAAS,cAAc,IAAI,YAAY,UAAW,CAAC,OAAQ,QAAS,IAAI,CAAC,CAAC,CACjF,CASU,UAA4B,CACpC,KAAK,QAAQ,YAAY,UAAU,EACnC,KAAK,SAAS,OAAO,EAEpB,KAAa,SAAW,IAC3B,CACF,ECrGO,SAAS,MAAM,SAAkB,MAAQ,KAAM,CACpD,OAAO,SAAU,OAAuB,YAA2B,CACjE,MAAM,WAAa,OAAO,GAAG,OAAO,WAAW,CAAC,IAAI,EAEpD,OAAO,eAAe,OAAQ,YAAa,CACzC,KAAyB,CACvB,GAAI,QAAU,OAAU,KAAa,UAAU,IAAM,OAAW,CAC7D,KAAa,UAAU,EAAI,KAAK,SAAS,cAAc,QAAQ,CAClE,CACA,OAAQ,KAAa,UAAU,CACjC,EACA,aAAc,KACd,WAAY,IACd,CAAC,CACH,CACF,CAiBO,SAAS,SAAS,SAAkB,MAAQ,KAAM,CACvD,OAAO,SAAU,OAAuB,YAA2B,CACjE,MAAM,WAAa,OAAO,GAAG,OAAO,WAAW,CAAC,IAAI,EAEpD,OAAO,eAAe,OAAQ,YAAa,CACzC,KAAyB,CACvB,GAAI,QAAU,OAAU,KAAa,UAAU,IAAM,OAAW,CAC7D,KAAa,UAAU,EAAI,KAAK,SAAS,iBAAiB,QAAQ,CACrE,CACA,OAAQ,KAAa,UAAU,CACjC,EACA,aAAc,KACd,WAAY,IACd,CAAC,CACH,CACF",
   "names": ["createLogger"]
 }

package/dist/queryDecorator.d.ts

@@ -11,7 +11,7 @@ import type { DirectiveBase } from './directiveClass.js';
  * @directive('[my-directive]')
  * class MyDirective extends DirectiveBase {
  *   @query('.my-element')
- *   protected myElement?: HTMLDivElement;
+ *   protected myElement: HTMLDivElement | null;
  * }
  * ```
  */
@@ -27,7 +27,7 @@ export declare function query(selector: string, cache?: boolean): (target: Direc
  * @directive('[my-directive]')
  * class MyDirective extends DirectiveBase {
  *   @queryAll('.my-elements')
- *   protected myElements?: NodeListOf<HTMLDivElement>;
+ *   protected myElements: NodeListOf<HTMLDivElement>;
  * }
  * ```
  */

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@alwatr/synapse",
   "description": "Connect your TypeScript classes to the DOM, declaratively.",
-  "version": "1.1.17",
+  "version": "1.1.19",
   "author": "S. Ali Mihandoost <ali.mihandoost@gmail.com>",
   "bugs": "https://github.com/Alwatr/nanolib/issues",
   "dependencies": {
-    "@alwatr/delay": "6.0.12",
-    "@alwatr/logger": "6.0.9"
+    "@alwatr/delay": "6.0.13",
+    "@alwatr/logger": "6.0.10"
   },
   "devDependencies": {
-    "@alwatr/nano-build": "6.3.5",
+    "@alwatr/nano-build": "6.3.6",
     "@alwatr/prettier-config": "5.0.5",
     "@alwatr/tsconfig-base": "6.0.3",
     "@alwatr/type-helper": "6.1.5",
@@ -80,5 +80,5 @@
   "sideEffects": false,
   "type": "module",
   "types": "./dist/main.d.ts",
-  "gitHead": "b141732f4dab13542e3cc99926a250fd5c74bad3"
+  "gitHead": "211a46c74acca97bf4b570b20c6dffbdf8bcccfe"
 }