inputsource.ts

/**
 * 이번 이용에서 조건을 **무엇으로 채웠나.**
 *
 * ── 왜 따로 두나 ────────────────────────────────────────────────────────────
 *
 * 계약의 `interaction.preferredInput` 은 사용자가 어떤 방식으로 입력하는 사람인지를
 * 키오스크에 전하는 값이다. 여태 이 값을 `voiceGuide`(소리로 읽어 주기)에서 끌어
 * 왔는데, 그건 **읽어 주는 설정이지 입력 방식이 아니다.** 둘은 자주 어긋난다.
 *
 *   말로 채웠는데 읽어 주기를 껐다   → TOUCH 로 나갔다. 음성으로 넣었는데도.
 *   손으로 골랐는데 읽어 주기를 켰다  → VOICE 로 나갔다. 말한 적 없는데도.
 *
 * 키오스크는 이 값을 보고 안내 방식을 정한다. 틀린 값을 보내면 그쪽이 잘못된
 * 준비를 한다(#99 리뷰).
 *
 * ── 한 번 켜지면 그대로 둔다 ────────────────────────────────────────────────
 *
 * 말로 채운 뒤 손으로 몇 칸 고쳐도 VOICE 다. "이 사람은 말로 넣는 사람" 이라는
 * 사실은 몇 칸 고쳤다고 달라지지 않는다.
 *
 * ── 남기지 않는 것 ──────────────────────────────────────────────────────────
 *
 * 들은 말 자체는 어디에도 안 담는다. 여기 남는 것은 **무엇으로 채웠나** 하는
 * 사실 하나뿐이다(voice.ts 의 들은말 주석).
 */

let 말로채웠나 = false;
const 듣는이 = new Set<() => void>();

const 알리기 = () => { for (const f of 듣는이) f(); };

export const 입력출처 = {
  /** 이번 이용에서 말로 채운 적이 있나. */
  말로채운적있나: (): boolean => 말로채웠나,

  /** 말로 채웠다고 표시한다. 확인 화면에서 '이대로 채우기' 를 누른 뒤에 부른다. */
  말로채움(): void {
    if (말로채웠나) return;
    말로채웠나 = true;
    알리기();
  },

  /** 로그아웃·기기 지우기에서 부른다. 다음 사람에게 앞사람의 방식이 이어지면 안 된다. */
  비우기(): void {
    if (!말로채웠나) return;
    말로채웠나 = false;
    알리기();
  },

  /** 새로고침 뒤에 되돌린다. 되살리는 것은 알리지 않는다 — 그리는 중에 부르기 때문이다. */
  되살리기(v: boolean): void {
    말로채웠나 = v;
  },

  구독(f: () => void): () => void {
    듣는이.add(f);
    return () => { 듣는이.delete(f); };
  },
};