Update document for v1.3.2

mrjung72 · mrjung72 · commit c5978fbf2d13 · 2025-10-31T13:58:22.000+09:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,5 +1,30 @@
 # SQL2Excel Version History
 
+## v1.3.2 - CSV/TXT Formatting & Directory Naming (2025-10-31)
+
+### ✨ New/Changed
+- Per-sheet export directory naming simplified
+  - Directory is now `<output_basename>` (extension suffix removed)
+  - Example: `output="d:/temp/report.csv"` → directory `d:/temp/report/`
+- CSV/TXT field formatting changes
+  - Apply CSV quoting/escaping rules only when output extension is `.csv`
+  - For non-CSV (e.g., `.txt`, `.sql`, etc.), write plain values without quoting
+  - Internal newlines inside field values are normalized (\r/\n → space) for both CSV and TXT
+  - Record separators remain CRLF; headers still included
+  - Date values are serialized as `yyyy-MM-dd HH:mm:ss` (24-hour) in CSV/TXT and SQL literals
+
+### 🔧 Code Changes
+- `src/excel-generator.js`
+  - Add `isCsv` flag; branch value formatter per format
+  - `escapeCsv()` now normalizes internal newlines before quoting
+  - Introduce `toPlain()` with newline normalization for non-CSV
+  - Change per-sheet target directory from `<base>_<ext>` to `<base>`
+
+### 📝 Documentation
+- README/README_KR: Updated highlights and per-sheet export directory rules; noted CSV/TXT newline normalization and quoting scope
+- USER_MANUAL/USER_MANUAL_KR: Updated per-sheet export section to reflect new directory naming and formatting rules
+- CHANGELOG/CHANGELOG_KR: Added v1.3.2 entry
+
 ## v1.3.1 - Filename Variables and DATE Fixes (2025-10-30)
 
 ### ✨ New/Changed
diff --git a/CHANGELOG_KR.md b/CHANGELOG_KR.md
@@ -1,5 +1,30 @@
 # SQL2Excel 버전 히스토리
 
+## v1.3.2 - CSV/TXT 포맷팅 및 디렉토리 명명 변경 (2025-10-31)
+
+### ✨ 변경 사항
+- 시트별 내보내기 디렉토리 명명 단순화
+  - 디렉토리가 이제 `<출력파일베이스>`로 생성됩니다 (확장자 접미사 제거)
+  - 예: `output="d:/temp/report.csv"` → 디렉토리 `d:/temp/report/`
+- CSV/TXT 필드 포맷팅 변경
+  - CSV 인용/이스케이프 규칙은 출력 확장자가 `.csv`일 때만 적용
+  - 비-CSV(예: `.txt`, `.sql` 등)는 인용 없이 값 그대로 출력
+  - 필드 내부 줄바꿈(\r/\n)은 CSV/TXT 모두 공백으로 정규화
+  - 레코드 구분 개행은 CRLF 유지, 헤더는 계속 포함
+  - 날짜 값은 CSV/TXT 및 SQL 리터럴에서 `yyyy-MM-dd HH:mm:ss`(24시간) 형식으로 직렬화
+
+### 🔧 코드 변경
+- `src/excel-generator.js`
+  - `isCsv` 플래그 추가 및 포맷별 값 포매터 분기
+  - `escapeCsv()`에서 인용 전 내부 줄바꿈 정규화
+  - 비-CSV용 `toPlain()`에 내부 줄바꿈 정규화 추가
+  - 시트별 대상 디렉토리 `<base>_<ext>` → `<base>`로 변경
+
+### 📝 문서
+- README/README_KR: 시트별 디렉토리 규칙 및 CSV/TXT 줄바꿈 정규화, 인용 적용 범위 반영
+- USER_MANUAL/USER_MANUAL_KR: 시트별 내보내기 섹션에 디렉토리 명명 및 포맷팅 규칙 업데이트
+- CHANGELOG/CHANGELOG_KR: v1.3.2 항목 추가
+
 ## v1.3.1 - 파일명 변수 및 DATE 개선 (2025-10-30)
 
 ### ✨ 변경 사항
