@ihabdevteam/core 0.347.0 → 0.349.0

package/dist/ihabdevteam-core.d.ts

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

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

@@ -27,7 +27,7 @@ import { useWaveReady } from './useWaveReady';
 import { useObjectUrls } from './useObjectUrls';
 import { useAnchorRect } from './useAnchorRect';
 import { useProgressTicker } from './useProgressTicker';
-import { nextTrackIndex, shouldIgnorePause, buildSegments, totalDurationOf, normalizeSources } from './audioPlaybackRules';
+import { nextTrackIndex, shouldIgnorePause, buildSegments, totalDurationOf, normalizeSources, needsReload } from './audioPlaybackRules';
 /** @public */
 export default function TrainingStepAudioPlayer({ btnLabel, soundSrc, bucketPath, onDone, disabled = false, ttsText = null, className, showSoundWaveForm = true, showNoiseWaveForm = true, leadInMs = 0, tailMs = 0 }) {
     const { t } = useTranslation();
@@ -312,6 +312,18 @@ export default function TrainingStepAudioPlayer({ btnLabel, soundSrc, bucketPath
      * (`test/audioPlaybackRateSurvivesLoad.test.tsx` 가 `load()` 자리 수를 센다).
      */
     const loadSound = useCallback((a, src) => {
+        /* **이미 들고 있는 소리는 다시 받지 않는다**(말귀 청 (311), 2026-10-19).
+           `src` 를 걸고 `load()` 를 부르면 새 요청이다. 폰에서 그것이 침묵이 되고, 하나만
+           실패해도 *"소스를 가져오지 못했다"* 가 떴다 — 한 낱말에 `load()` 가 넷이었고
+           되풀이마다 하나씩 더 붙었다. 까닭은 다시 듣기가 **같은 주소**를 또 걸었던 것이다. */
+        if (!needsReload(a, src)) {
+            try {
+                a.currentTime = 0;
+            }
+            catch (e) { }
+            applyPlaybackRate(a);
+            return;
+        }
         a.src = src;
         applyPlaybackRate(a); // defaultPlaybackRate 를 먼저 세워 둔다 — load() 가 그것으로 되돌린다
         a.load();

package/dist/packages/core/src/components/Training/audioPlaybackRules.d.ts

@@ -138,3 +138,20 @@ export interface NormalizedSource {
  * 이 판단에 닿으려면 네트워크와 오디오 요소가 먼저 필요했다.
  */
 export declare function normalizeSources(soundSrc: unknown, bucketPath: string | null | undefined, resolvePath: (code: string, bucketHint?: string | null) => string | null): NormalizedSource[];
+/**
+ * **같은 소리를 다시 받아야 하나** — 말귀 청 (311), 2026-10-19.
+ *
+ * `src` 를 걸고 `load()` 를 부르면 **새 요청**이다. 로컬에서는 안 보이지만 느린 망(폰)에서는
+ * 그만큼 **침묵**이 되고, 그중 하나만 실패해도 *"소스를 가져오지 못했다"* 가 뜬다.
+ * 말귀가 폰 폭에서 `HTMLMediaElement` 의 `src`·`load()`·`play()` 를 가로채 재니 **한
+ * 낱말(0.77초)을 한 번 듣는 동안 같은 파일에 `load()` 가 넷**이었고, **되풀이마다 하나씩 더**
+ * 붙었다(다시 듣기가 같은 주소를 또 걸었다).
+ *
+ * 이미 그 주소를 들고 있고 **길이까지 알고 있으면**(`readyState >= HAVE_METADATA`) 다시 받을
+ * 까닭이 없다 — `currentTime = 0` 뒤 `play()` 면 된다.
+ *
+ * **주소는 풀어서 견준다.** 부르는 쪽은 상대 주소를 줄 수 있고 `currentSrc` 는 늘 절대
+ * 주소라, 글자로 견주면 **같은 파일을 늘 다르다고 본다**(그러면 이 셈이 아무것도 안 아낀다).
+ * 서명 주소는 받을 때마다 조각이 달라지는데, 그때는 **참으로 다른 주소**라 다시 받는 것이 맞다.
+ */
+export declare function needsReload(el: Pick<HTMLMediaElement, 'currentSrc' | 'src' | 'readyState'>, src: string): boolean;

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

@@ -161,3 +161,45 @@ export function normalizeSources(soundSrc, bucketPath, resolvePath) {
     }
     return out;
 }
+/* ── 아래는 **왜 `audioWaits` 가 아니라 여기인가** ──
+   처음에 `audioWaits.ts` 에 넣었다가 **시험 95개가 빨개졌다.** 그 모듈은 **열두 시험이
+   공장 꼴로 흉내** 낸다(`vi.mock(... , () => ({ measureAudioDuration, waitForCanPlay }))`) —
+   공장은 자기가 쓰는 이름만 내보내므로, 이름을 하나 더하면 그 열둘에서 `undefined` 가 되어
+   던진다. **코드는 맞았고 흉내가 빈약해서 난 거짓 빨강**이다.
+   이 파일은 흉내 내는 시험이 **0 곳**이고 순수 규칙이 사는 자리다. 받아 오는 몫이 없는
+   판단은 여기 둔다 — 그러면 다음에 규칙을 더해도 그 열둘이 안 깨진다. */
+/**
+ * **같은 소리를 다시 받아야 하나** — 말귀 청 (311), 2026-10-19.
+ *
+ * `src` 를 걸고 `load()` 를 부르면 **새 요청**이다. 로컬에서는 안 보이지만 느린 망(폰)에서는
+ * 그만큼 **침묵**이 되고, 그중 하나만 실패해도 *"소스를 가져오지 못했다"* 가 뜬다.
+ * 말귀가 폰 폭에서 `HTMLMediaElement` 의 `src`·`load()`·`play()` 를 가로채 재니 **한
+ * 낱말(0.77초)을 한 번 듣는 동안 같은 파일에 `load()` 가 넷**이었고, **되풀이마다 하나씩 더**
+ * 붙었다(다시 듣기가 같은 주소를 또 걸었다).
+ *
+ * 이미 그 주소를 들고 있고 **길이까지 알고 있으면**(`readyState >= HAVE_METADATA`) 다시 받을
+ * 까닭이 없다 — `currentTime = 0` 뒤 `play()` 면 된다.
+ *
+ * **주소는 풀어서 견준다.** 부르는 쪽은 상대 주소를 줄 수 있고 `currentSrc` 는 늘 절대
+ * 주소라, 글자로 견주면 **같은 파일을 늘 다르다고 본다**(그러면 이 셈이 아무것도 안 아낀다).
+ * 서명 주소는 받을 때마다 조각이 달라지는데, 그때는 **참으로 다른 주소**라 다시 받는 것이 맞다.
+ */
+export function needsReload(el, src) {
+    if (!src)
+        return true;
+    if (el.readyState < 1 /* HAVE_METADATA */)
+        return true;
+    const have = el.currentSrc || el.src;
+    if (!have)
+        return true;
+    return resolveSoundUrl(have) !== resolveSoundUrl(src);
+}
+/** 주소를 절대 꼴로 — 못 풀면 글자 그대로(시험·서버 자리에서 `location` 이 없을 수 있다) */
+function resolveSoundUrl(u) {
+    try {
+        return new URL(u, typeof location === 'undefined' ? 'http://localhost/' : location.href).href;
+    }
+    catch {
+        return u;
+    }
+}