Update document for v1.3.0

Author: mrjung72

CHANGELOG.md

@@ -1,5 +1,32 @@
 # SQL2Excel Version History
 
+## v1.3.0 - Per-sheet Export for CSV/TXT and Routing Rules (2025-10-29)
+
+### ✨ New/Changed
+- Export routing based on output 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)
+- Output directory naming
+  - If per-sheet export is used, files are written under `<output_basename>_<ext>` (no dot)
+  - Example: `output="d:/temp/report.csv"` → directory `d:/temp/report_csv/`
+- Per-file naming
+  - Each sheet becomes a separate file named after the sheet's original name (`originalName`) with filesystem sanitization
+  - No 31-character truncation applies to CSV/TXT outputs (Excel-only limit)
+  - Max filename length capped at 100 characters; invalid characters replaced with `_`
+- Data formats
+  - CSV: comma-delimited, UTF-8 with BOM, headers included, CRLF line endings
+  - TXT: tab-delimited, UTF-8 with BOM, headers included, CRLF line endings
+
+### 🔧 Code Changes
+- index.js: Route by extension; only `.xlsx`/`.xls` use workbook generation; `.csv` uses per-sheet CSV; others per-sheet TXT
+- excel-generator.js: Implement per-sheet writer, directory naming `<basename>_<ext>`, filename from `originalName`, formatting defaults
+
+### 📝 Documentation
+- README/README_KR: Updated highlights to v1.3.0 with per-sheet export rules and examples
+- USER_MANUAL/USER_MANUAL_KR: Added section describing routing, directory/filename rules, and defaults
+- CHANGELOG/CHANGELOG_KR: Added v1.3.0 entry
+
 ## v1.2.11 - TOC Original Name & Sheet Name Length Warning (2025-10-29)
 
 ### ✨ New/Changed

CHANGELOG_KR.md

@@ -1,5 +1,32 @@
 # SQL2Excel 버전 히스토리
 
+## v1.3.0 - CSV/TXT 시트별 내보내기 및 라우팅 규칙 (2025-10-29)
+
+### ✨ 변경 사항
+- 출력 확장자에 따른 라우팅
+  - `.xlsx` / `.xls` → 단일 엑셀 통합문서 생성 (기존 동작)
+  - `.csv` → 시트별 CSV 파일 생성
+  - 그 외 모든 확장자(예: `.txt`, `.log`, `.data`, `.sql` 등) → 시트별 TXT 파일 생성 (탭 구분)
+- 출력 디렉토리 명명 규칙
+  - 시트별 내보내기 시 `<출력파일베이스>_<확장자>` (점 제외) 디렉토리 하위에 파일 생성
+  - 예: `output="d:/temp/report.csv"` → 디렉토리 `d:/temp/report_csv/`
+- 개별 파일명 규칙
+  - 각 시트는 원본 시트명(`originalName`)을 파일명으로 사용 (파일시스템 안전화 적용)
+  - CSV/TXT 출력에는 31자 제한(엑셀 전용 제한) 미적용
+  - 파일명 최대 100자, 금지 문자는 `_`로 치환
+- 데이터 형식 기본값
+  - CSV: 콤마 구분, UTF-8 BOM, 헤더 포함, CRLF 줄바꿈
+  - TXT: 탭 구분, UTF-8 BOM, 헤더 포함, CRLF 줄바꿈
+
+### 🔧 코드 변경
+- index.js: 확장자 기반 라우팅 — `.xlsx`/`.xls`만 통합문서 생성, `.csv`는 시트별 CSV, 기타는 시트별 TXT
+- excel-generator.js: 시트별 파일 작성 로직 추가, 디렉토리/파일명 규칙 반영, 출력 포맷 기본값 적용
+
+### 📝 문서
+- README/README_KR: v1.3.0 하이라이트 및 시트별 내보내기 규칙/예시 반영
+- USER_MANUAL/USER_MANUAL_KR: 라우팅, 디렉토리/파일명 규칙, 기본값 섹션 추가
+- CHANGELOG/CHANGELOG_KR: v1.3.0 항목 추가
+
 ## v1.2.11 - TOC 원본 시트명 컬럼 및 시트명 길이 경고 (2025-10-29)
 
 ### ✨ 변경 사항

