fw-webbuilder 1.1.253 → 1.1.254

package/index.d.ts

@@ -115,12 +115,12 @@ declare class webBuilderService {
     ctrlZ: any;
     ctrlY: any;
     /**
-   * dùng để lưu format copy {
-   * type: 'copy_style',
-   * data: {
-   * }
-   * }
-   */
+     * dùng để lưu format copy {
+     * type: 'copy_style',
+     * data: {
+     * }
+     * }
+     */
     dataCopyFormat: any;
     data_list: any;
     constructor(http: HttpClient);
@@ -212,6 +212,18 @@ declare class webBuilderService {
     flatNodes(nodes: any): any;
     getPages(): Promise<any>;
     addBlock(data: any, code?: any): Promise<any>;
+    /**
+     *  các hàm raw không xử lý dữ liệu đầu vào trước khi gửi đi
+     */
+    addRawPage(data: any): Promise<Object>;
+    addRawBlock(data: any): Promise<any>;
+    addRawObject(data: any): Promise<any>;
+    updateRawPage(id: string, data: any): Promise<Object>;
+    updateRawBlock(id: string, data: any): Promise<Object>;
+    updateRawObject(id: string, data: any): Promise<Object>;
+    deleteRawPage(id: string): Promise<Object>;
+    deleteRawBlock(id: string): Promise<Object>;
+    deleteRawObject(id: string): Promise<Object>;
     /**
      *
      * @param id
@@ -225,10 +237,11 @@ declare class webBuilderService {
     addObject(data: any, code?: any): Promise<any>;
     updateObject(id: string, data: any, code?: string): Promise<any>;
     /**
-     * @param id id của object cần xóa
+     * @param object đầy đủ data của object
+     * @param code mã action cho lịch sử Undo
      * @returns
      */
-    deleteObject(id: string, code?: any): Promise<any>;
+    deleteObject(object: any, code?: any): Promise<any>;
     uploadFile(file: File, newPath: string, options?: any): Promise<Object>;
     upLoadImage(file: any, oldPath: string, newPath: string, options?: any): Promise<any>;
     addCategory(data: any): Promise<any>;
@@ -298,6 +311,31 @@ declare class webBuilderService {
     getBlock(id: string): any;
     handleCtrl_C(): Promise<any>;
     handleCtrl_D(): Promise<any>;
+    updateDB(type: string | 'page' | 'block' | 'object', id: string, data: any): void;
+    /**
+     * CƠ CHẾ HOẠT ĐỘNG CỦA CHỨC NĂNG CLONE (NHÂN BẢN OBJECT):
+     * 1. Cấu trúc Clone:
+     *    - Đối tượng clone được đánh dấu `is_clone = true`.
+     *    - Thuộc tính `id_clone` lưu `_id` của đối tượng gốc (nếu mẫu đã là clone thì tiếp tục dùng `id_clone` cũ).
+     * 2. Lưu trữ Database (DB):
+     *    - Chỉ lưu thông tin định danh (`is_clone`, `id_clone`), id parent (`id_block` hoặc `id_object`)
+     *      và các tọa độ/vị trí (`*_position_<parentId>`) dưới DB để tiết kiệm RAM & dung lượng.
+     * 3. Cập nhật Local State (RAM / DOM):
+     *    - Sau khi tạo xong dưới DB, merge dữ liệu mẫu (`component`, `config`, `class`, `animation`, `objects`)
+     *      vào `newItem` để hiển thị tức thì trên giao diện local.
+     *    - Đổi `id_object` của các object con trong `objects` sang `_id` mới của bản clone.
+     * 4. Lịch sử Undo / Redo (Ctrl+Z / Ctrl+Y):
+     *    - Đẩy bản ghi dạng `type: 'add'` vào `ctrlZ` kèm `code` để hỗ trợ Undo/Redo đồng bộ.
+     */
+    addObjectClone(parent: any, object: any, code?: any): Promise<void>;
+    /**
+     * CƠ CHẾ HOẠT ĐỘNG CỦA CHỨC NĂNG CLONE (NHÂN BẢN BLOCK):
+     * 1. Cấu trúc Clone: `is_clone = true`, `id_clone` trỏ tới block gốc.
+     * 2. Vị trí & Thứ tự (Index): Lưu vị trí và chỉ số `index` trong trang để sắp xếp danh sách block.
+     * 3. Lưu trữ DB & Local State: Chỉ lưu thuộc tính định danh/vị trí dưới DB, sau đó merge với dữ liệu mẫu để render DOM.
+     * 4. Lịch sử Undo / Redo: Đẩy bản ghi `type: 'add'` vào `ctrlZ` để khôi phục hoặc xóa khi Undo/Redo.
+     */
+    addBlockClone(parent: any, block: any, code?: any): Promise<void>;
     handleCtrl_V(): any;
     handleCtrl_Z(): Promise<void>;
     handleCtrl_Y(): Promise<void>;
@@ -319,7 +357,7 @@ declare class webBuilderService {
      * @param page _id của page chứa block
      * @param block block có NHÁNH(objects) cần copy
      */
-    handleCopyBlock(page: any, block: any, code: any, isClone: boolean): Promise<void>;
+    handleCopyBlock(page: any, block: any, code: any, isClone?: boolean): Promise<void>;
     /**
      * Hàm này dùng để copy object
      * khi copy page thì cần mọi object nằm ở vị trí cũ,
@@ -328,7 +366,7 @@ declare class webBuilderService {
      * @param object object có NHÁNH(objects) cần copy
      * @param change_position
      */
-    handleCopyObject(parent: any, object: any, change_position: boolean | undefined, code: any, isClone: boolean): Promise<void>;
+    handleCopyObject(parent: any, object: any, change_position: boolean | undefined, code: any, isClone?: boolean): Promise<void>;
     /**
      * hàm này copy page, page truyền vào phải có nhánh
      * @param page page phải có NHÁNH

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fw-webbuilder",
-  "version": "1.1.253",
+  "version": "1.1.254",
   "peerDependencies": {
     "@fingerprintjs/fingerprintjs": "^5.2.0",
     "@abacritt/angularx-social-login": "2.4.0",