frontengine 1.0.5__tar.gz → 1.0.7__tar.gz

{frontengine-1.0.5 → frontengine-1.0.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.5
+Version: 1.0.7
 Summary: FrontEngine is use-define frontview or only use like screen saver
 Author-email: JE-Chen <jechenmailman@gmail.com>
 Project-URL: Homepage, https://github.com/Intergration-Automation-Testing/FrontEngine

{frontengine-1.0.5 → frontengine-1.0.7}/frontengine/show/pet/desktop_pet.py

@@ -1,10 +1,11 @@
 import random as _random_module
+from datetime import datetime
 from pathlib import Path
 from typing import Optional, Tuple
 
 from PySide6.QtCore import Qt, QRect, QTimer, Signal
-from PySide6.QtGui import QAction, QCursor, QMovie, QPainter, QPixmap, QTransform
-from PySide6.QtWidgets import QMenu, QMessageBox
+from PySide6.QtGui import QAction, QColor, QCursor, QFont, QFontMetrics, QMovie, QPainter, QPixmap, QTransform
+from PySide6.QtWidgets import QMenu, QMessageBox, QWidget
 
 from frontengine.show.base_widget import BaseWidget
 from frontengine.show.window_helpers import apply_overlay_window_flags
@@ -25,6 +26,7 @@ SURFACE_RIGHT = "right"
 # 視覺狀態（決定顯示哪張精靈）/ Visual states (which sprite to show)
 STATE_WALK = "walk"
 STATE_IDLE = "idle"
+STATE_SLEEP = "sleep"
 STATE_CLIMB = "climb"
 STATE_FALL = "fall"
 STATE_DRAG = "drag"
@@ -33,13 +35,23 @@ STATE_DRAG = "drag"
 # Accepted file stems per state inside a pet pack folder (first match wins).
 _PACK_STATE_ALIASES = {
     STATE_WALK: ("walk", "run", "move"),
-    STATE_IDLE: ("idle", "sit", "stand", "sleep"),
+    STATE_IDLE: ("idle", "sit", "stand"),
+    STATE_SLEEP: ("sleep", "zzz", "rest"),
     STATE_CLIMB: ("climb", "grab", "wall"),
     STATE_FALL: ("fall", "jump"),
     STATE_DRAG: ("drag", "pinch", "grabbed", "held"),
 }
 _PACK_EXTS = (".gif", ".webp", ".png", ".jpg", ".jpeg")
 
+# 缺該狀態精靈時的退回順序 / Fallback order when a state's sprite is missing
+_STATE_FALLBACKS = {
+    STATE_SLEEP: (STATE_IDLE, STATE_WALK),
+    STATE_IDLE: (STATE_WALK,),
+    STATE_CLIMB: (STATE_WALK,),
+    STATE_FALL: (STATE_WALK,),
+    STATE_DRAG: (STATE_WALK,),
+}
+
 
 def scan_pet_pack(folder: str) -> dict:
     """
@@ -75,11 +87,81 @@ def derive_visual_state(dragging: bool, airborne: bool, surface: str, motion_sta
         return STATE_FALL
     if surface in (SURFACE_LEFT, SURFACE_RIGHT, SURFACE_CEILING):
         return STATE_CLIMB
+    if surface == SURFACE_FLOOR and motion_state == STATE_SLEEP:
+        return STATE_SLEEP
     if surface == SURFACE_FLOOR and motion_state == "idle":
         return STATE_IDLE
     return STATE_WALK
 
 
+def message_bucket(hour: int) -> str:
+    """依小時回傳時段 / Time-of-day bucket for the given hour."""
+    hour = int(hour) % 24
+    if 5 <= hour < 12:
+        return "morning"
+    if 12 <= hour < 18:
+        return "afternoon"
+    if 18 <= hour < 22:
+        return "evening"
+    return "night"
+
+
+def pick_message(hour: int, rng, messages: dict) -> str:
+    """
+    依時段從對應句庫（加上通用句庫）隨機挑一句台詞；句庫皆空回傳空字串。
+    Pick a chatter line from the time bucket plus the generic pool. rng needs
+    a ``randrange`` method (injectable for tests).
+    """
+    pool = list(messages.get(message_bucket(hour), [])) + list(messages.get("any", []))
+    if not pool:
+        return ""
+    return pool[rng.randrange(len(pool))]
+
+
+class SpeechBubble(QWidget):
+    """寵物頭上的小對話泡泡，數秒後自動消失 / A small speech bubble that auto-hides."""
+
+    def __init__(self) -> None:
+        super().__init__()
+        self._text = ""
+        self._font = QFont()
+        self._font.setPointSize(11)
+        self.setAttribute(Qt.WidgetAttribute.WA_TranslucentBackground)
+        apply_overlay_window_flags(self, show_on_bottom=False, allow_input=False)
+        self._hide_timer = QTimer(self)
+        self._hide_timer.setSingleShot(True)
+        self._hide_timer.timeout.connect(self.hide)
+
+    def show_message(self, text: str, anchor: QWidget, duration_ms: int = 4000) -> None:
+        self._text = text
+        width = min(260, QFontMetrics(self._font).horizontalAdvance(text) + 28)
+        self.resize(max(60, width), 44)
+        self.reposition(anchor)
+        self.show()
+        self.raise_()
+        self.update()
+        self._hide_timer.start(max(500, int(duration_ms)))
+
+    def reposition(self, anchor: QWidget) -> None:
+        geo = anchor.frameGeometry()
+        self.move(geo.center().x() - self.width() // 2, geo.top() - self.height() - 6)
+
+    def paintEvent(self, event) -> None:
+        painter = QPainter(self)
+        painter.setRenderHint(QPainter.RenderHint.Antialiasing)
+        rect = self.rect().adjusted(1, 1, -1, -1)
+        painter.setBrush(QColor(255, 255, 240, 235))
+        painter.setPen(QColor(90, 90, 90))
+        painter.drawRoundedRect(rect, 8, 8)
+        painter.setPen(QColor(30, 30, 30))
+        painter.setFont(self._font)
+        painter.drawText(
+            rect.adjusted(8, 2, -8, -2),
+            int(Qt.AlignmentFlag.AlignCenter | Qt.TextFlag.TextWordWrap),
+            self._text,
+        )
+
+
 class PetMotion:
     """
     純邏輯的寵物移動模型（不依賴 Qt，完全可測試）。包含：
@@ -123,8 +205,9 @@ class PetMotion:
         self.vx = float(self.speed)
         self.vy = 0.0 if behaviour != BEHAVIOUR_WANDER else float(self.speed)
         self._airborne = False
-        self.state = "walk"  # walk | idle
+        self.state = "walk"  # walk | idle | sleep
         self._state_ticks = 0
+        self._idle_count = 0
         self.target: Optional[Tuple[float, float]] = None
         self.asleep = False
         self.climb = bool(climb)
@@ -260,13 +343,25 @@ class PetMotion:
     def _new_state(self, force_walk: bool = False) -> None:
         if force_walk or self._rng.random() < 0.65:
             self.state = "walk"
+            self._idle_count = 0
             if not force_walk:
                 self.vx = float(self.speed) if self._rng.random() < 0.5 else float(-self.speed)
             self._state_ticks = self._rng.randint(30, 120)
+        elif self._idle_count >= 2:
+            # been idling a while -> doze off
+            self.state = STATE_SLEEP
+            self._idle_count = 0
+            self._state_ticks = self._rng.randint(120, 300)
         else:
             self.state = "idle"
+            self._idle_count += 1
             self._state_ticks = self._rng.randint(20, 80)
 
+    def wake(self) -> None:
+        """喚醒寵物並恢復走動（互動時呼叫）/ Wake the pet and resume walking."""
+        self._idle_count = 0
+        self._new_state(force_walk=True)
+
     # --- free wander ---
     def _step_wander(self, left, top, right, bottom) -> Tuple[int, int]:
         if abs(self.vy) < 1e-9:
@@ -317,10 +412,10 @@ class DesktopPetWidget(BaseWidget):
     clone_requested = Signal()
 
     def __init__(self, image_path: str, size: int = 128, speed: int = 3,
-                 behaviour: str = BEHAVIOUR_FLOOR, climb: bool = True):
+                 behaviour: str = BEHAVIOUR_FLOOR, climb: bool = True, talk: bool = True):
         front_engine_logger.info(
             f"[DesktopPetWidget] Init | path={image_path}, size={size}, speed={speed}, "
-            f"behaviour={behaviour}, climb={climb}"
+            f"behaviour={behaviour}, climb={climb}, talk={talk}"
         )
         super().__init__()
         self.opacity = 1.0
