@ihabdevteam/core 0.9.4 → 0.9.5

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

@@ -8,7 +8,15 @@ export interface ImgStats {
 }
 /**
  * 단어쌍 인덱스와 이미지 캐시 현황을 읽어 반환하는 훅.
- * `words` 의존성이 변경될 때마다 1초 뒤 갱신 (비동기 빌드 완료 대기).
+ * 낱말 목록이 바뀔 때마다, 그리고 1초 뒤 한 번 더 갱신한다(비동기 빌드 완료 대기).
+ *
+ * `words` 는 **바뀌었다는 신호로만** 쓴다 — effect 안에서 내용을 읽지 않는다. 통계는
+ * 모듈 레벨 인덱스에서 나온다. 그래서 길이를 신호로 삼는다. 참조로 삼으면 안 되는데,
+ * 통계를 담는 setState 가 매번 새 객체라 리렌더가 나고, 인라인 배열을 넘긴 호출부에서는
+ * 그 리렌더가 다시 새 배열을 만들어 끝나지 않는다(실측: 힙이 터졌다).
+ *
+ * 길이가 그대로인 채 내용만 통째로 바뀌는 경우는 이 신호로 못 잡는다. 그때는 돌려주는
+ * `refreshStats()` 를 직접 부르면 된다.
  */
 /**
  * @public

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

@@ -4,7 +4,15 @@ import { getPairIndex } from '../utils/wordPairIndex';
 import { getImageExistenceStats } from '../utils/imageConfig';
 /**
  * 단어쌍 인덱스와 이미지 캐시 현황을 읽어 반환하는 훅.
- * `words` 의존성이 변경될 때마다 1초 뒤 갱신 (비동기 빌드 완료 대기).
+ * 낱말 목록이 바뀔 때마다, 그리고 1초 뒤 한 번 더 갱신한다(비동기 빌드 완료 대기).
+ *
+ * `words` 는 **바뀌었다는 신호로만** 쓴다 — effect 안에서 내용을 읽지 않는다. 통계는
+ * 모듈 레벨 인덱스에서 나온다. 그래서 길이를 신호로 삼는다. 참조로 삼으면 안 되는데,
+ * 통계를 담는 setState 가 매번 새 객체라 리렌더가 나고, 인라인 배열을 넘긴 호출부에서는
+ * 그 리렌더가 다시 새 배열을 만들어 끝나지 않는다(실측: 힙이 터졌다).
+ *
+ * 길이가 그대로인 채 내용만 통째로 바뀌는 경우는 이 신호로 못 잡는다. 그때는 돌려주는
+ * `refreshStats()` 를 직접 부르면 된다.
  */
 /**
  * @public
@@ -34,7 +42,7 @@ export function useWordDataStats(words) {
         refreshStats();
         const t = setTimeout(refreshStats, 1000);
         return () => clearTimeout(t);
-    }, [words, refreshStats]);
+    }, [words?.length, refreshStats]);
     /* eslint-enable react-hooks/set-state-in-effect */
     return { pairStats, imgStats, setPairStats, setImgStats, refreshStats };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ihabdevteam/core",
-  "version": "0.9.4",
+  "version": "0.9.5",
   "private": false,
   "main": "dist/ihabdevteam-core.cjs.js",
   "module": "dist/ihabdevteam-core.esm.js",