README.md

@@ -25,10 +25,24 @@ A Node.js-based tool for generating Excel files from SQL query results.
 - 📋 **SQL Query Formatting**: Preserve original SQL formatting with line breaks in Table of Contents
 - 🔧 **Input Validation**: Automatic whitespace trimming for file path inputs
 
-## v1.2.11 Highlights
-
-- **Validation Warning Change**: Sheet names longer than 31 characters now produce a warning (not an error). The warning also notes that Excel may truncate the sheet name.
-- **TOC Update**: The Table of Contents now includes an "Original Name" column to display the originally defined sheet name (useful when the tab name is truncated by Excel).
+## v1.3.0 Highlights
+
+- **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 for per-sheet export**
+  - Output directory: `<output_basename>_<ext>` (no dot). Example: `output="d:/temp/report.csv"` → `d:/temp/report_csv/`
+  - 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
+
+### Previously in v1.2.11
+
+- Validation warning for sheet names > 31 chars; note about Excel truncation
+- TOC: Added "Original Name" column; removed note tooltip
 
 ### Previously in v1.2.10
 

README_KR.md

@@ -25,10 +25,24 @@ SQL 쿼리 결과를 엑셀 파일로 생성하는 Node.js 기반 도구입니
 - 📋 **SQL 쿼리 포맷팅**: 목차에서 줄바꿈을 포함한 원본 SQL 포맷 유지
 - 🔧 **입력 유효성 검증**: 파일 경로 입력에 대한 자동 공백 제거
 
-## v1.2.11 하이라이트
-
-- **검증 경고 변경**: 시트명이 31자를 초과해도 이제 오류가 아닌 경고로 처리합니다. 경고에는 엑셀에서 시트명이 잘릴 수 있다는 안내가 포함됩니다.
-- **목차(TOC) 업데이트**: "Original Name" 컬럼이 추가되어, 엑셀 탭명이 잘린 경우에도 원래 정의된 시트명을 별도 컬럼으로 확인할 수 있습니다.
+## v1.3.0 하이라이트
+
+- **확장자 기반 시트별 내보내기 라우팅**
+  - `.xlsx` / `.xls` → 단일 엑셀 통합문서 생성 (기존 동작)
+  - `.csv` → 시트별 CSV 파일 생성
+  - 그 외 모든 확장자(예: `.txt`, `.log`, `.data`, `.sql` 등) → 시트별 TXT 파일 생성 (탭 구분)
+- **시트별 내보내기 디렉토리/파일명 규칙**
+  - 출력 디렉토리: `<출력파일베이스>_<확장자>` (점 제외). 예: `output="d:/temp/report.csv"` → `d:/temp/report_csv/`
+  - 각 시트는 `originalName`(원본 시트명)으로 파일 생성
+  - CSV/TXT는 31자 제한 없음(엑셀 전용 제한). 파일명은 안전화 및 최대 100자 제한
+- **포맷 기본값**
+  - CSV: 콤마, UTF-8 BOM, 헤더 포함, CRLF
+  - TXT: 탭, UTF-8 BOM, 헤더 포함, CRLF
+
+### 이전 버전(v1.2.11)
+
+- 시트명 31자 초과 경고 처리 및 엑셀에서 잘릴 수 있음 안내
+- TOC: "Original Name" 컬럼 추가, Note(툴팁) 제거
 
 ### 이전 버전(v1.2.10)
 

USER_MANUAL.md

@@ -42,10 +42,21 @@ 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.2.11)
+### What's New (v1.3.0)
 
-- Validation: Sheet names longer than 31 characters now trigger a warning (no failure). The warning also notes that Excel may truncate the sheet name.
-- TOC: Added an "Original Name" column to display the originally defined sheet name. Removed tooltip note; information is shown in the column.
+- 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/`
+  - 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
+
+Previously in v1.2.11
+
+- Validation warning for sheet names > 31 chars; note about Excel truncation
+- TOC: Added "Original Name" column; removed note tooltip
 
 ## 🛠️ Installation and Setup
 
@@ -112,6 +123,16 @@ Create `config/dbinfo.json` file:
 }
 ```
 
