ngx-kit 8.4.1 → 9.0.0

package/fesm2022/ngx-kit-menu.mjs

@@ -1,12 +1,9 @@
 import * as i0 from '@angular/core';
-import { input, HostListener, Directive, InjectionToken, viewChild, TemplateRef, Component, inject, NgModule } from '@angular/core';
-import * as i1 from 'ngx-kit/core';
+import { input, inject, ApplicationRef, ElementRef, HostListener, Directive, InjectionToken, viewChild, TemplateRef, Component, NgModule } from '@angular/core';
+import { OverlayService } from 'ngx-kit/core';
 import { CommonModule } from '@angular/common';
 
 class NgxMenu {
-    el;
-    appRef;
-    overlayService;
     ngxMenu = input.required(/* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ngxMenu" }] : /* istanbul ignore next */ []));
     placement = input(/* @ts-ignore */
@@ -14,11 +11,10 @@ class NgxMenu {
     alignment = input(/* @ts-ignore */
     ...(ngDevMode ? [undefined, { debugName: "alignment" }] : /* istanbul ignore next */ []));
     containerRef;
-    constructor(el, appRef, overlayService) {
-        this.el = el;
-        this.appRef = appRef;
-        this.overlayService = overlayService;
-    }
+    overlay = inject(OverlayService);
+    appRef = inject(ApplicationRef);
+    el = inject(ElementRef);
+    constructor() { }
     ngOnDestroy() {
         this.destroyContainer();
     }
@@ -35,7 +31,7 @@ class NgxMenu {
         const t = this.ngxMenu().template();
         if (!t)
             return;
-        this.containerRef = this.overlayService.openTemplate({
+        this.containerRef = this.overlay.openTemplate({
             anchor: this.el.nativeElement,
             template: t,
             appRef: this.appRef,
@@ -44,7 +40,7 @@ class NgxMenu {
             panelClass: 'ngx-menu-overlay',
             onClosed: () => {
                 this.containerRef = undefined;
-                this.overlayService.closeAll();
+                this.overlay.closeAll();
             },
             configure: (instance, ref) => {
                 this.ngxMenu().containerRef = ref;
@@ -55,7 +51,7 @@ class NgxMenu {
         this.containerRef?.close();
         this.containerRef = undefined;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.4", ngImport: i0, type: NgxMenu, deps: [{ token: i0.ElementRef }, { token: i0.ApplicationRef }, { token: i1.OverlayService }], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.4", ngImport: i0, type: NgxMenu, deps: [], target: i0.ɵɵFactoryTarget.Directive });
     static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.4", type: NgxMenu, isStandalone: true, selector: "[ngxMenu]", inputs: { ngxMenu: { classPropertyName: "ngxMenu", publicName: "ngxMenu", isSignal: true, isRequired: true, transformFunction: null }, placement: { classPropertyName: "placement", publicName: "placement", isSignal: true, isRequired: false, transformFunction: null }, alignment: { classPropertyName: "alignment", publicName: "alignment", isSignal: true, isRequired: false, transformFunction: null } }, host: { listeners: { "click": "onClick($event)" } }, exportAs: ["ngxMenu"], ngImport: i0 });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.4", ngImport: i0, type: NgxMenu, decorators: [{
@@ -64,15 +60,12 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.4", ngImpor
                     selector: '[ngxMenu]',
                     exportAs: 'ngxMenu',
                 }]
-        }], ctorParameters: () => [{ type: i0.ElementRef }, { type: i0.ApplicationRef }, { type: i1.OverlayService }], propDecorators: { ngxMenu: [{ type: i0.Input, args: [{ isSignal: true, alias: "ngxMenu", required: true }] }], placement: [{ type: i0.Input, args: [{ isSignal: true, alias: "placement", required: false }] }], alignment: [{ type: i0.Input, args: [{ isSignal: true, alias: "alignment", required: false }] }], onClick: [{
+        }], ctorParameters: () => [], propDecorators: { ngxMenu: [{ type: i0.Input, args: [{ isSignal: true, alias: "ngxMenu", required: true }] }], placement: [{ type: i0.Input, args: [{ isSignal: true, alias: "placement", required: false }] }], alignment: [{ type: i0.Input, args: [{ isSignal: true, alias: "alignment", required: false }] }], onClick: [{
                 type: HostListener,
                 args: ['click', ['$event']]
             }] } });
 
 class NgxContextMenu {
-    el;
-    appRef;
-    overlayService;
     ngxContextMenu = input.required(/* @ts-ignore */
     ...(ngDevMode ? [{ debugName: "ngxContextMenu" }] : /* istanbul ignore next */ []));
     containerRef;
@@ -81,11 +74,11 @@ class NgxContextMenu {
     // که removeEventListener اصلاً نمی‌تونست تشخیص بده مال همون listener قبلیه،
     // پس listener هیچ‌وقت واقعاً حذف نمی‌شد (نشتی حافظه‌ی کامل directive + المنت).
     boundOnClick = (ev) => this.onClick(ev);
-    constructor(el, appRef, overlayService) {
-        this.el = el;
-        this.appRef = appRef;
-        this.overlayService = overlayService;
-        el.nativeElement.addEventListener('contextmenu', this.boundOnClick);
+    overlay = inject(OverlayService);
+    appRef = inject(ApplicationRef);
+    el = inject(ElementRef);
+    constructor() {
+        this.el.nativeElement.addEventListener('contextmenu', this.boundOnClick);
     }
     ngOnDestroy() {
         this.destroyContainer();
@@ -106,7 +99,7 @@ class NgxContextMenu {
         const t = this.ngxContextMenu().template();
         if (!t)
             return;
-        this.containerRef = this.overlayService.openTemplate({
+        this.containerRef = this.overlay.openTemplate({
             anchor: this.el.nativeElement,
             point: { x, y },
             template: t,
@@ -115,7 +108,7 @@ class NgxContextMenu {
             placement: 'auto',
             onClosed: () => {
                 this.containerRef = undefined;
-                this.overlayService.closeAll();
+                this.overlay.closeAll();
             },
             configure: (instance, ref) => {
                 this.ngxContextMenu().containerRef = ref;
@@ -126,7 +119,7 @@ class NgxContextMenu {
         this.containerRef?.close();
         this.containerRef = undefined;
     }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.4", ngImport: i0, type: NgxContextMenu, deps: [{ token: i0.ElementRef }, { token: i0.ApplicationRef }, { token: i1.OverlayService }], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.4", ngImport: i0, type: NgxContextMenu, deps: [], target: i0.ɵɵFactoryTarget.Directive });
     static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "17.1.0", version: "22.0.4", type: NgxContextMenu, isStandalone: true, selector: "[ngxContextMenu]", inputs: { ngxContextMenu: { classPropertyName: "ngxContextMenu", publicName: "ngxContextMenu", isSignal: true, isRequired: true, transformFunction: null } }, exportAs: ["ngxContextMenu"], ngImport: i0 });
 }
 i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.4", ngImport: i0, type: NgxContextMenu, decorators: [{
@@ -135,7 +128,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.4", ngImpor
                     selector: '[ngxContextMenu]',
                     exportAs: 'ngxContextMenu',
                 }]
-        }], ctorParameters: () => [{ type: i0.ElementRef }, { type: i0.ApplicationRef }, { type: i1.OverlayService }], propDecorators: { ngxContextMenu: [{ type: i0.Input, args: [{ isSignal: true, alias: "ngxContextMenu", required: true }] }] } });
+        }], ctorParameters: () => [], propDecorators: { ngxContextMenu: [{ type: i0.Input, args: [{ isSignal: true, alias: "ngxContextMenu", required: true }] }] } });
 
 const NGX_MENU_CONTEXT = new InjectionToken('ngx-menu-context');
 

package/fesm2022/ngx-kit-menu.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"ngx-kit-menu.mjs","sources":["../../../projects/libs/menu/directives/ngx-menu.directive.ts","../../../projects/libs/menu/directives/ngx-context-menu.directive.ts","../../../projects/libs/menu/tokens/menu-context.token.ts","../../../projects/libs/menu/components/ngx-menu/menu.component.ts","../../../projects/libs/menu/components/ngx-menu-item/menu-item.component.ts","../../../projects/libs/menu/components/ngx-menu-divider/menu-divider.component.ts","../../../projects/libs/menu/ngx-menu.module.ts","../../../projects/libs/menu/ngx-kit-menu.ts"],"sourcesContent":["import {\n  Directive,\n  OnDestroy,\n  ElementRef,\n  HostListener,\n  input,\n  ApplicationRef,\n} from '@angular/core';\nimport { OverlayRef, OverlayService, OverlayInstance, Alignment, Placement } from 'ngx-kit/core';\nimport { NgxMenuPanel } from '../components/ngx-menu/menu.component';\n\n@Directive({\n  selector: '[ngxMenu]',\n  exportAs: 'ngxMenu',\n})\nexport class NgxMenu implements OnDestroy {\n  ngxMenu = input.required<NgxMenuPanel>();\n  placement = input<Placement>();\n  alignment = input<Alignment>();\n\n  private containerRef?: OverlayRef<NgxMenuPanel>;\n\n  constructor(\n    private el: ElementRef,\n    private appRef: ApplicationRef,\n    private overlayService: OverlayService,\n  ) {}\n\n  ngOnDestroy(): void {\n    this.destroyContainer();\n  }\n\n  @HostListener('click', ['$event'])\n  onClick(ev: Event) {\n    ev.stopPropagation();\n    ev.preventDefault();\n    this.toggleContainer();\n  }\n\n  private toggleContainer() {\n    if (this.containerRef) {\n      this.destroyContainer();\n      return;\n    }\n    const t = this.ngxMenu().template();\n    if (!t) return;\n    this.containerRef = this.overlayService.openTemplate({\n      anchor: this.el.nativeElement,\n      template: t,\n      appRef: this.appRef,\n      alignment: this.alignment() ?? 'start',\n      placement: this.placement() ?? 'auto',\n      panelClass: 'ngx-menu-overlay',\n      onClosed: () => {\n        this.containerRef = undefined;\n        this.overlayService.closeAll();\n      },\n      configure: (instance: OverlayInstance, ref: OverlayRef<NgxMenuPanel>) => {\n        this.ngxMenu().containerRef = ref;\n      },\n    });\n  }\n\n  private destroyContainer() {\n    this.containerRef?.close();\n    this.containerRef = undefined;\n  }\n}\n","import { Directive, OnDestroy, input, ApplicationRef, ElementRef } from '@angular/core';\nimport { OverlayRef, OverlayService, OverlayInstance } from 'ngx-kit/core';\nimport { NgxMenuPanel } from '../components/ngx-menu/menu.component';\n\n@Directive({\n  selector: '[ngxContextMenu]',\n  exportAs: 'ngxContextMenu',\n})\nexport class NgxContextMenu implements OnDestroy {\n  ngxContextMenu = input.required<NgxMenuPanel>();\n\n  private containerRef?: OverlayRef<NgxMenuPanel>;\n\n  // باید همون رفرنس تابعی که به addEventListener داده می‌شه رو نگه داریم و به\n  // removeEventListener هم بدیم؛ قبلاً هر بار یک آرو فانکشن جدید ساخته می‌شد\n  // که removeEventListener اصلاً نمی‌تونست تشخیص بده مال همون listener قبلیه،\n  // پس listener هیچ‌وقت واقعاً حذف نمی‌شد (نشتی حافظه‌ی کامل directive + المنت).\n  private readonly boundOnClick = (ev: PointerEvent) => this.onClick(ev);\n\n  constructor(\n    private el: ElementRef<HTMLElement>,\n    private appRef: ApplicationRef,\n    private overlayService: OverlayService,\n  ) {\n    el.nativeElement.addEventListener('contextmenu', this.boundOnClick);\n  }\n\n  ngOnDestroy(): void {\n    this.destroyContainer();\n    this.el.nativeElement.removeEventListener('contextmenu', this.boundOnClick);\n  }\n\n  onClick(ev: PointerEvent) {\n    if (ev.currentTarget == this.el.nativeElement) {\n      ev.stopPropagation();\n      ev.preventDefault();\n      this.toggleContainer(ev.clientX, ev.clientY);\n    }\n  }\n\n  private toggleContainer(x: number, y: number) {\n    if (this.containerRef) {\n      this.destroyContainer();\n      return;\n    }\n    const t = this.ngxContextMenu().template();\n    if (!t) return;\n    this.containerRef = this.overlayService.openTemplate({\n      anchor: this.el.nativeElement,\n      point: { x, y },\n      template: t,\n      appRef: this.appRef,\n      alignment: 'start',\n      placement: 'auto',\n      onClosed: () => {\n        this.containerRef = undefined;\n        this.overlayService.closeAll();\n      },\n      configure: (instance: OverlayInstance, ref: OverlayRef<NgxMenuPanel>) => {\n        this.ngxContextMenu().containerRef = ref;\n      },\n    });\n  }\n\n  private destroyContainer() {\n    this.containerRef?.close();\n    this.containerRef = undefined;\n  }\n}\n","import { InjectionToken } from '@angular/core';\n\nexport interface MenuContext {\n  close(): void;\n}\n\nexport const NGX_MENU_CONTEXT = new InjectionToken<MenuContext>('ngx-menu-context');\n","import { CommonModule } from '@angular/common';\nimport { Component, input, TemplateRef, viewChild } from '@angular/core';\nimport { OverlayRef } from 'ngx-kit/core';\nimport { MenuContext, NGX_MENU_CONTEXT } from '../../tokens/menu-context.token';\n\n@Component({\n  selector: 'ngx-menu,[ngx-menu]',\n  template: `\n    <ng-template>\n      <div class=\"ngx-menu-panel\" [class]=\"class()\">\n        <ng-content></ng-content>\n      </div>\n    </ng-template>\n  `,\n  exportAs: 'NgxMenu',\n  styles: `\n    .ngx-menu-panel {\n      --ngx-menu-bg: light-dark(#ffffff, #252425);\n      --ngx-menu-fg: light-dark(#000000, #ffffff);\n    }\n    .ngx-menu-panel {\n      overflow: auto;\n      box-sizing: border-box;\n      outline: 0;\n      background-color: var(--ngx-menu-bg);\n      color: var(--ngx-menu-fg);\n      box-shadow: var(--ngx-menu-shadow, 0px 0px 4px rgb(0 0 0 / 30%));\n      border-radius: var(--ngx-menu-radius, 10px);\n      padding: var(--ngx-menu-padding, 5px);\n      min-width: var(--ngx-menu-min-width, 20px);\n      min-height: var(--ngx-menu-min-height, 40px);\n      will-change: transform, opacity;\n      width: 100%;\n      height: 100%;\n    }\n    .ngx-menu-panel.ngx-menu-panel-exit {\n      animation: menu-exit 100ms 25ms linear forwards;\n    }\n  `,\n  imports: [CommonModule],\n  providers: [{ provide: NGX_MENU_CONTEXT, useExisting: NgxMenuPanel }],\n})\nexport class NgxMenuPanel implements MenuContext {\n  template = viewChild<TemplateRef<any>>(TemplateRef);\n  class = input<string>();\n\n  containerRef?: OverlayRef<NgxMenuPanel>;\n\n  close(): void {\n    this.containerRef?.close();\n  }\n}\n","import { Component, HostListener, inject } from '@angular/core';\nimport { NGX_MENU_CONTEXT } from '../../tokens/menu-context.token';\nimport { NgxMenu } from '../../directives/ngx-menu.directive';\n\n@Component({\n  selector: 'ngx-menu-item,[ngx-menu-item]',\n  template: `\n    <div class=\"ngx-menu-item\">\n      <ng-content></ng-content>\n    </div>\n  `,\n  exportAs: 'NgxMenuItem',\n  styles: `\n    .ngx-menu-item {\n      box-sizing: border-box;\n      outline: 0;\n      padding: var(--ngx-menu-item-padding, 6px 12px);\n      transition: all 300ms;\n      &:hover {\n        cursor: pointer;\n        background-color: var(--ngx-menu-item-hover-bg, #9bc6ff68);\n      }\n    }\n  `,\n})\nexport class NgxMenuItem {\n  menuContext = inject(NGX_MENU_CONTEXT);\n  childMenu = inject(NgxMenu, {\n    self: true,\n    optional: true,\n  });\n\n  @HostListener('click')\n  onClick() {\n    if (this.childMenu?.ngxMenu) {\n      return;\n    }\n    this.menuContext?.close();\n  }\n}\n","import { Component } from '@angular/core';\n\n@Component({\n  selector: 'ngx-menu-divider,[ngx-menu-divider]',\n  template: ``,\n  styles: `\n    :host {\n      display: block;\n      border-bottom: var(--ngx-menu-item-border, 1px #43434d3d solid);\n      border-bottom-color: var(--ngx-menu-divider-border-color, #43434d3d);\n      margin: var(--ngx-menu-divider-margin, 10px calc(var(--ngx-menu-padding, 5px) * -1));\n    }\n  `,\n})\nexport class NgxMenuDivider {}\n","import { NgModule } from '@angular/core';\nimport { NgxMenuDivider } from './components/ngx-menu-divider/menu-divider.component';\nimport { NgxMenuItem } from './components/ngx-menu-item/menu-item.component';\nimport { NgxMenuPanel } from './components/ngx-menu/menu.component';\nimport { NgxMenu } from './directives/ngx-menu.directive';\nimport { NgxContextMenu } from './directives/ngx-context-menu.directive';\n\nconst d = [NgxMenu, NgxContextMenu, NgxMenuPanel, NgxMenuItem, NgxMenuDivider];\n@NgModule({\n  imports: d,\n  exports: d,\n})\nexport class NgxMenuModule {}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"ngx-kit-menu.mjs","sources":["../../../projects/libs/menu/directives/ngx-menu.directive.ts","../../../projects/libs/menu/directives/ngx-context-menu.directive.ts","../../../projects/libs/menu/tokens/menu-context.token.ts","../../../projects/libs/menu/components/ngx-menu/menu.component.ts","../../../projects/libs/menu/components/ngx-menu-item/menu-item.component.ts","../../../projects/libs/menu/components/ngx-menu-divider/menu-divider.component.ts","../../../projects/libs/menu/ngx-menu.module.ts","../../../projects/libs/menu/ngx-kit-menu.ts"],"sourcesContent":["import {\n  Directive,\n  OnDestroy,\n  ElementRef,\n  HostListener,\n  input,\n  ApplicationRef,\n  inject,\n} from '@angular/core';\nimport { OverlayRef, OverlayService, OverlayInstance, Alignment, Placement } from 'ngx-kit/core';\nimport { NgxMenuPanel } from '../components/ngx-menu/menu.component';\n\n@Directive({\n  selector: '[ngxMenu]',\n  exportAs: 'ngxMenu',\n})\nexport class NgxMenu implements OnDestroy {\n  ngxMenu = input.required<NgxMenuPanel>();\n  placement = input<Placement>();\n  alignment = input<Alignment>();\n\n  private containerRef?: OverlayRef<NgxMenuPanel>;\n\n  protected readonly overlay = inject(OverlayService);\n  protected readonly appRef = inject(ApplicationRef);\n  protected readonly el = inject<ElementRef<HTMLElement>>(ElementRef);\n\n  constructor() {}\n\n  ngOnDestroy(): void {\n    this.destroyContainer();\n  }\n\n  @HostListener('click', ['$event'])\n  onClick(ev: Event) {\n    ev.stopPropagation();\n    ev.preventDefault();\n    this.toggleContainer();\n  }\n\n  private toggleContainer() {\n    if (this.containerRef) {\n      this.destroyContainer();\n      return;\n    }\n    const t = this.ngxMenu().template();\n    if (!t) return;\n    this.containerRef = this.overlay.openTemplate({\n      anchor: this.el.nativeElement,\n      template: t,\n      appRef: this.appRef,\n      alignment: this.alignment() ?? 'start',\n      placement: this.placement() ?? 'auto',\n      panelClass: 'ngx-menu-overlay',\n      onClosed: () => {\n        this.containerRef = undefined;\n        this.overlay.closeAll();\n      },\n      configure: (instance: OverlayInstance, ref: OverlayRef<NgxMenuPanel>) => {\n        this.ngxMenu().containerRef = ref;\n      },\n    });\n  }\n\n  private destroyContainer() {\n    this.containerRef?.close();\n    this.containerRef = undefined;\n  }\n}\n","import { Directive, OnDestroy, input, ApplicationRef, ElementRef, inject } from '@angular/core';\nimport { OverlayRef, OverlayService, OverlayInstance } from 'ngx-kit/core';\nimport { NgxMenuPanel } from '../components/ngx-menu/menu.component';\n\n@Directive({\n  selector: '[ngxContextMenu]',\n  exportAs: 'ngxContextMenu',\n})\nexport class NgxContextMenu implements OnDestroy {\n  ngxContextMenu = input.required<NgxMenuPanel>();\n\n  private containerRef?: OverlayRef<NgxMenuPanel>;\n\n  // باید همون رفرنس تابعی که به addEventListener داده می‌شه رو نگه داریم و به\n  // removeEventListener هم بدیم؛ قبلاً هر بار یک آرو فانکشن جدید ساخته می‌شد\n  // که removeEventListener اصلاً نمی‌تونست تشخیص بده مال همون listener قبلیه،\n  // پس listener هیچ‌وقت واقعاً حذف نمی‌شد (نشتی حافظه‌ی کامل directive + المنت).\n  private readonly boundOnClick = (ev: PointerEvent) => this.onClick(ev);\n\n\n  protected readonly overlay = inject(OverlayService);\n  protected readonly appRef = inject(ApplicationRef);\n  protected readonly el = inject<ElementRef<HTMLElement>>(ElementRef);\n  \n  constructor(\n  ) {\n    this.el.nativeElement.addEventListener('contextmenu', this.boundOnClick);\n  }\n\n  ngOnDestroy(): void {\n    this.destroyContainer();\n    this.el.nativeElement.removeEventListener('contextmenu', this.boundOnClick);\n  }\n\n  onClick(ev: PointerEvent) {\n    if (ev.currentTarget == this.el.nativeElement) {\n      ev.stopPropagation();\n      ev.preventDefault();\n      this.toggleContainer(ev.clientX, ev.clientY);\n    }\n  }\n\n  private toggleContainer(x: number, y: number) {\n    if (this.containerRef) {\n      this.destroyContainer();\n      return;\n    }\n    const t = this.ngxContextMenu().template();\n    if (!t) return;\n    this.containerRef = this.overlay.openTemplate({\n      anchor: this.el.nativeElement,\n      point: { x, y },\n      template: t,\n      appRef: this.appRef,\n      alignment: 'start',\n      placement: 'auto',\n      onClosed: () => {\n        this.containerRef = undefined;\n        this.overlay.closeAll();\n      },\n      configure: (instance: OverlayInstance, ref: OverlayRef<NgxMenuPanel>) => {\n        this.ngxContextMenu().containerRef = ref;\n      },\n    });\n  }\n\n  private destroyContainer() {\n    this.containerRef?.close();\n    this.containerRef = undefined;\n  }\n}\n","import { InjectionToken } from '@angular/core';\n\nexport interface MenuContext {\n  close(): void;\n}\n\nexport const NGX_MENU_CONTEXT = new InjectionToken<MenuContext>('ngx-menu-context');\n","import { CommonModule } from '@angular/common';\nimport { Component, input, TemplateRef, viewChild } from '@angular/core';\nimport { OverlayRef } from 'ngx-kit/core';\nimport { MenuContext, NGX_MENU_CONTEXT } from '../../tokens/menu-context.token';\n\n@Component({\n  selector: 'ngx-menu,[ngx-menu]',\n  template: `\n    <ng-template>\n      <div class=\"ngx-menu-panel\" [class]=\"class()\">\n        <ng-content></ng-content>\n      </div>\n    </ng-template>\n  `,\n  exportAs: 'NgxMenu',\n  styles: `\n    .ngx-menu-panel {\n      --ngx-menu-bg: light-dark(#ffffff, #252425);\n      --ngx-menu-fg: light-dark(#000000, #ffffff);\n    }\n    .ngx-menu-panel {\n      overflow: auto;\n      box-sizing: border-box;\n      outline: 0;\n      background-color: var(--ngx-menu-bg);\n      color: var(--ngx-menu-fg);\n      box-shadow: var(--ngx-menu-shadow, 0px 0px 4px rgb(0 0 0 / 30%));\n      border-radius: var(--ngx-menu-radius, 10px);\n      padding: var(--ngx-menu-padding, 5px);\n      min-width: var(--ngx-menu-min-width, 20px);\n      min-height: var(--ngx-menu-min-height, 40px);\n      will-change: transform, opacity;\n      width: 100%;\n      height: 100%;\n    }\n    .ngx-menu-panel.ngx-menu-panel-exit {\n      animation: menu-exit 100ms 25ms linear forwards;\n    }\n  `,\n  imports: [CommonModule],\n  providers: [{ provide: NGX_MENU_CONTEXT, useExisting: NgxMenuPanel }],\n})\nexport class NgxMenuPanel implements MenuContext {\n  template = viewChild<TemplateRef<any>>(TemplateRef);\n  class = input<string>();\n\n  containerRef?: OverlayRef<NgxMenuPanel>;\n\n  close(): void {\n    this.containerRef?.close();\n  }\n}\n","import { Component, HostListener, inject } from '@angular/core';\nimport { NGX_MENU_CONTEXT } from '../../tokens/menu-context.token';\nimport { NgxMenu } from '../../directives/ngx-menu.directive';\n\n@Component({\n  selector: 'ngx-menu-item,[ngx-menu-item]',\n  template: `\n    <div class=\"ngx-menu-item\">\n      <ng-content></ng-content>\n    </div>\n  `,\n  exportAs: 'NgxMenuItem',\n  styles: `\n    .ngx-menu-item {\n      box-sizing: border-box;\n      outline: 0;\n      padding: var(--ngx-menu-item-padding, 6px 12px);\n      transition: all 300ms;\n      &:hover {\n        cursor: pointer;\n        background-color: var(--ngx-menu-item-hover-bg, #9bc6ff68);\n      }\n    }\n  `,\n})\nexport class NgxMenuItem {\n  menuContext = inject(NGX_MENU_CONTEXT);\n  childMenu = inject(NgxMenu, {\n    self: true,\n    optional: true,\n  });\n\n  @HostListener('click')\n  onClick() {\n    if (this.childMenu?.ngxMenu) {\n      return;\n    }\n    this.menuContext?.close();\n  }\n}\n","import { Component } from '@angular/core';\n\n@Component({\n  selector: 'ngx-menu-divider,[ngx-menu-divider]',\n  template: ``,\n  styles: `\n    :host {\n      display: block;\n      border-bottom: var(--ngx-menu-item-border, 1px #43434d3d solid);\n      border-bottom-color: var(--ngx-menu-divider-border-color, #43434d3d);\n      margin: var(--ngx-menu-divider-margin, 10px calc(var(--ngx-menu-padding, 5px) * -1));\n    }\n  `,\n})\nexport class NgxMenuDivider {}\n","import { NgModule } from '@angular/core';\nimport { NgxMenuDivider } from './components/ngx-menu-divider/menu-divider.component';\nimport { NgxMenuItem } from './components/ngx-menu-item/menu-item.component';\nimport { NgxMenuPanel } from './components/ngx-menu/menu.component';\nimport { NgxMenu } from './directives/ngx-menu.directive';\nimport { NgxContextMenu } from './directives/ngx-context-menu.directive';\n\nconst d = [NgxMenu, NgxContextMenu, NgxMenuPanel, NgxMenuItem, NgxMenuDivider];\n@NgModule({\n  imports: d,\n  exports: d,\n})\nexport class NgxMenuModule {}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/lazy-i18n/README.md

@@ -0,0 +1,455 @@
+# ngx-kit/lazy-i18n
+
+Tiny, signal-based, **lazy-scoped** i18n for Angular.
+Flat keys, route-level scopes, pipe, directives, fallbacks and a key extractor CLI
+
+
+- **Route-level scopes, no key prefix.** A module's translations are loaded when its route is created and are used as plain keys (`Request`, not `setting.Request`).
+- **Routes wait for their translations.** One guard on the root route makes navigation resolve only after every scope on the path has loaded. No "missing translation" flashes.
+- **Signals first.** `t()`, `select()`, `translateSignal()` are reactive in `computed`, `effect` and templates. Works zoneless and with `OnPush`.
+- **Fast.** Dictionaries are flattened once into a `Map`, so a lookup is O(1). The pipe is memoised, the structural directive creates its view once, and interpolation skips the regex when a string has no `{{`.
+- **Complete.** Pipe, structural and attribute directives, fallback languages, missing-key handling, custom transpiler (ICU, plurals), custom loaders, RTL/`<html lang dir>` handling, and a **key extractor CLI** that generates your JSON files per scope.
+- Angular 19+ (standalone APIs, `provideAppInitializer`, `provideEnvironmentInitializer`). ESM only. Zero runtime dependencies besides `tslib`/`rxjs`.
+
+---
+
+## Contents
+
+1. [Install](#install)
+2. [Quick start](#quick-start)
+3. [Concepts](#concepts)
+4. [Using translations](#using-translations)
+5. [Scopes and routing](#scopes-and-routing)
+6. [Language switching](#language-switching)
+7. [Fallbacks and missing keys](#fallbacks-and-missing-keys)
+8. [Interpolation, plurals and ICU](#interpolation-plurals-and-icu)
+9. [Loaders](#loaders)
+10. [Key extractor CLI](#key-extractor-cli)
+11. [Configuration reference](#configuration-reference)
+12. [API reference](#api-reference)
+13. [Testing your app](#testing-your-app)
+14. [Performance notes](#performance-notes)
+15. [Migrating from Transloco](#migrating-from-transloco)
+16. [Limitations](#limitations)
+17. [Developing this library](#developing-this-library)
+
+---
+
+## Install
+
+```bash
+npm i ngx-kit
+```
+
+
+## Quick start
+
+**1. Provide it** (`app.config.ts`)
+
+```ts
+import { provideHttpClient } from '@angular/common/http';
+import { provideRouter } from '@angular/router';
+import { provideI18n } from 'ngx-kit/lazy-i18n';
+
+export const appConfig: ApplicationConfig = {
+  providers: [
+    provideRouter(routes),
+    provideHttpClient(),
+    provideI18n({
+      langs: ['fa', 'en'],
+      defaultLang: 'fa',
+      fallbackLangs: ['en'],
+      baseUrl: '/i18n',          // GET /i18n/fa   and   GET /i18n/setting/fa
+    }),
+  ],
+};
+```
+
+The global file of the initial language is loaded **before** the app bootstraps.
+
+**2. Declare scopes on routes and add the guard once** (`app.routes.ts`)
+
+```ts
+import { i18nReadyGuard, provideI18nScope } from 'ngx-kit/lazy-i18n';
+
+export const routes: Routes = [
+  {
+    path: '',
+    canActivateChild: [i18nReadyGuard],                 // once, on the root path-less route
+    children: [
+      {
+        path: 'setting',
+        providers: [provideI18nScope('setting')],       // loads /i18n/setting/{lang}
+        loadChildren: () => import('./setting/setting.routes'),
+      },
+      {
+        path: 'orders',
+        providers: [provideI18nScope(['orders', 'shared-grid'])], // several scopes are fine
+        loadComponent: () => import('./orders/orders.page'),
+      },
+    ],
+  },
+];
+```
+
+Child routes of `setting` need **nothing**. Components never mention a scope.
+
+**3. Translate**
+
+```ts
+import { Component } from '@angular/core';
+import { TR, translateSignal } from 'ngx-kit/lazy-i18n';
+
+@Component({
+  selector: 'app-requests',
+  imports: [TR],                                   // pipe + both directives
+  template: `
+    <h1>{{ 'Request' | tr }}</h1>
+    <p>{{ 'welcome' | tr: { name: user.name } }}</p>
+    <input trKey="Search" trAttr="placeholder" />
+    <h2>{{ title() }}</h2>
+  `,
+})
+export class RequestsComponent {
+  user = { name: 'Ali' };
+  title = translateSignal('Request');
+}
+```
+
+## Concepts
+
+| Term | Meaning |
+|---|---|
+| **Global file** | `GET {baseUrl}/{lang}`, loaded at startup. |
+| **Scope file** | `GET {baseUrl}/{scope}/{lang}`, loaded when a route registers the scope. |
+| **Flat namespace** | All files are merged at the **root** of one language dictionary. Keys never carry the scope name. |
+| **Registered scope** | A scope that any route has requested. Registered scopes stay registered, so they are also loaded when the language changes. |
+| **Revision** | A counter signal that changes whenever the language or any dictionary changes. Pipe and directives depend on it. |
+
+Because the namespace is flat, **two scopes must not define the same key with different values**. In dev mode a warning is logged when that happens. Put shared words (`Save`, `Cancel`) in the global file.
+
+## Using translations
+
+### Pipe
+
+```html
+{{ 'orders.title' | tr }}
+{{ 'hello' | tr: { name: user.name } }}
+<button [title]="'common.save' | tr">…</button>
+```
+
+### Structural directive
+
+The view is created once; `t` is a signal-aware function, so only the bindings that call it update.
+
+```html
+<ng-container *tr="let t; prefix: 'orders'">
+  <h1>{{ t('title') }}</h1>                 <!-- orders.title -->
+  <p>{{ t('count', { n: items.length }) }}</p>
+</ng-container>
+```
+
+Context: `$implicit` / `t` (the translate function) and `lang` (a `Signal<string>`).
+
+### Attribute directive
+
+```html
+<span trKey="orders.title"></span>
+<input trKey="form.name" trAttr="placeholder" />
+<p trKey="hello" [trParams]="{ name: user.name }"></p>
+<span trKey="title" trPrefix="orders"></span>
+```
+
+`trAttr` sets an attribute instead of the text content.
+
+### Signals
+
+```ts
+import { computed, inject } from '@angular/core';
+import { I18nService, injectT, translateSignal } from 'ngx-kit/lazy-i18n';
+
+class Demo {
+  private i18n = inject(I18nService);
+  title  = translateSignal('orders.title');
+  hello  = translateSignal('hello', () => ({ name: this.name() })); // params may read signals
+  t      = injectT();
+  label  = computed(() => this.t('orders.count', { n: this.n() }));
+  lang   = this.i18n.lang;       // Signal<string>
+  dir    = this.i18n.dir;        // Signal<'rtl' | 'ltr'>
+}
+```
+
+### Service
+
+```ts
+i18n.t('key', params?)         // reactive when read inside computed/effect/template
+i18n.instant('key', params?)   // same lookup, never creates a reactive dependency
+i18n.select('key', params?)    // Signal<string>
+i18n.has('key')                // true if non-empty in active lang or a fallback
+i18n.getObject('orders')       // nested object of everything under "orders."
+```
+
+## Scopes and routing
+
+`provideI18nScope('x')` is an environment initializer. Angular creates a route's injector while it recognises the URL, which happens **before guards run**, so loading starts as early as possible. `i18nReadyGuard` then waits until every registered scope has loaded and lets the navigation continue. Lazy-loaded children behave the same way.
+
+Rules of thumb:
+
+- Put `i18nReadyGuard` **once** on the root path-less route as `canActivateChild`.
+- Put `provideI18nScope(...)` on the route that owns the module.
+- Without the guard, scopes still load, but a component may render before the files arrive. Use `await i18n.whenReady()` if you must translate imperatively at startup.
+- For a scope not tied to a route (a dialog library, for example) call `i18n.registerScope('name')` and `await i18n.whenReady()`.
+- A failed scope request is retried (`retries`, default 1), then logged. It never blocks navigation forever.
+
+## Language switching
+
+```ts
+await i18n.use('en');
+```
+
+`use()` downloads the global file, **all registered scopes** and the fallback languages first, and only then switches `lang`. Nothing flashes untranslated. Calling `use()` repeatedly is safe: the last call wins. The choice is stored in `localStorage` (`storageKey`) and `<html lang dir>` is updated.
+
+`i18n.preload('en')` downloads a language without activating it.
+
+## Fallbacks and missing keys
+
+```ts
+provideI18n({
+  langs: ['fa', 'en'], defaultLang: 'fa',
+  fallbackLangs: ['en'],                    // looked up in order
+  missing: (key, lang) => `⚠ ${key}`,       // 'key' (default) | 'empty' | function
+  warnMissing: true,                        // console.warn once per key (default: dev mode)
+});
+```
+
+A value of `''` counts as **missing**, so the placeholders written by the extractor fall back to the next language automatically.
+
+## Interpolation, plurals and ICU
+
+Default syntax: `Hello {{ name }}`, nested paths (`{{ user.name }}`) are supported, unknown placeholders are left untouched.
+
+Plug in anything else with `transpile`:
+
+```ts
+provideI18n({
+  …,
+  transpile: (value, params, lang) => {
+    // example: tiny plural helper "{n, plural, one {# item} other {# items}}"
+    return value.replace(/\{(\w+), plural, one \{([^}]*)\} other \{([^}]*)\}\}/g, (_, k, one, other) => {
+      const n = Number(params?.[k] ?? 0);
+      const form = new Intl.PluralRules(lang).select(n) === 'one' ? one : other;
+      return form.replace('#', String(n));
+    });
+  },
+});
+```
+
+Use a real ICU library (for example `intl-messageformat`) inside `transpile` for full ICU support, and cache compiled messages there.
+
+## Loaders
+
+The default `HttpI18nLoader` uses `HttpClient`, so your interceptors (auth, base URL, retry) apply.
+
+```ts
+provideI18n({
+  …,
+  baseUrl: '/api/translations',   // /api/translations/fa, /api/translations/setting/fa
+  fileExtension: '.json',         // static files: /assets/i18n/fa.json
+  // or full control:
+  url: (lang, scope) => `/api/i18n?lang=${lang}${scope ? `&scope=${scope}` : ''}`,
+});
+```
+
+Custom loader (anything that returns a nested or flat object, as `Observable` or `Promise`):
+
+```ts
+@Injectable({ providedIn: 'root' })
+export class MyLoader implements I18nLoader {
+  load(lang: string, scope?: string) {
+    return fetch(`/x/${scope ?? '_global'}/${lang}`).then((r) => r.json());
+  }
+}
+provideI18n({ …, loader: MyLoader });
+```
+
+Nested JSON (`{ "a": { "b": "x" } }`) and flat JSON (`{ "a.b": "x" }`) are both accepted.
+
+## Key extractor CLI
+
+Generates and updates your JSON files from the source code, **per scope**.
+
+```bash
+npx ngx-lazy-i18n-extract                  # reads ./i18n.config.json
+npx ngx-lazy-i18n-extract --check          # CI: exit 1 if a used key is missing from the files
+npx ngx-lazy-i18n-extract --remove         # also delete keys no longer used
+npx ngx-lazy-i18n-extract --langs fa,en --output src/assets/i18n --input src
+```
+
+`i18n.config.json`:
+
+```json
+{
+  "input": ["src"],
+  "output": "src/assets/i18n",
+  "langs": ["fa", "en"],
+  "scopes": { "setting": "src/app/setting", "orders": "src/app/orders" },
+  "extensions": ["html", "ts"],
+  "ignore": [],
+  "placeholder": "",
+  "sort": true,
+  "unflat": false,
+  "remove": false
+}
+```
+
+- A source file belongs to the scope whose directory is the **longest match**; everything else is global.
+- Output: `{output}/{lang}.json` for global, `{output}/{scope}/{lang}.json` for scopes.
+- Existing values are never overwritten. New keys get `placeholder` (empty by default, which makes the runtime fall back).
+- `unflat: true` writes nested objects; a key that cannot be nested (leaf/branch conflict) stays dotted.
+- A second run is idempotent: unchanged files are not rewritten.
+
+What it recognises:
+
+| Source | Extracted |
+|---|---|
+| `{{ 'a.b' \| tr }}` and `(c ? 'a' : 'b') \| tr` | `a.b`, `a`, `b` |
+| `*tr="let t; prefix: 'orders'"` then `t('title')` | `orders.title` |
+| `trKey="a.b"`, `[trKey]="'a.b'"`, with `trPrefix="p"` | `a.b` / `p.a.b` |
+| `i18n.t('a')`, `.select('a')`, `.has('a')`, `.getObject('a')`, `.instant('a')` | `a` |
+| `translateSignal('a')`, `marker('a')` | `a` |
+| `// tr-keys: a, b` or `<!-- tr-keys(prefix): a, b -->` | declares dynamic keys |
+
+Dynamic keys (template strings with `${}`, variables) cannot be known statically. Declare them with a `tr-keys` comment or wrap constants in `marker('key')`:
+
+```ts
+import { marker } from 'ngx-kit/lazy-i18n';
+const STATUS = { open: marker('status.open'), closed: marker('status.closed') };
+// then: i18n.t(STATUS[s])
+```
+
+Add to `package.json` scripts: `"i18n": "ngx-lazy-i18n-extract"`, `"i18n:check": "ngx-lazy-i18n-extract --check"`.
+
+## Configuration reference
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `langs` | `string[]` | required | Supported languages. |
+| `defaultLang` | `string` | required | Used when nothing is stored or detected. |
+| `fallbackLangs` | `string[]` | `[]` | Languages tried, in order, for missing/empty keys. |
+| `missing` | `'key' \| 'empty' \| (key, lang) => string` | `'key'` | What to render for a missing key. |
+| `warnMissing` | `boolean` | `isDevMode()` | Log each missing key once. |
+| `transpile` | `(value, params, lang) => string` | built-in `{{ }}` | Custom message formatter. |
+| `loader` | `Type<I18nLoader>` | `HttpI18nLoader` | Custom loader class. |
+| `baseUrl` | `string` | `'/i18n'` | HTTP loader base. |
+| `fileExtension` | `string` | `''` | HTTP loader extension (e.g. `.json`). |
+| `url` | `(lang, scope?) => string` | none | HTTP loader full URL control. |
+| `retries` | `number` | `1` | Retries per failed request (250 ms delay). |
+| `storageKey` | `string \| null` | `'lazy-i18n.lang'` | Persist language; `null` disables. |
+| `detectBrowserLang` | `boolean` | `false` | Use `navigator.languages` when nothing is stored. |
+| `manageDocument` | `boolean` | `true` | Keep `<html lang dir>` in sync. |
+
+## API reference
+
+**Providers / guards:** `provideI18n(config)`, `provideI18nScope(scope | scope[])`, `i18nReadyGuard`
+
+**Template:** `TrPipe` (`tr`), `TrDirective` (`*tr`), `TrKeyDirective` (`trKey`), bundle `TR`
+
+**Functions:** `translateSignal(key, params?)`, `injectT()`, `marker(key)`, `interpolate(text, params)`, `flatten(dict)`
+
+**`I18nService`**
+
+| Member | Description |
+|---|---|
+| `lang: Signal<string>` | Active language. |
+| `dir: Signal<'rtl' \| 'ltr'>` | Direction for the active language. |
+| `revision: Signal<number>` | Changes on every language/dictionary change. |
+| `langs: readonly string[]` | Supported languages. |
+| `t(key, params?)` | Translate (reactive). |
+| `instant(key, params?)` | Translate (non-reactive). |
+| `select(key, params?)` | `Signal<string>`; `params` may be a function. |
+| `has(key)` / `getObject(prefix)` | Introspection. |
+| `use(lang)` | Load everything, then activate. |
+| `preload(lang)` | Download without activating. |
+| `registerScope(scope)` | Register and start loading a scope. |
+| `whenReady()` | Resolves when all registered scopes are loaded. Never rejects. |
+| `setTranslation(lang, dict, merge = true)` | Inject translations manually. |
+| `detectInitialLang()` | Stored, browser (opt-in) or default. |
+
+## Testing your app
+
+Skip the network by providing a loader that returns objects:
+
+```ts
+@Injectable({ providedIn: 'root' })
+class TestLoader implements I18nLoader {
+  load(lang: string, scope?: string) {
+    return of(DICTS[`${lang}|${scope ?? ''}`] ?? {});
+  }
+}
+
+TestBed.configureTestingModule({
+  providers: [provideI18n({ langs: ['en'], defaultLang: 'en', loader: TestLoader, storageKey: null })],
+});
+```
+
+Or call `TestBed.inject(I18nService).setTranslation('en', { a: 'A' })` and `await svc.use('en')`.
+
+## Performance notes
+
+- **Lookup:** one `Map.get` on the flattened active-language map, plus one per fallback language only on a miss.
+- **Pipe:** impure so it follows signals, but memoised on key, params (shallow compare) and `revision`. Unchanged inputs return the cached string without a lookup.
+- **Directive:** creates its view once. Updates happen through signal reads in the bindings, so nothing is re-created on language change.
+- **Interpolation:** `indexOf('{{')` fast path; no regex for static strings.
+- **Network:** each `(lang, scope)` file is requested at most once (in-flight requests are shared). The language switch loads global + scopes + fallbacks in parallel.
+- **Bundle:** no runtime dependency besides Angular, RxJS and `tslib`. The extractor is a separate Node script and is not bundled into apps.
+
+## Migrating from Transloco
+
+| Transloco | ngx-kit/lazy-i18n |
+|---|---|
+| `provideTransloco(...)` | `provideI18n(...)` |
+| `provideTranslocoScope('x')` | `provideI18nScope('x')` (route `providers`) |
+| `{{ 'x.key' \| transloco }}` | `{{ 'key' \| tr }}` |
+| `*transloco="let t; read: 'x'"` | `*tr="let t; prefix: 'x'"` |
+| `translateSignal('x.key')` | `translateSignal('key')` |
+| `service.selectTranslate()` | `i18n.select()` / `translateSignal()` |
+| `setActiveLang()` | `await i18n.use()` |
+| `TranslocoLoader` | `I18nLoader` |
+| `transloco-keys-manager` | `ngx-lazy-i18n-extract` |
+
+Server files can stay as they are (`/i18n/{scope}/{lang}`). Keys that used to be written with the scope prefix must be written without it, or the scope name must be moved inside your JSON.
+
+## Limitations
+
+- **Flat namespace.** Cross-scope key collisions are your responsibility (dev-mode warning only).
+- **Extractor is a static scanner.** It uses regular expressions and a small call parser, not the Angular compiler. `t()` calls are attributed to the **nearest preceding** `*tr="let t"` with the same variable name in the same file, so nested `*tr` blocks that reuse the same variable name with different prefixes can be mis-attributed. Use distinct variable names (`let t`, `let tOrders`) or `tr-keys` comments.
+- **SSR.** `localStorage`/`document` access is guarded, but relative HTTP URLs on the server need an absolute-URL interceptor or a custom loader. Transfer-state is not implemented; use `setTranslation()` if you need it.
+- **Pluralisation/ICU** are not built in; plug a formatter into `transpile`.
+- Signal `input()` is deliberately not used for the directives, so they work in JIT test environments and older Angular versions.
+
+## Developing this library
+
+```bash
+npm install
+npm test             # vitest: service, pipe/directives, routing, extractor
+npm run build        # ng-packagr -> dist/
+cd dist && npm publish
+```
+
+Source layout:
+
+```
+src/lib/
+  i18n.service.ts     state, loading, scopes, fallbacks, language switching
+  pipe.ts             `tr` pipe (memoised)
+  directives.ts       *tr and trKey
+  routing.ts          provideI18nScope, i18nReadyGuard
+  provide-i18n.ts     provideI18n
+  http-loader.ts      default loader
+  signals.ts          translateSignal, injectT
+  utils.ts            flatten, interpolate, marker
+tools/extractor.mjs   key extraction engine
+bin/extract.mjs       CLI wrapper
+```
+
+MIT licensed.