@ihabdevteam/core 0.293.0 → 0.295.0

package/dist/ihabdevteam-core.d.ts

@@ -1651,7 +1651,7 @@ export declare function copyText(text: string): Promise<boolean>;
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.293.0";
+export declare const CORE_VERSION = "0.295.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -10483,6 +10483,45 @@ export declare interface WordFilterSnapshot {
     wordTypeFilter?: string[];
 }
 
+/**
+ * @public **자리(어두·어중·어말)를 음절이 아니라 자음에 매긴다** — 말귀 요청 (93), 2026-10-06.
+ *
+ * `wordHasSyllableMatching` 의 위치 제약은 **음절 색인**으로 가른다(0번=어두 · 마지막=어말 ·
+ * 그 사이=어중). 그러면 **2음절 낱말에는 어중이 아예 없다** — `선물` 의 ㄴ받침·ㅁ초성을
+ * 뽑을 길이 없어 검색이 자료의 일부에 못 닿았다(말귀 두 화면이 2음절 이하면 어중 단추를
+ * 잠가 두고 있었다).
+ *
+ * 임상에서 쓰는 모델은 자리를 **자음에만** 매긴다(김동민 팀장·사공정희 선생, 2026-10-06):
+ *
+ *     선물 → ㅅ 어두초성 · ㄴ 어중종성 · ㅁ 어중초성 · ㄹ 어말종성
+ *     아기 → ㄱ 어중초성   (어두초성 없음 — `ㅇ` 은 음가가 없다 · 어말종성 없음)
+ *
+ *     어두 = 첫 음절의 **초성**(`ㅇ` 이면 **없는 것**으로 본다)
+ *     어말 = 마지막 음절의 **받침**(없으면 없는 것)
+ *     어중 = 그 밖의 **모든 초성·종성** — **2음절에도 생긴다**
+ *     중성(모음)에는 자리를 **안 매긴다** — 그래서 이 함수는 `jung` 을 안 받는다
+ *
+ * **`mid` 에서 `cho` 와 `jong` 을 둘 다 주면 둘 다 있어야 한다**(AND, 사용자 결정). `선물`
+ * 처럼 **받침+다음 초성**이 맞물리는 자음동화 꼴을 잡으려는 것이다. 다만 **붙어 있어야
+ * 하는 것은 아니다** — 낱말 어디에든 하나씩 있으면 된다. 하나만 주면 그것만 본다.
+ *
+ * `wordHasSyllableMatching` 은 **그대로 둔다** — 위치가 `무관` 일 때는 초성·중성·종성을
+ * **한 음절 안에서** 묶어 보는 것이 맞다(`ㄱ+ㅏ+ㅇ` = `강`). 두 함수는 묻는 것이 다르다.
+ *
+ * > **`mid` 에 `jongNone` 을 주는 길은 아직 쓰는 자리가 없다**(말귀 확인, 2026-10-06).
+ * > 단어표에서 종성 `없음` 은 *낱말 전체가 열린 음절*이라는 뜻으로 쓰여(`wordHasNoCoda`),
+ * > 자리를 고르는 물음과 섞인다. 그래도 **뜻을 정해 두고 못으로 박아 둔다** — 안 정해 두면
+ * > 나중에 쓰는 사람이 제 짐작으로 쓰고, 그 짐작이 여기 셈과 다를 수 있다.
+ * > 정한 뜻: **어중에 받침 없는 음절이 하나라도 있나**(마지막 음절은 어말이라 빼고 센다).
+ */
+export declare function wordHasConsonantAt(word: string, parts: {
+    cho?: string[] | null;
+    jong?: string[] | null;
+    jongNone?: boolean;
+}, position: 'head' | 'mid' | 'tail', 
+/** 종성을 무엇으로 견줄지 — `wordHasSyllableMatching` 과 같다(`JongMatch` 참고) */
+jongMatch?: JongMatch): boolean;
+
 /** @public 단어의 모든 한글 음절에 종성(받침)이 없는지 (열린 음절로만 구성) */
 export declare function wordHasNoCoda(word: string): boolean;
 

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

