From e7937c877f46ef685446a912e2d75dee53971558 Mon Sep 17 00:00:00 2001 From: Yun Chan Date: Wed, 21 Oct 2026 11:35:14 +0900 Subject: [PATCH] fix(recording-tip): show "inserted" only after the text was actually inserted The tip drew its done state on session-completed, before the async insert ran and even when auto-insert was off or the text was empty. A failed insert also left the screen-saver-level tip over the result popup's copy button. session-completed now says whether an insert follows, VoiceModeService emits text-inserted on success, and the tip hides first when the insert fails. --- apps/desktop/src/main/bootstrap.ts | 5 ++- .../src/main/services/VoiceModeService.ts | 14 +++++- .../main/windows/recording-tip-presenter.ts | 44 ++++++++++++++++--- .../services/voice-mode-redteam-r1-3.test.ts | 15 +++++++ .../windows/recording-tip-presenter.test.ts | 38 ++++++++++++++-- 5 files changed, 104 insertions(+), 12 deletions(-) diff --git a/apps/desktop/src/main/bootstrap.ts b/apps/desktop/src/main/bootstrap.ts index 289bb49..113883f 100644 --- a/apps/desktop/src/main/bootstrap.ts +++ b/apps/desktop/src/main/bootstrap.ts @@ -476,6 +476,7 @@ async function initVoiceMode(): Promise { voiceMode.on('audio-level', ({ level }) => tip.onAudioLevel(level)) voiceMode.on('partial-transcript', ({ text }) => tip.onPartialTranscript(text)) voiceMode.on('insert-failed', ({ text }) => tip.onInsertFailed(text)) + voiceMode.on('text-inserted', () => tip.onTextInserted()) // 수정자 없는 Esc 로 진행 중인 받아쓰기(녹음·처리)를 취소한다. 녹음 팁은 포커스를 받지 않는 창이라 // 전역 keydown 을 직접 듣는다(제안 오버레이의 Esc 와 같은 방식). 세션이 없으면 아무 일도 하지 않는다. @@ -494,8 +495,8 @@ async function initVoiceMode(): Promise { soundEffect.play('recording-start') }) - voiceMode.on('session-completed', ({ session, finalText, audioPath }) => { - tip.onSessionCompleted() + voiceMode.on('session-completed', ({ session, finalText, audioPath, willInsert }) => { + tip.onSessionCompleted(willInsert) soundEffect.play('recording-stop') // 녹음은 완료 이벤트 전에 저장됐다 — 실제 저장 경로(없으면 null)만 히스토리에 남긴다. diff --git a/apps/desktop/src/main/services/VoiceModeService.ts b/apps/desktop/src/main/services/VoiceModeService.ts index bfadc7f..439727e 100644 --- a/apps/desktop/src/main/services/VoiceModeService.ts +++ b/apps/desktop/src/main/services/VoiceModeService.ts @@ -84,7 +84,15 @@ export interface VoiceModeEvents { }) => void 'transcription-update': (payload: { text: string; isFinal: boolean }) => void /** audioPath: 저장된 녹음 WAV 경로(완료 이벤트 전에 저장됨). 오디오가 없거나 저장 실패면 null */ - 'session-completed': (payload: { session: VoiceSession; finalText: string; audioPath: string | null }) => void + /** willInsert: 이어서 자동 입력을 시도하는지(자동 입력 꺼짐·빈 글이면 false) */ + 'session-completed': (payload: { + session: VoiceSession + finalText: string + audioPath: string | null + willInsert: boolean + }) => void + /** 완료된 세션의 글을 자동 입력했다 */ + 'text-inserted': (payload: { sessionId: string }) => void 'session-cancelled': (payload: { session: VoiceSession reason: 'user' | 'timeout' | 'too-short' @@ -1122,7 +1130,8 @@ class VoiceModeService extends EventEmitter { // Speakly 패턴: 먼저 IDLE 복귀 (다음 핫키 즉시 사용 가능). 표시 계층이 완료 이벤트로 팁을 숨긴다. this._setRecognitionState(RecognitionState.COMPLETED) this._setAudioState(AudioState.STOPPED) - this.emit('session-completed', { session, finalText, audioPath }) + const willInsert = Boolean(configGet('autoInsert')) && finalText.length > 0 + this.emit('session-completed', { session, finalText, audioPath, willInsert }) this._endRun(run) // 텍스트 삽입은 세션과 무관하게 비동기 실행 (세션 블로킹 방지) @@ -1140,6 +1149,7 @@ class VoiceModeService extends EventEmitter { if (selectionCapture) await selectionCapture const insertMethod = configGet('insertMethod') await getTextInsertService().insertText(finalText, insertMethod) + this.emit('text-inserted', { sessionId }) } catch (error) { logger.warn(`Text insert failed: ${describe(error)}`) // 삽입 실패 시 표시 계층이 ResultPopup에 텍스트를 보여 준다 diff --git a/apps/desktop/src/main/windows/recording-tip-presenter.ts b/apps/desktop/src/main/windows/recording-tip-presenter.ts index b886cf6..d8941e8 100644 --- a/apps/desktop/src/main/windows/recording-tip-presenter.ts +++ b/apps/desktop/src/main/windows/recording-tip-presenter.ts @@ -49,6 +49,8 @@ export interface RecordingTipPresenterOptions { resultPopupMs?: number /** 완료 확인 표시 후 팁을 숨기기까지(ms). 기본 700 */ doneHideMs?: number + /** 완료 뒤 삽입 결과(성공·실패)를 기다리는 최대 시간 */ + insertResultTimeoutMs?: number timers?: RecordingTipTimers } @@ -57,6 +59,9 @@ export type RecordingTipSeverity = 'error' | 'warning' export class RecordingTipPresenter { private _hideTimer: ReturnType | null = null + /** 완료 뒤 삽입 결과를 기다리는 중 — "입력함"은 실제로 넣은 뒤에만 보인다 */ + private _awaitingInsert = false + private readonly _insertResultTimeoutMs: number private readonly _errorHideMs: number private readonly _resultPopupMs: number private readonly _doneHideMs: number @@ -69,6 +74,7 @@ export class RecordingTipPresenter { this._errorHideMs = options.errorHideMs ?? 3000 this._resultPopupMs = options.resultPopupMs ?? 10000 this._doneHideMs = options.doneHideMs ?? 700 + this._insertResultTimeoutMs = options.insertResultTimeoutMs ?? 5000 this._timers = options.timers ?? { setTimeout: (fn, ms) => setTimeout(fn, ms), clearTimeout: (handle) => clearTimeout(handle), @@ -78,6 +84,7 @@ export class RecordingTipPresenter { /** 새 세션이 시작되면 이전 에러의 숨김 예약을 취소한다 (새 팁을 숨기지 않게) */ onSessionStarted(): void { this._cancelHide() + this._awaitingInsert = false } onPhase(phase: RecordingTipPhase): void { @@ -122,19 +129,46 @@ export class RecordingTipPresenter { * 세션 완료 — "입력함"을 잠깐 보이고 숨긴다. 이전에는 즉시 사라져 성공했는지 알 수 없었다(2026-09-28). * 숨김 예약은 오류와 같은 핸들 하나 — 곧바로 새 세션이 시작되면 onSessionStarted 가 취소한다. */ - onSessionCompleted(): void { + onSessionCompleted(willInsert: boolean): void { + this._cancelHide() + // 자동 입력이 꺼졌거나 넣을 글이 없으면 아무것도 입력하지 않았다 — "입력함"을 보이지 않는다. + if (!willInsert) { + this._awaitingInsert = false + this._view.hide() + return + } + // 삽입은 완료 뒤 비동기로 끝난다. 결과가 오지 않으면(예외 경로) 잠시 뒤 숨긴다. + this._awaitingInsert = true + this._scheduleHide(this._insertResultTimeoutMs) + } + + /** 자동 입력 성공 — 이제 "입력함"을 잠깐 보이고 숨긴다 */ + onTextInserted(): void { + if (!this._awaitingInsert) return + this._awaitingInsert = false this._cancelHide() this._view.showDone() - this._hideTimer = this._timers.setTimeout(() => { - this._hideTimer = null - this._view.hide() - }, this._doneHideMs) + this._scheduleHide(this._doneHideMs) } onInsertFailed(text: string): void { + // 팁은 결과 팝업보다 위 레벨이라 같은 자리에 남으면 복사 버튼을 덮는다 — 먼저 내린다. + if (this._awaitingInsert) { + this._awaitingInsert = false + this._cancelHide() + this._view.hide() + } this._view.showResult(text, this._resultPopupMs) } + private _scheduleHide(ms: number): void { + this._hideTimer = this._timers.setTimeout(() => { + this._hideTimer = null + this._awaitingInsert = false + this._view.hide() + }, ms) + } + dispose(): void { this._cancelHide() } diff --git a/apps/desktop/tests/main/services/voice-mode-redteam-r1-3.test.ts b/apps/desktop/tests/main/services/voice-mode-redteam-r1-3.test.ts index fda12aa..e76dbee 100644 --- a/apps/desktop/tests/main/services/voice-mode-redteam-r1-3.test.ts +++ b/apps/desktop/tests/main/services/voice-mode-redteam-r1-3.test.ts @@ -353,6 +353,21 @@ describe('표시 이벤트', () => { expect(phases).toEqual(['recording', 'thinking']) }) + it('자동 삽입이 끝나면 text-inserted 를 내보낸다(완료 이벤트는 willInsert 로 예고한다)', async () => { + const svc = getVoiceModeService() + const inserted: string[] = [] + const willInsert: boolean[] = [] + svc.on('session-completed', (p) => willInsert.push(p.willInsert)) + svc.on('text-inserted', ({ sessionId }) => inserted.push(sessionId)) + + await svc.startSession('dictation') + audioBus.emit('audio-data', { buffer: SPEECH }) + advanceClock(1000) + await svc.stopSession() + await vi.waitFor(() => expect(inserted).toHaveLength(1)) + expect(willInsert).toEqual([true]) + }) + it('자동 삽입이 실패하면 insert-failed 를 내보낸다', async () => { mockInsert.insertText.mockRejectedValueOnce(new Error('clipboard busy')) const svc = getVoiceModeService() diff --git a/apps/desktop/tests/main/windows/recording-tip-presenter.test.ts b/apps/desktop/tests/main/windows/recording-tip-presenter.test.ts index fe2a25b..347595f 100644 --- a/apps/desktop/tests/main/windows/recording-tip-presenter.test.ts +++ b/apps/desktop/tests/main/windows/recording-tip-presenter.test.ts @@ -93,11 +93,13 @@ describe('RecordingTipPresenter', () => { expect(view.calls).toEqual(['error:x']) }) - it('완료는 "입력함"을 잠깐 보이고 숨기며, 곧바로 시작한 새 세션의 팁은 숨기지 않는다', () => { + it('입력에 성공하면 "입력함"을 잠깐 보이고 숨기며, 곧바로 시작한 새 세션의 팁은 숨기지 않는다', () => { const view = fakeView() const presenter = new RecordingTipPresenter(view) presenter.onPhase('recording') - presenter.onSessionCompleted() + presenter.onSessionCompleted(true) + expect(view.calls).toEqual(['show']) + presenter.onTextInserted() vi.advanceTimersByTime(699) expect(view.calls).toEqual(['show', 'done']) vi.advanceTimersByTime(1) @@ -105,11 +107,41 @@ describe('RecordingTipPresenter', () => { const view2 = fakeView() const presenter2 = new RecordingTipPresenter(view2) - presenter2.onSessionCompleted() + presenter2.onSessionCompleted(true) + presenter2.onTextInserted() vi.advanceTimersByTime(300) presenter2.onSessionStarted() presenter2.onPhase('recording') vi.advanceTimersByTime(2000) expect(view2.calls).toEqual(['done', 'show']) }) + + it('자동 입력을 하지 않는 완료는 "입력함" 없이 숨긴다', () => { + const view = fakeView() + const presenter = new RecordingTipPresenter(view) + presenter.onPhase('recording') + presenter.onSessionCompleted(false) + presenter.onTextInserted() + expect(view.calls).toEqual(['show', 'hide']) + }) + + it('입력이 실패하면 "입력함" 없이 팁을 내리고 결과 팝업을 띄운다', () => { + const view = fakeView() + const presenter = new RecordingTipPresenter(view) + presenter.onPhase('recording') + presenter.onSessionCompleted(true) + presenter.onInsertFailed('text') + vi.advanceTimersByTime(10000) + expect(view.calls).toEqual(['show', 'hide', 'result:text:10000']) + }) + + it('입력 결과가 오지 않으면 잠시 뒤 숨기고, 늦게 온 성공은 무시한다', () => { + const view = fakeView() + const presenter = new RecordingTipPresenter(view) + presenter.onPhase('recording') + presenter.onSessionCompleted(true) + vi.advanceTimersByTime(5000) + presenter.onTextInserted() + expect(view.calls).toEqual(['show', 'hide']) + }) })