blacktrigram 0.7.13 → 0.7.14

package/ARCHITECTURE.md

@@ -30,6 +30,7 @@
 ## 🌐 System Context
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#455A64','secondaryColor':'#4CAF50','tertiaryColor':'#FF9800','personBkg':'#1565C0','containerBkg':'#2979FF','componentBkg':'#4CAF50','person_bg':'#1565C0','container_bg':'#2979FF','component_bg':'#4CAF50'}}}%%
 C4Context
     title System Context - Black Trigram (흑괘) Web Application (Q1 2026)
 
@@ -69,6 +70,7 @@ C4Context
 ## 🏢 Container View
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#455A64','secondaryColor':'#4CAF50','tertiaryColor':'#FF9800','personBkg':'#1565C0','containerBkg':'#2979FF','componentBkg':'#4CAF50','person_bg':'#1565C0','container_bg':'#2979FF','component_bg':'#4CAF50'}}}%%
 C4Container
     title Container View - Black Trigram Performance Architecture (Q1 2026)
 
@@ -164,6 +166,7 @@ C4Container
 ## 🧩 Component View
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#455A64','secondaryColor':'#4CAF50','tertiaryColor':'#FF9800','personBkg':'#1565C0','containerBkg':'#2979FF','componentBkg':'#4CAF50','person_bg':'#1565C0','container_bg':'#2979FF','component_bg':'#4CAF50'}}}%%
 C4Component
     title Combat System Components - Korean Martial Arts Engine (Q1 2026)
 
@@ -352,6 +355,7 @@ The following Three.js packages are now installed and configured:
 ### 🏗️ Architecture Integration
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TD
     subgraph "React 19 Application Layer"
         A[React Components]
@@ -360,7 +364,7 @@ graph TD
     end
     
     subgraph "Rendering Layer"
-        D[@react-three/fiber Canvas]
+        D["@react-three/fiber Canvas"]
     end
     
     subgraph "Three.js 3D Scene"
@@ -404,6 +408,7 @@ graph TD
 ### 📐 Rendering Pipeline
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#455A64','secondaryColor':'#4CAF50','tertiaryColor':'#FF9800','actorBkg':'#1565C0','actorTextColor':'#fff','actorLineColor':'#455A64','signalColor':'#455A64','signalTextColor':'#fff','noteBkgColor':'#FFD600','noteTextColor':'#000','noteBorderColor':'#F57F17'}}}%%
 sequenceDiagram
     participant React as React Component
     participant Canvas as @react-three/fiber Canvas
@@ -1150,6 +1155,7 @@ src/
 ## 🔄 Combat Flow Sequence
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#455A64','secondaryColor':'#4CAF50','tertiaryColor':'#FF9800','actorBkg':'#1565C0','actorTextColor':'#fff','actorLineColor':'#455A64','signalColor':'#455A64','signalTextColor':'#fff','noteBkgColor':'#FFD600','noteTextColor':'#000','noteBorderColor':'#F57F17'}}}%%
 sequenceDiagram
     title 🔄 Combat Flow – Fully Frontend (Black Trigram Q1 2026)
 
@@ -1207,6 +1213,7 @@ sequenceDiagram
 ### **Three.js-Specific Optimizations**
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TD
     subgraph PM["🔍 Performance Monitoring (Q1 2026)"]
       PerfMon[📈 Performance Monitor]
@@ -1530,6 +1537,7 @@ quadrantChart
 ### Mindmap of Strengths
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 mindmap
   root((🟢 Strengths Q1 2026))
     id1(🛠️ Zero-Install Web App)
@@ -1580,6 +1588,7 @@ mindmap
 ### Mindmap of Weaknesses
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 mindmap
   root((🟠 Weaknesses Q1 2026))
     id1(🌀 No Persistence Session-Only)
@@ -1600,15 +1609,15 @@ mindmap
       id4.3[Mobile browser performance gaps]
     id5(⚠️ Memory/GC Concerns)
       id5.1[Three.js objects need manual disposal]
