frontengine 1.0.6__tar.gz → 1.0.7__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.6
+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.6 → frontengine-1.0.7}/frontengine/show/pet/desktop_pet.py

@@ -26,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"
@@ -34,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:
     """
@@ -76,6 +87,8 @@ 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
@@ -192,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)
@@ -329,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:
@@ -461,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)
@@ -558,6 +584,7 @@ class DesktopPetWidget(BaseWidget):
             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)
 

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

@@ -226,7 +226,7 @@ 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!",

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

@@ -227,7 +227,7 @@ 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": "午安！|要不要休息一下？|繼續加油！",

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.6
+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.6 → frontengine-1.0.7}/pyproject.toml

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