From 58d17dc1bbfc642cce66ec71bf76ab5255e7284d Mon Sep 17 00:00:00 2001
From: Youna Joo <you.na.joo0@gmail.com>
Date: Mon, 20 Oct 2025 19:19:07 +0900
Subject: [PATCH 01/14] docs: add README.md

---
 README.md | 71 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 70 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 13420b29..e1c318fb 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,70 @@
-# javascript-calculator-precourse
\ No newline at end of file
+# javascript-calculator-precourse
+
+# 🧮 문자열 덧셈 계산기
+
+## 구현 기능 목록
+
+> 각 기능 구현이 완료될 때마다 AngularJS 커밋 컨벤션을 사용하여 커밋.  
+> 커밋 단위는 “한 기능 = 한 커밋” 
+
+---
+
+### 1. 입력 안내 출력
+
+- [x] `Console.print('덧셈할 문자열을 입력해 주세요.')` 출력
+
+---
+
+### 2. 문자열 입력 받기
+
+- [x] `Console.readLineAsync()`로 사용자로부터 문자열 한 줄을 입력받음
+
+---
+
+### 3. 빈 문자열 처리
+
+- [x] 빈 문자열(`""` 또는 공백만 포함) 입력 시 결과 `0` 반환
+
+---
+
+### 4. 커스텀 구분자 파싱
+
+- [x] 입력 문자열이 "//"로 시작하고 "\n"을 포함하는 경우, "//"와 "\n" 사이에 있는 문자를 커스텀 구분자로 사용
+- [x] 그렇지 않으면 기본 구분자 `,`와 `:` 사용
+
+---
+
+### 5. 숫자 분리 로직
+
+- [x] 구분자(기본/커스텀)로 문자열을 나누어 각 숫자를 얻기
+- [x] 각 숫자 앞뒤 공백(`trim()`) 제거
+
+---
+
+### 6. 유효성 검증
+
+- [x] 분리된 모든 값이 정수 형태의 문자열인지 확인
+- [x] 양의 정수만 허용 (0 및 음수 금지)
+- [x] 연속 구분자(`"1,,2"`, `"1:"`) 등 잘못된 형식의 입력을 확인
+- [x] 오류 발생 시 `[ERROR]`로 시작하는 메시지와 함께 `Error` 발생시킨 후 애플리케이션은 종료
+
+---
+
+### 7. 합계 계산
+
+- [x] 검증 통과한 정수들을 합산하여 `Number`로 반환
+
+---
+
+### 8. 출력 형식 준수
+
+- [x] 결과 출력 시 형식을 정확히 맞춤
+- [x] 공백 및 콜론(`:`) 위치 정확히 유지
+
+---
+
+### 9. 예외 처리 및 종료 흐름
+
+- [x] `run()` 내부에서 오류를 `try/catch`로 처리
+- [x] `[ERROR]` 메시지를 `Console.print()`로 출력
+- [x] `process.exit()` 호출 없이 자연스럽게 종료

From ab6d630443f2631a27d5750b6ebdcbae92964560 Mon Sep 17 00:00:00 2001
From: Youna Joo <you.na.joo0@gmail.com>
Date: Mon, 20 Oct 2025 19:25:47 +0900
Subject: [PATCH 02/14] feat(app): print input prompt using mission-utils
 Console

---
 src/App.js | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/src/App.js b/src/App.js
index 091aa0a5..2d820d55 100644
--- a/src/App.js
+++ b/src/App.js
@@ -1,5 +1,8 @@
 class App {
-  async run() {}
+  async run() {
+    const { Console } = await import("@woowacourse/mission-utils");
+    Console.print("덧셈할 문자열을 입력해 주세요.");
+  }
 }
 
 export default App;

From b7354bc7ba54263476badcc84f6ce88b2eaba494 Mon Sep 17 00:00:00 2001
From: Youna Joo <you.na.joo0@gmail.com>
Date: Mon, 20 Oct 2025 19:26:47 +0900
Subject: [PATCH 03/14] chore: add custom type declarations for
 @woowacourse/mission-utils

---
 types/woowacourse__mission-utils.d.ts | 6 ++++++
 1 file changed, 6 insertions(+)
 create mode 100644 types/woowacourse__mission-utils.d.ts

diff --git a/types/woowacourse__mission-utils.d.ts b/types/woowacourse__mission-utils.d.ts
new file mode 100644
index 00000000..00574645
--- /dev/null
+++ b/types/woowacourse__mission-utils.d.ts
@@ -0,0 +1,6 @@
+declare module "@woowacourse/mission-utils" {
+  export const Console: {
+    readLineAsync(prompt?: string): Promise<string>;
+    print(message: string): void;
+  };
+}