diff --git a/README.md b/README.md
@@ -26,6 +26,18 @@ A Node.js-based tool for generating Excel files from SQL query results.
 - 🔧 **Input Validation**: Automatic whitespace trimming for file path inputs
 - 🗂️ **Filename Variables**: Use `${DATE:...}`, `${DATE.TZ:...}`, and `${DB_NAME}` in `excel.output` (also supports custom `$(DB_NAME}`)
 
+## v1.3.2 Highlights
+
+- Per-sheet export directory naming simplified
+  - Directory is now `<output_basename>` (extension suffix removed)
+  - Example: `output="d:/temp/report.csv"` → directory `d:/temp/report/`
+- CSV/TXT field formatting changes
+  - Apply CSV quoting/escaping rules only for `.csv`
+  - Non-CSV (e.g., `.txt`, `.sql`) writes plain values without quoting
+  - Normalize internal newlines in fields (\r/\n → space) for both CSV and TXT
+  - Record separators remain CRLF; headers included
+  - Date values are serialized as `yyyy-MM-dd HH:mm:ss` (24-hour) in CSV/TXT and SQL literals
+
 ## v1.3.1 Highlights
 
 - Filename variables in output path
@@ -41,12 +53,14 @@ A Node.js-based tool for generating Excel files from SQL query results.
   - `.csv` → Generate per-sheet CSV files
   - All other extensions (e.g., `.txt`, `.log`, `.data`, `.sql`, etc.) → Generate per-sheet TXT files (tab-delimited)
 - **Directory and filename rules for per-sheet export**
-  - Output directory: `<output_basename>_<ext>` (no dot). Example: `output="d:/temp/report.csv"` → `d:/temp/report_csv/`
+  - Output directory (updated in v1.3.2): `<output_basename>`
+    - Example: `output="d:/temp/report.csv"` → `d:/temp/report/`
   - Each sheet becomes a separate file named after the sheet's `originalName`
   - No 31-character truncation for CSV/TXT (Excel-only limit). Filenames sanitized and capped at 100 chars
 - **Format defaults**
-  - CSV: comma, UTF-8 with BOM, headers, CRLF
-  - TXT: tab, UTF-8 with BOM, headers, CRLF
+  - CSV: comma, UTF-8 with BOM, headers, CRLF; quoting only for `.csv`; internal newlines normalized
+  - TXT: tab, UTF-8 with BOM, headers, CRLF; no quoting; internal newlines normalized
+  - Dates: `yyyy-MM-dd HH:mm:ss` (24-hour)
 
 ### Previously in v1.2.11
 
diff --git a/README_KR.md b/README_KR.md
@@ -26,6 +26,18 @@ SQL 쿼리 결과를 엑셀 파일로 생성하는 Node.js 기반 도구입니
 - 🔧 **입력 유효성 검증**: 파일 경로 입력에 대한 자동 공백 제거
 - 🗂️ **파일명 변수**: `excel.output`에서 `${DATE:...}`, `${DATE.TZ:...}`, `${DB_NAME}` 사용 가능 (커스텀 `$(DB_NAME}`도 지원)
 
+## v1.3.2 하이라이트
+
+- 시트별 내보내기 디렉토리 명명 단순화
+  - 디렉토리는 이제 `<출력파일베이스>` (확장자 접미사 제거)
+  - 예: `output="d:/temp/report.csv"` → 디렉토리 `d:/temp/report/`
+- CSV/TXT 필드 포맷팅 변경
+  - CSV 인용/이스케이프는 `.csv`일 때만 적용
+  - 비-CSV(예: `.txt`, `.sql`)는 인용 없이 그대로 기록
+  - 필드 내부 줄바꿈(\r/\n)은 CSV/TXT 모두 공백으로 정규화
+  - 레코드 구분 개행은 CRLF 유지, 헤더 포함
+  - 날짜 값은 CSV/TXT 및 SQL 리터럴에서 `yyyy-MM-dd HH:mm:ss`(24시간) 형식으로 직렬화
+
 ## v1.3.1 하이라이트
 
 - 출력 경로에서 파일명 변수 지원 강화
