@ihabdevteam/core 0.141.0 → 0.142.0

package/dist/ihabdevteam-core.d.ts

@@ -1376,7 +1376,7 @@ export declare function copyText(text: string): Promise<boolean>;
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.141.0";
+export declare const CORE_VERSION = "0.142.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -2206,7 +2206,7 @@ export declare function formatDateLongLocale(iso: string, lang: string): string;
 export declare function formatDatetimeKo(iso: string): string;
 
 /**
- * 초 → "M분 S초"(또는 "M분"·"S초"). 없거나 0 이하면 '-'.
+ * 초 → "M분 S초"(또는 "M분"·"S초"). 초 단위로 반올림한 뒤 나눈다 — 없거나(숫자가 아님) 반올림해 0 이하(0.5초 미만 포함)면 '-'.
  *
  * 문구는 지금 언어로(`customers.duration.*`, 사전에 없으면 한국어). `durationStr` 를 주면
  * 그 함수가 만든 글을 그대로 쓴다 — `calcAge` 의 `ageStr` 와 같은 결.
@@ -3807,13 +3807,13 @@ export declare interface PaymentPlanTier {
     highlight?: boolean;
     /**
      * 할인 배지에 '오픈 특가'를 함께 얹는다 — **표시 전용**.
-     * 계정당 1회 제한은 라벨의 '오픈 특가' 문자열로 판정하므로, 이 플래그만으로는
+     * 계정당 1회 제한은 `onceOnly`(없으면 라벨의 '오픈 특가' 문자열)로 판정하므로, 이 플래그만으로는
      * 구매 횟수가 제한되지 않는다(같은 프로모션이되 1회 제한 대상은 아닌 tier용).
      */
     openPromo?: boolean;
     /**
      * **계정당 1회만 살 수 있는 tier**(오픈 특가 30일 등). 이미 산 것(`ownedCodes`)이면 숨기고 기본 tier 를 카드로 올린다.
-     * 안 주면 예전처럼 라벨에 '오픈 특가' 가 있는지로 판정한다 — 그런데 라벨은 번역되므로 영어 화면에서는 판정이 실패해
+     * 안 주면 라벨에 '오픈 특가' 가 있는지로 판정한다 — 그런데 라벨은 번역되므로 영어 화면에서는 판정이 실패해
      * 이미 산 특가 카드가 남고 정가 30일권을 살 길이 없어진다. 번역되는 라벨 대신 이 값을 넘긴다.
      */
     onceOnly?: boolean;