From d60a9c74586f3c8809cfce2bd0a76d7541ffcb51 Mon Sep 17 00:00:00 2001
From: Youna Joo <you.na.joo0@gmail.com>
Date: Mon, 20 Oct 2025 19:30:06 +0900
Subject: [PATCH 04/14] feat(app): read user input from console

---
 src/App.js | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/App.js b/src/App.js
index 2d820d55..091e0ee0 100644
--- a/src/App.js
+++ b/src/App.js
@@ -2,6 +2,8 @@ class App {
   async run() {
     const { Console } = await import("@woowacourse/mission-utils");
     Console.print("덧셈할 문자열을 입력해 주세요.");
+
+    const input = await Console.readLineAsync();
   }
 }
 

From 568594dc67295757ff3ff9fc30ec461ea9b4a55e Mon Sep 17 00:00:00 2001
From: Youna Joo <you.na.joo0@gmail.com>
Date: Mon, 20 Oct 2025 20:50:25 +0900
Subject: [PATCH 05/14] feat(calculator): implement add function to handle
 input and return sum

---
 src/App.js              | 2 ++
 src/StringCalculator.js | 4 ++++
 2 files changed, 6 insertions(+)
 create mode 100644 src/StringCalculator.js

diff --git a/src/App.js b/src/App.js
index 091e0ee0..25cf6783 100644
--- a/src/App.js
+++ b/src/App.js
@@ -4,6 +4,8 @@ class App {
     Console.print("덧셈할 문자열을 입력해 주세요.");
 
     const input = await Console.readLineAsync();
+
+    const result = add(input);
   }
 }
 
diff --git a/src/StringCalculator.js b/src/StringCalculator.js
new file mode 100644
index 00000000..de2520bb
--- /dev/null
+++ b/src/StringCalculator.js
@@ -0,0 +1,4 @@
+export function add(input) {
+  const trimmed = (input ?? "").trim();
+  if (trimmed === "") return 0;
+}

From f030549a9bab4709333d8dca91b3ca8e63847f92 Mon Sep 17 00:00:00 2001
From: Youna Joo <you.na.joo0@gmail.com>
Date: Mon, 20 Oct 2025 21:23:33 +0900
Subject: [PATCH 06/14] feat(calculator): add support for custom delimiters in
 input parsing

---
 src/StringCalculator.js | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/src/StringCalculator.js b/src/StringCalculator.js
index de2520bb..39e5302e 100644
--- a/src/StringCalculator.js
+++ b/src/StringCalculator.js
@@ -1,4 +1,27 @@
+const DEFAULT_DELIMS = [",", ":"];
+
+function parseDelimiterAndBody(input) {
+  if (input.startsWith("//")) {
+    const idx = input.indexOf("\n");
+    if (idx === -1) {
+      throw new Error("[ERROR] 커스텀 구분자 뒤에 줄바꿈(\\n)이 필요합니다.");
+    }
+    const delim = input.slice(2, idx);
+    if (!delim || delim.length !== 1) {
+      throw new Error(
+        "[ERROR] 커스텀 구분자는 '//'와 '\\n' 사이의 문자 1개만 사용할 수 있습니다."
+      );
+    }
+    // 커스텀 구분자가 존재할 때
+    return { delims: [delim], body: input.slice(idx + 1) };
+  }
+  // 커스텀 구분자가 없을 때
+  return { delims: DEFAULT_DELIMS, body: input };
+}
+
 export function add(input) {
   const trimmed = (input ?? "").trim();
   if (trimmed === "") return 0;
+
+  const { delims, body } = parseDelimiterAndBody(trimmed);
 }

From db773d92ba7acf35374948253c8dae481837b880 Mon Sep 17 00:00:00 2001
From: Youna Joo <you.na.joo0@gmail.com>
Date: Mon, 20 Oct 2025 21:47:43 +0900
Subject: [PATCH 07/14] feat(calculator): implement token splitting for input
 parsing with custom delimiters

---
 src/StringCalculator.js | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/src/StringCalculator.js b/src/StringCalculator.js
index 39e5302e..f2873e28 100644
--- a/src/StringCalculator.js
+++ b/src/StringCalculator.js
@@ -1,5 +1,9 @@
 const DEFAULT_DELIMS = [",", ":"];
 
