barsa-tiles 3.0.13 → 3.0.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "barsa-tiles",
-  "version": "3.0.13",
+  "version": "3.0.14",
   "peerDependencies": {
     "@angular/core": "^22.0.8",
     "@angular/common": "^22.0.8",

package/types/barsa-tiles.d.ts

@@ -1144,6 +1144,18 @@ declare class TilePropPipe implements PipeTransform {
 
 /** کلید گروه‌های chip فیلتر نتایج جستجو (به‌جز «همه»). */
 type SuggestionGroupFilter = 'subsystem' | 'navgroup' | 'report' | 'command';
+/**
+ * یک ورودی از فهرست واحد دستورات نوار (BTILES-006). ترتیب فهرست = ترتیب نمایش:
+ * اول دستورات سراسری، بعد workflow، بعد منوهای گروهی.
+ * `action` همان ورودی به شکل گره‌ی منوی ⋯ است.
+ */
+interface ShellbarCommandEntry {
+    id: string;
+    kind: 'global' | 'workflow' | 'group';
+    command?: ShellbarCommandAction;
+    group?: ShellbarGroupedCommandMenu;
+    action: ShellbarCommandAction;
+}
 interface ShellbarSetting extends MetaobjectDataModel {
     subtitle: string;
     calcSubtitle: string;
@@ -1237,6 +1249,10 @@ declare class BarsaShellbarComponent extends BaseComponent implements OnInit {
     comboboxComponent: ComboboxComponent;
     popoverComponent: PopoverComponent;
     _notificationsDialog: TemplateRef<any>;
+    /** ظرف دستورات نوار؛ عرضش = فضای در اختیار دستورات (مستقل از تعداد دستورات نمایان). */
+    commandsHost: ElementRef<HTMLElement>;
+    /** لایه‌ی اندازه‌گیری پنهان که همه‌ی ورودی‌ها و دکمه‌ی ⋯ را با همان markup نوار رندر می‌کند. */
+    commandsMeasure: ElementRef<HTMLElement>;
     /** گروه فعال فیلتر نتایج جستجو؛ `null` یعنی «همه». signal است تا view داخل dialog (OnPush) رفرش شود. */
     selectedSuggestionFilter: i0.WritableSignal<SuggestionGroupFilter | null>;
     isOpenNotificatoin: boolean;
@@ -1250,6 +1266,19 @@ declare class BarsaShellbarComponent extends BaseComponent implements OnInit {
     appVersion: string;
     /** روی موبایل اگه شل‌بار جا کم بیاره، تایتلِ برندینگ حذف می‌شه تا لوگو/آواتار از صفحه نزنن بیرون. */
     brandingTitleHidden: boolean;
+    /** فهرست واحد دستورات نوار (سراسری، workflow، گروهی)؛ در `ngOnChanges` از روی inputها ساخته می‌شود. */
+    readonly commandEntries: i0.WritableSignal<ShellbarCommandEntry[]>;
+    /**
+     * تعداد ورودی‌هایی که در نوار می‌مانند (priority+، BTILES-006). روی موبایل همه به ⋯ می‌روند؛
+     * در بقیه‌ی اندازه‌ها از اندازه‌گیری عرض می‌آید (تا قبل از اولین اندازه‌گیری، همه نمایان‌اند).
+     */
+    readonly visibleCommandCount: i0.Signal<number>;
+    /** ورودی‌های نمایان در نوار: `slice(0, visibleCount)`. */
+    readonly visibleCommandEntries: i0.Signal<ShellbarCommandEntry[]>;
+    /** ورودی‌های داخل منوی ⋯: `slice(visibleCount)`؛ هر ورودی یا این‌جاست یا در نوار (AC-3). */
+    readonly hiddenCommandEntries: i0.Signal<ShellbarCommandEntry[]>;
+    /** گره‌های منوی ⋯ (همان نگاشت `mobileCommandNodes`، فقط برای ورودی‌های پنهان). */
+    readonly hiddenCommandNodes: i0.Signal<ShellbarCommandAction[]>;
     private _bbbTranslate;
     private _portalService;
     private _favoriteItems;
@@ -1260,16 +1289,27 @@ declare class BarsaShellbarComponent extends BaseComponent implements OnInit {
     private _dialogReference;
     private _titleWidth;
     private _brandingResizeObserver?;
-    /** در اندازه‌های کوچک و متوسط، دستورات به‌جای نمایش مستقیم داخل منوی overflow قرار می‌گیرند. */
+    private _commandsResizeObserver?;
+    private _commandMeasureFrame;
+    /** نتیجه‌ی آخرین اندازه‌گیری؛ مقدار اولیه یعنی «همه نمایان» (fallback وقتی ResizeObserver نیست). */
+    private readonly _measuredVisibleCount;
+    private readonly _allCommandsInOverflow;
+    /**
+     * فقط روی موبایل (`'s'`) همه‌ی دستورات به‌جای نمایش مستقیم داخل منوی overflow (⋯) قرار می‌گیرند.
+     * در بقیه‌ی اندازه‌ها سرریز priority+ است: فقط دستوراتی که جا نمی‌شوند به ⋯ می‌روند (BTILES-006).
+     */
     get isCompactShellbar(): boolean;
+    /** ظاهر منوی ⋯ در جایی که قبلاً هم ⋯ داشت (`'s'` و `'m'`) عوض نمی‌شود؛ در `'l'`/`'xl'` popover عادی است. */
+    get isOverflowMenuMobile(): boolean;
     /**
-     * روی موبایل و تبلت همه‌ی دستورات (global + workflow + grouped) توی یک منوی overflow (⋯) جمع می‌شن
-     * تا شل‌بار سرریز نکنه و برندینگ/آواتار جا بمونن. این getter اون سه منبع رو به یک درختِ واحد ادغام می‌کنه.
+     * همه‌ی دستورات (global + workflow + grouped) به شکل یک درختِ واحد، به همان ترتیب نوار.
+     * منوی ⋯ زیرمجموعه‌ی انتهایی همین فهرست را نشان می‌دهد (`hiddenCommandNodes`).
      */
     get mobileCommandNodes(): ShellbarCommandAction[];
     constructor();
     ngOnInit(): void;
     ngOnChanges(changes: SimpleChanges): void;
+    ngAfterViewInit(): void;
     ngOnDestroy(): void;
     onSearchSubmit(e: SearchInput): void;
     /**
@@ -1299,6 +1339,23 @@ declare class BarsaShellbarComponent extends BaseComponent implements OnInit {
      * تایتلِ برندینگ رو حذف می‌کنه. با hysteresis (پهنای تایتل + کمی فاصله) از نوسانِ پنهان/نمایان جلوگیری می‌شه.
      */
     private _initBrandingOverflowWatch;
+    /**
+     * سرریز priority+ دستورات (BTILES-006): عرض ظرف دستورات و عرض لایه‌ی اندازه‌گیری را با ResizeObserver
+     * می‌پاید. لایه‌ی اندازه‌گیری هم پاییده می‌شود تا تغییر برچسب‌ها (زبان، فونت) هم بازمحاسبه شود.
+     * اگر ResizeObserver نبود، همه‌ی دستورات نمایان می‌مانند (رفتار قبلی عرض کامل).
+     */
+    private _initCommandOverflowWatch;
+    /** اندازه‌گیری را به فریم بعد (بعد از رندر) می‌برد و چند درخواست هم‌فریم را یکی می‌کند. */
+    private _scheduleCommandMeasure;
+    /**
+     * عرض هر ورودی و دکمه‌ی ⋯ را از لایه‌ی اندازه‌گیری می‌خواند و `visibleCount` را با تابع خالص حساب می‌کند.
+     * عرض ظرف (`flex: 1 1 0`، `min-width: 0`) به تعداد دستورات نمایان وابسته نیست، پس حلقه‌ی بازخورد نداریم —
+     * به شرط override ِ کانتکست‌اریا در scss (10061): fundamental-ngx آن را `flex: none` می‌کند و بدون override،
+     * `host.clientWidth` همان عرض دستورات نمایان می‌شد و شمارش فقط کم می‌شد، هیچ‌وقت زیاد.
+     */
+    private _measureCommands;
+    /** فهرست واحد دستورات به ترتیب نوار؛ نگاشت هر ورودی به گره‌ی منوی ⋯ فقط همین‌جاست. */
+    private _buildCommandEntries;
     private _closeSideMenu;
     private _changeCulture;
     static ɵfac: i0.ɵɵFactoryDeclaration<BarsaShellbarComponent, never>;