@@ -93,6 +93,44 @@ export declare function wordHasSyllableMatching(word: string, parts: {
 /** 종성을 무엇으로 견줄지 — 기본은 **글자 그대로**(`'glyph'`). 받침 **소리**로 모으려면 `'phoneme'`(`JongMatch` 참고).
  *  발음 입력 화면은 넘기는 낱말 자체가 표준발음이라 겹받침이 안 나온다 — 기본 그대로 두면 된다. */
 jongMatch?: JongMatch): boolean;
+/**
+ * @public **자리(어두·어중·어말)를 음절이 아니라 자음에 매긴다** — 말귀 요청 (93), 2026-10-06.
+ *
+ * `wordHasSyllableMatching` 의 위치 제약은 **음절 색인**으로 가른다(0번=어두 · 마지막=어말 ·
+ * 그 사이=어중). 그러면 **2음절 낱말에는 어중이 아예 없다** — `선물` 의 ㄴ받침·ㅁ초성을
+ * 뽑을 길이 없어 검색이 자료의 일부에 못 닿았다(말귀 두 화면이 2음절 이하면 어중 단추를
+ * 잠가 두고 있었다).
+ *
+ * 임상에서 쓰는 모델은 자리를 **자음에만** 매긴다(김동민 팀장·사공정희 선생, 2026-10-06):
+ *
+ *     선물 → ㅅ 어두초성 · ㄴ 어중종성 · ㅁ 어중초성 · ㄹ 어말종성
+ *     아기 → ㄱ 어중초성   (어두초성 없음 — `ㅇ` 은 음가가 없다 · 어말종성 없음)
+ *
+ *     어두 = 첫 음절의 **초성**(`ㅇ` 이면 **없는 것**으로 본다)
+ *     어말 = 마지막 음절의 **받침**(없으면 없는 것)
+ *     어중 = 그 밖의 **모든 초성·종성** — **2음절에도 생긴다**
+ *     중성(모음)에는 자리를 **안 매긴다** — 그래서 이 함수는 `jung` 을 안 받는다
+ *
+ * **`mid` 에서 `cho` 와 `jong` 을 둘 다 주면 둘 다 있어야 한다**(AND, 사용자 결정). `선물`
+ * 처럼 **받침+다음 초성**이 맞물리는 자음동화 꼴을 잡으려는 것이다. 다만 **붙어 있어야
+ * 하는 것은 아니다** — 낱말 어디에든 하나씩 있으면 된다. 하나만 주면 그것만 본다.
+ *
+ * `wordHasSyllableMatching` 은 **그대로 둔다** — 위치가 `무관` 일 때는 초성·중성·종성을
+ * **한 음절 안에서** 묶어 보는 것이 맞다(`ㄱ+ㅏ+ㅇ` = `강`). 두 함수는 묻는 것이 다르다.
+ *
+ * > **`mid` 에 `jongNone` 을 주는 길은 아직 쓰는 자리가 없다**(말귀 확인, 2026-10-06).
+ * > 단어표에서 종성 `없음` 은 *낱말 전체가 열린 음절*이라는 뜻으로 쓰여(`wordHasNoCoda`),
+ * > 자리를 고르는 물음과 섞인다. 그래도 **뜻을 정해 두고 못으로 박아 둔다** — 안 정해 두면
+ * > 나중에 쓰는 사람이 제 짐작으로 쓰고, 그 짐작이 여기 셈과 다를 수 있다.
+ * > 정한 뜻: **어중에 받침 없는 음절이 하나라도 있나**(마지막 음절은 어말이라 빼고 센다).
+ */
+export declare function wordHasConsonantAt(word: string, parts: {
+    cho?: string[] | null;
+    jong?: string[] | null;
+    jongNone?: boolean;
+}, position: 'head' | 'mid' | 'tail', 
+/** 종성을 무엇으로 견줄지 — `wordHasSyllableMatching` 과 같다(`JongMatch` 참고) */
+jongMatch?: JongMatch): boolean;
 /**
  * @public 문자열이 음절 패턴 DSL 문법인지 — 쉼표(,) 포함 여부로 판별한다.
  * 일반 단어 검색어엔 쉼표가 쓰이지 않으므로 충돌 없이 자동 분기할 수 있다.

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

@@ -337,6 +337,78 @@ jongMatch = 'glyph') {
             return true;
     return false;
 }
+/**
+ * @public **자리(어두·어중·어말)를 음절이 아니라 자음에 매긴다** — 말귀 요청 (93), 2026-10-06.
+ *
+ * `wordHasSyllableMatching` 의 위치 제약은 **음절 색인**으로 가른다(0번=어두 · 마지막=어말 ·
+ * 그 사이=어중). 그러면 **2음절 낱말에는 어중이 아예 없다** — `선물` 의 ㄴ받침·ㅁ초성을
+ * 뽑을 길이 없어 검색이 자료의 일부에 못 닿았다(말귀 두 화면이 2음절 이하면 어중 단추를
+ * 잠가 두고 있었다).
+ *
+ * 임상에서 쓰는 모델은 자리를 **자음에만** 매긴다(김동민 팀장·사공정희 선생, 2026-10-06):
+ *
+ *     선물 → ㅅ 어두초성 · ㄴ 어중종성 · ㅁ 어중초성 · ㄹ 어말종성
+ *     아기 → ㄱ 어중초성   (어두초성 없음 — `ㅇ` 은 음가가 없다 · 어말종성 없음)
+ *
+ *     어두 = 첫 음절의 **초성**(`ㅇ` 이면 **없는 것**으로 본다)
+ *     어말 = 마지막 음절의 **받침**(없으면 없는 것)
+ *     어중 = 그 밖의 **모든 초성·종성** — **2음절에도 생긴다**
+ *     중성(모음)에는 자리를 **안 매긴다** — 그래서 이 함수는 `jung` 을 안 받는다
+ *
+ * **`mid` 에서 `cho` 와 `jong` 을 둘 다 주면 둘 다 있어야 한다**(AND, 사용자 결정). `선물`
+ * 처럼 **받침+다음 초성**이 맞물리는 자음동화 꼴을 잡으려는 것이다. 다만 **붙어 있어야
+ * 하는 것은 아니다** — 낱말 어디에든 하나씩 있으면 된다. 하나만 주면 그것만 본다.
+ *
+ * `wordHasSyllableMatching` 은 **그대로 둔다** — 위치가 `무관` 일 때는 초성·중성·종성을
+ * **한 음절 안에서** 묶어 보는 것이 맞다(`ㄱ+ㅏ+ㅇ` = `강`). 두 함수는 묻는 것이 다르다.
+ *
+ * > **`mid` 에 `jongNone` 을 주는 길은 아직 쓰는 자리가 없다**(말귀 확인, 2026-10-06).
+ * > 단어표에서 종성 `없음` 은 *낱말 전체가 열린 음절*이라는 뜻으로 쓰여(`wordHasNoCoda`),
+ * > 자리를 고르는 물음과 섞인다. 그래도 **뜻을 정해 두고 못으로 박아 둔다** — 안 정해 두면
+ * > 나중에 쓰는 사람이 제 짐작으로 쓰고, 그 짐작이 여기 셈과 다를 수 있다.
+ * > 정한 뜻: **어중에 받침 없는 음절이 하나라도 있나**(마지막 음절은 어말이라 빼고 센다).
+ */
+export function wordHasConsonantAt(word, parts, position, 
+/** 종성을 무엇으로 견줄지 — `wordHasSyllableMatching` 과 같다(`JongMatch` 참고) */
+jongMatch = 'glyph') {
+    if (!word)
+        return false;
+    const 음절 = [...word].map(parseSyllable).filter((s) => !!s);
+    if (음절.length === 0)
+        return false;
+    const 끝 = 음절.length - 1;
+    if (position === 'head') {
+        /* 어두는 **첫 음절의 초성**뿐이다. `ㅇ` 은 음가가 없어 자리를 안 가진다 —
+           `아기` 의 어두초성은 **없다**(`cho: ['ㅇ']` 로 물으면 거짓). */
+        if (!parts.cho)
+            return false;
+        const c = CHOSEONG[음절[0].cho];
+        return c !== 'ㅇ' && parts.cho.includes(c);
+    }
+    if (position === 'tail') {
+        /* 어말은 **마지막 받침**뿐이다. 받침이 없으면 자리가 없다. */
+        if (parts.jongNone)
+            return 음절[끝].jong === 0;
+        if (!parts.jong)
+            return false;
+        return syllableJongMatches(음절[끝], parts.jong, jongMatch);
+    }
+    /* 어중 — 첫 초성과 마지막 종성을 **뺀** 나머지 자음 전부. 2음절 `선물` 이면
+       ㄴ(0번 종성) · ㅁ(1번 초성) 둘이 어중이다. */
+    const 초성맞나 = !parts.cho || 음절.some((s, i) => {
+        if (i === 0)
+            return false; // 첫 초성은 어두다
+        const c = CHOSEONG[s.cho];
+        return c !== 'ㅇ' && parts.cho.includes(c); // 음가 없는 ㅇ 은 자리를 안 가진다
+    });
+    const 종성맞나 = parts.jongNone
+        ? 음절.some((s, i) => i !== 끝 && s.jong === 0)
+        : !parts.jong || 음절.some((s, i) => i !== 끝 && syllableJongMatches(s, parts.jong, jongMatch));
+    /* 둘 다 줬으면 **둘 다** 있어야 한다(AND) — 하나만 줬으면 그쪽만 참이면 된다 */
+    if (!parts.cho && !parts.jong && !parts.jongNone)
+        return false;
+    return 초성맞나 && 종성맞나;
+}
 /**
  * @public 문자열이 음절 패턴 DSL 문법인지 — 쉼표(,) 포함 여부로 판별한다.
  * 일반 단어 검색어엔 쉼표가 쓰이지 않으므로 충돌 없이 자동 분기할 수 있다.

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

@@ -122,15 +122,35 @@ position) {
             return s != null && selParts.every(part => selSets[part].has(PART_ARR[part][s[part]]));
         };
         for (const pw of words) {
-            // 위치 제약이 있으면 그 자리(어두=0, 어말=L-1, 어중=중간)에서 매칭하는 음절을, 없으면 첫 매칭 음절을 대립 대상으로.
+            /* 위치 제약이 있으면 그 자리에서 매칭하는 음절을, 없으면 첫 매칭 음절을 대립 대상으로.
+               **자리는 음절이 아니라 자음에 매긴다**(말귀 요청 (94), 2026-10-07 — (93) 의 자매다).
+      
+               전에는 어중을 `k ∈ 1..L-2` 로 봤다. 그러면 **2음절에는 어중이 한 자리도 없어**
+               `가마`·`거미` 의 ㅁ 초성으로 묶음이 **0 개** 나왔다(말귀 실측: 어중+초성 ㅁ → 0 묶음,
+               같은 조건의 어두는 37 묶음). 검색 쪽은 0.294.0 의 `wordHasConsonantAt` 으로 고쳤는데
+               **묶음 짓는 쪽이 안 따라와** 정답 풀에 서른 남짓 남아도 짝이 안 섰다.
+      
+               어중은 **첫 초성과 마지막 받침만 빼면 나머지 자음 전부**다. 그래서 고른 성분에 따라
+               범위가 달라진다:
+      
+                   어중 + 초성만        k ∈ 1..L-1   2음절 둘째 음절이 든다(`가마` 의 `마`)
+                   어중 + 종성만        k ∈ 0..L-2   첫 음절 받침이 든다(`선물` 의 `선`)
+                   어중 + 초성 + 종성   k ∈ 1..L-2   전과 같다 — 아래 까닭
+      
+               **초성·종성을 함께 고르면 한 음절 안에서 둘 다** 봐야 한다. 검색(`wordHasConsonantAt`)
+               은 둘이 다른 음절에 흩어져도 참이지만(AND, 자음동화 꼴을 잡으려고), **대립은 갈릴
+               음절이 하나 있어야** 성립한다 — 가릴 자리(`pos`)가 하나이기 때문이다. 묻는 것이
+               다르므로 셈도 다르다. */
             let i;
             if (position === 'head')
                 i = matchesAt(pw, 0) ? 0 : -1;
             else if (position === 'tail')
                 i = matchesAt(pw, L - 1) ? L - 1 : -1;
             else if (position === 'mid') {
+                const 처음 = selParts.includes('cho') ? 1 : 0; // 첫 초성은 어두다
+                const 마지막 = selParts.includes('jong') ? L - 2 : L - 1; // 마지막 받침은 어말이다
                 i = -1;
-                for (let k = 1; k < L - 1; k++)
+                for (let k = 처음; k <= 마지막; k++)
                     if (matchesAt(pw, k)) {
                         i = k;
                         break;

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

@@ -51,7 +51,7 @@ export type { TrainingCounts, ComputeDailySelectionOptions } from './utils/getTr
 export { TRAINING_TYPES, TOPIC_TYPES, TRAINING_TYPE_I18N_KEY } from './utils/CategoryData';
 export type { WordEntry } from './utils/phonemePairSearch';
 export { CAPABILITY, isValidQuestionWord, hasQuestionWordConstraint, isManualOnlyType } from './utils/wordTrainingRuntime';
-export { wordContainsChoseong, wordContainsJungseong, wordContainsJongseong, wordHasNoCoda, wordHasSyllableMatching, syllableLength } from './utils/koreanSyllable';
+export { wordContainsChoseong, wordContainsJungseong, wordContainsJongseong, wordHasNoCoda, wordHasSyllableMatching, wordHasConsonantAt, syllableLength } from './utils/koreanSyllable';
 export { isSyllablePattern, matchesSyllablePattern, validateSyllableSearchInput, patternToComposition, matchesWordQuery, searchAndRankWords } from './utils/koreanSyllable';
 export { PLAN_FEATURES, PLAN_LIMITS, TIER_RANK, getPlanTier, isManagerTier, type PlanTier, type DataLevel, type PlanFeatures, type PlanLimits, } from './utils/planFeatures';
 export { WORD_SUGGESTION_WEEKLY_QUOTA, WORD_SUGGESTION_ACCOUNT_LIMIT, WORD_SUGGESTION_EXISTING_ERROR, isThisWeekPick, } from './utils/wordSuggestionPolicy';

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

@@ -34,7 +34,7 @@ export { classifyPairDifficulty, firstChoseongOf, toChoseong, isAllChoseong, mat
 export { ensureTrainingDataLoaded, getTrainingPools, loadTrainingData, isTrainingDataLoaded, getDailySelection, computeDailySelection, NOISE_DATAS, SHORT_STORIES, LONG_STORIES, ORDER_SETS } from './utils/getTrainingData';
 export { TRAINING_TYPES, TOPIC_TYPES, TRAINING_TYPE_I18N_KEY } from './utils/CategoryData';
 export { CAPABILITY, isValidQuestionWord, hasQuestionWordConstraint, isManualOnlyType } from './utils/wordTrainingRuntime';
-export { wordContainsChoseong, wordContainsJungseong, wordContainsJongseong, wordHasNoCoda, wordHasSyllableMatching, syllableLength } from './utils/koreanSyllable';
+export { wordContainsChoseong, wordContainsJungseong, wordContainsJongseong, wordHasNoCoda, wordHasSyllableMatching, wordHasConsonantAt, syllableLength } from './utils/koreanSyllable';
 export { isSyllablePattern, matchesSyllablePattern, validateSyllableSearchInput, patternToComposition, matchesWordQuery, searchAndRankWords } from './utils/koreanSyllable';
 /* 요금제 정의 — 회원앱과 말귀어드민이 둘 다 본다. 예전에는 회원앱(src/libs) 안에 있었고
    어드민이 '@app/libs/planFeatures' 로 끌어다 썼는데, 그 한 줄 때문에 어드민이 회원앱

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

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

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

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