@shival99/z-ui 2.6.7 → 2.6.9

package/types/shival99-z-ui-components-z-table.d.ts

@@ -1261,23 +1261,20 @@ declare class ZTableComponent<T> implements AfterViewInit {
     protected readonly hasScrollLeft: _angular_core.WritableSignal<boolean>;
     /** True when table has right-pinned columns and body isn't scrolled to the end */
     protected readonly hasScrollRight: _angular_core.WritableSignal<boolean>;
-    /** True khi top-pinned rows đang đè lên nội dung body đã scroll qua đầu */
+    /** True when top-pinned rows overlap body content that has scrolled underneath. */
     protected readonly hasScrollTop: _angular_core.WritableSignal<boolean>;
-    /** True khi bottom-pinned rows đang đè lên nội dung body còn scroll xuống được */
+    /** True when bottom-pinned rows overlap body content that can still scroll down. */
     protected readonly hasScrollBottom: _angular_core.WritableSignal<boolean>;
     /**
-     * Group header (non-virtual) đang ghim ở mép dưới cùng của chồng sticky — chỉ mình nó đổ shadow.
-     * Nhiều header ghim chung một chỗ, mỗi cái một shadow thì alpha cộng dồn thành vệt đen đậm dần.
-     * Chỉ dùng cho shadow: class này bám theo scroll nên luôn trễ một frame, chấp nhận được với shadow
-     * nhưng không dùng được cho z-index (xem `tr.z-group-row-sticky`).
+     * ID of the lowest stuck non-virtual group header. Only this header receives a shadow.
+     * The value is for shadows only; it can lag scrolling by one frame and must not control z-index.
      */
     protected readonly shadowGroupRowId: _angular_core.WritableSignal<string | null>;
-    /** Chiều cao thật của group header row (non-virtual), dùng để xếp chồng sticky theo depth. */
+    /** Measured non-virtual group-row height used to stack sticky headers by depth. */
     private readonly _groupRowHeight;
     /**
-     * Tổng chiều cao khối pinned top rows (non-virtual), đo trực tiếp từ DOM sau mỗi render.
-     * Không dùng `pinnedRowHeights` vì signal đó chỉ refresh trong `_checkScrollState`, nên có thể
-     * còn giữ số đo cũ khi bảng vừa đổi cấu hình — sticky group header sẽ hở một khoảng vài px.
+     * Total height of non-virtual top-pinned rows, measured from the DOM after each render.
+     * This avoids stale values while table configuration changes.
      */
     private readonly _nonVirtualPinnedTopHeight;
     /** Maps row IDs to measured DOM heights for pinned row offset calculations */
@@ -1359,10 +1356,10 @@ declare class ZTableComponent<T> implements AfterViewInit {
     protected readonly hasLocalSorting: _angular_core.Signal<boolean>;
     protected readonly hasServerFiltering: _angular_core.Signal<boolean>;
     protected readonly groupingConfig: _angular_core.Signal<ZTableGroupingConfig<T>>;
-    /** EN/VI: true khi grouping chạy ở chế độ server (group meta do server cung cấp). */
+    /** True when grouping runs in server mode and group metadata comes from the server. */
     protected readonly isServerGrouping: _angular_core.Signal<boolean>;
     protected readonly canUseGrouping: _angular_core.Signal<boolean>;
-    /** EN/VI: cột group hiệu lực cho chế độ server (config cung cấp, không suy ra từ data). */
+    /** Effective grouping column for server mode, provided by configuration. */
     protected readonly serverGroupColumnId: _angular_core.Signal<string | null>;
     protected readonly activeGroupingColumnIds: _angular_core.Signal<string[]>;
     protected readonly activeGroupingColumnId: _angular_core.Signal<string>;
@@ -1372,59 +1369,46 @@ declare class ZTableComponent<T> implements AfterViewInit {
     protected readonly groupableColumnMap: _angular_core.Signal<Record<string, boolean>>;
     protected readonly groupingHeaderMenuMap: _angular_core.Signal<Record<string, boolean>>;
     protected readonly groupedCenterRowItems: _angular_core.Signal<ZTableGroupedRowItem<T>[]>;
-    /** Local grouping: group được tính tại client từ rows của trang hiện tại. */
+    /** Builds groups on the client from rows on the current page. */
     private _buildLocalGroupedItems;
     private _appendLocalGroupedItems;
     /**
-     * Server grouping: thứ tự & meta group do `config.enableGrouping.serverGroups` quyết định.
-     * Child rows lấy từ `getCenterRows()` (data parent đã fetch) và gán vào group theo value.
+     * Server grouping uses the order and metadata from `serverGroups`.
+     * Fetched center rows are assigned to groups by their value.
      */
     private _buildServerGroupedItems;
     private _getGroupTotals;
     private _sumGroupColumn;
     /**
-     * EN: Flat list of body rows in the exact order they are rendered. When grouping is active the
+     * Flat list of body rows in the exact order they are rendered. When grouping is active the
      *     center rows are re-ordered group-by-group, so the flat `table.getRowModel().rows` no longer
      *     matches the visual order. The `z-at-bottom` border logic must use this visual order, otherwise
      *     `border-bottom: none` is applied to whichever row happens to be last in the flat model — which
      *     after grouping lands somewhere in the middle of the table.
-     * VI: Danh sách phẳng các row body theo đúng thứ tự render. Khi đang group, center rows bị sắp xếp
-     *     lại theo từng group nên `table.getRowModel().rows` không còn khớp thứ tự hiển thị. Logic
-     *     border `z-at-bottom` phải dùng thứ tự hiển thị này, nếu không `border-bottom: none` sẽ bị gán
-     *     nhầm cho row đang nằm ở giữa bảng.
      */
     protected readonly renderedBodyRows: _angular_core.Signal<Row<T>[]>;
     protected readonly bodyRowSpanRows: _angular_core.Signal<Row<T>[]>;
     protected readonly virtualGroupedFlatItems: _angular_core.Signal<ZVirtualFlatItem<T>[]>;
-    /** Sticky group header đang bật (config cho phép và đang thực sự group theo cột nào đó). */
+    /** True when sticky group headers are enabled and at least one grouping column is active. */
     protected readonly isStickyGroupHeaderEnabled: _angular_core.Signal<boolean>;
-    /** Flow layout: một transform cho cả khối thay vì mỗi row một cái. Sticky group header phải
-     * dùng absolute vì rangeExtractor làm tập render không liền mạch. */
+    /** Uses one transform for the virtual block; sticky group headers require absolute positioning. */
     protected readonly usesFlowVirtualRows: _angular_core.Signal<boolean>;
     protected readonly virtualFlowOffset: _angular_core.Signal<number>;
     /**
-     * `top` (px) của sticky group header theo depth ở chế độ non-virtual.
-     * Ở đây mọi group header đều là `<tr>` thật trong cùng một `<tbody>`, nên chỉ cần `position: sticky`:
-     * header sau (đứng sau trong DOM) tự đè lên header trước khi trôi tới rồi lộ lại khi cuộn ngược —
-     * không cần rangeExtractor như bên virtual (cơ chế đó chỉ để giữ row đã ra khỏi range).
-     * Header con xếp chồng ngay dưới header cha nên cộng thêm `depth * chiều cao group row`.
+     * Computes `top` offsets for non-virtual sticky group headers.
+     * Headers share one tbody, so native sticky positioning handles their stacking order.
      */
     protected readonly stickyGroupTopByDepth: _angular_core.Signal<number[]>;
     /**
-     * Lookup phục vụ sticky group header trong virtual scroll:
-     * - `nearest[i]`: index group header gần nhất tại hoặc trước `i` (-1 nếu chưa có).
-     * - `parent`: index group header cha của một header (multi-level grouping), -1 nếu là cấp gốc.
-     * Trả `null` khi tắt sticky hoặc không ở chế độ virtual + grouping.
+     * Lookup data for sticky group headers in virtual scroll.
+     * `nearest[i]` points to the closest preceding header; `parent` stores each header's parent.
+     * Returns `null` when sticky grouping is inactive.
      */
     private readonly _stickyGroupHeaderMeta;
-    /** Chuỗi header (gốc → sâu nhất) cần ghim khi viewport bắt đầu tại `startIndex`. */
+    /** Builds the root-to-leaf header chain for a virtual viewport start index. */
     private _buildStickyGroupChain;
     /**
-     * Trạng thái sticky group header theo virtual index:
-     * - `tops`: offset `top` (px) của từng header đang ghim; header cấp sâu hơn xếp chồng bên dưới
-     *   header cha nên cộng dồn chiều cao.
-     * - `shadowIndex`: header cuối chuỗi mang shadow (giống pinned row), -1 khi chưa có row nào
-     *   cuộn xuống dưới nó — lúc đó header vẫn ở đúng vị trí thật nên không cần shadow.
+     * Returns sticky header offsets and the header that should receive the shadow.
      */
     protected readonly stickyGroupHeaderState: _angular_core.Signal<{
         shadowIndex: number;
@@ -1703,10 +1687,8 @@ declare class ZTableComponent<T> implements AfterViewInit {
         rowSortingFeature: _tanstack_angular_table.TableFeature;
     }, T & Record<string, unknown>>[]>;
     /**
-     * Id row ở hai biên của mỗi khối pinned, theo THỨ TỰ HIỂN THỊ (pinned bottom render ngược lại).
-     * Dùng signal thay cho `zTableRow` pipe: pipe là pure, chỉ chạy lại khi một tham số đổi reference.
-     * Khi ghim thêm/bớt row thì `row` và `table` giữ nguyên reference, nên row từng là biên vẫn giữ
-     * class cũ — pin bottom lộ rõ nhất vì shadow ở lại row cũ và row mới cũng có shadow.
+     * Tracks the first and last visible row IDs in each pinned block.
+     * Signals are used because the pure pipe does not rerun when pinning mutates existing references.
      */
     protected readonly firstTopPinnedRowId: _angular_core.Signal<string>;
     protected readonly lastTopPinnedRowId: _angular_core.Signal<string>;
@@ -1879,41 +1861,31 @@ declare class ZTableComponent<T> implements AfterViewInit {
     /** Virtualizer instance — operates on groups rather than individual rows */
     protected readonly virtualizer: _tanstack_angular_virtual.AngularVirtualizer<HTMLElement, Element>;
     /**
-     * Nhận diện group header đang ghim sau MỖI render, không chỉ khi scroll.
-     * Đổi virtual/non-virtual, đổi cột group hay pin/unpin row đều giữ nguyên scrollOffset nhưng dựng
-     * lại DOM và đổi đường sticky — nếu chỉ trông vào scroll handler thì header đang ghim sẽ thiếu
-     * class `z-group-row-stuck` cho tới lần cuộn kế tiếp, và bị data row đè trong khoảng đó.
-     * `_refreshStuckGroupRows` đọc `groupRowElements` + `stickyGroupTopByDepth` trước mọi early-return
-     * nên effect này tự chạy lại khi hai nguồn đó đổi (kể cả khi số đo tới muộn hơn một pass).
+     * Detects stuck group headers after every render, not only after scrolling.
+     * Layout and grouping changes can rebuild the DOM without changing scrollOffset.
      */
     private readonly _trackStuckGroupRows;
     /** Measures in the render `read` phase so corrected offsets land before paint, not a frame later. */
     private readonly _measureVirtualItems;
     private _stuckGroupRowsFrame;
-    /** Gom nhiều lần scroll trong cùng một frame — mỗi lần chạy đều đọc rect nên phải giới hạn tần suất. */
+    /** Coalesces stuck-row refreshes so DOM measurements run at most once per frame. */
     private _scheduleStuckGroupRowsRefresh;
     private _cancelStuckGroupRowsRefresh;
     /**
-     * Tìm group header (non-virtual) đang ghim ở mép dưới cùng của chồng sticky để trao shadow.
-     * Header đã ghim có `rect.top` đúng bằng đường sticky của depth đó; header chưa tới thì lớn hơn.
-     * Ưu tiên đường sticky thấp nhất (multi-level: header con), tie thì lấy cái sau cùng trong DOM vì
-     * đó là cái đang nằm trên khi nhiều header chồng nhau.
+     * Finds the lowest stuck non-virtual group header and assigns its shadow.
+     * Prefer the lowest sticky offset, then the last matching DOM element.
      */
     private _refreshStuckGroupRows;
-    /** Đo các mốc mà `stickyGroupTopByDepth` cần (non-virtual): chiều cao group row và khối pinned top. */
+    /** Measures the group-row and top-pinned heights used by non-virtual sticky offsets. */
     private _refreshStickyGroupMetrics;
     private _hasWarnedOverflowingFixedRows;
     /**
-     * Cảnh báo một lần mỗi bảng khi body row cao hơn `virtual.size`.
-     * CSS table layout coi `height` trên `<tr>`/`<td>` là min-height, nên nội dung cell không nén được
-     * (tag, button, nhiều dòng…) sẽ đẩy row vượt slot của virtualizer; row kế tiếp định vị tuyệt đối
-     * đúng theo `virtual.size` nên đè lên phần dôi ra — nhìn như mỗi row bị hụt mất vài px.
-     * Không tự sửa: chiều cao đúng phụ thuộc dữ liệu, chọn tăng `size` hay bật `dynamicSize` là của app.
+     * Warns once when a body row exceeds the fixed virtual size.
+     * CSS table layout treats row height as a minimum, so dense cell content can overflow its slot.
      */
     private _warnOnOverflowingFixedRows;
     private _dynamicEstimateSampleCount;
-    /** Averages the rows measured so far to estimate the ones not yet rendered.
-     * Tính lại theo bậc ~1.5x để tổng công việc là O(N) thay vì O(N²) khi cuộn hết danh sách dài. */
+    /** Averages measured rows and refreshes at roughly 1.5x sample growth to keep work O(N). */
     private _refreshDynamicEstimate;
     private readonly _rowDragAutoScroll;
     private readonly _rowDragCellSelectionCleanup;
@@ -1964,7 +1936,7 @@ declare class ZTableComponent<T> implements AfterViewInit {
     private _scheduleFitColumnWidths;
     private _applyFitColumnWidths;
     private _setColumnSizingFromFit;
-    /** Cập nhật state sizing ngoài và atom của TanStack v9 đồng thời. */
+    /** Updates the external sizing state and TanStack's state together. */
     private _setColumnSizingState;
     private _getColumnBaseSize;
     private _isSameColumnSizing;
@@ -1974,12 +1946,12 @@ declare class ZTableComponent<T> implements AfterViewInit {
     private _updateVerticalScrollShadowState;
     hasRightPinnedColumns(): boolean;
     onTbodyScroll(event: Event): void;
-    /** Chặn wheel trực tiếp trên header; header chỉ nhận scrollLeft từ body. */
+    /** Prevent direct header wheel scrolling; the body owns horizontal scroll. */
     onTheadWheel(event: WheelEvent): void;
     private _syncScrollLeft;
     /**
      * @deprecated Header sort now lives in the column filter popover.
-     * Giữ tạm để các consumer/template cũ còn compile trong giai đoạn chuyển đổi.
+     * Kept for compatibility with existing consumers and templates.
      */
     handleSort(event: Event, handler?: (event: unknown) => void): void;
     protected _handleDragDrop(event: ZTableDragDropData): void;

package/.npmignore

@@ -1,58 +0,0 @@
-# Nested package.json's are only needed for development.
-i18n/package.json
-pipes/package.json
-providers/package.json
-services/package.json
-utils/package.json
-components/z-accordion/package.json
-components/z-audio-player/package.json
-components/z-autocomplete/package.json
-components/z-avatar/package.json
-components/z-badge/package.json
-components/z-breadcrumb/package.json
-components/z-button/package.json
-components/z-button-group/package.json
-components/z-calendar/package.json
-components/z-card/package.json
-components/z-chat/package.json
-components/z-checkbox/package.json
-components/z-code/package.json
-components/z-command/package.json
-components/z-dropdown-menu/package.json
-components/z-drawer/package.json
-components/z-editor/package.json
-components/z-filter/package.json
-components/z-empty/package.json
-components/z-gallery/package.json
-components/z-hover-glide/package.json
-components/z-icon/package.json
-components/z-input/package.json
-components/z-kanban/package.json
-components/z-loading/package.json
-components/z-marquee/package.json
-components/z-media-player/package.json
-components/z-metric-card/package.json
-components/z-menu/package.json
-components/z-modal/package.json
-components/z-number-ticker/package.json
-components/z-pagination/package.json
-components/z-overlay/package.json
-components/z-qrcode/package.json
-components/z-popover/package.json
-components/z-radio/package.json
-components/z-scrollarea/package.json
-components/z-select/package.json
-components/z-show-more/package.json
-components/z-skeleton/package.json
-components/z-skeleton-auto/package.json
-components/z-steps/package.json
-components/z-switch/package.json
-components/z-table/package.json
-components/z-tabs/package.json
-components/z-tags/package.json
-components/z-timeline/package.json
-components/z-toast/package.json
-components/z-tooltip/package.json
-components/z-upload/package.json
-services/excel/package.json
-services/office/package.json