@@ -4135,12 +4135,12 @@ export declare interface PopupProps {
     /**
      * 닫기 직전에 불린다. false를 반환하면 닫기를 중단한다(닫힘 애니메이션도 시작하지 않음).
      *
-     * "입력 중인데 정말 닫을까요?" 같은 확인 절차용. onClose에서 막으면 안 되는 이유 —
-     * onClose는 이미 애니메이션이 시작된 뒤(animateThen의 setTimeout 안)에 불리므로,
-     * 거기서 닫기를 취소해도 팝업은 closingRef=true인 채로 남아 이후 ESC·X가 전부
-     * 무시된다(영구히 못 닫는 상태). 그래서 판단은 반드시 이 시점에 해야 한다.
+     * "입력 중인데 정말 닫을까요?" 같은 확인 절차용. onClose에서 막지 않는 이유 —
+     * onClose는 이미 닫힘 애니메이션(260ms)이 끝난 뒤(animateThen의 setTimeout 안)에 불리므로,
+     * 거기서 닫기를 취소하면 창이 한 번 사라졌다가 되살아난다(animateThen 은 콜백 뒤에도 창이
+     * 남아 있으면 되살린다). 사라지지 않고 그대로 머물게 하려면 이 시점에 판단한다.
      *
-     * 미지정이면 기존 동작과 완전히 동일하다.
+     * 미지정이면 묻지 않고 닫는다.
      */
     beforeClose?: () => boolean;
     /**
@@ -7920,6 +7920,18 @@ export declare function useDeviceManagement(): {
     handleSelectFromList: (form: DeviceForm) => void;
 };
 
+/**
+ * 현재 화면의 제목을 `document.title`에 반영한다 — `'<제목> · <앱 이름>'`.
+ *
+ * SPA는 라우트를 옮겨도 문서 제목이 그대로라, 브라우저 탭·히스토리·북마크로 위치를
+ * 구분할 수 없고 화면낭독기도 이동을 인지하지 못한다(WCAG 2.4.2).
+ * 여러 화면이 함께 걸면 제목이 쌓여 가장 나중에 건 것이 보이고, 언마운트하면
+ * 남은 것 중 가장 나중에 건 제목으로(남은 것이 없으면 처음 제목으로) 되돌린다.
+ *
+ * @param title 페이지 제목. 비어 있거나 문자열이 아니면 아무것도 하지 않는다.
+ *
+ * @public
+ */
 export declare function useDocumentTitle(title?: string | null): void;
 
 /**

package/dist/packages/core/src/components/BulkBar.js

@@ -56,10 +56,21 @@ export default function BulkBar({ count, actions, onClear, clearLabel: clearLabe
             return;
         const obs = new ResizeObserver(check);
         obs.observe(el);
-        // 창 폭이 바뀌면 기억한 가로 칸 폭은 옛 것이다 — 버리고 다시 잰다
-        const 창바뀜 = () => { 가로칸폭Ref.current = null; check(); };
-        window.addEventListener('resize', 창바뀜);
-        return () => { obs.disconnect(); window.removeEventListener('resize', 창바뀜); };
+        /* 막대 자체의 폭이 바뀌면(창 크기뿐 아니라 옆 메뉴 접기로 본문 열이 넓어질 때도) 기억한 가로 칸 폭은 옛 것이다 — 버리고 다시
+           잰다. 안 그러면 넘친 순간의 좁은 폭을 들고 있어 넓어져도 쌓임이 영영 안 풀렸다. 단추 배치로는 막대 폭이 안 바뀐다. */
+        const 막대 = el.parentElement;
+        let 막대폭 = 막대?.clientWidth ?? 0;
+        const 막대obs = new ResizeObserver(() => {
+            const w = 막대?.clientWidth ?? 0;
+            if (w === 막대폭)
+                return;
+            막대폭 = w;
+            가로칸폭Ref.current = null;
+            check();
+        });
+        if (막대)
+            막대obs.observe(막대);
+        return () => { obs.disconnect(); 막대obs.disconnect(); };
     }, [content, count]);
     return (_jsxs("div", { className: `bulk-bar ${show ? 'bulk-bar--visible' : ''}`, 
         /* 숨은 막대는 CSS 로 투명(opacity 0)할 뿐 DOM 에 그대로 있다 — 예전에는 그 안의

package/dist/packages/core/src/components/PaymentPlan.d.ts

@@ -16,13 +16,13 @@ export interface PaymentPlanTier {
     highlight?: boolean;
     /**
      * 할인 배지에 '오픈 특가'를 함께 얹는다 — **표시 전용**.
-     * 계정당 1회 제한은 라벨의 '오픈 특가' 문자열로 판정하므로, 이 플래그만으로는
+     * 계정당 1회 제한은 `onceOnly`(없으면 라벨의 '오픈 특가' 문자열)로 판정하므로, 이 플래그만으로는
      * 구매 횟수가 제한되지 않는다(같은 프로모션이되 1회 제한 대상은 아닌 tier용).
      */
     openPromo?: boolean;
     /**
      * **계정당 1회만 살 수 있는 tier**(오픈 특가 30일 등). 이미 산 것(`ownedCodes`)이면 숨기고 기본 tier 를 카드로 올린다.
-     * 안 주면 예전처럼 라벨에 '오픈 특가' 가 있는지로 판정한다 — 그런데 라벨은 번역되므로 영어 화면에서는 판정이 실패해
+     * 안 주면 라벨에 '오픈 특가' 가 있는지로 판정한다 — 그런데 라벨은 번역되므로 영어 화면에서는 판정이 실패해
      * 이미 산 특가 카드가 남고 정가 30일권을 살 길이 없어진다. 번역되는 라벨 대신 이 값을 넘긴다.
      */
     onceOnly?: boolean;

package/dist/packages/core/src/components/Popup/Popup.d.ts

@@ -38,12 +38,12 @@ export interface PopupProps {
     /**
      * 닫기 직전에 불린다. false를 반환하면 닫기를 중단한다(닫힘 애니메이션도 시작하지 않음).
      *
-     * "입력 중인데 정말 닫을까요?" 같은 확인 절차용. onClose에서 막으면 안 되는 이유 —
-     * onClose는 이미 애니메이션이 시작된 뒤(animateThen의 setTimeout 안)에 불리므로,
-     * 거기서 닫기를 취소해도 팝업은 closingRef=true인 채로 남아 이후 ESC·X가 전부
-     * 무시된다(영구히 못 닫는 상태). 그래서 판단은 반드시 이 시점에 해야 한다.
+     * "입력 중인데 정말 닫을까요?" 같은 확인 절차용. onClose에서 막지 않는 이유 —
+     * onClose는 이미 닫힘 애니메이션(260ms)이 끝난 뒤(animateThen의 setTimeout 안)에 불리므로,
+     * 거기서 닫기를 취소하면 창이 한 번 사라졌다가 되살아난다(animateThen 은 콜백 뒤에도 창이
+     * 남아 있으면 되살린다). 사라지지 않고 그대로 머물게 하려면 이 시점에 판단한다.
      *
-     * 미지정이면 기존 동작과 완전히 동일하다.
+     * 미지정이면 묻지 않고 닫는다.
      */
     beforeClose?: () => boolean;
     /**

package/dist/packages/core/src/components/Popup/Popup.js

@@ -81,7 +81,8 @@ export default function Popup(props) {
     // 포커스 관리 — 이전까진 팝업이 열려도 포커스가 배경(주로 body)에 남아있어서,
     // 키보드 사용자가 Tab을 눌러도 팝업 밖 배경 요소로 이동해버리고(포커스 트랩 없음),
     // 스크린리더는 열린 다이얼로그를 아예 인지하지 못했다. 열릴 때 패널(또는 첫 포커스
-    // 가능 요소)로 포커스를 옮기고, 닫히면 원래 포커스였던 요소로 되돌린다.
+    // 가능 요소)로 포커스를 옮기고, 닫히면 — 포커스가 아직 이 창 안이거나 body 일 때만 —
+    // 원래 포커스였던 요소로 되돌린다(다른 창으로 옮겨 갔으면 그대로 둔다).
     // 단, 자식이 자체 autoFocus를 쓰는 경우(SaveTablePopup 등)는 이미 그쪽으로 포커스가
     // 가 있을 것이므로(브라우저가 커밋 시점에 처리) 뺏지 않는다.
     useEffect(() => {
@@ -130,13 +131,11 @@ export default function Popup(props) {
                 되살리기();
                 return;
             }
-            // 부모가 치울 틈(렌더·커밋)을 준 뒤에도 남아 있으면 되살린다
-            const 남았으면 = () => { setTimeout(되살리기, 120); };
+            /* 약속을 돌려준 콜백만 **끝난 뒤에도 남아 있으면** 되살린다. 동기 콜백(undefined)은 되살리지 않는다 — 부모가 저장을
+               따로 기다렸다 닫는 흔한 꼴(onSave 를 부르고 약속은 안 돌려줌)에서 기다리는 사이 창이 다시 보이고 저장 단추가 다시
+               눌려 두 번 저장됐다. 저장 실패에 창을 되살리고 싶으면 콜백이 그 약속을 돌려주면 된다. */
             if (결과 && typeof 결과.then === 'function') {
-                결과.then(남았으면, 되살리기);
-            }
-            else {
-                남았으면();
+                결과.then(() => { setTimeout(되살리기, 120); }, 되살리기);
             }
         }, ANIM_MS);
     }, [되살리기]);

