feat(gui): add dynamic welcome tab when no compiler engines are active

Signed-off-by: Samuel Amen Ague <ague.samuel27@gmail.com>

Author: raidos23

pycompiler_ark/Core/engine/hello_tab.py

@@ -0,0 +1,203 @@
+# SPDX-License-Identifier: Apache-2.0
+# Copyright 2026 Samuel Amen Ague
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+from __future__ import annotations
+
+from PySide6.QtCore import Qt
+from PySide6.QtWidgets import (
+    QWidget,
+    QVBoxLayout,
+    QHBoxLayout,
+    QLabel,
+    QPushButton,
+    QFrame,
+)
+
+
+class HelloTab(QWidget):
+    def __init__(self, gui, parent=None):
+        super().__init__(parent)
+        self.gui = gui
+        self.setObjectName("tab_hello")
+        self.init_ui()
+        if hasattr(self.gui, "register_language_refresh"):
+            try:
+                self.gui.register_language_refresh(self.retranslate_ui)
+            except Exception:
+                pass
+
+    def init_ui(self):
+        # Main layout
+        layout = QVBoxLayout(self)
+        layout.setContentsMargins(30, 30, 30, 30)
+        layout.setSpacing(12)
+        layout.setAlignment(Qt.AlignmentFlag.AlignCenter)
+
+        # Title Label
+        self.title_label = QLabel()
+        self.title_label.setObjectName("welcome_title")
+        self.title_label.setAlignment(Qt.AlignmentFlag.AlignCenter)
+        self.title_label.setStyleSheet(
+            "font-size: 16pt; font-weight: bold; color: #ffffff;"
+        )
+
+        # Description Label
+        self.desc_label = QLabel()
+        self.desc_label.setObjectName("welcome_desc")
+        self.desc_label.setAlignment(Qt.AlignmentFlag.AlignCenter)
+        self.desc_label.setWordWrap(True)
+        self.desc_label.setStyleSheet(
+            "font-size: 9.5pt; color: #a0a0a0; max-width: 500px;"
+        )
+
+        # Guide Box (Frame)
+        self.guide_box = QFrame()
+        self.guide_box.setStyleSheet(
+            "QFrame {"
+            "  background-color: #2b2b2b;"
+            "  border: 1px solid #3d3d3d;"
+            "  border-radius: 6px;"
+            "  margin-top: 10px;"
+            "}"
+        )
+        guide_layout = QVBoxLayout(self.guide_box)
+        guide_layout.setContentsMargins(15, 15, 15, 15)
+        guide_layout.setSpacing(6)
+
+        self.guide_title = QLabel()
+        self.guide_title.setObjectName("welcome_guide_title")
+        self.guide_title.setStyleSheet(
+            "font-size: 10pt; font-weight: bold; color: #ffcc00; border: none;"
+        )
+        self.guide_title.setAlignment(Qt.AlignmentFlag.AlignCenter)
+
+        self.guide_desc = QLabel()
+        self.guide_desc.setObjectName("welcome_guide")
+        self.guide_desc.setStyleSheet("font-size: 9pt; color: #d4d4d4; border: none;")
+        self.guide_desc.setWordWrap(True)
+        self.guide_desc.setAlignment(Qt.AlignmentFlag.AlignCenter)
+
+        guide_layout.addWidget(self.guide_title)
+        guide_layout.addWidget(self.guide_desc)
+
+        # Buttons layout
+        btn_layout = QHBoxLayout()
+        btn_layout.setSpacing(10)
+        btn_layout.setAlignment(Qt.AlignmentFlag.AlignCenter)
+
+        # Settings/Config Button
+        self.btn_config = QPushButton()
+        self.btn_config.setObjectName("btn_welcome_config")
+        self.btn_config.setMinimumSize(140, 30)
+        self.btn_config.setStyleSheet(
+            "QPushButton {"
+            "  background-color: #0e639c;"
+            "  color: #ffffff;"
+            "  font-weight: bold;"
+            "  font-size: 9pt;"
+            "  border: none;"
+            "  border-radius: 4px;"
+            "}"
+            "QPushButton:hover {"
+            "  background-color: #1177bb;"
+            "}"
+        )
+        if hasattr(self.gui, "open_advanced_config_editor"):
+            self.btn_config.clicked.connect(self.gui.open_advanced_config_editor)
+
+        # Help Button
+        self.btn_help = QPushButton()
+        self.btn_help.setObjectName("btn_welcome_help")
+        self.btn_help.setMinimumSize(140, 30)
+        self.btn_help.setStyleSheet(
+            "QPushButton {"
+            "  background-color: #3c3c3c;"
+            "  color: #ffffff;"
+            "  font-size: 9pt;"
+            "  border: 1px solid #555555;"
+            "  border-radius: 4px;"
+            "}"
+            "QPushButton:hover {"
+            "  background-color: #454545;"
+            "}"
+        )
+        if hasattr(self.gui, "show_help_dialog"):
+            self.btn_help.clicked.connect(self.gui.show_help_dialog)
+
+        btn_layout.addWidget(self.btn_config)
+        btn_layout.addWidget(self.btn_help)
+
+        # Spacer to push elements into center-top vertical layout
+        layout.addSpacing(10)
+        layout.addWidget(self.title_label)
+        layout.addWidget(self.desc_label)
+        layout.addWidget(self.guide_box)
+        layout.addSpacing(10)
+        layout.addLayout(btn_layout)
+        layout.addStretch()
+
+        self.retranslate_ui()
+
+    def retranslate_ui(self):
+        try:
+            from pycompiler_ark.Ui.i18n import translate
+
+            ctx = self.gui.id if hasattr(self.gui, "id") else "ui"
+
+            t_title = translate(ctx, "welcome_title", "Bienvenue dans PyCompiler ARK")
+            t_desc = translate(
+                ctx,
+                "welcome_desc",
+                "Un outil de compilation et d'empaquetage universel pour vos applications Python.",
+            )
+            t_guide_title = translate(
+                ctx, "welcome_guide_title", "Aucun moteur de compilation disponible"
+            )
+            t_guide_desc = translate(
+                ctx,
+                "welcome_guide",
+                "Veuillez installer un moteur de compilation pour commencer.",
+            )
+            t_btn_config = translate(
+                ctx, "btn_welcome_config", "Configurer les moteurs"
+            )
+            t_btn_help = translate(ctx, "btn_welcome_help", "Aide & Documentation")
+        except Exception:
+            t_title = "Bienvenue dans PyCompiler ARK"
+            t_desc = "Un outil de compilation et d'empaquetage universel pour vos applications Python."
+            t_guide_title = "Aucun moteur de compilation disponible"
+            t_guide_desc = "Veuillez installer un moteur de compilation pour commencer."
+            t_btn_config = "Configurer les moteurs"
+            t_btn_help = "Aide & Documentation"
+
+        self.title_label.setText(t_title)
+        self.desc_label.setText(t_desc)
+        self.guide_title.setText(t_guide_title)
+        self.guide_desc.setText(t_guide_desc)
+        self.btn_config.setText(t_btn_config)
+        self.btn_help.setText(t_btn_help)
+
+    def destroy(self, destroyWindow=True, destroySubWindows=True):
+        if hasattr(self.gui, "unregister_language_refresh"):
+            try:
+                self.gui.unregister_language_refresh(self.retranslate_ui)
+            except Exception:
+                pass
+        super().destroy(destroyWindow, destroySubWindows)
+
+
+def create_hello_tab(gui) -> HelloTab:
+    """Create a new HelloTab widget for the GUI."""
+    return HelloTab(gui)

