@libs-ui/services-grid-layout 0.2.357-26 → 0.2.357-28

package/grid-layout.service.d.ts

@@ -53,6 +53,16 @@ export declare class LibsUiGridLayoutService {
     /** Khởi tạo mặt phẳng. Gọi lại sẽ dọn sạch component cũ rồi dựng lại từ đầu. */
     init(config: T_gridLayout_config): void;
     setEditMode(value: boolean): void;
+    /**
+     * Đổi số hàng TỐI THIỂU của lưới cấp trang — KHÔNG dựng lại mặt phẳng.
+     *
+     * 🔴 `minRows` chỉ được đọc MỘT LẦN lúc `init()`, nên nơi dùng muốn đổi nó theo chế độ (sửa thì ô
+     * li phủ kín màn, xem thì đúng số hàng của bố cục) buộc phải gọi `init()` lại — mà `init()` huỷ
+     * sạch rồi dựng lại mọi component nội dung. Hệ quả đo được 15/09/2026: mở ở chế độ xem rồi bấm
+     * Sửa thì lưới đứng ở số hàng của bố cục (28 hàng = 448px) trong khi vùng nhìn cao hơn nhiều, nên
+     * ô li ngừng ngay dưới khối cuối và phần còn lại trống trơn không có đường kẻ nào.
+     */
+    setMinRows(value: number): void;
     /**
      * Bật/tắt cho khối chồng lên nhau — KHÔNG dựng lại mặt phẳng.
      *

package/interfaces/grid-layout.interface.d.ts

@@ -201,6 +201,15 @@ export type T_gridLayout_config = {
     outerMargin?: boolean;
     /** chừa thêm bao nhiêu px dưới đáy lưới cấp trang. Mặc định 40 */
     outerMarginBottom?: number;
+    /**
+     * Lề TRÊN của lưới cấp trang, px — chỗ trống phía trên hàng 0.
+     *
+     * 🔴 Khai số này thay vì lấy `padding` của khung bọc khi nơi dùng đã đẩy vùng cuộn vào trong
+     * `<gridster>`: khoảng trống đó phải nằm TRONG hệ toạ độ của gridster thì thư viện mới tính đúng
+     * (`gridsterRenderer.getMarginTop`) và kéo–thả mới không lệch. Đặt ở khung bọc thì mép trên của
+     * gridster cắt mất mọi thứ thò lên — thanh công cụ của khối ở hàng 0 treo ở `top: -22px` biến mất.
+     */
+    outerMarginTop?: number;
     /** số hàng tối thiểu một khối được co lại. Mặc định 2 */
     minItemRows?: number;
     /** kích thước mặc định của khối mới, tính theo ô lưới. Mặc định 3 cột × 2 hàng */
@@ -310,5 +319,13 @@ export type T_gridLayout_externalDragPayload = {
     iconText?: string;
     iconClass?: string;
     data?: Record<string, unknown>;
+    /**
+     * Khối này có được thả VÀO TRONG một khối ghép không. Bỏ trống = được (giữ nguyên hành vi cũ).
+     *
+     * 🔴 Khai `false` cho thứ mà nơi dùng sẽ từ chối khi thả (vd chính khối ghép — lồng khối ghép vào
+     * khối ghép). Thiếu cờ này thì thư viện vẫn tô ô li lên khối ghép đang rê qua, mời người dùng thả
+     * vào chỗ mà nơi dùng chắc chắn chối — thả xong khối nhảy ra ngoài (người dùng chỉ ra 15/09/2026).
+     */
+    canDropInsideContainer?: boolean;
     [key: string]: unknown;
 };

package/package.json

@@ -1,13 +1,14 @@
 {
   "name": "@libs-ui/services-grid-layout",
-  "version": "0.2.357-26",
+  "version": "0.2.357-28",
   "peerDependencies": {
-    "@angular/core": "^18.2.0",
     "@angular/common": "^18.2.0",
+    "@angular/core": "^18.2.0",
+    "@libs-ui/components-buttons-button": "0.2.357-28",
+    "@libs-ui/components-scroll-overlay": "0.2.357-28",
+    "@libs-ui/utils": "0.2.357-28",
     "gridster18": "npm:angular-gridster2@18.0.1",
-    "rxjs": "~7.8.0",
-    "@libs-ui/components-buttons-button": "0.2.357-26",
-    "@libs-ui/utils": "0.2.357-26"
+    "rxjs": "~7.8.0"
   },
   "sideEffects": false,
   "module": "fesm2022/libs-ui-services-grid-layout.mjs",