@ihabdevteam/core 0.312.0 → 0.314.0

package/dist/ihabdevteam-core.d.ts

@@ -1669,7 +1669,7 @@ export declare function copyText(text: string): Promise<boolean>;
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.312.0";
+export declare const CORE_VERSION = "0.314.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;

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

@@ -129,6 +129,10 @@ function BarChartCanvas({ data, colorA, colorB, labelA, labelB, barWidth = 10, b
     useEffect(() => {
         if (!떠있음)
             return;
+        /* **안-모음: 닫기만 한다**(코어 자체 조사 2026-10-10에서 세어 보고 적음).
+           굴림에 하는 일이 `setTooltip(null)` 하나뿐이라 레이아웃을 안 읽는다. 그리고 **미루면 안 된다** —
+           풍선은 막대에 붙어 떠 있어서, 한 틀 미루면 막대에서 떨어진 풍선이 그만큼 더 허공에 남는다
+           (Tooltip·useAnchoredMenu 의 `close` 길과 같은 가름: *자리 재기는 미뤄도 되고 닫기는 안 된다*). */
         const 닫기 = () => setTooltip(null);
         const 바깥누름 = (e) => {
             const t = e.target;

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

@@ -227,6 +227,11 @@ export default function Table({ fields = [], headerGroups, items = [], renderRow
         const 다음틀 = typeof requestAnimationFrame === 'function'
             ? requestAnimationFrame(() => 넘침재기())
             : null;
+        /* **안-모음: 모을 값이 없다**(2026-10-10 조사에서 한 번 모아 봤다가 되돌림). `넘침재기` 는
+           `scrollWidth > clientWidth` 하나를 **불리언**으로 넣는데, 같은 값이면 React 가 그 자리에서
+           멈춘다 — 몰려 와도 다시 그리지 않는다. 그리고 바로 위 `requestAnimationFrame(() => 넘침재기())`
+           가 *자리잡은 뒤 한 번 더* 재는 일을 이미 하고, `test/tableScrollRegion.test.tsx` 가 **이 배선을
+           글자로 박아** 두었다(옛 결함을 지키는 못이다). 모으면 그 못이 지키던 모양이 바뀐다. */
         window.addEventListener('resize', 넘침재기);
         return () => {
             if (다음틀 != null)
@@ -324,6 +329,9 @@ export default function Table({ fields = [], headerGroups, items = [], renderRow
             : { index, startX: e.clientX, startW: measured[index] };
         colWidthsRef.current = measured;
         setColWidths(measured);
+        /* **안-모음: 곧바로 써야 한다** — `onResizeMove` 가 `colWidthsRef` 를 그 자리에서 맞춘다.
+           한 틀 미루면 마지막 이동 직후 손을 떼었을 때 **화면은 새 폭인데 저장소에는 한 박자 전 폭**이
+           남는다(그 함수 머리말에 적힌 까닭). 자리 재기와 달리 이것은 *값을 쓰는* 일이다. */
         window.addEventListener('pointermove', onResizeMove);
         window.addEventListener('pointerup', onResizeEnd);
         // 터치 조절이 시스템 제스처 등으로 취소되면(pointercancel) 끝낸다 — 안 들으면 리스너가 남아 다음 스크롤 손짓이 폭을 바꿨다

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

@@ -72,17 +72,33 @@ export default function TextField(props) {
             return;
         목록자리재기();
         /* 굴리거나 창 크기가 바뀌면 칸을 따라간다 — 목록 안을 굴리는 것은 무시 */
+        /* **틀에 한 번으로 모은다** — (115) 와 같은 꼴, 셋째 자리(2026-10-10, 코어 자체 조사). `목록자리재기` 는
+           `getBoundingClientRect()` 로 레이아웃을 읽고 상태를 바꾸는데, 이 듣는 이는 **문서 전체의 굴림을
+           capture 로** 받는다 — 목록이 뜬 동안 굴리면 틀마다 여러 번 돌았다. 여기는 **닫는 길이 없다**(자리만
+           따라간다) — 미뤄도 되는 일뿐이다. */
+        let 예약 = null;
+        const 자리다시 = () => {
+            if (typeof requestAnimationFrame === 'undefined') {
+                목록자리재기();
+                return;
+            }
+            if (예약 !== null)
+                return;
+            예약 = requestAnimationFrame(() => { 예약 = null; 목록자리재기(); });
+        };
         const 굴림 = (e) => {
             const t = e.target;
             if (t && t.nodeType === 1 && t.closest?.('.text-field__suggestions'))
                 return;
-            목록자리재기();
+            자리다시();
         };
         window.addEventListener('scroll', 굴림, true);
-        window.addEventListener('resize', 목록자리재기);
+        window.addEventListener('resize', 자리다시);
         return () => {
+            if (예약 !== null)
+                cancelAnimationFrame(예약);
             window.removeEventListener('scroll', 굴림, true);
-            window.removeEventListener('resize', 목록자리재기);
+            window.removeEventListener('resize', 자리다시);
         };
     }, [목록떴나, 목록자리재기]);
     // 외부 inputRef + 내부 autoRef 동시 연결 — 외부에서 전달받은 ref 객체(.current)에 노드를 채우는

package/dist/packages/core/src/components/Word/wordTablePrint.js

@@ -197,6 +197,9 @@ export function captureHtml(els, paperW, paperH, autoPrint = false, fileName = '
       });
     }
     scale();
+    /* 안-모음: 인쇄 창에 끼워 넣는 글이고, 아래 refit 과 함께 beforeprint 에서도 불린다 —
+       인쇄 배치를 뜨는 순간이라 미루면 **옛 배율로 인쇄된다**. resize 는 사람이 미리보기 창을
+       끄는 때뿐이라 잦지 않다. */
     window.addEventListener('resize', scale);
 
     /* **칸 글씨를 이 종이 칸에 맞춰 다시 센다.**
@@ -226,6 +229,8 @@ export function captureHtml(els, paperW, paperH, autoPrint = false, fileName = '
       });
     }
     refit();
+    /* 안-모음: 바로 아래 beforeprint·print 매체질의가 **같은 함수**를 부른다 — 그 자리는 인쇄 배치가
+       잡히는 순간이라 못 미룬다(미루면 옛 배율로 인쇄된다, Letter 실측 -3.4% 가 그 꼴이었다). */
     window.addEventListener('resize', refit);
     /* 인쇄 배치로 바뀌는 순간을 브라우저마다 다른 신호로 알린다 — 크롬은 beforeprint,
        파이어폭스는 print 매체 질의가 먼저 켜진다. 둘 다 걸어 두고 두 번 세도 값이 같다. */

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

@@ -317,22 +317,48 @@ export default function WordTable({ title, titleIcon, disc, className, orientati
            거기서는 막을 수 없어, 익은 순간 직접 단다(passive:false). */
         const 스크롤막기 = (ev) => { if (익음 && ev.cancelable)
             ev.preventDefault(); };
-        const 이동 = (ev) => {
-            if (!익음) {
-                if (Math.abs(ev.clientX - 시작.x) > 움직임문턱_PX || Math.abs(ev.clientY - 시작.y) > 움직임문턱_PX)
-                    해제();
+        /* **길이 둘이라 갈라 둔다**(2026-10-10, 코어 자체 조사). *문턱을 넘었나* 는 **안 미룬다** — 그 판정이
+           길게누름을 거두는 일이라, 한 틀 미루면 손가락을 움직였는데도 끌기가 익어 버린다. *밑에 어느 칸인가*
+           는 `elementFromPoint`(레이아웃을 읽는다) + 상태 바꾸기라 **틀에 한 번으로 모은다** — 보이는 일뿐이다. */
+        let 자리예약 = null;
+        let 마지막점 = null;
+        const 자리셈 = () => {
+            const pt = 마지막점;
+            if (!pt)
                 return;
-            }
             /* 손가락 밑의 칸. `elementFromPoint` 가 없는 환경(구형·시험)에서는 자리를 못 고른다 —
                그때는 떨어뜨려도 아무 일이 없다(끌기가 시작되지 않은 것과 같다). */
-            const 밑 = document.elementFromPoint?.(ev.clientX, ev.clientY);
+            const 밑 = document.elementFromPoint?.(pt.x, pt.y);
             const 칸 = 밑?.closest?.('[data-wordtable-cell]');
             const i = 칸 ? Number(칸.dataset.wordtableCell) : NaN;
             const 자리 = Number.isInteger(i) ? i : null;
             떨굴자리.current = 자리;
-            setDragOver(자리);
+            setDragOver(prev => (prev === 자리 ? prev : 자리));
+        };
+        const 이동 = (ev) => {
+            if (!익음) {
+                if (Math.abs(ev.clientX - 시작.x) > 움직임문턱_PX || Math.abs(ev.clientY - 시작.y) > 움직임문턱_PX)
+                    해제();
+                return;
+            }
+            마지막점 = { x: ev.clientX, y: ev.clientY };
+            if (typeof requestAnimationFrame === 'undefined') {
+                자리셈();
+                return;
+            }
+            if (자리예약 !== null)
+                return;
+            자리예약 = requestAnimationFrame(() => { 자리예약 = null; 자리셈(); });
         };
         const 뗌 = () => {
+            /* **떼기 전에 밀린 셈을 치른다.** 자리셈을 틀로 모았으니, 움직이고 **같은 틀 안에** 떼면 틀이
+               오기 전에 여기 닿는다 — 그러면 `떨굴자리` 가 비어 **떨어뜨린 자리를 잃는다.** 옛 시험
+               (`wordTableReorder0916`)이 그것을 짚었다. 모으는 고침을 할 때는 **그 값을 읽는 쪽**도 봐야 한다. */
+            if (자리예약 !== null) {
+                cancelAnimationFrame(자리예약);
+                자리예약 = null;
+                자리셈();
+            }
             const 자리 = 떨굴자리.current;
             const 끌었다 = 익음;
             해제();
@@ -344,6 +370,8 @@ export default function WordTable({ title, titleIcon, disc, className, orientati
             set끌기(index);
             떨굴자리.current = index;
             setDragOver(index);
+            /* **안-모음: `preventDefault()` 는 못 미룬다** — 틀로 미루면 이벤트가 이미 지나가 막을 수 없다
+               (`passive: false` 로 다는 까닭이 그것이다). */
             window.addEventListener('touchmove', 스크롤막기, { passive: false });
         }, 길게누름_MS);
         function 해제() {
@@ -353,6 +381,10 @@ export default function WordTable({ title, titleIcon, disc, className, orientati
             window.removeEventListener('pointercancel', 뗌);
             window.removeEventListener('touchmove', 스크롤막기);
             익음 = false;
+            if (자리예약 !== null) {
+                cancelAnimationFrame(자리예약);
+                자리예약 = null;
+            }
             떨굴자리.current = null;
             풀기.current = null;
             set끌기(null);

package/dist/packages/core/src/context/I18nProvider.js

@@ -1,6 +1,6 @@
 'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useEffect } from 'react';
+import { useEffect, useMemo } from 'react';
 import i18n, { SUPPORTED_LOCALES, DEFAULT_LOCALE } from '../i18n';
 import { I18nContext } from './I18nContext';
 function 지원코드(locale) {
@@ -20,5 +20,14 @@ export function I18nProvider({ locale = DEFAULT_LOCALE, children }) {
             i18n.changeLanguage(code);
         }
     }, [code]);
-    return (_jsx(I18nContext.Provider, { value: { locale: code, supportedLocales: SUPPORTED_LOCALES }, children: children }));
+    /**
+     * **값을 기억해 둔다** — (114) 와 **같은 꼴, 둘째 자리**다(2026-10-10, 코어 자체 조사).
+     * (114) 로 `WordDataProvider` 를 고칠 때 **프로바이더를 세지 않았다** — 리터럴을 바로 넘기는 자리가
+     * 둘이었고 하나만 고쳤다. 이 프로바이더도 앱 전체를 감싸고, `useI18n()` 은 공개 훅이라 쓰는 쪽을 코어가 모른다.
+     *
+     * `code` 는 글자이고 `SUPPORTED_LOCALES` 는 모듈 상수라 **값은 늘 같은데 객체만 새로** 났다 —
+     * 가장 안 보이는 꼴이다(값이 틀리지 않으니 아무도 안 묻는다).
+     */
+    const value = useMemo(() => ({ locale: code, supportedLocales: SUPPORTED_LOCALES }), [code]);
+    return (_jsx(I18nContext.Provider, { value: value, children: children }));
 }

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

@@ -89,11 +89,26 @@ export function useAnchoredMenu({ computeStyle, onScroll = 'close', onResize = '
         document.addEventListener('mousedown', handleOutsideClick);
         // iOS 는 누를 수 없는 요소를 톡하면 mousedown 을 안 보낸다 — pointerdown 으로도 닫는다(Tooltip·CategoryIcon 과 같게)
         document.addEventListener('pointerdown', handleOutsideClick);
+        /* **자리 다시 재기는 틀에 한 번으로 모은다** — (115) 와 같은 꼴, 둘째 자리(2026-10-10, 코어 자체 조사).
+           `recalc()` 은 `getBoundingClientRect()` 로 레이아웃을 읽는데, 이 듣는 이는 **문서 전체의 굴림을
+           capture 로** 받는다 — `DatePicker` 가 `onScroll: 'reposition'` 을 주므로 달력이 열린 동안 굴리면
+           틀마다 여러 번 돌았다. **닫는 길('close')은 안 미룬다** — 미루면 앵커에서 떨어진 판이 한 틀 더
+           허공에 남는다(Tooltip 과 같은 가름). 미루는 것은 *자리* 뿐이다. */
+        let 자리예약 = null;
+        const 자리다시 = () => {
+            if (typeof requestAnimationFrame === 'undefined') {
+                recalc();
+                return;
+            }
+            if (자리예약 !== null)
+                return;
+            자리예약 = requestAnimationFrame(() => { 자리예약 = null; recalc(); });
+        };
         const handleScroll = (e) => {
             if (menuRef.current?.contains(e.target))
                 return;
             if (onScroll === 'reposition')
-                recalc();
+                자리다시();
             else if (onScroll === 'close')
                 setOpen(false);
         };
@@ -101,7 +116,7 @@ export function useAnchoredMenu({ computeStyle, onScroll = 'close', onResize = '
             window.addEventListener('scroll', handleScroll, true);
         const handleResize = () => {
             if (onResize === 'reposition')
-                recalc();
+                자리다시();
             else if (onResize === 'close')
                 setOpen(false);
         };
@@ -119,6 +134,8 @@ export function useAnchoredMenu({ computeStyle, onScroll = 'close', onResize = '
             window.addEventListener('orientationchange', handleOrientation);
         }
         return () => {
+            if (자리예약 !== null)
+                cancelAnimationFrame(자리예약);
             판관찰?.disconnect();
             document.removeEventListener('mousedown', handleOutsideClick);
             document.removeEventListener('pointerdown', handleOutsideClick);

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

@@ -1,6 +1,8 @@
 /** @public */
 export const TRAINING_TYPES = [
-    { key: "LISTEN_IN_NOISE", label: "소음 하 문장 듣기", icon: "party-popper", desc: "다양한 소음 환경에서 문장 청력을 훈련합니다." },
+    /* 아이콘은 **`categories.ts` 의 `DEFAULT_TRAINING_TYPES` 와 같아야 한다** — 말귀는 그쪽 하나만 짚었는데
+       세어 보니 **둘**이었고, 화면에 나가는 것은 이쪽(`translateTrainingTypes`)이다. (116), 2026-10-10. */
+    { key: "LISTEN_IN_NOISE", label: "소음 하 문장 듣기", icon: "audio-lines", desc: "다양한 소음 환경에서 문장 청력을 훈련합니다." },
     { key: "SHORT_STORY", label: "짧은 이야기 듣기", icon: "message-square", desc: "짧은 이야기를 듣고 기억하여 문제를 풀어봅니다." },
     { key: "LONG_STORY", label: "긴 이야기 듣기", icon: "message-square-text", desc: "긴 이야기를 듣고 기억하여 다수의 문제를 풀어봅니다." },
     { key: "ORDERING_SENTENCE", label: "문장 순서화 하기", icon: "align-start-vertical", desc: "여러개의 짧은 문장을 듣고 기억하여 그 순서에 맞게 배열합니다." },

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

@@ -33,7 +33,10 @@ const DEFAULT_TOPIC_TYPES = [
     { key: 'SPRT', label: '스포츠', icon: 'trophy', color: '#FFCA28', subs: [{ key: 'INVDSP', label: '개인경기' }, { key: 'MARART', label: '격투기' }, { key: 'TEAMSP', label: '단체경기' }, { key: 'FOOTBL', label: '축구' }, { key: 'GESPKL', label: '스포츠 상식' }] },
 ];
 const DEFAULT_TRAINING_TYPES = [
-    { key: 'LISTEN_IN_NOISE', label: '소음 하 문장 듣기', icon: 'party-popper', desc: '소음 환경 속 문장 이해 훈련' },
+    /* 아이콘은 **`CategoryData.ts` 의 `TRAINING_TYPES` 와 같아야 한다** — 같은 결정이 두 목록에 적혀 있다
+       (못: `test/trainingTypeIconsAgree.test.ts`). (116) 에서 `party-popper`(🎉) 를 걷었다: 자리를 채워 둔
+       값이 두 앱 숙제 카드에 그대로 나갔고, 네 갈래 중 **가장 많이 쓰이는** 갈래라 목록이 폭죽밭이었다. */
+    { key: 'LISTEN_IN_NOISE', label: '소음 하 문장 듣기', icon: 'audio-lines', desc: '소음 환경 속 문장 이해 훈련' },
     { key: 'SHORT_STORY', label: '짧은 이야기 듣기', icon: 'message-square', desc: '짧은 이야기 + 4문제' },
     { key: 'LONG_STORY', label: '긴 이야기 듣기', icon: 'message-square-text', desc: '긴 이야기 심화 훈련' },
     { key: 'ORDERING_SENTENCE', label: '문장 순서화 하기', icon: 'align-start-vertical', desc: '순서 배열 훈련' },

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

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

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

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