+### Per-sheet export (CSV/TXT)
+
+- Routing by `excel.output` extension
+  - `.xlsx`/`.xls` → Single Excel workbook
+  - `.csv` → Per-sheet CSV
+  - Others → Per-sheet TXT (tab-delimited)
+- Output directory and filenames
+  - Files are written under `<output_basename>_<ext>` (no dot)
+  - Each file name is the sheet `originalName` (sanitized, max 100 chars). No 31-char limit (Excel-only)
+
 ## 🚀 Basic Usage
 
 ### Language Settings

USER_MANUAL_KR.md

@@ -42,10 +42,21 @@ SQL2Excel은 고급 스타일링, 템플릿 지원, 독립 실행 파일 배포
 - 📋 **SQL 쿼리 포맷팅**: 목차에서 줄바꿈을 포함한 원본 SQL 포맷 유지
 - 🔧 **입력 유효성 검증**: 파일 경로 입력에 대한 자동 공백 제거
 
-### What's New (v1.2.11)
+### What's New (v1.3.0)
 
-- 검증: 시트명이 31자를 초과해도 이제 오류가 아닌 경고로 처리합니다. 경고에는 엑셀에서 시트명이 잘릴 수 있다는 안내가 포함됩니다.
-- 목차(TOC): 원래 정의된 시트명을 표시하는 "Original Name" 컬럼이 추가되었습니다. 기존의 Note(툴팁) 표시는 제거되었으며, 정보는 컬럼으로 표시됩니다.
+- 확장자 기반 시트별 내보내기 라우팅
+  - `.xlsx` / `.xls` → 단일 엑셀 통합문서 생성 (기존 동작)
+  - `.csv` → 시트별 CSV 파일 생성
+  - 그 외 모든 확장자(예: `.txt`, `.log`, `.data`, `.sql` 등) → 시트별 TXT 파일 생성 (탭 구분)
+- 디렉토리/파일명 규칙 (시트별 내보내기)
+  - 출력 디렉토리: `<출력파일베이스>_<확장자>` (점 제외). 예: `output="d:/temp/report.csv"` → `d:/temp/report_csv/`
+  - 각 시트는 `originalName`(원본 시트명)으로 파일 생성
+  - CSV/TXT에는 31자 제한 없음(엑셀 전용 제한). 파일명은 안전화 및 최대 100자 제한
+
+이전 버전(v1.2.11)
+
+- 시트명 31자 초과 경고 처리 및 엑셀에서 잘릴 수 있음 안내
+- TOC: "Original Name" 컬럼 추가, Note(툴팁) 제거
 
 ## 🛠️ 설치 및 설정
 
@@ -367,6 +378,16 @@ sql2excel.exe --mode=help
 }
 ```
 
+### 시트별 내보내기 (CSV/TXT)
+
+- `excel.output` 확장자에 따른 라우팅
+  - `.xlsx`/`.xls` → 단일 엑셀 통합문서
+  - `.csv` → 시트별 CSV
+  - 그 외 → 시트별 TXT (탭 구분)
+- 출력 디렉토리 및 파일명
+  - 출력은 `<출력파일베이스>_<확장자>` (점 제외) 하위에 생성
+  - 파일명은 시트 `originalName` 사용 (파일시스템 안전화, 최대 100자). 31자 제한 없음(엑셀 전용)
+
 ## 🎨 템플릿 스타일 시스템
 
 SQL2Excel은 사전 정의된 엑셀 스타일링 템플릿을 포함한 포괄적인 템플릿 스타일 시스템을 제공합니다.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "sql2excel",
-  "version": "1.2.11",
+  "version": "1.3.0",
   "description": "SQL 쿼리 결과를 엑셀 파일로 저장하는 도구 (시트별 쿼리, 변수, XML/JSON 지원)",
   "main": "app.js",
   "scripts": {