-      id5.2[Skeletal animation memory overhead (~180MB desktop)]
-      id5.3[Particle systems can spike memory (1000+ particles)]
+      id5.2[Skeletal animation memory overhead - 180MB desktop]
+      id5.3[Particle systems can spike memory - 1000+ particles]
     id6(⚙️ Combat Realism Systems)
       id6.1[8/12 systems complete or near-complete - 67%]
       id6.2[4 systems remaining: trauma visualization, balance, HUD, movement]
-      id6.3[1 system partially implemented: bone impact audio (mapping + selection complete; asset coverage/final mix pending)]
+      id6.3[1 system partially implemented: bone impact audio - mapping + selection complete, asset coverage/final mix pending]
     id7(❌ Incomplete Features)
       id7.1[Techniques not yet stance-specific - 4 per archetype vs 3-5 per stance]
-      id7.2[EndScreen3D implemented but missing final UX polish (detailed stats, meta-progression hooks)]
+      id7.2[EndScreen3D implemented but missing final UX polish - detailed stats, meta-progression hooks]
       id7.3[Training mode limited scope]
     id8(📱 Mobile Performance)
       id8.1[30-45fps on mobile devices - meeting 30fps baseline target]
@@ -1623,6 +1632,7 @@ mindmap
 ### Mindmap of Opportunities
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 mindmap
   root((🔵 Opportunities Q1 2026))
     id1(💡 PWA & Offline Caching)
@@ -1668,6 +1678,7 @@ mindmap
 ### Mindmap of Threats
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 mindmap
   root((🔴 Threats Q1 2026))
     id1(🌩️ CDN Outages / Latency)
@@ -1737,6 +1748,7 @@ mindmap
 ### Player Archetypes & Combat Philosophy
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 mindmap
   root((🥋 Black Trigram Core))
     id1[🎮 Player Archetypes]
@@ -1814,6 +1826,7 @@ mindmap
 ### System Architecture Layers
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 mindmap
   root((🏗️ Architecture))
     id1[🖥️ Presentation Layer]
@@ -1889,6 +1902,7 @@ mindmap
 ### User Journey Through Game
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     Start([🎮 Game Load]) --> Loading[⏳ Loading Assets]
     Loading --> Intro[🏮 Intro Screen]
@@ -1932,6 +1946,7 @@ flowchart TD
 ### Combat System Data Flow
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TB
     subgraph "🎮 Input Layer"
         KI[Keyboard Input]
@@ -1993,6 +2008,7 @@ graph TB
 ### Trigram Advantage Matrix
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph LR
     subgraph "☯️ Trigram Relationships"
         G[☰ 건 Geon]
@@ -2038,6 +2054,7 @@ graph LR
 ### Resource Loading Pipeline
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#455A64','secondaryColor':'#4CAF50','tertiaryColor':'#FF9800','actorBkg':'#1565C0','actorTextColor':'#fff','actorLineColor':'#455A64','signalColor':'#455A64','signalTextColor':'#fff','noteBkgColor':'#FFD600','noteTextColor':'#000','noteBorderColor':'#F57F17'}}}%%
 sequenceDiagram
     participant B as Browser
     participant L as Asset Loader
@@ -2065,6 +2082,7 @@ sequenceDiagram
 ### Memory Management Strategy
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TD
     subgraph "🧠 Memory Pools"
         PP[Particle Pool<br/>Pre-allocated: 1000]
@@ -2109,6 +2127,7 @@ graph TD
 ### Frontend Security Architecture
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TB
     subgraph "🛡️ Security Layers"
         CSP[Content Security Policy]
@@ -2149,6 +2168,7 @@ graph TB
 ### CI/CD Pipeline
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph LR
     subgraph "🔧 Development"
         DEV[Local Dev]
@@ -2200,6 +2220,7 @@ graph LR
 ### Performance Monitoring Dashboard
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TD
     subgraph "📈 Client Metrics"
         FPS[FPS Counter]