+function escapeRegexChar(ch) {
+  return ch.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
 function parseDelimiterAndBody(input) {
   if (input.startsWith("//")) {
     const idx = input.indexOf("\n");
@@ -19,9 +23,19 @@ function parseDelimiterAndBody(input) {
   return { delims: DEFAULT_DELIMS, body: input };
 }
 
+function splitTokens(body, delims) {
+  if (body === "") return [];
+  const escaped = delims.map(escapeRegexChar).join("");
+  const re = new RegExp(`[${escaped}]`, "g");
+  const raw = body.split(re).map((t) => t.trim());
+  return raw;
+}
+
 export function add(input) {
   const trimmed = (input ?? "").trim();
   if (trimmed === "") return 0;
 
   const { delims, body } = parseDelimiterAndBody(trimmed);
+
+  const tokens = splitTokens(body, delims);
 }

From f80da9318a144ef0463baac511d2aeeae2441f16 Mon Sep 17 00:00:00 2001
From: Youna Joo <you.na.joo0@gmail.com>
Date: Mon, 20 Oct 2025 22:08:00 +0900
Subject: [PATCH 08/14] feat(calculator): add validation for token splitting
 and convert tokens to positive integers

---
 src/StringCalculator.js | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/src/StringCalculator.js b/src/StringCalculator.js
index f2873e28..a0cff4d3 100644
--- a/src/StringCalculator.js
+++ b/src/StringCalculator.js
@@ -28,9 +28,29 @@ function splitTokens(body, delims) {
   const escaped = delims.map(escapeRegexChar).join("");
   const re = new RegExp(`[${escaped}]`, "g");
   const raw = body.split(re).map((t) => t.trim());
+
+  // split으로 나눈 결과가 유효한지 검사
+  if (raw.some((t) => t === "")) {
+    throw new Error("[ERROR] 구분자 사이에 숫자가 비어있습니다.");
+  }
   return raw;
 }
 
+function toPositiveIntegers(tokens) {
+  return tokens.map((t) => {
+    // 정규식 검사
+    if (!/^\d+$/.test(t)) {
+      throw new Error("[ERROR] 숫자 이외의 값이 포함되어 있습니다.");
+    }
+    // 숫자 변환 및 음수/0 검사
+    const num = Number(t);
+    if (num <= 0) {
+      throw new Error("[ERROR] 0 또는 음수는 허용되지 않습니다.");
+    }
+    return num;
+  });
+}
+
 export function add(input) {
   const trimmed = (input ?? "").trim();
   if (trimmed === "") return 0;
@@ -38,4 +58,6 @@ export function add(input) {
   const { delims, body } = parseDelimiterAndBody(trimmed);
 
   const tokens = splitTokens(body, delims);
+
+  const numbers = toPositiveIntegers(tokens);
 }

From 0a1790d9b712fa4000b933ad7597d24366b2933f Mon Sep 17 00:00:00 2001
From: Youna Joo <you.na.joo0@gmail.com>
Date: Mon, 20 Oct 2025 22:11:49 +0900
Subject: [PATCH 09/14] feat(calculator): calculate sum of positive integers
 from split strings

---
 src/StringCalculator.js | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/StringCalculator.js b/src/StringCalculator.js
index a0cff4d3..2f950c49 100644
--- a/src/StringCalculator.js
+++ b/src/StringCalculator.js
@@ -60,4 +60,9 @@ export function add(input) {
   const tokens = splitTokens(body, delims);
 
   const numbers = toPositiveIntegers(tokens);
+
+  // 합산
+  return numbers.reduce((acc, n) => acc + n, 0);
+
+  r;
 }

From ba191bd2cea295c9b2b08f56e1e95c3bd907739c Mon Sep 17 00:00:00 2001
From: Youna Joo <you.na.joo0@gmail.com>
Date: Mon, 20 Oct 2025 22:14:17 +0900
Subject: [PATCH 10/14] feat(app): display calculation result in console output

---
 src/App.js | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/src/App.js b/src/App.js
index 25cf6783..bb968053 100644
--- a/src/App.js
+++ b/src/App.js
@@ -6,6 +6,8 @@ class App {
     const input = await Console.readLineAsync();
 
     const result = add(input);
+
+    Console.print(`결과 : ${result}`);
   }
 }
 

From a51252afe87dac4b089570ec941ed8695a79d466 Mon Sep 17 00:00:00 2001
From: Youna Joo <you.na.joo0@gmail.com>
Date: Mon, 20 Oct 2025 22:38:50 +0900
Subject: [PATCH 11/14] feat(app): add error handling for user input in console

---
 src/App.js | 18 +++++++++++++-----
 1 file changed, 13 insertions(+), 5 deletions(-)

diff --git a/src/App.js b/src/App.js
index bb968053..bec89bb3 100644
--- a/src/App.js
+++ b/src/App.js
@@ -1,13 +1,21 @@
 class App {
   async run() {
-    const { Console } = await import("@woowacourse/mission-utils");
-    Console.print("덧셈할 문자열을 입력해 주세요.");
+    // 예외 처리
+    try {
+      const { Console } = await import("@woowacourse/mission-utils");
+      Console.print("덧셈할 문자열을 입력해 주세요.");
 
-    const input = await Console.readLineAsync();
+      const input = await Console.readLineAsync();
 
-    const result = add(input);
+      const result = add(input);
 
-    Console.print(`결과 : ${result}`);
+      Console.print(`결과 : ${result}`);
+    } catch (error) {
+      const { Console } = await import("@woowacourse/mission-utils");
+      const message =
+        error?.message ?? "[ERROR] 알 수 없는 오류가 발생했습니다.";
+      Console.print(message);
+    }
   }
 }
 

From 0bdb072685b51280d144273fe9e878b53f4bcf36 Mon Sep 17 00:00:00 2001
From: Youna Joo <you.na.joo0@gmail.com>
Date: Mon, 20 Oct 2025 22:44:40 +0900
Subject: [PATCH 12/14] refactor(app): simplify Console import and improve
 error handling

---
 src/App.js | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/src/App.js b/src/App.js
index bec89bb3..eaeb3e10 100644
--- a/src/App.js
+++ b/src/App.js
@@ -1,20 +1,20 @@
+import { Console } from "@woowacourse/mission-utils";
+import { add } from "./StringCalculator";
 class App {
   async run() {
+    Console.print("덧셈할 문자열을 입력해 주세요.");
+
     // 예외 처리
     try {
-      const { Console } = await import("@woowacourse/mission-utils");
-      Console.print("덧셈할 문자열을 입력해 주세요.");
-
       const input = await Console.readLineAsync();
-
       const result = add(input);
-
       Console.print(`결과 : ${result}`);
     } catch (error) {
-      const { Console } = await import("@woowacourse/mission-utils");
       const message =
         error?.message ?? "[ERROR] 알 수 없는 오류가 발생했습니다.";
       Console.print(message);
+
+      throw error;
     }
   }
 }

From 8bc9ca55770cfda639922d3990a0b6a7ea8a7d0d Mon Sep 17 00:00:00 2001
From: Youna Joo <you.na.joo0@gmail.com>
Date: Mon, 20 Oct 2025 23:05:04 +0900
Subject: [PATCH 13/14] fix(calculator): properly parse custom delimiters
 containing newline characters

---
 src/StringCalculator.js | 21 +++++++++++++++++----
 1 file changed, 17 insertions(+), 4 deletions(-)

diff --git a/src/StringCalculator.js b/src/StringCalculator.js
index 2f950c49..b1fa3406 100644
--- a/src/StringCalculator.js
+++ b/src/StringCalculator.js
@@ -6,7 +6,19 @@ function escapeRegexChar(ch) {
 
 function parseDelimiterAndBody(input) {
   if (input.startsWith("//")) {
-    const idx = input.indexOf("\n");
+    const realNewlineIdx = input.indexOf("\n");
+    const literalNewlineIdx = input.indexOf("\\n");
+
+    let idx = -1;
+    let useLiteral = false;
+
+    if (realNewlineIdx !== -1) {
+      idx = realNewlineIdx;
+    } else if (literalNewlineIdx !== -1) {
+      idx = literalNewlineIdx;
+      useLiteral = true;
+    }
+
     if (idx === -1) {
       throw new Error("[ERROR] 커스텀 구분자 뒤에 줄바꿈(\\n)이 필요합니다.");
     }
@@ -16,8 +28,11 @@ function parseDelimiterAndBody(input) {
         "[ERROR] 커스텀 구분자는 '//'와 '\\n' 사이의 문자 1개만 사용할 수 있습니다."
       );
     }
+
+    const body = useLiteral ? input.slice(idx + 2) : input.slice(idx + 1);
+
     // 커스텀 구분자가 존재할 때
-    return { delims: [delim], body: input.slice(idx + 1) };
+    return { delims: [delim], body };
   }
   // 커스텀 구분자가 없을 때
   return { delims: DEFAULT_DELIMS, body: input };
@@ -63,6 +78,4 @@ export function add(input) {
 
   // 합산
   return numbers.reduce((acc, n) => acc + n, 0);
-
-  r;
 }

From ee70eb3cb35524fac643509dffb5037b334806a1 Mon Sep 17 00:00:00 2001
From: Youna Joo <you.na.joo0@gmail.com>
Date: Mon, 20 Oct 2025 23:07:20 +0900
Subject: [PATCH 14/14] fix(app): fix console input error caused by missing
 prompt argument

---
 src/App.js | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

diff --git a/src/App.js b/src/App.js
index eaeb3e10..4aec972d 100644
--- a/src/App.js
+++ b/src/App.js
@@ -1,12 +1,10 @@
 import { Console } from "@woowacourse/mission-utils";
-import { add } from "./StringCalculator";
+import { add } from "./StringCalculator.js";
 class App {
   async run() {
     Console.print("덧셈할 문자열을 입력해 주세요.");
-
-    // 예외 처리
     try {
-      const input = await Console.readLineAsync();
+      const input = await Console.readLineAsync("");
       const result = add(input);
       Console.print(`결과 : ${result}`);
     } catch (error) {