package/dist/packages/core/src/components/Popup/customerDetailUtils.d.ts

@@ -27,7 +27,7 @@ export declare function visitItemKey(v: {
     minute: string;
 }): string;
 /**
- * 초 → "M분 S초"(또는 "M분"·"S초"). 없거나 0 이하면 '-'.
+ * 초 → "M분 S초"(또는 "M분"·"S초"). 초 단위로 반올림한 뒤 나눈다 — 없거나(숫자가 아님) 반올림해 0 이하(0.5초 미만 포함)면 '-'.
  *
  * 문구는 지금 언어로(`customers.duration.*`, 사전에 없으면 한국어). `durationStr` 를 주면
  * 그 함수가 만든 글을 그대로 쓴다 — `calcAge` 의 `ageStr` 와 같은 결.

package/dist/packages/core/src/components/Popup/customerDetailUtils.js

@@ -71,7 +71,7 @@ export function visitItemKey(v) {
     return `${v.year}-${v.month}-${v.day}T${v.hour}:${v.minute}`;
 }
 /**
- * 초 → "M분 S초"(또는 "M분"·"S초"). 없거나 0 이하면 '-'.
+ * 초 → "M분 S초"(또는 "M분"·"S초"). 초 단위로 반올림한 뒤 나눈다 — 없거나(숫자가 아님) 반올림해 0 이하(0.5초 미만 포함)면 '-'.
  *
  * 문구는 지금 언어로(`customers.duration.*`, 사전에 없으면 한국어). `durationStr` 를 주면
  * 그 함수가 만든 글을 그대로 쓴다 — `calcAge` 의 `ageStr` 와 같은 결.

package/dist/packages/core/src/components/Tooltip/Tooltip.js

@@ -146,6 +146,12 @@ export default function Tooltip(props) {
                 const t = e.target;
                 if (t && ref.current && ref.current.contains(t))
                     return;
+                // 툴팁에서 body 로 빠진 메뉴·달력(data-tooltip-ignore)을 굴리는 것도 툴팁 안의 일이다 — 열자마자 선택값으로 굴리면 닫혔다
+                try {
+                    if (t && t.closest && t.closest('[data-tooltip-ignore]'))
+                        return;
+                }
+                catch (err) { }
                 startCloseRef.current(true);
                 return;
             }

package/dist/packages/core/src/components/Training/TrainingBlock.js

@@ -7,6 +7,7 @@ import Section from '../Section';
 import './TrainingBlock.css';
 import TrainingBlockButton from './TrainingBlockButton';
 import { useWindowEvent } from '../../hooks/useWindowEvent';
+import { 키보드로눌렀나 } from '../../hooks/inputModality';
 const BTN_COUNT_MAX = 20;
 /** @public */
 export default function TrainingBlock(props) {
@@ -34,7 +35,7 @@ export default function TrainingBlock(props) {
     const 더보기초점Ref = useRef(null);
     function loadMore() {
         const 단추 = document.activeElement;
-        더보기초점Ref.current = 단추 && 단추.closest?.('.training-block__more') ? visible : null;
+        더보기초점Ref.current = 키보드로눌렀나() && 단추 && 단추.closest?.('.training-block__more') ? visible : null;
         setVisible((v) => Math.min(total, v + BTN_COUNT_MAX));
     }
     useEffect(() => {

package/dist/packages/core/src/components/Training/TrainingPagePopup.js

@@ -25,6 +25,7 @@ import useTrainingSessionLog from '../../hooks/useTrainingSessionLog';
 import { logTrainingCompletion } from '../../utils/trainingLogger';
 import { toItemResults } from '../../utils/trainingItemResults';
 import { loadNoiseSettings, saveNoiseSettings, reportAppliedNoiseSettings } from '../../utils/noiseSettingsStore';
+import { 키보드로눌렀나 } from '../../hooks/inputModality';
 // 문장 4종은 각 PagePopup 래퍼에서 useTrainingSessionLog로 이미 기록 → 베이스에서 중복 방지
 const SENTENCE_TIME_LOGGED_TYPES = new Set(['LISTEN_IN_NOISE', 'SHORT_STORY', 'LONG_STORY', 'ORDERING_SENTENCE']);
 // renderResultPopup 미지정 시 기본 결과 팝업 — 모든 훈련 타입 공통 폴백
@@ -763,6 +764,9 @@ function TrainingPagePopupInner(props) {
         앞쪽Ref.current = effectivePageIndex;
         if (앞 === undefined || 앞 === effectivePageIndex)
             return;
+        // 키보드로 넘겼을 때만 — 마우스로 누른 사람에게 매 문제 '듣기' 초점 안내가 뜨지 않게
+        if (!키보드로눌렀나())
+            return;
         const panel = panelRef.current;
         if (!panel)
             return;

package/dist/packages/core/src/components/Training/TrainingStepAudioPlayer.js

@@ -17,6 +17,7 @@ import Button from '../Button';
 import Icon from '../Icon';
 import InfoTooltip from '../Tooltip/InfoTooltip';
 import { STATUS_MESSAGES } from './trainingStepAudioPlayerTypes';
+import { 키보드로눌렀나 } from '../../hooks/inputModality';
 import { measureAudioDuration, waitForCanPlay } from './audioWaits';
 import { useWaveReady } from './useWaveReady';
 import { useObjectUrls } from './useObjectUrls';
@@ -1092,7 +1093,9 @@ export default function TrainingStepAudioPlayer({ btnLabel, soundSrc, bucketPath
     const fillPausedFlag = playbackState === "paused";
     const fillLeftPercent = Math.max(0, Math.min(100, (progress || 0) * 100));
     const fillClass = cx('audio-player__fill', fillVisibleFlag ? 'is-visible' : '', fillExpandedFlag ? 'is-expanded' : '', fillPausedFlag ? 'is-paused' : '', isFillOutAnimating ? 'is-out' : '');
-    return (_jsxs("div", { className: `audio-player ${isDisabled ? 'is-disabled' : ''}${className ? ` ${className}` : ''}`, role: "group", "aria-label": typeof label === 'string' ? label : undefined, children: [_jsxs("div", { className: `audio-player__panel ${displayedPlaying ? "is-playing" : ""} ${isFetchingUrl ? "is-loading" : ""} ${stateLocal !== "default" ? "is-revealed" : ""}`, children: [isFetchingUrl ? (_jsxs("div", { className: "audio-player__loading", role: "status", "aria-live": "polite", children: [_jsx("span", { className: "audio-player__loading-spinner", "aria-hidden": "true" }), _jsx("span", { className: "audio-player__loading-text", children: t(`training.audioStatus.${fetchDebugStatus}`, { defaultValue: STATUS_MESSAGES[fetchDebugStatus] }) })] })) : null, stateLocal === "active" ? (_jsx("button", { className: "audio-player__button", type: "button", onClick: (e) => { 듣기초점옮기기Ref.current = document.activeElement === e.currentTarget; hideListenTip(); handleToggle(); }, "aria-label": typeof label === 'string' ? label : t('training.listen', '듣기'), onMouseEnter: showListenTip, onMouseLeave: hideListenTip, 
+    return (_jsxs("div", { className: `audio-player ${isDisabled ? 'is-disabled' : ''}${className ? ` ${className}` : ''}`, role: "group", "aria-label": typeof label === 'string' ? label : undefined, children: [_jsxs("div", { className: `audio-player__panel ${displayedPlaying ? "is-playing" : ""} ${isFetchingUrl ? "is-loading" : ""} ${stateLocal !== "default" ? "is-revealed" : ""}`, children: [isFetchingUrl ? (_jsxs("div", { className: "audio-player__loading", role: "status", "aria-live": "polite", children: [_jsx("span", { className: "audio-player__loading-spinner", "aria-hidden": "true" }), _jsx("span", { className: "audio-player__loading-text", children: t(`training.audioStatus.${fetchDebugStatus}`, { defaultValue: STATUS_MESSAGES[fetchDebugStatus] }) })] })) : null, stateLocal === "active" ? (_jsx("button", { className: "audio-player__button", type: "button", 
+                        // 키보드로 눌렀을 때만 초점을 옮긴다 — 마우스로 누른 사람에게 '재생 / 멈춤' 초점 툴팁이 뜨지 않게
+                        onClick: () => { 듣기초점옮기기Ref.current = 키보드로눌렀나(); hideListenTip(); handleToggle(); }, "aria-label": typeof label === 'string' ? label : t('training.listen', '듣기'), onMouseEnter: showListenTip, onMouseLeave: hideListenTip, 
                         // 키보드로 이 버튼에 오면 마우스와 동일하게 안내를 띄운다
                         onFocus: showListenTip, onBlur: hideListenTip, children: _jsx("span", { ref: listenBtnRef, className: "audio-player__button-triangle-wrap", children: _jsx("svg", { className: "audio-player__button-triangle", viewBox: "0 0 24 24", "aria-hidden": "true", children: _jsx("path", { ref: triPathRef, d: "M13.2 7.7 L16.5 9.85 Q20.2 12 16.5 14.15 L10 18.3 Q7 19.7 7 16.3 L7 7.7 Q7 4.3 10 5.7 L13.2 7.7" }) }) }) })) : null, listenBtnRect && (_jsx(InfoTooltip, { anchorRect: listenBtnRect, text: typeof label === 'string' && label ? label : t('training.listenLabel', '문장 듣기'), offset: 8 })), _jsxs("div", { className: `audio-player__play ${stateLocal === "playMode" || displayedPlaying ? "is-visible" : ""}`, children: [_jsxs("div", { ref: btnsRef, className: "audio-player__buttons", children: [_jsx(Button, { htmlType: "button", size: 32, showTooltipInfo: true, type: "dot", shape: "pill", useBorder: false, icon: "skip-back", onClick: handlePrev, ariaLabel: t('training.prev', '이전'), width: "60px", variant: "transparent-white", "aria-hidden": "true", tabIndex: -1, disabled: stateLocal !== 'playMode' }), _jsx(Button, { htmlType: "button", size: 32, showTooltipInfo: true, type: "dot", shape: "pill", useBorder: false, icon: displayedPlaying ? "pause" : "play", onClick: handleToggle, ariaLabel: t('common.playPause', '재생 / 멈춤'), width: "60px", variant: "transparent-white", disabled: stateLocal !== 'playMode' }), _jsx(Button, { htmlType: "button", size: 32, showTooltipInfo: true, type: "dot", shape: "pill", useBorder: false, icon: "square", onClick: handleStop, ariaLabel: t('training.stop', '정지'), width: "60px", variant: "transparent-white", "aria-hidden": "true", tabIndex: -1, disabled: stateLocal !== 'playMode' }), sourceButtonCount > 1 ? (_jsx("div", { ref: sourceButtonsRef, className: "audio-player__source-buttons", children: Array.from({ length: sourceButtonCount }).map((_, idx) => (_jsx(Button, { htmlType: "button", size: 32, type: "dot", shape: "pill", useBorder: false, label: String(idx + 1), onClick: () => { try {
                                                 handleJumpTo(idx);

package/dist/packages/core/src/components/Training/TrainingStepTextBox.js

@@ -2,6 +2,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { useTranslation } from 'react-i18next';
+import { 키보드로눌렀나 } from '../../hooks/inputModality';
 import Button from '../Button';
 import Toast from '../Toast';
 import { useFontScale } from '../../hooks';
@@ -34,7 +35,8 @@ export default function TrainingStepTextBox({ context, state = "disabled", theme
     const 상자Ref = useRef(null);
     const 펼친뒤초점Ref = useRef(false);
     const handleActivate = useCallback(() => {
-        펼친뒤초점Ref.current = !!상자Ref.current && 상자Ref.current.contains(document.activeElement);
+        // 키보드로 눌렀을 때만 — 마우스로 눌렀는데 옮기면 '글자 크기 감소' 초점 툴팁이 떴다
+        펼친뒤초점Ref.current = 키보드로눌렀나() && !!상자Ref.current && 상자Ref.current.contains(document.activeElement);
         setLocalStatus("active");
     }, []);
     const handleNoticeClose = useCallback(() => setNoticeMessage(''), []);

package/dist/packages/core/src/hooks/inputModality.d.ts

@@ -0,0 +1,2 @@
+/** 마지막 입력이 키보드였으면 true(모르면 false) */
+export declare function 키보드로눌렀나(): boolean;

package/dist/packages/core/src/hooks/inputModality.js

@@ -0,0 +1,31 @@
+'use client';
+/*
+ * 마지막 입력이 **키보드였나** — 누른 단추가 사라지는 자리에서 초점을 옮길지 가를 때 쓴다.
+ *
+ * "초점이 누른 단추에 있었나" 로만 보면 Chrome·Edge·안드로이드는 마우스로 눌러도 단추에 초점이 가서, 마우스 사용자에게도
+ * 초점을 옮겨 그 단추의 초점 툴팁이 떴다(듣기 → '재생 / 멈춤', 문장 미리보기 → '글자 크기 감소'). Safari 는 누른 단추에 초점을
+ * 안 줘 body 에 남는다. 문서 전체에서 키 누름·포인터 누름을 들어 마지막 것을 기억한다(캡처 단계, 한 번만 붙인다).
+ */
+let 마지막 = null;
+let 붙음 = false;
+function 붙이기() {
+    if (붙음 || typeof document === 'undefined')
+        return;
+    붙음 = true;
+    document.addEventListener('keydown', (e) => {
+        if (e.metaKey || e.ctrlKey || e.altKey)
+            return;
+        마지막 = 'keyboard';
+    }, true);
+    const 포인터 = () => { 마지막 = 'pointer'; };
+    document.addEventListener('pointerdown', 포인터, true);
+    document.addEventListener('mousedown', 포인터, true);
+    document.addEventListener('touchstart', 포인터, { capture: true, passive: true });
+}
+// 불러오는 즉시 듣는다 — 첫 누름부터 알아야 한다
+붙이기();
+/** 마지막 입력이 키보드였으면 true(모르면 false) */
+export function 키보드로눌렀나() {
+    붙이기();
+    return 마지막 === 'keyboard';
+}

package/dist/packages/core/src/hooks/useDocumentTitle.d.ts

@@ -7,5 +7,17 @@
  * @public
  */
 export declare const DocumentTitleSuppressContext: import("react").Context<boolean>;
+/**
+ * 현재 화면의 제목을 `document.title`에 반영한다 — `'<제목> · <앱 이름>'`.
+ *
+ * SPA는 라우트를 옮겨도 문서 제목이 그대로라, 브라우저 탭·히스토리·북마크로 위치를
+ * 구분할 수 없고 화면낭독기도 이동을 인지하지 못한다(WCAG 2.4.2).
+ * 여러 화면이 함께 걸면 제목이 쌓여 가장 나중에 건 것이 보이고, 언마운트하면
+ * 남은 것 중 가장 나중에 건 제목으로(남은 것이 없으면 처음 제목으로) 되돌린다.
+ *
+ * @param title 페이지 제목. 비어 있거나 문자열이 아니면 아무것도 하지 않는다.
+ *
+ * @public
+ */
 export declare function useDocumentTitle(title?: string | null): void;
 export default useDocumentTitle;

package/dist/packages/core/src/hooks/useDocumentTitle.js

@@ -23,22 +23,23 @@ const BASE_TITLE = (() => {
  * @public
  */
 export const DocumentTitleSuppressContext = createContext(false);
+/* 제목을 건 화면들 — 나중에 건 것이 위. 떠날 때 **남은 맨 위 제목**으로 돌린다.
+   전에는 저마다 건 순간의 제목(prev)을 기억했다가 되돌려, A 가 떠 있는 동안 B 가 붙고 A 가 나중에 떠나면
+   A 의 prev 로 돌아가 B 의 제목이 지워졌다(말귀 CustomersPage 가 겪고 우회해 둠). */
+const 걸린제목 = [];
+let 처음제목 = null;
 /**
  * 현재 화면의 제목을 `document.title`에 반영한다 — `'<제목> · <앱 이름>'`.
  *
  * SPA는 라우트를 옮겨도 문서 제목이 그대로라, 브라우저 탭·히스토리·북마크로 위치를
  * 구분할 수 없고 화면낭독기도 이동을 인지하지 못한다(WCAG 2.4.2).
- * 언마운트하면 이전 제목으로 되돌린다.
+ * 여러 화면이 함께 걸면 제목이 쌓여 가장 나중에 건 것이 보이고, 언마운트하면
+ * 남은 것 중 가장 나중에 건 제목으로(남은 것이 없으면 처음 제목으로) 되돌린다.
  *
  * @param title 페이지 제목. 비어 있거나 문자열이 아니면 아무것도 하지 않는다.
  *
  * @public
  */
-/* 제목을 건 화면들 — 나중에 건 것이 위. 떠날 때 **남은 맨 위 제목**으로 돌린다.
-   전에는 저마다 건 순간의 제목(prev)을 기억했다가 되돌려, A 가 떠 있는 동안 B 가 붙고 A 가 나중에 떠나면
-   A 의 prev 로 돌아가 B 의 제목이 지워졌다(말귀 CustomersPage 가 겪고 우회해 둠). */
-const 걸린제목 = [];
-let 처음제목 = null;
 export function useDocumentTitle(title) {
     const suppressed = useContext(DocumentTitleSuppressContext);
     useEffect(() => {

package/dist/packages/core/src/hooks/useEditableList.js

@@ -27,9 +27,9 @@ export function useEditableList(emptyItem, initialList = []) {
     // 값만 캡처하므로 이 effect가 없으면 이후 prop 변경이 화면에 전혀 반영되지 않는다.
     // 단, 사용자가 이 목록의 항목을 수정 중(isEditing)일 때 리셋하면 아직 list에 반영되지
     // 않은 진행 중인 편집(editForm)이 저장 시 조용히 무시될 수 있으므로 그 사이엔 건너뛴다.
-    // isEditing은 ref로만 참조해 effect가 initialList 변경 시에만 실행되게 한다 — 편집을
-    // 끝내는 순간(isEditing만 바뀌는 렌더)에는 재실행되지 않아, 방금 커밋된 편집 결과가
-    // 곧바로 stale한 initialList로 덮어써지는 것도 막는다.
+    // effect 는 initialList 와 isEditing 둘 다에 걸려 있어 편집이 끝나는 렌더에서도 돈다 —
+    // 취소(cancelEditing)로 끝났으면 그 사이 건너뛴 목록을 받고, commitEdit 으로 끝났으면
+    // 방금 커밋한 편집을 옛 initialList 로 덮지 않도록 한 번 건너뛴다(아래 커밋으로끝남Ref).
     //
     // 비교는 참조가 아니라 **내용**으로 한다. 호출부가 배열을 인라인으로 넘기면
     // (useEditableList(EMPTY, [a, b]) — 가장 자연스러운 호출 방식이고, 인자를 생략해

package/dist/packages/core/src/utils/textSort.d.ts

@@ -1,3 +1,13 @@
 /** 글자 둘을 한국어 차례로 견준다 */
 export declare function 한글순(a: string, b: string): number;
+/**
+ * 표의 한 칸끼리 견준다 — **숫자는 숫자로, 나머지는 글자 속 숫자까지 수로.**
+ *
+ * 표의 칸은 무엇이든 올 수 있어서 늘 글자로 견주면 **숫자 칸이 망가진다**
+ * (`10` 이 `9` 앞에 선다). 그래서 둘 다 온전한 숫자(수, 또는 숫자만 든 글자)면 숫자로 견주고,
+ * 그 밖에는 한국어 차례로 견주되 글자 안의 숫자는 수로 읽는다(`회차 9` 가 `회차 10` 앞).
+ *
+ * 비어 있는 값(`null`·`undefined`)은 빈 글자로 본다 — 부르는 쪽이 이미
+ * `?? ''` 로 채워 넘기던 것과 같은 뜻이다.
+ */
 export declare function 칸순(a: unknown, b: unknown): number;

package/dist/packages/core/src/utils/textSort.js

@@ -22,16 +22,6 @@ const 콜레이터 = (() => {
 export function 한글순(a, b) {
     return 콜레이터().compare(a, b);
 }
-/**
- * 표의 한 칸끼리 견준다 — **숫자는 숫자로, 나머지는 글자로.**
- *
- * 표의 칸은 무엇이든 올 수 있어서 늘 글자로 견주면 **숫자 칸이 망가진다**
- * (`10` 이 `9` 앞에 선다). 그래서 둘 다 진짜 숫자일 때만 숫자로 견주고,
- * 그 밖에는 한국어 차례를 쓴다.
- *
- * 비어 있는 값(`null`·`undefined`)은 빈 글자로 본다 — 부르는 쪽이 이미
- * `?? ''` 로 채워 넘기던 것과 같은 뜻이다.
- */
 const 숫자글자 = /^-?\d+(\.\d+)?$/;
 /* 칸의 글자 비교는 **안의 숫자도 수로** 본다 — 숫자 칸끼리는 수로, 섞인 칸은 글자로 견주면 '9'<'10'(수)·'10'<'10분'(글자)·
    '10분'<'9'(글자) 로 돌고 돌아, 같은 행을 들어온 차례만 바꿔도 정렬 결과가 달랐다. 수를 수로 읽는 콜레이터는
@@ -44,6 +34,16 @@ const 칸콜레이터 = (() => {
         return 것;
     };
 })();
+/**
+ * 표의 한 칸끼리 견준다 — **숫자는 숫자로, 나머지는 글자 속 숫자까지 수로.**
+ *
+ * 표의 칸은 무엇이든 올 수 있어서 늘 글자로 견주면 **숫자 칸이 망가진다**
+ * (`10` 이 `9` 앞에 선다). 그래서 둘 다 온전한 숫자(수, 또는 숫자만 든 글자)면 숫자로 견주고,
+ * 그 밖에는 한국어 차례로 견주되 글자 안의 숫자는 수로 읽는다(`회차 9` 가 `회차 10` 앞).
+ *
+ * 비어 있는 값(`null`·`undefined`)은 빈 글자로 본다 — 부르는 쪽이 이미
+ * `?? ''` 로 채워 넘기던 것과 같은 뜻이다.
+ */
 export function 칸순(a, b) {
     /* NaN 은 숫자가 아닌 것으로 — a - b 가 NaN 이면 정렬 비교가 어긋나 줄이 뒤섞였다. 글자로 온 숫자('10'·'9')도
        둘 다 온전한 숫자면 숫자로 견준다(전에는 '10' 이 '9' 앞에 섰다). */
@@ -51,5 +51,10 @@ export function 칸순(a, b) {
     const na = 수(a), nb = 수(b);
     if (na !== null && nb !== null)
         return na - nb;
-    return 칸콜레이터().compare(a == null ? '' : String(a), b == null ? '' : String(b));
+    const sa = a == null ? '' : String(a), sb = b == null ? '' : String(b);
+    /* 소수점·음수가 든 글자('12.5%'·'-10 dB')는 수로 읽는 콜레이터가 틀린다 — 점 뒤를 따로 떼어 '12.5' 가 '12.25' 뒤에,
+       빼기표를 버려 '-5' 가 '-10' 뒤에 섰다. 그런 칸은 한국어 글자 차례로 둔다. 선행 0 도 수로 읽으면 'A007'='A7' 이 되어 글자로. */
+    if (/\d\.\d|-\d|(^|\D)0\d/.test(sa) || /\d\.\d|-\d|(^|\D)0\d/.test(sb))
+        return 한글순(sa, sb);
+    return 칸콜레이터().compare(sa, sb);
 }

package/dist/packages/core/src/version.d.ts

@@ -46,4 +46,4 @@
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.141.0";
+export declare const CORE_VERSION = "0.142.0";

package/dist/packages/core/src/version.js

@@ -46,4 +46,4 @@
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export const CORE_VERSION = '0.141.0';
+export const CORE_VERSION = '0.142.0';