@@ -2246,6 +2267,7 @@ graph TD
 ### Potential Backend Integration
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TD
     subgraph "Current: Frontend Only"
         FE[React + Three.js]

package/COMBAT_ARCHITECTURE.md

@@ -78,6 +78,7 @@ Below, we define the Combat System's architecture in detail.
 ## 🔧 Core Combat System Architecture
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TB
     subgraph "Combat System Controller (src/systems/CombatSystem.ts)"
         CSC[CombatSystemController]:::core
@@ -152,6 +153,7 @@ graph TB
 ## ☰ Trigram Combat System (팔괘 무술 체계)
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph LR
     subgraph "Eight Trigram Stances (팔괘)"
         G[☰ 건 Geon<br/>Heaven]:::geon
@@ -241,6 +243,7 @@ interface StanceGuardPose {
 ### Animation State Integration
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph LR
     subgraph "Guard Animation States"
         SG1[stance_guard_geon]:::guard
@@ -681,6 +684,7 @@ The Stance Transition Animation System provides smooth, realistic 600ms transiti
 ### System Architecture
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TB
     subgraph "Transition Matrix (64 Transitions)"
         TM[STANCE_TRANSITIONS Map]:::matrix
@@ -1194,6 +1198,7 @@ function handleStanceChange(from: TrigramStance, to: TrigramStance) {
 ## 🎯 Vital Point Targeting System (급소 타격 체계)
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TB
     subgraph "70 Vital Points (급소)"
         VPS[VitalPointSystem]:::vital
@@ -1246,6 +1251,7 @@ graph TB
 ## 👤 Player Archetype Combat Specializations (무사 유형별 전투 특화)
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph LR
     subgraph "Five Player Archetypes (오대 무사)"
         M[무사 Musa<br/>Traditional Warrior]:::musa
@@ -1294,6 +1300,7 @@ graph LR
 The Dark Ops technique system integrates authentic Korean special operations combat methods into the game, providing 15 specialized techniques focused on silent incapacitation, tactical assassination, and nerve strike warfare.
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TB
     subgraph "Dark Ops Units (암흑작전 부대)"
         DO[암흑작전부대<br/>Dark Operations Unit]:::darkops
@@ -1453,6 +1460,7 @@ Dark Ops techniques target specific anatomical vulnerable points:
 The Movement Penalty System implements realistic injury-based movement penalties where leg and body damage reduces movement speed, restricts stance changes, and affects balance. This system creates authentic combat trauma effects based on Korean martial arts principles where targeting legs (다리) is a fundamental combat strategy.
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TB
     subgraph "Movement Penalty System (src/systems/bodypart/MovementPenaltySystem.ts)"
         MPS[MovementPenaltySystem]:::movement
@@ -1631,6 +1639,7 @@ if (movementPenaltySystem.shouldEnterHelplessState(health, maxHealth)) {
 The Physical Attributes System implements authentic biomechanics where each fighter's body dimensions (weight, limb length, muscle/fat mass, age) directly affect combat performance. Based on realistic human physiology and Korean martial arts principles, this system ensures that combat feels authentic and strategic.
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TB
     subgraph "Physical Attributes System (src/data/archetypePhysicalAttributes.ts)"
         PAS[PhysicalAttributesSystem]:::physical
@@ -1642,11 +1651,11 @@ graph TB
     
     subgraph "Archetype Physical Profiles"
         APH[ArchetypeProfiles]:::profile
-        APH --> MU[무사 (Musa)]:::musa
-        APH --> AM[암살자 (Amsalja)]:::amsalja
-        APH --> HK[해커 (Hacker)]:::hacker
-        APH --> JB[정보요원 (Jeongbo)]:::jeongbo
-        APH --> JJ[조직폭력배 (Jojik)]:::jojik
+        APH --> MU["무사 Musa"]:::musa
+        APH --> AM["암살자 Amsalja"]:::amsalja
+        APH --> HK["해커 Hacker"]:::hacker
+        APH --> JB["정보요원 Jeongbo"]:::jeongbo
+        APH --> JJ["조직폭력배 Jojik"]:::jojik
     end
     
     subgraph "Combat Physics Engine (src/utils/combatPhysics.ts)"
@@ -2331,6 +2340,7 @@ Recovery animations follow Black Trigram's Korean martial arts principles:
 ## 🎮 Combat Component Architecture
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TB
     subgraph "React Components Layer"
         CS[CombatScreen]:::react
@@ -2372,6 +2382,7 @@ graph TB
 ## 🔊 Audio System Integration
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph LR
     subgraph "Traditional Korean Instruments (국악)"
         GAY[가야금 Gayageum]:::traditional
@@ -2730,6 +2741,7 @@ AI fighters utilize behavior trees for dynamic combat decision-making based on h
 ### AI Decision Flow
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TB
     START[Combat AI Tick]:::start --> ASSESS[Assess Situation]:::process
     
@@ -2754,8 +2766,8 @@ graph TB
     CALC1 --> EXEC[Execute Technique]:::action
     GUARD --> WAIT[Wait for Opening]:::action
     
-    EXEC --> END[End AI Tick]:::end
-    WAIT --> END
+    EXEC --> ENDTICK[End AI Tick]:::endState
+    WAIT --> ENDTICK
     
     classDef start fill:#00ff00,stroke:#333,color:#000
     classDef process fill:#4da6ff,stroke:#333,color:#fff
@@ -2764,7 +2776,7 @@ graph TB
     classDef balanced fill:#ff8c00,stroke:#333,color:#fff
     classDef defensive fill:#0066cc,stroke:#333,color:#fff
     classDef action fill:#9370db,stroke:#333,color:#fff
-    classDef end fill:#808080,stroke:#333,color:#fff
+    classDef endState fill:#808080,stroke:#333,color:#fff
 ```
 
 ### Aggression Levels
@@ -3304,6 +3316,7 @@ The system embodies traditional principles:
 ## 🎯 Success Metrics
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph LR
     subgraph "Combat Effectiveness Metrics"
         ACC[정확도 Accuracy<br/>85%+ hit detection]:::metric

package/DATA_MODEL.md

@@ -38,6 +38,7 @@ Black Trigram (흑괘) is a frontend-only Korean martial arts combat simulator w
 ### **Entity Relationship Diagram**
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#455A64','secondaryColor':'#4CAF50','tertiaryColor':'#FF9800'}}}%%
 erDiagram
     PLAYER ||--|| PLAYER_ARCHETYPE : "has"
     PLAYER ||--o{ STATUS_EFFECT : "suffers"
@@ -689,6 +690,7 @@ Black Trigram implements a performance-optimized skeletal animation system with
 #### **Core Bone Structure (28 bones)**
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TD
     PELVIS[PELVIS - Root]
     
@@ -903,6 +905,7 @@ export enum VitalPointSeverity {
 ### **Combat State Transitions**
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 stateDiagram-v2
     [*] --> IDLE
     

package/SECURITY_ARCHITECTURE.md

@@ -98,6 +98,7 @@ This security architecture implements controls aligned with Hack23 AB's publicly
 The following diagram illustrates the layered defense-in-depth architecture for Black Trigram, showing how security controls are organized across infrastructure, application, and development layers.
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TD
     subgraph "🏆 Defense-in-Depth Security Architecture"
         direction TB
@@ -165,6 +166,7 @@ graph TD
 **Current Status**: ❌ No Authentication - Client-Side Only Web Application
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     subgraph "Frontend-Only Architecture (No Authentication)"
         A[👤 Player] -->|"Direct Access"| B[🌐 Web Browser]
@@ -213,6 +215,7 @@ Black Trigram is a frontend-only web application with:
 **Current Status**: ❌ No Data Auditing - Session-Only Application
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     subgraph "No Auditing Architecture"
         A[👤 Player] -->|"Action"| B[⚙️ Client Logic]
@@ -251,6 +254,7 @@ Black Trigram currently has:
 **Current Status**: ❌ No Session Tracking - Client-Side Only
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     subgraph "No Session Tracking"
         A[👤 Player] -->|"Interact"| B[🖱️ Game Interface]
@@ -289,6 +293,7 @@ Black Trigram session handling:
 **Current Status**: ❌ No Security Event Monitoring - Frontend Only
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     subgraph "No Security Event Monitoring"
         A[🔓 No Authentication<br>Events]
@@ -324,6 +329,7 @@ Black Trigram security monitoring:
 **Current Status**: ✅ AWS CloudFront + Route53 - Multi-Region with GitHub Pages DR
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TD
     subgraph "AWS Network Security Infrastructure"
         A[🌐 Internet] -->|"DNS Query"| B[🛡️ Route53 DNSSEC + Health Checks]
@@ -433,6 +439,7 @@ Black Trigram network security includes AWS CloudFront + S3 multi-region deploym
 ### Domain Security Monitoring
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart LR
     subgraph "DNS Security Monitoring"
         A[🔍 DNSSEC Validation] --> B[📊 Query Monitoring]
@@ -455,6 +462,7 @@ flowchart LR
 **Current Status**: ❌ Not Applicable - No AWS Infrastructure
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart LR
     subgraph "No VPC Infrastructure"
         A[🚫 No Private Subnets]
@@ -478,6 +486,7 @@ Black Trigram does not use VPC infrastructure:
 **Current Status**: ✅ Multi-Region AWS + GitHub Pages DR
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TD
     subgraph "AWS Multi-Region High Availability"
         A[📡 Route53 Health Checks] --> B{Primary Healthy?}
@@ -545,6 +554,7 @@ As a static content application, Black Trigram benefits from inherent resilience
 **Current Status**: ✅ TLS Encryption + S3 Server-Side Encryption
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     subgraph "Data Protection Strategy"
         A[👤 Player] <-->|"🔒 TLS 1.3"| B[⚖️ CloudFront CDN]
@@ -594,6 +604,7 @@ Black Trigram data protection:
 **Current Status**: ✅ Implemented - CloudFront + S3 + Route53
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TD
     subgraph "AWS Security Services"
         A[⚖️ CloudFront CDN] --> B[🛡️ AWS Shield Standard]
@@ -676,6 +687,7 @@ Black Trigram uses AWS infrastructure exclusively for static content hosting and
 **Current Status**: ❌ Not Applicable - No AWS Backend Services
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     subgraph "No AWS FSBP Implementation"
         A[🚫 No Config Service]
@@ -701,6 +713,7 @@ Black Trigram does not implement AWS FSBP (uses AWS only for static hosting via
 **Current Status**: ❌ No Threat Detection - Frontend Only
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     subgraph "No Threat Detection"
         A[🔍 No Threat<br>Detection]
@@ -731,6 +744,7 @@ Black Trigram threat detection:
 **Current Status**: ❌ No Vulnerability Management - Static Content
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     subgraph "No Vulnerability Management"
         A[🔎 No Vulnerability<br>Scanning]
@@ -761,6 +775,7 @@ Black Trigram vulnerability management:
 **Current Status**: ❌ No Configuration Management - Static Content
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     subgraph "No Configuration Management"
         A[⚙️ No AWS Config]
@@ -790,6 +805,7 @@ Black Trigram configuration management:
 **Current Status**: ❌ No Security Monitoring - Frontend Only
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     subgraph "No Security Monitoring"
         A[📊 No Log Sources]
@@ -821,6 +837,7 @@ Black Trigram monitoring:
 **Current Status**: ❌ No Automated Security Operations - Static Content
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     subgraph "No Automated Security Operations"
         A[⏱️ No Maintenance<br>Windows]
@@ -850,6 +867,7 @@ Black Trigram automated operations:
 **Current Status**: ✅ Partial Implementation - Frontend Security Only
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart LR
     subgraph "Frontend Application Security"
         A[🛡️ Browser<br>Security Model] --> B[🔐 HTTPS Only]
@@ -888,6 +906,7 @@ Black Trigram application security:
 **Current Status**: ❌ No Formal Compliance - Educational Application
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph TD
     subgraph "No Formal Compliance"
         A[🏛️ No Compliance<br>Framework]
@@ -919,6 +938,7 @@ Black Trigram compliance:
 **Current Status**: ✅ Simplified Defense Strategy - Minimal Attack Surface
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     subgraph "Simplified Defense-in-Depth"
         A[🌐 Network Layer] --> B[🔒 HTTPS/TLS]
@@ -959,6 +979,7 @@ Black Trigram's simplified defense approach:
 **Current Status**: ❌ No Security Operations - Static Content Only
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     subgraph "No Security Operations"
         A[🔍 No Monitoring]
@@ -990,6 +1011,7 @@ Black Trigram security operations:
 **Current Status**: ✅ Minimal Security Investment - Frontend Only
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     subgraph "Minimal Security Investment"
         A[💰 Low Cost] --> B[📦 CDN Costs Only]
@@ -1028,6 +1050,7 @@ Black Trigram security investment:
 **Current Status**: ✅ Comprehensive CI/CD Security - GitHub Actions
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     subgraph "Security-Hardened CI/CD Pipeline"
         A[🔒 Source Code<br>Security] --> B[🔍 CodeQL Analysis]

package/THREAT_MODEL.md

@@ -45,6 +45,7 @@ _— Based on Hack23 AB's commitment to security through transparency and excell
 This threat model implements all five strategies defined in [Hack23 AB Threat Modeling Policy §4](https://github.com/Hack23/ISMS-PUBLIC/blob/main/Threat_Modeling.md#threat-modeling-strategies):
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 mindmap
   root)🎯 Black Trigram Threat Modeling(
     (🎖️ Attacker-Centric)
@@ -425,16 +426,20 @@ Following [Risk-Centric Threat Modeling](https://github.com/Hack23/ISMS-PUBLIC/b
 ### **⚖️ Risk Heat Matrix**
 
 ```mermaid
-%%{
-  init: {
-    'theme': 'base',
-    'themeVariables': {
-      'primaryColor': '#fff',
-      'primaryTextColor': '#000',
-      'lineColor': '#333'
-    }
+%%{init: {
+  "theme": "neutral",
+  "themeVariables": {
+    "quadrant1Fill": "#2E7D32",
+    "quadrant2Fill": "#D32F2F",
+    "quadrant3Fill": "#1565C0",
+    "quadrant4Fill": "#FF9800",
+    "quadrantTitleFill": "#ffffff",
+    "quadrantPointFill": "#ffffff",
+    "quadrantPointTextFill": "#ffffff",
+    "quadrantXAxisTextFill": "#ffffff",
+    "quadrantYAxisTextFill": "#ffffff"
   }
-}%%
+}}%%
 quadrantChart
     title 🎯 Black Trigram Risk Heat Matrix
     x-axis Low Likelihood --> High Likelihood
@@ -937,6 +942,7 @@ Following [Hack23 AB Threat Modeling Policy — AI-Enabled Threats](https://gith
 #### **🛡️ AI Threat Countermeasures for Educational Gaming**
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 flowchart TD
     A[🤖 AI Threat Detection] --> B{Threat Category}
     B -->|Content Manipulation| C[Cultural Review Gate]
@@ -974,6 +980,7 @@ Following [Hack23 AB Threat Modeling Policy — Maturity Framework](https://gith
 #### **📈 Maturity Progression Roadmap**
 
 ```mermaid
+%%{init: {'theme':'base', 'themeVariables': {'primaryColor':'#2979FF','primaryTextColor':'#fff','primaryBorderColor':'#0D47A1','lineColor':'#00C853','secondaryColor':'#FFD600','tertiaryColor':'#FF3D00'}}}%%
 graph LR
     L1[Level 1<br/>Ad-hoc<br/>✅ Done] --> L2[Level 2<br/>Repeatable<br/>✅ Done]
     L2 --> L3[Level 3<br/>Defined<br/>✅ Current]

package/lib/components/screens/intro/IntroScreen3D.js

@@ -21,7 +21,7 @@ import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Canvas } from "@react-three/fiber";
 //#region src/components/screens/intro/IntroScreen3D.tsx
-var APP_VERSION = "0.7.13";
+var APP_VERSION = "0.7.14";
 var MENU_ITEMS = [
 	{
 		mode: GameMode.VERSUS,

package/lib/components/shared/ui/SplashScreen.js

@@ -183,7 +183,7 @@ var SplashScreen = ({ onStart, width, height }) => {
 			}),
 			/* @__PURE__ */ jsxs("div", {
 				role: "contentinfo",
-				"aria-label": `Application version 0.7.13`,
+				"aria-label": `Application version 0.7.14`,
 				style: {
 					position: "absolute",
 					bottom: "20px",
@@ -192,7 +192,7 @@ var SplashScreen = ({ onStart, width, height }) => {
 					fontSize: "10px",
 					zIndex: 1
 				},
-				children: ["v", "0.7.13"]
+				children: ["v", "0.7.14"]
 			})
 		]
 	});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "blacktrigram",
-  "version": "0.7.13",
+  "version": "0.7.14",
   "description": "Black Trigram (흑괘) - Korean Martial Arts Combat Simulator. Reusable game systems, combat mechanics, animation framework, and Korean martial arts data built with React, Three.js, and TypeScript.",
   "type": "module",
   "main": "./lib/index.js",
@@ -186,7 +186,7 @@
     "three": "^0.183.0"
   },
   "devDependencies": {
-    "@aws-sdk/client-bedrock-runtime": "3.1025.0",
+    "@aws-sdk/client-bedrock-runtime": "3.1027.0",
     "@eslint/js": "10.0.1",
     "@react-three/drei": "10.7.7",
     "@react-three/fiber": "9.5.0",
@@ -202,7 +202,7 @@
     "@vitejs/plugin-react": "6.0.1",
     "@vitest/coverage-v8": "4.1.3",
     "@vitest/ui": "4.1.3",
-    "cypress": "15.13.0",
+    "cypress": "15.13.1",
     "cypress-junit-reporter": "1.3.1",
     "cypress-multi-reporters": "2.0.5",
     "cypress-wait-until": "3.0.2",
@@ -214,17 +214,17 @@
     "globals": "17.4.0",
     "jest-axe": "10.0.0",
     "jsdom": "29.0.2",
-    "knip": "6.3.0",
+    "knip": "6.3.1",
     "license-compliance": "3.0.1",
     "mocha-junit-reporter": "2.2.1",
     "mochawesome": "7.1.4",
     "mochawesome-merge": "5.1.1",
     "mochawesome-report-generator": "6.3.2",
-    "openai": "6.33.0",
+    "openai": "6.34.0",
     "playwright": "1.59.1",
     "postprocessing": "6.39.0",
-    "react": "19.2.4",
-    "react-dom": "19.2.4",
+    "react": "19.2.5",
+    "react-dom": "19.2.5",
     "start-server-and-test": "3.0.0",
     "three": "0.183.2",
     "ts-morph": "27.0.2",
@@ -236,8 +236,8 @@
     "typedoc-plugin-mermaid": "1.12.0",
     "typedoc-plugin-missing-exports": "4.1.3",
     "typescript": "6.0.2",
-    "typescript-eslint": "8.58.0",
-    "vite": "8.0.6",
+    "typescript-eslint": "8.58.1",
+    "vite": "8.0.8",
     "vite-bundle-analyzer": "1.3.7",
     "vite-tsconfig-paths": "6.1.1",
     "vitest": "4.1.3"