@@ -350,6 +445,16 @@ class DesktopPetWidget(BaseWidget):
         self._timer = QTimer(self)
         self._timer.timeout.connect(self._on_tick)
 
+        # Speech bubbles / chatter
+        self._talk = bool(talk)
+        self._moved = False
+        self._chatter_rng = _random_module.SystemRandom()
+        self._messages = self._load_messages()
+        self._bubble = SpeechBubble()
+        self._chatter_timer = QTimer(self)
+        self._chatter_timer.setSingleShot(True)
+        self._chatter_timer.timeout.connect(self._on_chatter)
+
         self.menu = QMenu(self)
         self.clone_action = QAction(language_wrapper.language_word_dict.get("pet_clone", "Clone"), self)
         self.clone_action.triggered.connect(self.clone_requested.emit)
@@ -382,7 +487,7 @@ class DesktopPetWidget(BaseWidget):
             return self._sprites["default"]
         if state in self._sprites:
             return self._sprites[state]
-        for fallback in (STATE_WALK, STATE_IDLE):
+        for fallback in _STATE_FALLBACKS.get(state, (STATE_WALK,)):
             if fallback in self._sprites:
                 return self._sprites[fallback]
         return next(iter(self._sprites.values()), None)
@@ -426,6 +531,38 @@ class DesktopPetWidget(BaseWidget):
         self.motion.y = float(bottom - self.pet_size)
         self.move(int(self.motion.x), int(self.motion.y))
         self._timer.start(max(10, int(interval_ms)))
