flexgui 1.0.2__tar.gz → 1.1.0__tar.gz

{flexgui-1.0.2 → flexgui-1.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: flexgui
-Version: 1.0.2
+Version: 1.1.0
 Summary: Thư viện GUI Python kéo-thả-thiết-kế trên tkinter — FlexGUI Studio tích hợp (design mode + mini VS Code cho trigger)
 Keywords: gui,tkinter,designer,drag-and-drop,visual-designer,no-code,vietnamese,flexgui
 Author: FlexGUI Team
@@ -73,13 +73,21 @@ flexgui.setup()      # hoặc:  from flexgui import design; design.mode = True
 Chạy `python myapp.py` → **Studio tự mở giao diện trống** (hoặc nạp
 thiết kế đã lưu). Tính năng:
 
-- Kéo thả mượt (canvas item — không tàn ảnh), **snap lưới 10px** (bật/tắt)
+- Kéo thả mượt (canvas item — không tàn ảnh), **snap lưới 10px** (bật/tắt),
+  **lưới chấm** kiểu Figma
 - **Resize 8 núm** quanh thành phần đang chọn
 - **Multi-select**: Ctrl/Shift + click, quét vùng chuột, kéo cả cụm
 - Đổi z-order (menu chuột phải), nhân bản `Ctrl+D`, undo/redo `Ctrl+Z/Y`
 - Bảng thuộc tính bên phải: chữ, tọa độ, kích thước **pixel WYSIWYG**,
   màu chữ/nền, cỡ chữ, **độ trong suốt 0–100%**, ẩn khi chạy, khoá...
-- **Xem trước F5** — chạy thử app thật + trigger thật ngay tại chỗ
+- **Start F5** — Studio **hóa thành GUI demo thật** ngay trong cửa sổ
+  (trigger chạy thật); `■ Stop` hoặc `Esc` quay về thiết kế
+- **Thư viện F1** — tra cứu API + ví dụ (checkbox toggle, nhập input,
+  decorator, lệnh app…) — chèn code thẳng vào trigger được
+- **Chuột phải → "Thuộc tính khi bắt đầu"** — chỉnh trạng thái ban đầu
+  của widget khi GUI start, hiện ngay trên canvas để dễ hình dung
+- **Ẩn tạm trong studio** (menu chuột phải) — giấu widget để thiết kế đè
+  lên vùng nhiều nút chồng nhau; bảng góc trái-dưới liệt kê để hiện lại
 - **Build .exe** bằng PyInstaller (nút ❖ — tự cài nếu thiếu)
 - **Xuất .py** — 1 file tự chạy nhúng toàn bộ thiết kế + trigger
 
@@ -116,7 +124,10 @@ def on_text_5_change():               # gõ chữ trong text[5]
 ```
 
 Quy ước tên hàm: `on_<loại>_<id>_<sự kiện>`
-(`click` / `toggle` / `enter` / `change`). Studio tự sinh sườn hàm khi lưu.
+(`click` / `toggle` / `enter` / `change`). Muốn sườn hàm nhanh thì bấm
+**`+ Sườn hàm`** trên drawer (1.1.0: việc LƯU không tự sinh hàm nữa — tránh
+file ngày càng dài; hàm mồ côi của widget đã xóa và hàm trùng tên được
+**tự dọn** mỗi lần lưu).
 
 Kiểu **decorator** mạnh hơn (cũng viết trong file trigger):
 
@@ -137,6 +148,18 @@ def dong_ho(): ...
 def khoi_dong(): ...
 ```
 
+### Mini VS Code trong Studio — giờ có phát hiện lỗi như VSCode
+
+- **Bôi đen + Tab** → thụt lề **cả cụm dòng**; **bôi đen + Shift+Tab** →
+  bỏ thụt lề cả cụm (giữ nguyên vùng chọn để thao tác tiếp)
+- **Tự kiểm tra lỗi** ~0.5s sau khi ngừng gõ:
+  - lỗi cú pháp Python → tô đỏ dòng + **bảng VẤN ĐỀ** (bấm vào dòng để
+    nhảy tới, như Problems của VS Code)
+  - cảnh báo **trigger mồ côi** — hàm `on_label_9_click` mà `label[9]`
+    không còn trong thiết kế
+  - cảnh báo **hàm trùng tên** — def lại 2 lần, bản sau đè bản trước
+- Enter tự thụt lề theo dòng trên (an toàn bộ gõ tiếng Việt Unikey/Telex)
+
 ## 4. Chạy thật
 
 Đổi 1 dòng trong `myapp.py`:
@@ -234,6 +257,16 @@ flexgui/
 
 ## Lịch sử phiên bản
 
+- **1.1.0** — **Start/Stop thay cho "Xem trước"**: F5 biến Studio thành
+  **GUI demo thật ngay trong cửa sổ** (trigger chạy thật, đúng cỡ app);
+  `■ Stop` / `Esc` đưa về thiết kế. **Thư viện F1** (API + ví dụ chèn được).
+  **Chuột phải → Thuộc tính khi bắt đầu** (hiện ngay trên canvas). **Ẩn tạm
+  trong studio** + bảng góc hiện lại. Mini VS Code: **bôi đen + Tab /
+  Shift+Tab thụt cả cụm dòng** + **tự phát hiện lỗi** (cú pháp, trigger mồ
+  côi, hàm trùng) với bảng VẤN ĐỀ. **Fix bug lưu tự thêm hàm**: Lưu không
+  còn sinh sườn `def on_label_<id>_click` — chỉ bấm `+ Sườn hàm` mới sinh;
+  hàm mồ côi & trùng tên tự dọn khi lưu; xóa widget xóa luôn trigger của nó.
+  Đồ họa: nút Start xanh, lưới chấm Figma, thanh "đang chạy thử" nổi.
 - **1.0.2** — **Sửa lỗi "Xem trước" (F5) mở lại Studio**: khi file người
   dùng còn `flexgui.setup()` (hoặc `design.mode = True`, hoặc chạy với cờ
   `--design`), bấm "Xem trước" trước đây làm cửa sổ preview tự hủy rồi mở

{flexgui-1.0.2 → flexgui-1.1.0}/README.md

@@ -44,13 +44,21 @@ flexgui.setup()      # hoặc:  from flexgui import design; design.mode = True
 Chạy `python myapp.py` → **Studio tự mở giao diện trống** (hoặc nạp
 thiết kế đã lưu). Tính năng:
 
-- Kéo thả mượt (canvas item — không tàn ảnh), **snap lưới 10px** (bật/tắt)
+- Kéo thả mượt (canvas item — không tàn ảnh), **snap lưới 10px** (bật/tắt),
+  **lưới chấm** kiểu Figma
 - **Resize 8 núm** quanh thành phần đang chọn
 - **Multi-select**: Ctrl/Shift + click, quét vùng chuột, kéo cả cụm
 - Đổi z-order (menu chuột phải), nhân bản `Ctrl+D`, undo/redo `Ctrl+Z/Y`
 - Bảng thuộc tính bên phải: chữ, tọa độ, kích thước **pixel WYSIWYG**,
   màu chữ/nền, cỡ chữ, **độ trong suốt 0–100%**, ẩn khi chạy, khoá...
-- **Xem trước F5** — chạy thử app thật + trigger thật ngay tại chỗ
+- **Start F5** — Studio **hóa thành GUI demo thật** ngay trong cửa sổ
+  (trigger chạy thật); `■ Stop` hoặc `Esc` quay về thiết kế
+- **Thư viện F1** — tra cứu API + ví dụ (checkbox toggle, nhập input,
+  decorator, lệnh app…) — chèn code thẳng vào trigger được
+- **Chuột phải → "Thuộc tính khi bắt đầu"** — chỉnh trạng thái ban đầu
+  của widget khi GUI start, hiện ngay trên canvas để dễ hình dung
+- **Ẩn tạm trong studio** (menu chuột phải) — giấu widget để thiết kế đè
+  lên vùng nhiều nút chồng nhau; bảng góc trái-dưới liệt kê để hiện lại
 - **Build .exe** bằng PyInstaller (nút ❖ — tự cài nếu thiếu)
 - **Xuất .py** — 1 file tự chạy nhúng toàn bộ thiết kế + trigger
 
@@ -87,7 +95,10 @@ def on_text_5_change():               # gõ chữ trong text[5]
 ```
 
 Quy ước tên hàm: `on_<loại>_<id>_<sự kiện>`
-(`click` / `toggle` / `enter` / `change`). Studio tự sinh sườn hàm khi lưu.
+(`click` / `toggle` / `enter` / `change`). Muốn sườn hàm nhanh thì bấm
+**`+ Sườn hàm`** trên drawer (1.1.0: việc LƯU không tự sinh hàm nữa — tránh
+file ngày càng dài; hàm mồ côi của widget đã xóa và hàm trùng tên được
+**tự dọn** mỗi lần lưu).
 
 Kiểu **decorator** mạnh hơn (cũng viết trong file trigger):
 
@@ -108,6 +119,18 @@ def dong_ho(): ...
 def khoi_dong(): ...
 ```
 
+### Mini VS Code trong Studio — giờ có phát hiện lỗi như VSCode
+
+- **Bôi đen + Tab** → thụt lề **cả cụm dòng**; **bôi đen + Shift+Tab** →
+  bỏ thụt lề cả cụm (giữ nguyên vùng chọn để thao tác tiếp)
+- **Tự kiểm tra lỗi** ~0.5s sau khi ngừng gõ:
+  - lỗi cú pháp Python → tô đỏ dòng + **bảng VẤN ĐỀ** (bấm vào dòng để
+    nhảy tới, như Problems của VS Code)
+  - cảnh báo **trigger mồ côi** — hàm `on_label_9_click` mà `label[9]`
+    không còn trong thiết kế
+  - cảnh báo **hàm trùng tên** — def lại 2 lần, bản sau đè bản trước
+- Enter tự thụt lề theo dòng trên (an toàn bộ gõ tiếng Việt Unikey/Telex)
+
 ## 4. Chạy thật
 
 Đổi 1 dòng trong `myapp.py`:
@@ -205,6 +228,16 @@ flexgui/
 
 ## Lịch sử phiên bản
 
+- **1.1.0** — **Start/Stop thay cho "Xem trước"**: F5 biến Studio thành
+  **GUI demo thật ngay trong cửa sổ** (trigger chạy thật, đúng cỡ app);
+  `■ Stop` / `Esc` đưa về thiết kế. **Thư viện F1** (API + ví dụ chèn được).
+  **Chuột phải → Thuộc tính khi bắt đầu** (hiện ngay trên canvas). **Ẩn tạm
+  trong studio** + bảng góc hiện lại. Mini VS Code: **bôi đen + Tab /
+  Shift+Tab thụt cả cụm dòng** + **tự phát hiện lỗi** (cú pháp, trigger mồ
+  côi, hàm trùng) với bảng VẤN ĐỀ. **Fix bug lưu tự thêm hàm**: Lưu không
+  còn sinh sườn `def on_label_<id>_click` — chỉ bấm `+ Sườn hàm` mới sinh;
+  hàm mồ côi & trùng tên tự dọn khi lưu; xóa widget xóa luôn trigger của nó.
+  Đồ họa: nút Start xanh, lưới chấm Figma, thanh "đang chạy thử" nổi.
 - **1.0.2** — **Sửa lỗi "Xem trước" (F5) mở lại Studio**: khi file người
   dùng còn `flexgui.setup()` (hoặc `design.mode = True`, hoặc chạy với cờ
   `--design`), bấm "Xem trước" trước đây làm cửa sổ preview tự hủy rồi mở

{flexgui-1.0.2 → flexgui-1.1.0}/flexgui/__init__.py

@@ -53,7 +53,7 @@ from .widgets import Label, Button, Input, Checkbox, Text
 from .app import App
 from .runtime import run, setup, run_embedded
 
-__version__ = "1.0.2"
+__version__ = "1.1.0"
 __author__ = "FlexGUI Team"
 
 __all__ = [

{flexgui-1.0.2 → flexgui-1.1.0}/flexgui/app.py

@@ -41,24 +41,33 @@ class App:
       goc                  : None = cửa sổ chính (tk.Tk)
                              tk widget = cửa sổ con (Toplevel) — dùng khi
                              Studio mở bản XEM TRƯỚC, không chặn Studio.
+      trong_khung          : tk.Frame — chạy GẮN TRONG khung có sẵn (chế độ
+                             START của Studio: cửa sổ Studio hóa thành app
+                             demo thật, nút Stop đưa về thiết kế lại).
     """
 
     def __init__(self, title="Ứng dụng FlexGUI", width=860, height=560,
-                 bg=None, goc=None):
+                 bg=None, goc=None, trong_khung=None):
         self.title = title
         self.width = int(width)
         self.height = int(height)
         self._nen = bg or MAU_APP["nen_mac_dinh"]
-        self.xem_truoc = goc is not None      # True = bản xem trước từ Studio
+        self.xem_truoc = (goc is not None) or (trong_khung is not None)
+        self.trong_khung = trong_khung
         self.dang_thiet_ke = False
+        self.hoi_dong = None            # callback khi bản demo bị đóng
 
-        if goc is None:
+        if trong_khung is not None:
+            # START trong Studio: root = khung nhúng (không phải cửa sổ)
+            self.root = trong_khung
+        elif goc is None:
             self.root = tk.Tk()
         else:
             self.root = tk.Toplevel(goc)
             self.root.title(title)
-        self.root.geometry(f"{self.width}x{self.height}")
-        self.root.minsize(320, 200)
+        if trong_khung is None:
+            self.root.geometry(f"{self.width}x{self.height}")
+            self.root.minsize(320, 200)
         self.root.configure(bg=self._nen)
         self.khung = tk.Frame(self.root, bg=self._nen)
         self.khung.pack(fill="both", expand=True)
@@ -200,8 +209,10 @@ class App:
         self.dong_co.bat_dau()
 
         if self.xem_truoc:
-            # Bản xem trước từ Studio: đóng = dọn dẹp + destroy Toplevel
-            self.root.protocol("WM_DELETE_WINDOW", self._dong_xem_truoc)
+            # Bản demo/xem trước: đóng = dọn dẹp + destroy (Toplevel)
+            # hoặc trả quyền cho Studio (chế độ trong_khung)
+            if isinstance(self.root, (tk.Tk, tk.Toplevel)):
+                self.root.protocol("WM_DELETE_WINDOW", self._dong_xem_truoc)
         else:
             self.root.protocol("WM_DELETE_WINDOW", self._dong_app)
 
@@ -221,11 +232,21 @@ class App:
             pass
 
     def _dong_xem_truoc(self):
-        """Đóng bản XEM TRƯỚC (Studio vẫn sống)."""
+        """Đóng bản XEM TRƯỚC / demo START (Studio vẫn sống)."""
         self.dong_co.dung()
         try:
-            self.root.destroy()
+            if isinstance(self.root, (tk.Tk, tk.Toplevel)):
+                self.root.destroy()
+            elif self.root.winfo_exists():
+                self.root.destroy()          # khung nhúng trong Studio
         except Exception:
             pass
         if _reg._app_hien_tai() is self:
             _reg._dat_app(None)
+        hoi = getattr(self, "hoi_dong", None)
+        if hoi is not None:
+            self.hoi_dong = None             # tránh gọi 2 lần
+            try:
+                hoi()
+            except Exception:
+                pass

{flexgui-1.0.2 → flexgui-1.1.0}/flexgui/builder.py

@@ -28,9 +28,14 @@ def xuat_file_dung(duong_dan, thiet_ke, nguon_trigger):
     nguon_trigger : chuỗi code trigger (file .triggers.py)
     Trả về đường dẫn đã ghi.
     """
+    import copy
     import pprint
 
     ten = os.path.splitext(os.path.basename(duong_dan))[0]
+    # bỏ cờ studio-only (an_tam) — file chạy LUÔN hiện đầy đủ widget
+    thiet_ke = copy.deepcopy(thiet_ke)
+    for d in thiet_ke.get("components", []):
+        d.pop("an_tam", None)
     body = (
         f"# {'=' * 74}\n"
         f"# {ten} — sinh bởi FlexGUI Studio\n"