pycompiler_ark/Core/engine/registry.py

@@ -537,8 +537,18 @@ def bind_tabs(gui) -> None:
         except Exception:
             pass
 
-        # Get the Hello tab if it exists
+        # Get the Hello tab if it exists, or create it dynamically
         hello_tab = getattr(gui, "tab_hello", None)
+        if hello_tab is None:
+            try:
+                from pycompiler_ark.Core.engine.hello_tab import create_hello_tab
+
+                hello_tab = create_hello_tab(gui)
+                if hello_tab is not None:
+                    setattr(gui, "tab_hello", hello_tab)
+            except Exception:
+                pass
+
         hello_tab_index = -1
         if hello_tab is not None:
             try:
@@ -648,10 +658,27 @@ def _wrap_tab_scroll(widget):
                 )
                 continue
 
-        # Hide the Hello tab if any engine has created a tab
-        if any_engine_tab_created and hello_tab_index >= 0:
+        # Show/add or hide/remove the Hello tab depending on whether engine tabs exist
+        if hello_tab is not None:
             try:
-                tabs.tabBar().hideTab(hello_tab_index)
+                if any_engine_tab_created:
+                    if hello_tab_index >= 0:
+                        tabs.removeTab(hello_tab_index)
+                else:
+                    if hello_tab_index < 0:
+                        title = "Bienvenue"
+                        try:
+                            from pycompiler_ark.Ui.i18n import translate
+
+                            title = translate(
+                                gui.id if hasattr(gui, "id") else "ui",
+                                "tab_hello",
+                                "Bienvenue",
+                            )
+                        except Exception:
+                            pass
+                        tabs.insertTab(0, hello_tab, title)
+                    tabs.setCurrentWidget(hello_tab)
             except Exception:
                 pass
     except Exception:
@@ -669,9 +696,20 @@ def show_hello_tab(gui) -> None:
         if hello_tab is not None:
             try:
                 idx = tabs.indexOf(hello_tab)
-                if idx >= 0:
-                    tabs.tabBar().showTab(idx)
-                    tabs.setCurrentIndex(idx)
+                if idx < 0:
+                    title = "Bienvenue"
+                    try:
+                        from pycompiler_ark.Ui.i18n import translate
+
+                        title = translate(
+                            gui.id if hasattr(gui, "id") else "ui",
+                            "tab_hello",
+                            "Bienvenue",
+                        )
+                    except Exception:
+                        pass
+                    tabs.insertTab(0, hello_tab, title)
+                tabs.setCurrentWidget(hello_tab)
             except Exception:
                 pass
     except Exception:

pycompiler_ark/languages/en.yml

@@ -112,3 +112,11 @@ init_project_install_reqs: Install dependencies
 init_project_note: 'Note: This will create an ark.yml file and configure the project
   structure.'
 init_project_success: Project initialized successfully!
+tab_hello: "Welcome"
+welcome_title: "Welcome to PyCompiler ARK"
+welcome_desc: "A universal Python compilation and packaging tool."
+welcome_guide_title: "No compiler engines available"
+welcome_guide: "Please install a compiler engine to get started."
+btn_welcome_config: "Configure Engines"
+btn_welcome_help: "Help & Docs"
+

pycompiler_ark/languages/fr.yml

@@ -115,3 +115,11 @@ init_project_install_reqs: Installer les dépendances
 init_project_note: 'Note : Cela va créer un fichier ark.yml et configurer la structure
   du projet.'
 init_project_success: Projet initialisé avec succès !
+tab_hello: "Bienvenue"
+welcome_title: "Bienvenue dans PyCompiler ARK"
+welcome_desc: "Un outil de compilation et d'empaquetage universel pour vos applications Python."
+welcome_guide_title: "Aucun moteur de compilation disponible"
+welcome_guide: "Veuillez installer un moteur de compilation pour commencer."
+btn_welcome_config: "Configurer les moteurs"
+btn_welcome_help: "Aide & Documentation"
+