@@ -41,12 +53,14 @@ SQL 쿼리 결과를 엑셀 파일로 생성하는 Node.js 기반 도구입니
   - `.csv` → 시트별 CSV 파일 생성
   - 그 외 모든 확장자(예: `.txt`, `.log`, `.data`, `.sql` 등) → 시트별 TXT 파일 생성 (탭 구분)
 - **시트별 내보내기 디렉토리/파일명 규칙**
-  - 출력 디렉토리: `<출력파일베이스>_<확장자>` (점 제외). 예: `output="d:/temp/report.csv"` → `d:/temp/report_csv/`
+  - 출력 디렉토리( v1.3.2에서 업데이트): `<출력파일베이스>`
+    - 예: `output="d:/temp/report.csv"` → `d:/temp/report/`
   - 각 시트는 `originalName`(원본 시트명)으로 파일 생성
   - CSV/TXT는 31자 제한 없음(엑셀 전용 제한). 파일명은 안전화 및 최대 100자 제한
 - **포맷 기본값**
-  - CSV: 콤마, UTF-8 BOM, 헤더 포함, CRLF
-  - TXT: 탭, UTF-8 BOM, 헤더 포함, CRLF
+  - CSV: 콤마, UTF-8 BOM, 헤더, CRLF; 인용은 `.csv`에서만; 내부 줄바꿈 정규화
+  - TXT: 탭, UTF-8 BOM, 헤더, CRLF; 인용 없음; 내부 줄바꿈 정규화
+  - 날짜: `yyyy-MM-dd HH:mm:ss` (24시간)
 
 ### 이전 버전(v1.2.11)
 
diff --git a/USER_MANUAL.md b/USER_MANUAL.md
@@ -42,16 +42,18 @@ SQL2Excel is a powerful Node.js-based tool for generating Excel files from SQL q
 - 📋 **SQL Query Formatting**: Preserve original SQL formatting with line breaks in Table of Contents
 - 🔧 **Input Validation**: Automatic whitespace trimming for file path inputs
 
-### What's New (v1.3.0)
+### What's New (v1.3.2)
 
 - Per-sheet export routing by extension
   - `.xlsx` / `.xls` → Generate a single Excel workbook (existing behavior)
   - `.csv` → Generate per-sheet CSV files
   - All other extensions (e.g., `.txt`, `.log`, `.data`, `.sql`, etc.) → Generate per-sheet TXT files (tab-delimited)
 - Directory and filename rules (per-sheet export)
-  - Output directory: `<output_basename>_<ext>` (no dot). Example: `output="d:/temp/report.csv"` → `d:/temp/report_csv/`
+  - Output directory: `<output_basename>` (updated in v1.3.2). Example: `output="d:/temp/report.csv"` → `d:/temp/report/`
   - Each sheet becomes a separate file named after the sheet's `originalName`
   - No 31-character truncation for CSV/TXT (Excel-only limit). Filenames sanitized and capped at 100 chars
+  - CSV/TXT formatting: CSV quoting only for `.csv`; internal newlines normalized to space for both
+  - Date values are serialized as `yyyy-MM-dd HH:mm:ss` (24-hour) in CSV/TXT and SQL literals
 
 Previously in v1.2.11
 
@@ -130,8 +132,10 @@ Create `config/dbinfo.json` file:
   - `.csv` → Per-sheet CSV
   - Others → Per-sheet TXT (tab-delimited)
 - Output directory and filenames
-  - Files are written under `<output_basename>_<ext>` (no dot)
+  - Files are written under `<output_basename>` (updated in v1.3.2)
   - Each file name is the sheet `originalName` (sanitized, max 100 chars). No 31-char limit (Excel-only)
+  - CSV/TXT formatting: `.csv` applies CSV quoting/escaping; non-CSV writes plain values; internal newlines (\r/\n) normalized to spaces for both
+  - Dates: `yyyy-MM-dd HH:mm:ss` (24-hour)
 
 ## 🚀 Basic Usage
 
