clawmate 1.4.0 → 1.4.2

package/renderer/js/speech.js

@@ -1,8 +1,8 @@
 /**
- * 말풍선 시스템
- * - 타자기 효과 (30ms/글자)
- * - 5초 유지 → 페이드 아웃
- * - 모드별 스타일: Pet(둥글고 빨간 테두리) / Incarnation(각지고 틸 발광)
+ * Speech bubble system
+ * - Typewriter effect (30ms/char)
+ * - Hold for 5s -> fade out
+ * - Mode-based styling: Pet (rounded, red border) / Incarnation (angular, teal glow)
  */
 const Speech = (() => {
   const CHAR_DELAY = 30;
@@ -19,18 +19,18 @@ const Speech = (() => {
   }
 
   /**
-   * 캐릭터 위치(edge)에 따라 말풍선 좌표를 계산
-   * - bottom(바닥): 캐릭터 위에
-   * - left(왼쪽 벽): 캐릭터 오른쪽(머리 쪽)에
-   * - right(오른쪽 벽): 캐릭터 왼쪽(머리 쪽)에
-   * - top(천장): 캐릭터 아래에
-   * - 점프/낙하/레펠 중: 캐릭터 위에 (기본)
+   * Calculate speech bubble coordinates based on character position (edge)
+   * - bottom (floor): above character
+   * - left (left wall): to character's right (head side)
+   * - right (right wall): to character's left (head side)
+   * - top (ceiling): below character
+   * - jumping/falling/rappelling: above character (default)
    */
   function getBubblePosition(pos) {
     const edge = pos.edge;
     const mode = pos.movementMode;
 
-    // 공중일 때는 항상 위에 표시
+    // Always show above when in mid-air
     if (mode === 'jumping' || mode === 'falling' || mode === 'rappelling') {
       return { left: pos.x - 30, top: pos.y - 60 };
     }
@@ -49,10 +49,10 @@ const Speech = (() => {
   }
 
   /**
-   * 말풍선이 화면 밖으로 나가지 않도록 좌표를 제한
+   * Clamp coordinates to prevent speech bubble from going off-screen
    */
   function clampBubblePosition(left, top) {
-    const maxW = window.innerWidth - 200;  // 말풍선 대략 너비 고려
+    const maxW = window.innerWidth - 200;  // Account for approximate bubble width
     const maxH = window.innerHeight - 50;
     return {
       left: Math.max(5, Math.min(left, maxW)),
@@ -61,7 +61,7 @@ const Speech = (() => {
   }
 
   function show(text) {
-    hide(); // 기존 말풍선 제거
+    hide(); // Remove existing bubble
 
     const container = document.getElementById('speech-container');
     const pos = PetEngine.getPosition();
@@ -69,7 +69,7 @@ const Speech = (() => {
     const bubble = document.createElement('div');
     bubble.className = `speech-bubble speech-${mode}`;
 
-    // edge별 말풍선 위치 계산 + 화면 밖 방지 clamp
+    // Calculate bubble position per edge + off-screen prevention clamp
     const rawPos = getBubblePosition(pos);
     const clamped = clampBubblePosition(rawPos.left, rawPos.top);
     bubble.style.left = clamped.left + 'px';
@@ -82,7 +82,7 @@ const Speech = (() => {
     container.appendChild(bubble);
     currentBubble = bubble;
 
-    // 타자기 효과
+    // Typewriter effect
     let charIndex = 0;
     typeTimer = setInterval(() => {
       if (charIndex < text.length) {
@@ -94,7 +94,7 @@ const Speech = (() => {
       }
     }, CHAR_DELAY);
 
-    // 자동 숨김
+    // Auto-hide
     const totalTypeTime = text.length * CHAR_DELAY;
     hideTimer = setTimeout(() => {
       if (currentBubble) {
@@ -116,14 +116,14 @@ const Speech = (() => {
   function updatePosition() {
     if (!currentBubble) return;
     const pos = PetEngine.getPosition();
-    // edge별 말풍선 위치 재계산 + 화면 밖 방지
+    // Recalculate bubble position per edge + off-screen prevention
     const rawPos = getBubblePosition(pos);
     const clamped = clampBubblePosition(rawPos.left, rawPos.top);
     currentBubble.style.left = clamped.left + 'px';
     currentBubble.style.top = clamped.top + 'px';
   }
 
-  // --- 메시지 선택 헬퍼 ---
+  // --- Message selection helpers ---
   function randomFrom(arr) {
     return arr[Math.floor(Math.random() * arr.length)];
   }

package/renderer/js/state-machine.js

@@ -1,11 +1,11 @@
 /**
- * 펫 행동 유한 상태 머신 (FSM)
+ * Pet behavior finite state machine (FSM)
  *
- * 상태 전이도:
- *   IDLE → WALKING → CLIMBING_UP → CEILING_WALK
- *   IDLE ← PLAYING ← CLIMBING_DOWN ← (천장/벽)
- *   IDLE → SLEEPING (23:00~06:00)
- *   인터럽트: 클릭→INTERACTING, 커서→SCARED/EXCITED
+ * State transition diagram:
+ *   IDLE -> WALKING -> CLIMBING_UP -> CEILING_WALK
+ *   IDLE <- PLAYING <- CLIMBING_DOWN <- (ceiling/wall)
+ *   IDLE -> SLEEPING (23:00~06:00)
+ *   Interrupts: click->INTERACTING, cursor->SCARED/EXCITED
  */
 const StateMachine = (() => {
   const STATES = {
@@ -20,13 +20,13 @@ const StateMachine = (() => {
     INTERACTING: 'interacting',
     SCARED: 'scared',
     EXCITED: 'excited',
-    JUMPING: 'jumping',       // 포물선 점프 중 (물리 엔진이 제어)
-    RAPPELLING: 'rappelling', // 실(thread)을 타고 하강 중
-    FALLING: 'falling',       // 중력에 의한 자유 낙하 중
-    CUSTOM: 'custom',         // 커스텀 이동 패턴 실행 중 (Movement Registry)
+    JUMPING: 'jumping',       // Parabolic jump in progress (controlled by physics engine)
+    RAPPELLING: 'rappelling', // Descending on thread
+    FALLING: 'falling',       // Free fall under gravity
+    CUSTOM: 'custom',         // Custom movement pattern in progress (Movement Registry)
   };
 
-  // 각 상태의 최소/최대 지속 시간(ms)
+  // Min/max duration per state (ms)
   const DURATIONS = {
     [STATES.IDLE]:          { min: 2000, max: 5000 },
     [STATES.WALKING]:       { min: 3000, max: 8000 },
@@ -39,10 +39,10 @@ const StateMachine = (() => {
     [STATES.INTERACTING]:   { min: 1500, max: 3000 },
     [STATES.SCARED]:        { min: 1000, max: 2000 },
     [STATES.EXCITED]:       { min: 1500, max: 3000 },
-    [STATES.JUMPING]:       { min: 500, max: 2000 },    // 점프 비행 시간
-    [STATES.RAPPELLING]:    { min: 2000, max: 8000 },   // 레펠 하강 시간
-    [STATES.FALLING]:       { min: 200, max: 1000 },    // 낙하 시간
-    [STATES.CUSTOM]:        { min: 500, max: 30000 },   // 커스텀 이동 (패턴에 따라 가변)
+    [STATES.JUMPING]:       { min: 500, max: 2000 },    // Jump flight time
+    [STATES.RAPPELLING]:    { min: 2000, max: 8000 },   // Rappel descent time
+    [STATES.FALLING]:       { min: 200, max: 1000 },    // Fall time
+    [STATES.CUSTOM]:        { min: 500, max: 30000 },   // Custom movement (varies by pattern)
   };
 
   let currentState = STATES.IDLE;
@@ -51,7 +51,7 @@ const StateMachine = (() => {
   let personality = null;
   let onStateChange = null;
 
-  // 기본 전이 확률 (personality로 조정됨)
+  // Base transition probabilities (adjusted by personality)
   const BASE_TRANSITIONS = {
     [STATES.IDLE]: [
       { state: STATES.WALKING, weight: 0.5 },
@@ -63,7 +63,7 @@ const StateMachine = (() => {
       { state: STATES.CLIMBING_UP, weight: 0.2 },
       { state: STATES.WALKING, weight: 0.25 },
       { state: STATES.PLAYING, weight: 0.2 },
-      { state: STATES.JUMPING, weight: 0.05 },  // 가끔 점프 (낮은 확률)
+      { state: STATES.JUMPING, weight: 0.05 },  // Occasional jump (low probability)
     ],
     [STATES.CLIMBING_UP]: [
       { state: STATES.CEILING_WALK, weight: 0.5 },
@@ -72,7 +72,7 @@ const StateMachine = (() => {
     [STATES.CEILING_WALK]: [
       { state: STATES.CLIMBING_DOWN, weight: 0.4 },
       { state: STATES.CEILING_WALK, weight: 0.4 },
-      { state: STATES.RAPPELLING, weight: 0.2 },  // 천장에서 레펠로 하강
+      { state: STATES.RAPPELLING, weight: 0.2 },  // Rappel descent from ceiling
     ],
     [STATES.CLIMBING_DOWN]: [
       { state: STATES.WALKING, weight: 0.5 },
@@ -103,21 +103,21 @@ const StateMachine = (() => {
       { state: STATES.IDLE, weight: 0.5 },
       { state: STATES.WALKING, weight: 0.5 },
     ],
-    // 점프 후: 착지하면 idle 또는 walking으로
+    // After jump: idle or walking on landing
     [STATES.JUMPING]: [
       { state: STATES.IDLE, weight: 0.5 },
       { state: STATES.WALKING, weight: 0.5 },
     ],
-    // 레펠 후: 낙하하거나 착지
+    // After rappel: fall or land
     [STATES.RAPPELLING]: [
       { state: STATES.FALLING, weight: 0.3 },
       { state: STATES.IDLE, weight: 0.7 },
     ],
-    // 낙하 후: 착지하면 idle
+    // After fall: idle on landing
     [STATES.FALLING]: [
       { state: STATES.IDLE, weight: 1.0 },
     ],
-    // 커스텀 이동 완료 후: idle 또는 walking
+    // After custom movement: idle or walking
     [STATES.CUSTOM]: [
       { state: STATES.IDLE, weight: 0.6 },
       { state: STATES.WALKING, weight: 0.4 },
@@ -153,7 +153,7 @@ const StateMachine = (() => {
     if (forceState) {
       currentState = forceState;
     } else {
-      // 수면 시간 확인 (23:00~06:00)
+      // Sleep time check (23:00~06:00)
       const hour = new Date().getHours();
       if (hour >= 23 || hour < 6) {
         if (currentState !== STATES.SLEEPING && Math.random() < 0.3) {

package/renderer/js/time-aware.js

@@ -1,22 +1,22 @@
 /**
- * 시간대별 행동 변화 시스템
- * - 아침 인사, 점심 알림, 밤엔 잠자기
- * - 랜덤 혼잣말 (idle chatter)
- * - 팁 메시지 랜덤 출현
+ * Time-based behavior change system
+ * - Morning greetings, lunch alerts, sleeping at night
+ * - Random idle chatter
+ * - Random tip messages
  */
 const TimeAware = (() => {
   let lastGreetingHour = -1;
   let lastChatterTime = 0;
   let lastTipTime = 0;
-  const CHATTER_COOLDOWN = 60000;     // 1분 최소 간격
-  const TIP_COOLDOWN = 5 * 60000;     // 5분 최소 간격
+  const CHATTER_COOLDOWN = 60000;     // 1 minute minimum interval
+  const TIP_COOLDOWN = 5 * 60000;     // 5 minute minimum interval
   let chatterChance = 0.15;
 
   function init() {
-    // 시작 시 인사
+    // Greet on start
     showTimeGreeting();
-    // 주기적 체크
-    setInterval(tick, 30000); // 30초마다
+    // Periodic check
+    setInterval(tick, 30000); // Every 30 seconds
   }
 
   function setChatterChance(chance) {
@@ -27,13 +27,13 @@ const TimeAware = (() => {
     const hour = new Date().getHours();
     const now = Date.now();
 
-    // 시간대 변경 감지 → 인사
+    // Detect time period change -> greet
     if (hour !== lastGreetingHour && [6, 12, 18, 23].includes(hour)) {
       showTimeGreeting();
       lastGreetingHour = hour;
     }
 
-    // 수면 시간 체크 (23:00~06:00)
+    // Sleep time check (23:00~06:00)
     if (hour >= 23 || hour < 6) {
       const state = StateMachine.getState();
       if (state !== 'sleeping' && state !== 'interacting') {
@@ -44,7 +44,7 @@ const TimeAware = (() => {
       }
     }
 
-    // idle 상태일 때 혼잣말
+    // Idle chatter when in idle state
     const state = StateMachine.getState();
     if (state === 'idle' && now - lastChatterTime > CHATTER_COOLDOWN) {
       if (Math.random() < chatterChance) {
@@ -57,7 +57,7 @@ const TimeAware = (() => {
       }
     }
 
-    // 팁 메시지 (더 드물게)
+    // Tip messages (less frequently)
     if (now - lastTipTime > TIP_COOLDOWN && Math.random() < 0.05) {
       const tip = Speech.getTipMessage();
       if (tip) {
@@ -75,7 +75,7 @@ const TimeAware = (() => {
 
   function showSleepEffect() {
     const pet = document.getElementById('pet-container');
-    // Z-z-z 이펙트 추가
+    // Add Z-z-z sleep effect
     for (let i = 0; i < 3; i++) {
       const z = document.createElement('div');
       z.className = 'sleep-z';
@@ -83,7 +83,7 @@ const TimeAware = (() => {
       z.style.animationDelay = (i * 0.5) + 's';
       pet.appendChild(z);
     }
-    // 5초 후 제거
+    // Remove after 5 seconds
     setTimeout(() => {
       pet.querySelectorAll('.sleep-z').forEach(el => el.remove());
     }, 5000);

package/renderer/launcher.html

@@ -1,5 +1,5 @@
 <!DOCTYPE html>
-<html lang="ko">
+<html lang="en">
 <head>
   <meta charset="UTF-8">
   <title>ClawMate Launcher</title>
@@ -12,27 +12,27 @@
         <span class="claw-icon">\u{1F99E}</span>
       </div>
       <h1>ClawMate</h1>
-      <p class="subtitle">데스크톱 위의 살아있는 Claw</p>
+      <p class="subtitle">A living Claw on your desktop</p>
     </div>
 
     <div class="launcher-body">
       <div class="mode-card" id="mode-pet" onclick="selectMode('pet')">
         <div class="mode-icon">\u{1F990}</div>
         <h2>Clawby</h2>
-        <p>귀여운 동반자</p>
-        <span class="mode-desc">장난기 넘치는 꼬마 랍스터가 바탕화면을 돌아다녀요!</span>
+        <p>Cute companion</p>
+        <span class="mode-desc">A playful little lobster roaming your desktop!</span>
       </div>
 
       <div class="mode-card" id="mode-incarnation" onclick="selectMode('incarnation')">
         <div class="mode-icon">\u{1F980}</div>
         <h2>Claw</h2>
-        <p>육체를 얻은 존재</p>
-        <span class="mode-desc">침착하고 대담한 Claw가 바탕화면에 강림합니다.</span>
+        <p>An entity given physical form</p>
+        <span class="mode-desc">The calm and bold Claw descends upon your desktop.</span>
       </div>
     </div>
 
     <button class="start-btn" id="start-btn" disabled onclick="startPet()">
-      모드를 선택해주세요
+      Select a mode
     </button>
   </div>
 
@@ -45,7 +45,7 @@
       document.getElementById('mode-' + mode).classList.add('selected');
       const btn = document.getElementById('start-btn');
       btn.disabled = false;
-      btn.textContent = mode === 'pet' ? 'Clawby 시작!' : 'Claw 각성!';
+      btn.textContent = mode === 'pet' ? 'Start Clawby!' : 'Awaken Claw!';
     }
 
     async function startPet() {

package/shared/constants.js

@@ -1,24 +1,24 @@
-// 캐릭터 크기 (16x16 픽셀 → 4배 확대)
+// Character size (16x16 pixels -> 4x scale)
 const PIXEL_SIZE = 4;
 const GRID_SIZE = 16;
 const CHAR_SIZE = PIXEL_SIZE * GRID_SIZE; // 64px
 
-// 이동 속도 (px/frame)
+// Movement speed (px/frame)
 const BASE_SPEED = 1.5;
 const CLIMB_SPEED = 1.0;
 
-// 말풍선
+// Speech bubble
 const SPEECH_CHAR_DELAY = 30;    // ms per character
-const SPEECH_DISPLAY_TIME = 5000; // ms 표시 유지
-const SPEECH_FADE_TIME = 500;     // ms 페이드 아웃
+const SPEECH_DISPLAY_TIME = 5000; // ms display duration
+const SPEECH_FADE_TIME = 500;     // ms fade out
 
-// 파일 작업 안전장치
+// File operation safeguards
 const MAX_FILES_PER_SESSION = 3;
-const FILE_MOVE_COOLDOWN = 5 * 60 * 1000; // 5분
+const FILE_MOVE_COOLDOWN = 5 * 60 * 1000; // 5 minutes
 const MAX_FILE_SIZE = 100 * 1024 * 1024;  // 100MB
 const EXCLUDED_EXTENSIONS = ['.exe', '.dll', '.sys', '.lnk', '.ini', '.bat', '.cmd', '.ps1'];
 
-// FSM 상태
+// FSM states
 const STATES = {
   IDLE: 'idle',
   WALKING: 'walking',
@@ -33,7 +33,7 @@ const STATES = {
   EXCITED: 'excited',
 };
 
-// 화면 가장자리
+// Screen edges
 const EDGES = {
   BOTTOM: 'bottom',
   LEFT: 'left',
@@ -41,13 +41,13 @@ const EDGES = {
   TOP: 'top',
 };
 
-// 방향
+// Directions
 const DIRECTIONS = {
   LEFT: -1,
   RIGHT: 1,
 };
 
-// 색상 팔레트
+// Color palette
 const COLORS = {
   pet: {
     primary: '#ff4f40',