Update document for v1.2.11

Author: mrjung72

CHANGELOG.md

@@ -1,5 +1,23 @@
 # SQL2Excel Version History
 
+## v1.2.11 - TOC Original Name & Sheet Name Length Warning (2025-10-29)
+
+### ✨ New/Changed
+- Sheet name length > 31 characters is now treated as a warning during validation (no failure)
+  - Warning also indicates that Excel may truncate the sheet name
+- Table of Contents (TOC) updated to include a new column: "Original Name"
+  - Shows the originally defined sheet name even if the actual tab was truncated
+  - Removed tooltip note; information is displayed as a dedicated column instead
+
+### 🔧 Code Changes
+- excel-cli.js: Validation now logs warnings for long names, not errors
+- excel-style-helper.js: TOC structure updated (add Original Name column, remove Note column)
+- index.js / excel-generator.js: Pass original sheet name through to TOC
+
+### 📝 Documentation
+- README/README_KR: Updated highlights to v1.2.11, described changes
+- CHANGELOG: Added v1.2.11 entry
+
 ## v1.2.10 - Non-interactive CLI & Docs (2025-10-29)
 
 ### ✨ New Features

CHANGELOG_KR.md

@@ -1,5 +1,23 @@
 # SQL2Excel 버전 히스토리
 
+## v1.2.11 - TOC 원본 시트명 컬럼 및 시트명 길이 경고 (2025-10-29)
+
+### ✨ 변경 사항
+- 시트명 길이 31자 초과 시 이제 검증에서 오류가 아닌 경고로 처리합니다.
+  - 경고 메시지에 엑셀에서 시트명이 잘릴 수 있음도 함께 안내합니다.
+- 목차(TOC)에 "Original Name" 컬럼 추가
+  - 엑셀 탭이 잘린 경우에도 원래 정의된 시트명을 별도 컬럼으로 표시
+  - 기존 Note(툴팁) 표시는 제거하고 컬럼으로 노출
+
+### 🔧 코드 변경
+- excel-cli.js: 시트명 길이 초과 시 에러 → 경고 출력
+- excel-style-helper.js: TOC 구조 변경 (Original Name 컬럼 추가, Note 컬럼 제거)
+- index.js / excel-generator.js: 원본 시트명을 TOC로 전달
+
+### 📝 문서
+- README/README_KR: v1.2.11 하이라이트 및 변경점 반영
+- CHANGELOG/CHANGELOG_KR: v1.2.11 항목 추가
+
 ## v1.2.10 - 비대화식 CLI 및 문서 업데이트 (2025-10-29)
 
 ### ✨ 새로운 기능

README.md

@@ -25,7 +25,12 @@ 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.10 Highlights
+## 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).
+
+### Previously in v1.2.10
 
 - **Non-interactive CLI**: Run tasks directly with `app.js --mode` (no menu)
   - Modes: `validate`, `test`, `export`, `help`

README_KR.md

@@ -25,7 +25,12 @@ SQL 쿼리 결과를 엑셀 파일로 생성하는 Node.js 기반 도구입니
 - 📋 **SQL 쿼리 포맷팅**: 목차에서 줄바꿈을 포함한 원본 SQL 포맷 유지
 - 🔧 **입력 유효성 검증**: 파일 경로 입력에 대한 자동 공백 제거
 
-## v1.2.10 하이라이트
+## v1.2.11 하이라이트
+
+- **검증 경고 변경**: 시트명이 31자를 초과해도 이제 오류가 아닌 경고로 처리합니다. 경고에는 엑셀에서 시트명이 잘릴 수 있다는 안내가 포함됩니다.
+- **목차(TOC) 업데이트**: "Original Name" 컬럼이 추가되어, 엑셀 탭명이 잘린 경우에도 원래 정의된 시트명을 별도 컬럼으로 확인할 수 있습니다.
+
+### 이전 버전(v1.2.10)
 
 - **비대화식 CLI**: 메뉴 없이 `app.js --mode`로 직접 실행
   - 모드: `validate`, `test`, `export`, `help`

USER_MANUAL.md

@@ -42,6 +42,11 @@ 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)
+
+- 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.
+
 ## 🛠️ Installation and Setup
 
 ### 1. System Requirements

USER_MANUAL_KR.md

@@ -42,6 +42,11 @@ SQL2Excel은 고급 스타일링, 템플릿 지원, 독립 실행 파일 배포
 - 📋 **SQL 쿼리 포맷팅**: 목차에서 줄바꿈을 포함한 원본 SQL 포맷 유지
 - 🔧 **입력 유효성 검증**: 파일 경로 입력에 대한 자동 공백 제거
 
+### What's New (v1.2.11)
+
+- 검증: 시트명이 31자를 초과해도 이제 오류가 아닌 경고로 처리합니다. 경고에는 엑셀에서 시트명이 잘릴 수 있다는 안내가 포함됩니다.
+- 목차(TOC): 원래 정의된 시트명을 표시하는 "Original Name" 컬럼이 추가되었습니다. 기존의 Note(툴팁) 표시는 제거되었으며, 정보는 컬럼으로 표시됩니다.
+
 ## 🛠️ 설치 및 설정
 
 ### 1. 시스템 요구사항

package.json

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