슬래시 하이라이트 인덱스 보정 분리

components/admin/AdminMarkdownEditor.vue

@@ -45,6 +45,7 @@ import {
 } from '../../lib/markdown-editor-media.js'
 import {
   addSlashSuppressedLine,
+  clampSlashHighlightedIndex,
   filterSlashCommands,
   getMediaPickerKindFromSlashAction,
   getSlashCommandFocusTarget,
@@ -2567,9 +2568,7 @@ watch(liveSlashQuery, () => {
 })
 
 watch(visibleLiveSlashCommands, (commands) => {
-  if (liveSlashHighlightedIndex.value >= commands.length) {
-    liveSlashHighlightedIndex.value = Math.max(0, commands.length - 1)
-  }
+  liveSlashHighlightedIndex.value = clampSlashHighlightedIndex(liveSlashHighlightedIndex.value, commands.length)
 
   updateLiveSlashMenuPosition()
 })

docs/map.md

@@ -60,7 +60,7 @@
 | lib/markdown-image.js | 이미지 마크다운 직렬화·파싱, 단독 이미지 URL 판별 |
 | lib/markdown-table.js | 공개 Markdown 표 행·구분선·정렬·블록 파싱 |
 | lib/markdown-toc.js | 공개 게시글 TOC용 H1~H3 제목 추출과 앵커 ID 생성 |
-| lib/markdown-slash-commands.js | 관리자 Markdown-first 에디터 슬래시 명령 목록과 삽입 줄 정의, 미디어 명령 action·모달 종류 판별, 슬래시 메뉴 제외 줄 Set 갱신, 미디어 명령 지연 commit 무시·슬래시 원문 줄 교체 삽입, 적용 후 포커스·textarea 선택 위치 계산 helper |
+| lib/markdown-slash-commands.js | 관리자 Markdown-first 에디터 슬래시 명령 목록과 삽입 줄 정의, 미디어 명령 action·모달 종류 판별, 슬래시 메뉴 제외 줄 Set·하이라이트 인덱스 갱신, 미디어 명령 지연 commit 무시·슬래시 원문 줄 교체 삽입, 적용 후 포커스·textarea 선택 위치 계산 helper |
 | lib/markdown-slash-menu-position.js | 관리자 Markdown-first 에디터 슬래시 메뉴 뷰포트 위치 보정 helper |
 | lib/markdown-slash-menu-scroll.js | 관리자 Markdown-first 에디터 슬래시 메뉴 선택 항목 표시용 scrollTop 계산 helper |
 | lib/markdown-inline.js | 공개·관리자 공통 인라인 마크다운 파서, 링크·굵게·기울임·인라인 코드·첨자·인라인 색상 토큰(`::color[텍스트]`) 변환, 링크·굵게·기울임·색상 내부 중첩 인라인 문법과 `<br>` 줄바꿈 처리, 라이브 멀티라인 본문의 기본 불릿/번호 목록 HTML 변환과 contenteditable 목록 마커 기준 커서 offset 계산·직렬화 |
@@ -123,7 +123,7 @@
 | tests/markdown-block-context.test.js | 관리자 블록 설정 패널의 활성 블록 컨텍스트 단위 회귀 테스트 |
 | tests/markdown-editor-history.test.js | 관리자 Markdown 에디터 undo/redo 히스토리 항목과 선택 범위 보정 단위 회귀 테스트 |
 | tests/markdown-editor-media.test.js | 관리자 Markdown 에디터 미디어 선택 helper의 종류·선택 가능 여부·미리보기·선택 상태·블록 생성 단위 회귀 테스트 |
-| tests/markdown-slash-commands.test.js | 관리자 슬래시 명령 파싱·미디어 action·모달 종류·제외 줄 Set 갱신·포커스 대상·textarea 선택 위치·원문 줄 교체 삽입 단위 회귀 테스트 |
+| tests/markdown-slash-commands.test.js | 관리자 슬래시 명령 파싱·미디어 action·모달 종류·제외 줄 Set 갱신·하이라이트 인덱스 보정·포커스 대상·textarea 선택 위치·원문 줄 교체 삽입 단위 회귀 테스트 |
 | tests/markdown-slash-menu-scroll.test.js | 관리자 슬래시 메뉴 선택 항목 scrollTop 보정 단위 테스트 |
 | tests/markdown-block-parser.test.js | 공개 Markdown 본문 블록 파싱 단위 회귀 테스트 |
 | tests/markdown-fenced-meta.test.js | Markdown fenced 블록 시작·종료 줄 탐색, 본문 수집, 메타 파싱 단위 회귀 테스트 |

docs/update.md

@@ -1,5 +1,10 @@
 # 업데이트 이력
 
+## v1.11.90
+
+- 관리자 Markdown 에디터의 슬래시 메뉴 하이라이트 인덱스 보정을 `markdown-slash-commands` helper로 분리.
+- 슬래시 메뉴 하이라이트 범위 보정 단위 테스트 추가.
+
 ## v1.11.89
 
 - 관리자 Markdown 에디터의 슬래시 메뉴 제외 줄 Set 갱신을 `markdown-slash-commands` helper로 분리.

lib/markdown-slash-commands.js

@@ -274,6 +274,23 @@ export const removeSlashSuppressedLine = (suppressedLines, line) => {
   return next
 }
 
+/**
+ * 슬래시 메뉴 하이라이트 인덱스를 명령 목록 범위 안으로 보정한다.
+ * @param {number} currentIndex - 현재 하이라이트 인덱스
+ * @param {number} commandCount - 표시 가능한 명령 개수
+ * @returns {number} 보정된 인덱스
+ */
+export const clampSlashHighlightedIndex = (currentIndex, commandCount) => {
+  const count = Math.max(0, Number.isFinite(commandCount) ? Math.floor(commandCount) : 0)
+  const index = Math.max(0, Number.isFinite(currentIndex) ? Math.floor(currentIndex) : 0)
+
+  if (count <= 0) {
+    return 0
+  }
+
+  return Math.min(index, count - 1)
+}
+
 /**
  * 라이브 모드 미디어 슬래시 명령 처리 중 지연 commit을 무시할지 확인한다.
  * @param {Object} options - 판별 옵션

package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "sori.studio",
-  "version": "1.11.89",
+  "version": "1.11.90",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "sori.studio",
-      "version": "1.11.89",
+      "version": "1.11.90",
       "hasInstallScript": true,
       "dependencies": {
         "@nuxtjs/tailwindcss": "^6.14.0",

package.json

@@ -1,6 +1,6 @@
 {
   "name": "sori.studio",
-  "version": "1.11.89",
+  "version": "1.11.90",
   "private": true,
   "type": "module",
   "imports": {

tests/markdown-slash-commands.test.js

@@ -2,6 +2,7 @@ import assert from 'node:assert/strict'
 import test from 'node:test'
 import {
   addSlashSuppressedLine,
+  clampSlashHighlightedIndex,
   getMediaPickerKindFromSlashAction,
   getSlashCommandFocusTarget,
   getSlashCommandTextareaSelection,
@@ -67,6 +68,14 @@ test('슬래시 제외 줄 Set은 유효하지 않은 줄 번호를 무시한다
   assert.deepEqual([...removeSlashSuppressedLine(new Set([1]), Number.NaN)], [1])
 })
 
+test('슬래시 메뉴 하이라이트 인덱스는 명령 목록 범위 안으로 보정한다', () => {
+  assert.equal(clampSlashHighlightedIndex(3, 5), 3)
+  assert.equal(clampSlashHighlightedIndex(7, 5), 4)
+  assert.equal(clampSlashHighlightedIndex(-2, 5), 0)
+  assert.equal(clampSlashHighlightedIndex(2, 0), 0)
+  assert.equal(clampSlashHighlightedIndex(Number.NaN, Number.NaN), 0)
+})
+
 test('슬래시 명령 줄에 미디어를 삽입할 때 원문 줄을 교체한다', () => {
   const markdown = [
     '첫 줄',