doc: add chinese, koren, russian

Docs/README.es.md

@@ -1,6 +1,6 @@
 # SmartAsyncImage
 
-Un `AsyncImage` para SwiftUI (iOS) mas inteligente y rapido, con cache en memoria y en disco, cancelacion y concurrencia de Swift 6.
+Un `AsyncImage` para SwiftUI (iOS) más inteligente y rápido, con caché en memoria y en disco, cancelación y concurrencia de Swift 6.
 
 [![CI](https://github.com/gentle-giraffe-apps/SmartAsyncImage/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/gentle-giraffe-apps/SmartAsyncImage/actions/workflows/ci.yml)
 [![Coverage](https://codecov.io/gh/gentle-giraffe-apps/SmartAsyncImage/branch/main/graph/badge.svg)](https://codecov.io/gh/gentle-giraffe-apps/SmartAsyncImage)
@@ -12,34 +12,34 @@ Un `AsyncImage` para SwiftUI (iOS) mas inteligente y rapido, con cache en memori
 ![Last commit](https://img.shields.io/github/last-commit/gentle-giraffe-apps/SmartAsyncImage)
 [![DeepSource](https://app.deepsource.com/gh/gentle-giraffe-apps/SmartAsyncImage.svg/?label=active+issues&show_trend=true)](https://app.deepsource.com/gh/gentle-giraffe-apps/SmartAsyncImage/)
 
-> **Idioma** · [English](../README.md) · Español · [Português (Brasil)](README.pt-BR.md) · [日本語](README.ja.md)
+> 🌍 **Idioma** · [English](../README.md) · Español · [Português (Brasil)](README.pt-BR.md) · [日本語](README.ja.md) · [简体中文](README.zh-CN.md) · [한국어](README.ko.md) · [Русский](README.ru.md)
 
-## Caracteristicas
+## Características
 - API compatible con SwiftUI con un view model observable
 - Manejo inteligente de fases: `empty`, `loading`, `success(Image)`, `failure(Error)`
-- Protocolo de cache en memoria con implementaciones intercambiables
-- Cache en disco para persistencia entre ejecuciones
-- Concurrencia de Swift (`async/await`) con cancelacion cooperativa
+- Protocolo de caché en memoria con implementaciones intercambiables
+- Caché en disco para persistencia entre ejecuciones
+- Concurrencia de Swift (`async/await`) con cancelación cooperativa
 - Actualizaciones de estado seguras en MainActor
 
-💬 **[Participa en la discusion. Comentarios y preguntas son bienvenidos](https://github.com/gentle-giraffe-apps/SmartAsyncImage/discussions)**
+💬 **[Participa en la discusión. Comentarios y preguntas son bienvenidos](https://github.com/gentle-giraffe-apps/SmartAsyncImage/discussions)**
 
 ## Requisitos
 - iOS 17+
 - Swift 6.1+
 - Swift Package Manager
 
-## 📦 Instalacion (Swift Package Manager)
+## 📦 Instalación (Swift Package Manager)
 
-### Via Xcode
+### Vía Xcode
 
 1. Abre tu proyecto en Xcode
 2. Ve a **File → Add Packages...**
 3. Ingresa la URL del repositorio: `https://github.com/gentle-giraffe-apps/SmartAsyncImage.git`
-4. Elige una regla de version (o `main` durante el desarrollo)
+4. Elige una regla de versión (o `main` durante el desarrollo)
 5. Agrega el producto **SmartAsyncImage** a tu target de la app
 
-### Via `Package.swift`
+### Vía `Package.swift`
 
 ```swift
 dependencies: [
@@ -49,32 +49,32 @@ dependencies: [
 
 Luego agrega `"SmartAsyncImage"` a las `dependencies` de tu target.
 
-## App de Demostracion
+## App de Demostración
 
-Se incluye una app de demostracion en SwiftUI en este repositorio usando una referencia local al paquete.
+Se incluye una app de demostración en SwiftUI en este repositorio usando una referencia local al paquete.
 
 **Ruta:**
 ```
 Demo/SmartAsyncImageDemo/SmartAsyncImageDemo.xcodeproj
 ```
 
-### Como Ejecutar
+### Cómo Ejecutar
 1. Clona el repositorio:
    ```bash
    git clone https://github.com/gentle-giraffe-apps/SmartAsyncImage.git
    ```
-2. Abre el proyecto de demostracion:
+2. Abre el proyecto de demostración:
    ```
    Demo/SmartAsyncImageDemo/SmartAsyncImageDemo.xcodeproj
    ```
 3. Selecciona un simulador con iOS 17+.
 4. Compila y ejecuta (⌘R).
 
-El proyecto esta preconfigurado con una referencia local de Swift Package a `SmartAsyncImage` y deberia ejecutarse sin configuracion adicional.
+El proyecto está preconfigurado con una referencia local de Swift Package a `SmartAsyncImage` y debería ejecutarse sin configuración adicional.
 
 ## Uso
 
-### Ejemplo Rapido (SwiftUI)
+### Ejemplo Rápido (SwiftUI)
 ```swift
 import SwiftUI
 import SmartAsyncImage
@@ -108,23 +108,23 @@ struct MinimalRemoteImageView: View {
 
 ## Calidad y Herramientas
 
-Este proyecto aplica controles de calidad mediante CI y analisis estatico:
+Este proyecto aplica controles de calidad mediante CI y análisis estático:
 
 - **CI:** Todos los commits a `main` deben pasar las verificaciones de GitHub Actions
-- **Analisis estatico:** DeepSource se ejecuta en cada commit a `main`.
-  La insignia indica el numero actual de problemas pendientes de analisis estatico.
-- **Cobertura de tests:** Codecov reporta la cobertura de lineas para la rama `main`
+- **Análisis estático:** DeepSource se ejecuta en cada commit a `main`.
+  La insignia indica el número actual de problemas pendientes de análisis estático.
+- **Cobertura de tests:** Codecov reporta la cobertura de líneas para la rama `main`
 
 <sub><strong>Captura de Codecov</strong></sub><br/>
 <a href="https://codecov.io/gh/gentle-giraffe-apps/SmartAsyncImage">
   <img
     src="https://codecov.io/gh/gentle-giraffe-apps/SmartAsyncImage/graphs/icicle.svg"
     height="80"
-    alt="Captura de cobertura de codigo por archivo y modulo (grafico de arbol de Codecov)"
+    alt="Captura de cobertura de código por archivo y módulo (gráfico de árbol de Codecov)"
   />
 </a>
 
-Estas verificaciones tienen como objetivo mantener el sistema de diseno seguro para evolucionar con el tiempo.
+Estas verificaciones tienen como objetivo mantener el sistema de diseño seguro para evolucionar con el tiempo.
 
 ---
 
@@ -145,7 +145,7 @@ flowchart TD
 
 ## 🤖 Nota sobre Herramientas
 
-Partes de la redaccion y el refinamiento editorial en este repositorio fueron aceleradas utilizando modelos de lenguaje grandes (incluyendo ChatGPT, Claude y Gemini) bajo diseno, validacion y aprobacion final humana directa. Todas las decisiones tecnicas, el codigo y las conclusiones arquitectonicas son de autoria y verificacion del mantenedor del repositorio.
+Partes de la redacción y el refinamiento editorial en este repositorio fueron aceleradas utilizando modelos de lenguaje grandes (incluyendo ChatGPT, Claude y Gemini) bajo diseño, validación y aprobación final humana directa. Todas las decisiones técnicas, el código y las conclusiones arquitectónicas son de autoría y verificación del mantenedor del repositorio.
 
 ---
 

Docs/README.ja.md

@@ -12,7 +12,7 @@ SwiftUI (iOS) 向けの、より高速でスマートな `AsyncImage`。メモ
 ![Last commit](https://img.shields.io/github/last-commit/gentle-giraffe-apps/SmartAsyncImage)
 [![DeepSource](https://app.deepsource.com/gh/gentle-giraffe-apps/SmartAsyncImage.svg/?label=active+issues&show_trend=true)](https://app.deepsource.com/gh/gentle-giraffe-apps/SmartAsyncImage/)
 
-> **言語** · [English](../README.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · 日本語
+> 🌍 **言語** · [English](../README.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · 日本語 · [简体中文](README.zh-CN.md) · [한국어](README.ko.md) · [Русский](README.ru.md)
 
 ## 特徴
 - Observable なビューモデルを備えた SwiftUI 対応 API

Docs/README.ko.md

@@ -0,0 +1,165 @@
+# SmartAsyncImage
+
+SwiftUI (iOS)를 위한 더 스마트하고 빠른 `AsyncImage` 대체제. 메모리 및 디스크 캐싱, 취소, Swift 6 동시성을 기본 지원합니다.
+
+[![CI](https://github.com/gentle-giraffe-apps/SmartAsyncImage/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/gentle-giraffe-apps/SmartAsyncImage/actions/workflows/ci.yml)
+[![Coverage](https://codecov.io/gh/gentle-giraffe-apps/SmartAsyncImage/branch/main/graph/badge.svg)](https://codecov.io/gh/gentle-giraffe-apps/SmartAsyncImage)
+[![Swift](https://img.shields.io/badge/Swift-6.1+-orange.svg)](https://swift.org)
+![Bazel](https://img.shields.io/badge/Bazel-enabled-555?logo=bazel)
+[![SPM Compatible](https://img.shields.io/badge/SPM-Compatible-brightgreen.svg)](https://swift.org/package-manager/)
+[![Platforms](https://img.shields.io/badge/platforms-iOS%2017%2B-blue)](https://developer.apple.com/ios/)
+![Commit activity](https://img.shields.io/github/commit-activity/y/gentle-giraffe-apps/SmartAsyncImage)
+![Last commit](https://img.shields.io/github/last-commit/gentle-giraffe-apps/SmartAsyncImage)
+[![DeepSource](https://app.deepsource.com/gh/gentle-giraffe-apps/SmartAsyncImage.svg/?label=active+issues&show_trend=true)](https://app.deepsource.com/gh/gentle-giraffe-apps/SmartAsyncImage/)
+
+> 🌍 **언어** · [English](../README.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · [日本語](README.ja.md) · [简体中文](README.zh-CN.md) · 한국어 · [Русский](README.ru.md)
+
+## 특징
+- Observable 뷰 모델을 갖춘 SwiftUI 친화적 API
+- 스마트한 단계 관리: `empty`, `loading`, `success(Image)`, `failure(Error)`
+- 플러그인 가능한 구현을 지원하는 메모리 캐시 프로토콜
+- 앱 재시작 간 데이터를 유지하는 디스크 캐시
+- Swift Concurrency (`async/await`) 및 협력적 취소
+- MainActor 안전한 상태 업데이트
+
+💬 **[토론에 참여하세요. 피드백과 질문을 환영합니다](https://github.com/gentle-giraffe-apps/SmartAsyncImage/discussions)**
+
+## 요구 사항
+- iOS 17+
+- Swift 6.1+
+- Swift Package Manager
+
+## 📦 설치 (Swift Package Manager)
+
+### Xcode를 통한 설치
+
+1. Xcode에서 프로젝트를 엽니다
+2. **File → Add Packages...** 로 이동합니다
+3. 저장소 URL을 입력합니다: `https://github.com/gentle-giraffe-apps/SmartAsyncImage.git`
+4. 버전 규칙을 선택합니다 (개발 중에는 `main` 선택 가능)
+5. **SmartAsyncImage** 제품을 앱 타겟에 추가합니다
+
+### `Package.swift`를 통한 설치
+
+```swift
+dependencies: [
+    .package(url: "https://github.com/gentle-giraffe-apps/SmartAsyncImage.git", from: "1.0.0")
+]
+```
+
+그런 다음 타겟의 `dependencies`에 `"SmartAsyncImage"`를 추가합니다.
+
+## 데모 앱
+
+로컬 패키지 참조를 사용하는 SwiftUI 데모 앱이 이 저장소에 포함되어 있습니다.
+
+**경로:**
+```
+Demo/SmartAsyncImageDemo/SmartAsyncImageDemo.xcodeproj
+```
+
+### 실행 방법
+1. 저장소를 클론합니다:
+   ```bash
+   git clone https://github.com/gentle-giraffe-apps/SmartAsyncImage.git
+   ```
+2. 데모 프로젝트를 엽니다:
+   ```
+   Demo/SmartAsyncImageDemo/SmartAsyncImageDemo.xcodeproj
+   ```
+3. iOS 17+ 시뮬레이터를 선택합니다.
+4. 빌드 및 실행합니다 (⌘R).
+
+프로젝트는 `SmartAsyncImage`에 대한 로컬 Swift Package 참조로 사전 구성되어 있으며, 추가 설정 없이 실행할 수 있습니다.
+
+## 사용법
+
+### 빠른 예제 (SwiftUI)
+```swift
+import SwiftUI
+import SmartAsyncImage
+
+struct MinimalRemoteImageView: View {
+    let imageURL = URL(string: "https://picsum.photos/300")
+
+    var body: some View {
+
+        // 교체 전: AsyncImage(url: imageURL) { phase in
+        // ------------------------------------------------
+        // 교체 후:
+
+        SmartAsyncImage(url: imageURL) { phase in
+
+        // ------------------------------------------------
+
+            switch phase {
+            case .empty, .loading:
+                ProgressView()
+            case .success(let image):
+                image.resizable().scaledToFit()
+            case .failure:
+                Image(systemName: "photo")
+            }
+        }
+        .frame(width: 150, height: 150)
+    }
+}
+```
+
+## 품질 및 도구
+
+이 프로젝트는 CI와 정적 분석을 통해 품질 관리를 시행합니다:
+
+- **CI:** `main`에 대한 모든 커밋은 GitHub Actions 검사를 통과해야 합니다
+- **정적 분석:** DeepSource가 `main`에 대한 모든 커밋에서 실행됩니다.
+  배지는 현재 미해결 정적 분석 이슈 수를 나타냅니다.
+- **테스트 커버리지:** Codecov가 `main` 브랜치의 라인 커버리지를 보고합니다
+
+<sub><strong>Codecov 스냅샷</strong></sub><br/>
+<a href="https://codecov.io/gh/gentle-giraffe-apps/SmartAsyncImage">
+  <img
+    src="https://codecov.io/gh/gentle-giraffe-apps/SmartAsyncImage/graphs/icicle.svg"
+    height="80"
+    alt="파일 및 모듈별 코드 커버리지 스냅샷 (Codecov 트리 그래프)"
+  />
+</a>
+
+이러한 검사는 설계 시스템이 안전하게 발전할 수 있도록 하기 위한 것입니다.
+
+---
+
+## 아키텍처
+
+```mermaid
+flowchart TD
+    SAI["SmartAsyncImage<br/>(SwiftUI View)"] --> VM["SmartAsyncImage<br/>ViewModel"]
+    VM --> Phase["SmartAsyncImage<br/>Phase"]
+    VM --> MemProto["SmartAsyncImageMemory<br/>CacheProtocol"]
+    MemProto --> Mem["SmartAsyncImage<br/>MemoryCache<br/>(actor)"]
+    Mem --> Disk["SmartAsyncImage<br/>DiskCache"]
+    Disk --> Encoder["SmartAsyncImage<br/>Encoder"]
+    Mem --> URLSession[["URLSession"]]
+```
+
+---
+
+## 🤖 도구 참고 사항
+
+이 저장소의 초안 작성 및 편집 다듬기 일부는 대규모 언어 모델(ChatGPT, Claude, Gemini 포함)을 활용하여 가속되었으며, 인간의 직접적인 설계, 검증 및 최종 승인 하에 수행되었습니다. 모든 기술적 결정, 코드 및 아키텍처 결론은 저장소 관리자가 작성하고 검증했습니다.
+
+---
+
+## 🔐 라이선스
+
+MIT 라이선스
+개인 및 상업적 용도로 자유롭게 사용할 수 있습니다.
+
+---
+
+## 👤 저자
+
+**Jonathan Ritchey** 제작
+Gentle Giraffe Apps
+시니어 iOS 엔지니어 --- Swift | SwiftUI | Concurrency
+
+![Visitors](https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fgithub.com%2Fgentle-giraffe-apps%2FSmartAsyncImage)