+        self._schedule_chatter()
+
+    def _load_messages(self) -> dict:
+        d = language_wrapper.language_word_dict
+
+        def lines(key: str, fallback: str) -> list:
+            return [part.strip() for part in str(d.get(key, fallback)).split("|") if part.strip()]
+
+        return {
+            "morning": lines("pet_chatter_morning", "Good morning!|Ready for the day?"),
+            "afternoon": lines("pet_chatter_afternoon", "Good afternoon!|Taking a break?"),
+            "evening": lines("pet_chatter_evening", "Good evening!|How was your day?"),
+            "night": lines("pet_chatter_night", "It's late - get some rest!|Still up?"),
+            "any": lines("pet_chatter_any", "Hi there!|(^_^)|Keep going!"),
+        }
+
+    def _schedule_chatter(self) -> None:
+        if self._talk:
+            self._chatter_timer.start(self._chatter_rng.randint(15000, 35000))
+
+    def _on_chatter(self) -> None:
+        self.say()
+        self._schedule_chatter()
+
+    def say(self, text: Optional[str] = None) -> None:
+        """顯示一句台詞（text 為 None 時依時段隨機挑）。"""
+        if not self._talk:
+            return
+        if text is None:
+            text = pick_message(datetime.now().hour, self._chatter_rng, self._messages)
+        if text:
+            self._bubble.show_message(text, self)
 
     def _on_tick(self) -> None:
         if self._dragging:
@@ -437,13 +574,17 @@ class DesktopPetWidget(BaseWidget):
         x, y = self.motion.step()
         self.move(x, y)
         self._set_active_sprite(self._visual_state())
+        if self._bubble.isVisible():
+            self._bubble.reposition(self)
 
     # --- dragging + throwing ---
     def mousePressEvent(self, event) -> None:
         if event.button() == Qt.MouseButton.LeftButton:
             self._dragging = True
+            self._moved = False
             self._last_move_delta = (0, 0)
             self._drag_offset = event.globalPosition().toPoint() - self.frameGeometry().topLeft()
+            self.motion.wake()  # interacting wakes a sleeping pet
             self._set_active_sprite(STATE_DRAG)
         super().mousePressEvent(event)
 
@@ -451,6 +592,7 @@ class DesktopPetWidget(BaseWidget):
         if self._dragging and self._drag_offset is not None:
             new_top_left = event.globalPosition().toPoint() - self._drag_offset
             self._last_move_delta = (new_top_left.x() - self.x(), new_top_left.y() - self.y())
+            self._moved = True
             self.move(new_top_left)
         super().mouseMoveEvent(event)
 
@@ -459,9 +601,12 @@ class DesktopPetWidget(BaseWidget):
             self._dragging = False
             self.motion.x = float(self.x())
             self.motion.y = float(self.y())
-            # Fling with the momentum of the last drag movement (floor mode).
-            if self.motion.behaviour == BEHAVIOUR_FLOOR:
-                self.motion.throw(self._last_move_delta[0], self._last_move_delta[1])
+            if self._moved:
+                # Fling with the momentum of the last drag movement (floor mode).
+                if self.motion.behaviour == BEHAVIOUR_FLOOR:
+                    self.motion.throw(self._last_move_delta[0], self._last_move_delta[1])
+            else:
+                self.say()  # a click (no drag) makes the pet talk
         super().mouseReleaseEvent(event)
 
     def contextMenuEvent(self, event) -> None:
@@ -470,6 +615,9 @@ class DesktopPetWidget(BaseWidget):
     def closeEvent(self, event) -> None:
         if self._timer.isActive():
             self._timer.stop()
+        if self._chatter_timer.isActive():
+            self._chatter_timer.stop()
+        self._bubble.close()
         for kind, obj in self._sprites.values():
             if kind == "movie":
                 obj.stop()

{frontengine-1.0.5 → frontengine-1.0.7}/frontengine/ui/page/pet/pet_setting_ui.py

@@ -69,6 +69,8 @@ class PetSettingUI(QWidget):
         # Climb walls / ceiling (only meaningful in floor mode)
         self.climb_checkbox = QCheckBox(language_wrapper.language_word_dict.get("pet_climb_label", "Climb walls"))
         self.climb_checkbox.setChecked(True)
+        self.talk_checkbox = QCheckBox(language_wrapper.language_word_dict.get("pet_talk_label", "Speech bubbles"))
+        self.talk_checkbox.setChecked(True)
 
         # Start
         self.start_button = QPushButton(language_wrapper.language_word_dict.get("pet_start", "Spawn pet"))
@@ -93,6 +95,7 @@ class PetSettingUI(QWidget):
         self.grid_layout.addWidget(self.behaviour_label, 3, 0)
         self.grid_layout.addWidget(self.behaviour_combobox, 3, 1)
         self.grid_layout.addWidget(self.climb_checkbox, 3, 2)
+        self.grid_layout.addWidget(self.talk_checkbox, 2, 2)
         self.grid_layout.addWidget(self.start_button, 4, 0)
         self.grid_layout.addWidget(self.recent_files_label, 5, 0)
         self.grid_layout.addWidget(self.recent_files_combobox, 5, 1)
@@ -107,6 +110,7 @@ class PetSettingUI(QWidget):
             speed=int(self.speed_combobox.currentText()),
             behaviour=self.behaviour_combobox.currentData(),
             climb=self.climb_checkbox.isChecked(),
