[문자열 덧셈 계산기] 주유나 미션 제출합니다.

README.md

@@ -1 +1,70 @@
-# javascript-calculator-precourse
+# 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()` 호출 없이 자연스럽게 종료

src/App.js

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

src/StringCalculator.js

@@ -0,0 +1,81 @@
+const DEFAULT_DELIMS = [",", ":"];
+
+function escapeRegexChar(ch) {
+  return ch.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+
+function parseDelimiterAndBody(input) {
+  if (input.startsWith("//")) {
+    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)이 필요합니다.");
+    }
+    const delim = input.slice(2, idx);
+    if (!delim || delim.length !== 1) {
+      throw new Error(
+        "[ERROR] 커스텀 구분자는 '//'와 '\\n' 사이의 문자 1개만 사용할 수 있습니다."
+      );
+    }
+
+    const body = useLiteral ? input.slice(idx + 2) : input.slice(idx + 1);
+
+    // 커스텀 구분자가 존재할 때
+    return { delims: [delim], body };
+  }
+  // 커스텀 구분자가 없을 때
+  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());
+
+  // 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;
+
+  const { delims, body } = parseDelimiterAndBody(trimmed);
+
+  const tokens = splitTokens(body, delims);
+
+  const numbers = toPositiveIntegers(tokens);
+
+  // 합산
+  return numbers.reduce((acc, n) => acc + n, 0);
+}

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;
+  };
+}