diff --git a/USER_MANUAL_KR.md b/USER_MANUAL_KR.md
@@ -42,16 +42,19 @@ SQL2Excel은 고급 스타일링, 템플릿 지원, 독립 실행 파일 배포
 - 📋 **SQL 쿼리 포맷팅**: 목차에서 줄바꿈을 포함한 원본 SQL 포맷 유지
 - 🔧 **입력 유효성 검증**: 파일 경로 입력에 대한 자동 공백 제거
 
-### What's New (v1.3.0)
+### What's New (v1.3.2)
 
-- 확장자 기반 시트별 내보내기 라우팅
+- 확장자 기반 시트별 내보내기 라우팅(유지)
   - `.xlsx` / `.xls` → 단일 엑셀 통합문서 생성 (기존 동작)
   - `.csv` → 시트별 CSV 파일 생성
   - 그 외 모든 확장자(예: `.txt`, `.log`, `.data`, `.sql` 등) → 시트별 TXT 파일 생성 (탭 구분)
-- 디렉토리/파일명 규칙 (시트별 내보내기)
-  - 출력 디렉토리: `<출력파일베이스>_<확장자>` (점 제외). 예: `output="d:/temp/report.csv"` → `d:/temp/report_csv/`
-  - 각 시트는 `originalName`(원본 시트명)으로 파일 생성
-  - CSV/TXT에는 31자 제한 없음(엑셀 전용 제한). 파일명은 안전화 및 최대 100자 제한
+- 디렉토리/파일명 및 포맷팅 규칙 (시트별 내보내기)
+  - 출력 디렉토리: `<출력파일베이스>`로 단순화 (확장자 접미사 제거)
+    - 예: `output="d:/temp/report.csv"` → `d:/temp/report/`
+  - 각 시트는 `originalName`(원본 시트명)으로 파일 생성 (파일시스템 안전화, 최대 100자)
+  - CSV 인용/이스케이프는 `.csv`일 때만 적용, 비-CSV는 인용 없이 기록
+  - CSV/TXT 모두 필드 내부 줄바꿈(\r/\n)을 공백으로 정규화
+  - 날짜 값은 CSV/TXT 및 SQL 리터럴에서 `yyyy-MM-dd HH:mm:ss`(24시간) 형식으로 직렬화
 
 이전 버전(v1.2.11)
 
@@ -385,8 +388,11 @@ sql2excel.exe --mode=help
   - `.csv` → 시트별 CSV
   - 그 외 → 시트별 TXT (탭 구분)
 - 출력 디렉토리 및 파일명
-  - 출력은 `<출력파일베이스>_<확장자>` (점 제외) 하위에 생성
+  - 출력은 `<출력파일베이스>` 하위에 생성 (v1.3.2 변경)
   - 파일명은 시트 `originalName` 사용 (파일시스템 안전화, 최대 100자). 31자 제한 없음(엑셀 전용)
+  - 포맷팅: `.csv`는 CSV 인용/이스케이프 적용, 비-CSV는 인용 없음
+  - 내부 줄바꿈(\r/\n)은 CSV/TXT 모두 공백으로 정규화
+  - 날짜 직렬화: `yyyy-MM-dd HH:mm:ss` (24시간)
 
 ## 🎨 템플릿 스타일 시스템
 
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "sql2excel",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "SQL 쿼리 결과를 엑셀 파일로 저장하는 도구 (시트별 쿼리, 변수, XML/JSON 지원)",
   "main": "app.js",
   "scripts": {

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "sql2excel",`
`3`		`- "version": "1.3.1",`
	`3`	`+ "version": "1.3.2",`
`4`	`4`	`"description": "SQL 쿼리 결과를 엑셀 파일로 저장하는 도구 (시트별 쿼리, 변수, XML/JSON 지원)",`
`5`	`5`	`"main": "app.js",`
`6`	`6`	`"scripts": {`