+            talk=self.talk_checkbox.isChecked(),
         )
         pet.clone_requested.connect(self._spawn_pet)
         pet.set_pet_window_flag()
@@ -183,6 +187,7 @@ class PetSettingUI(QWidget):
             "speed": self.speed_combobox.currentText(),
             "behaviour": self.behaviour_combobox.currentData(),
             "climb": self.climb_checkbox.isChecked(),
+            "talk": self.talk_checkbox.isChecked(),
         }
 
     def set_state(self, state: dict) -> None:
@@ -204,3 +209,5 @@ class PetSettingUI(QWidget):
                 self.behaviour_combobox.setCurrentIndex(index)
         if "climb" in state:
             self.climb_checkbox.setChecked(bool(state["climb"]))
+        if "talk" in state:
+            self.talk_checkbox.setChecked(bool(state["talk"]))

{frontengine-1.0.5 → frontengine-1.0.7}/frontengine/utils/multi_language/english.py

@@ -226,7 +226,13 @@ english_word_dict = {
     "pet_climb_label": "Climb walls",
     "pet_clone": "Clone",
     "pet_choose_pack": "Choose pet pack...",
-    "pet_pack_empty": "No sprites (walk/idle/climb/fall/drag) found in that folder.",
+    "pet_pack_empty": "No sprites (walk/idle/sleep/climb/fall/drag) found in that folder.",
+    "pet_talk_label": "Speech bubbles",
+    "pet_chatter_morning": "Good morning!|Rise and shine!|Ready for the day?",
+    "pet_chatter_afternoon": "Good afternoon!|Taking a break?|Keep it up!",
+    "pet_chatter_evening": "Good evening!|How was your day?|Almost done?",
+    "pet_chatter_night": "It's late - get some rest!|Still up?|Sweet dreams soon~",
+    "pet_chatter_any": "Hi there!|(^_^)|Keep going!|You've got this!",
     "pet_start": "Spawn pet",
     "pet_message_box_text": "Pet image not found",
 }

{frontengine-1.0.5 → frontengine-1.0.7}/frontengine/utils/multi_language/traditional_chinese.py

@@ -227,7 +227,13 @@ traditional_chinese_word_dict = {
     "pet_climb_label": "攀爬牆壁",
     "pet_clone": "複製",
     "pet_choose_pack": "選擇動作包資料夾...",
-    "pet_pack_empty": "該資料夾找不到精靈檔（walk/idle/climb/fall/drag）。",
+    "pet_pack_empty": "該資料夾找不到精靈檔（walk/idle/sleep/climb/fall/drag）。",
+    "pet_talk_label": "對話泡泡",
+    "pet_chatter_morning": "早安！|新的一天開始囉！|準備好了嗎？",
+    "pet_chatter_afternoon": "午安！|要不要休息一下？|繼續加油！",
+    "pet_chatter_evening": "晚上好！|今天過得如何？|快完成了嗎？",
+    "pet_chatter_night": "很晚了，早點休息！|還沒睡嗎？|祝好夢～",
+    "pet_chatter_any": "嗨！|(^_^)|加油！|你可以的！",
     "pet_start": "召喚寵物",
     "pet_message_box_text": "找不到寵物圖片",
 }

{frontengine-1.0.5 → frontengine-1.0.7}/frontengine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.5
+Version: 1.0.7
 Summary: FrontEngine is use-define frontview or only use like screen saver
 Author-email: JE-Chen <jechenmailman@gmail.com>
 Project-URL: Homepage, https://github.com/Intergration-Automation-Testing/FrontEngine

{frontengine-1.0.5 → frontengine-1.0.7}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "frontengine"
-version = "1.0.5"
+version = "1.0.7"
 authors = [
     { name = "JE-Chen", email = "jechenmailman@gmail.com" },
 ]