@ihabdevteam/core 0.203.0 → 0.205.0

package/dist/ihabdevteam-core.d.ts

@@ -1626,7 +1626,7 @@ export declare function copyText(text: string): Promise<boolean>;
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.203.0";
+export declare const CORE_VERSION = "0.205.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -10326,7 +10326,7 @@ export declare interface WordSearchResultWord {
  */
 export declare function WordTable({ title, titleIcon, disc, className, orientation, contentTypes, cutLine, showOutline, showDivLine, items, editCells, count, activeCell, onActivateCell, onRemoveCell, onRemoveItem, onReorder, renderCellAction, showFillerAdd, contentRef, buttonSize, pageNumber, pageNumberPosition, fitHeight, scoring, marks, onMarkClick, scoreIndexOffset, }: WordTableProps): JSX.Element;
 
-export declare function WordTableBlock({ title, titleIcon, disc, items, onSaveComplete, onLoad, onRemoveItem, onReset, resetLabel, saveButtonLabel, secondarySaveButtonLabel, onReorder, showCellCount, onAddItem, className, renderSavePopup, renderWordSearch, hideControls, saveOnly, tableName, nameValue, onNameChange, descriptionValue, onDescriptionChange, namePlaceholder, descriptionPlaceholder, existingNames, editingName, onCancel, initialItemsPerPage, renderCellAction }: WordTableBlockProps): JSX.Element;
+export declare function WordTableBlock({ title, titleIcon, disc, items, onSaveComplete, onLoad, onRemoveItem, onReset, resetLabel, saveButtonLabel, secondarySaveButtonLabel, onReorder, showCellCount, onAddItem, className, renderSavePopup, renderWordSearch, hideControls, saveOnly, tableName, nameValue, onNameChange, descriptionValue, onDescriptionChange, namePlaceholder, descriptionPlaceholder, existingNames, editingName, onCancel, initialItemsPerPage, renderCellAction, actionsLeftExtra }: WordTableBlockProps): JSX.Element;
 
 /** @public */
 export declare interface WordTableBlockProps {
@@ -10421,6 +10421,25 @@ export declare interface WordTableBlockProps {
      * **표시 모드에만 간다** — 편집 모드(칸을 손으로 채우는 꼴)에는 얹을 항목이 없다.
      */
     renderCellAction?: (index: number, item: WordSearchResultItem) => ReactNode;
+    /**
+     * **액션 줄 왼쪽 무리에 부르는 쪽이 덧붙이는 것** — '모두 선택 해제' 다음, '불러오기' 앞에 선다.
+     *
+     * 그 줄 왼쪽은 **표를 손보는 단추들**이고 뒤쪽(불러오기 · 새 창으로 보기)은 **표를 드나드는
+     * 단추들**이다. 덧붙는 것이 앞 무리에 드는 것은 그 까닭이다 — '모두 다른 단어로' 처럼 표
+     * 내용을 바꾸는 단추가 '표를 나가는' 단추들 사이에 끼면 무리가 안 읽힌다(말귀 요청 ㉕,
+     * 2026-09-28). `onReset` 을 안 주면 맨 앞에 선다.
+     *
+     * **동작이 아니라 그릴 것을 받는다.** 화면마다 무엇을 얹을지 다르고(한쪽은 '모두 다른 단어로',
+     * 다른 쪽은 '모두 다른 대립쌍으로'), 코어가 아는 것은 **어디에 놓느냐**뿐이다. 코어가 세우는
+     * 단추와 같아 보이려면 `<Button size={40} type="bar">` 로 지으면 된다.
+     *
+     * `saveOnly` 에서는 안 그린다 — 그때 이 줄 왼쪽은 통째로 빈다.
+     *
+     * 이 자리가 나기 전에는 앱이 `.word-table-block__actions-left` 를 찾아 포털로 얹고 CSS
+     * `order` 로 차례를 맞추고 있었다. 남의 마디에 얹는 것이라 **코어가 class 이름이나 마디를
+     * 바꾸면 조용히 어긋난다** — 그 길을 닫으려고 낸 자리다.
+     */
+    actionsLeftExtra?: ReactNode;
 }
 
 /**

package/dist/packages/core/src/components/Word/WordTableBlock.css

@@ -13,6 +13,16 @@
     justify-content: space-between;
     align-items: center;
     gap: var(--spacing-xs);
+    /* 모자라면 아랫줄로 내린다 — 안 그러면 오른쪽 무리가 판 밖으로 밀려 **'저장하기' 가 잘린다**
+       (실측 2026-09-28: 판 오른끝 947px 인데 저장하기 오른끝이 1078px 이었다). 왼쪽 무리가
+       늘 수 있게 되면서(`actionsLeftExtra`) 닿기 쉬워졌다. 넉넉하면 아무것도 안 바뀐다. */
+    flex-wrap: wrap;
+}
+
+/* 아랫줄로 내려가도 주 단추는 **오른쪽 끝**에 선다 — 사람이 '저장하기' 를 찾는 자리다.
+   한 줄에 다 설 때는 `space-between` 이 이미 하는 일이라 아무 일도 안 한다. */
+.word-table-block__actions-right {
+    margin-left: auto;
 }
 
 .word-table-block__actions-left,
@@ -31,6 +41,11 @@
     display: grid;
     grid-template-columns: repeat(2, 1fr);
   }
+  /* 세로로 세울 때는 `margin-left: auto` 를 거둔다 — 가로가 곧 엇축이라 그 자동 여백이
+     `align-items: stretch` 를 이겨, 오른쪽 무리만 제 속 너비로 쪼그라든다. */
+  .word-table-block__actions-right {
+    margin-left: 0;
+  }
   /* min-width 해제 — !important 불필요: 이 결합 선택자(2클래스)가 버튼 사이즈 클래스
      (.button40--bar 등, 1클래스)보다 특이도가 이미 높아 소스 순서와 무관하게 우선 적용됨.
      (minWidth prop을 인라인으로 넘기는 경우는 여기 해당 없음) */

package/dist/packages/core/src/components/Word/WordTableBlock.d.ts

@@ -1,4 +1,4 @@
 import './WordTableBlock.css';
 import type { WordTableBlockProps } from './wordTableBlockTypes';
 export type { WordEntry, WordTableBlockProps } from './wordTableBlockTypes';
-export default function WordTableBlock({ title, titleIcon, disc, items, onSaveComplete, onLoad, onRemoveItem, onReset, resetLabel, saveButtonLabel, secondarySaveButtonLabel, onReorder, showCellCount, onAddItem, className, renderSavePopup, renderWordSearch, hideControls, saveOnly, tableName, nameValue, onNameChange, descriptionValue, onDescriptionChange, namePlaceholder, descriptionPlaceholder, existingNames, editingName, onCancel, initialItemsPerPage, renderCellAction }: WordTableBlockProps): import("react").JSX.Element;
+export default function WordTableBlock({ title, titleIcon, disc, items, onSaveComplete, onLoad, onRemoveItem, onReset, resetLabel, saveButtonLabel, secondarySaveButtonLabel, onReorder, showCellCount, onAddItem, className, renderSavePopup, renderWordSearch, hideControls, saveOnly, tableName, nameValue, onNameChange, descriptionValue, onDescriptionChange, namePlaceholder, descriptionPlaceholder, existingNames, editingName, onCancel, initialItemsPerPage, renderCellAction, actionsLeftExtra }: WordTableBlockProps): import("react").JSX.Element;

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

@@ -45,7 +45,7 @@ function 겹치지않는id(list) {
         return id === it.id ? it : { ...it, id };
     });
 }
-export default function WordTableBlock({ title, titleIcon, disc, items, onSaveComplete, onLoad, onRemoveItem, onReset, resetLabel, saveButtonLabel, secondarySaveButtonLabel, onReorder, showCellCount, onAddItem, className, renderSavePopup, renderWordSearch, hideControls, saveOnly, tableName, nameValue, onNameChange, descriptionValue, onDescriptionChange, namePlaceholder, descriptionPlaceholder, existingNames, editingName, onCancel, initialItemsPerPage, renderCellAction }) {
+export default function WordTableBlock({ title, titleIcon, disc, items, onSaveComplete, onLoad, onRemoveItem, onReset, resetLabel, saveButtonLabel, secondarySaveButtonLabel, onReorder, showCellCount, onAddItem, className, renderSavePopup, renderWordSearch, hideControls, saveOnly, tableName, nameValue, onNameChange, descriptionValue, onDescriptionChange, namePlaceholder, descriptionPlaceholder, existingNames, editingName, onCancel, initialItemsPerPage, renderCellAction, actionsLeftExtra }) {
     const { t } = useTranslation();
     const resolvedResetLabel = resetLabel ?? t('wordPrint.clearAllSelection', '모두 선택 해제');
     const isEditable = items === undefined;
@@ -341,5 +341,5 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
                                             e.preventDefault();
                                             onDescriptionChange?.(descriptionPlaceholder ?? '');
                                         }
-                                    } }) })] }))] }), !hideControls && (_jsxs("div", { className: "word-table-block__actions", children: [_jsxs("div", { className: "word-table-block__actions-left", children: [!saveOnly && onReset && (_jsx(Button, { htmlType: "button", size: 40, type: "bar", label: resolvedResetLabel, onClick: onReset })), !saveOnly && onLoad && (_jsx(Button, { htmlType: "button", size: 40, type: "bar", label: t('wordTable.load', '불러오기'), onClick: onLoad })), !saveOnly && _jsx(Button, { htmlType: "button", size: 40, type: "bar", label: t('wordTable.openNewWindow', '새 창으로 보기'), onClick: handleOpenNewWindow })] }), _jsxs("div", { className: "word-table-block__actions-right", children: [onCancel && _jsx(Button, { htmlType: "button", size: "56", type: "bar", label: t('common.cancel', '취소'), onClick: onCancel }), !saveOnly && _jsx(Button, { htmlType: "button", size: "56", type: "bar", label: t('wordTable.print', '인쇄하기'), onClick: handlePrint }), secondarySaveButtonLabel && (_jsx(Button, { htmlType: "button", size: "56", type: "bar", label: secondarySaveButtonLabel, onClick: () => inlineNameFields ? openSaveAsPopup() : handleSave(true), disabled: noItems, onDisabledClick: () => { showWarning(t('wordTable.emptyItems', '단어를 1개 이상 추가해주세요.')); } })), _jsx(Button, { htmlType: "button", size: "56", type: "bar", variant: "main", label: saveButtonLabel ?? t('wordTable.saveButton', '저장하기'), onClick: () => handleSave(false), disabled: mainSaveDisabled, onDisabledClick: handleMainDisabledClick })] })] })), _jsx(Toast, { message: toastMessage, type: toastType, onClose: clearToast })] }));
+                                    } }) })] }))] }), !hideControls && (_jsxs("div", { className: "word-table-block__actions", children: [_jsxs("div", { className: "word-table-block__actions-left", children: [!saveOnly && onReset && (_jsx(Button, { htmlType: "button", size: 40, type: "bar", label: resolvedResetLabel, onClick: onReset })), !saveOnly && actionsLeftExtra, !saveOnly && onLoad && (_jsx(Button, { htmlType: "button", size: 40, type: "bar", label: t('wordTable.load', '불러오기'), onClick: onLoad })), !saveOnly && _jsx(Button, { htmlType: "button", size: 40, type: "bar", label: t('wordTable.openNewWindow', '새 창으로 보기'), onClick: handleOpenNewWindow })] }), _jsxs("div", { className: "word-table-block__actions-right", children: [onCancel && _jsx(Button, { htmlType: "button", size: "56", type: "bar", label: t('common.cancel', '취소'), onClick: onCancel }), !saveOnly && _jsx(Button, { htmlType: "button", size: "56", type: "bar", label: t('wordTable.print', '인쇄하기'), onClick: handlePrint }), secondarySaveButtonLabel && (_jsx(Button, { htmlType: "button", size: "56", type: "bar", label: secondarySaveButtonLabel, onClick: () => inlineNameFields ? openSaveAsPopup() : handleSave(true), disabled: noItems, onDisabledClick: () => { showWarning(t('wordTable.emptyItems', '단어를 1개 이상 추가해주세요.')); } })), _jsx(Button, { htmlType: "button", size: "56", type: "bar", variant: "main", label: saveButtonLabel ?? t('wordTable.saveButton', '저장하기'), onClick: () => handleSave(false), disabled: mainSaveDisabled, onDisabledClick: handleMainDisabledClick })] })] })), _jsx(Toast, { message: toastMessage, type: toastType, onClose: clearToast })] }));
 }

package/dist/packages/core/src/components/Word/wordTableBlockTypes.d.ts

@@ -107,6 +107,25 @@ export interface WordTableBlockProps {
      * **표시 모드에만 간다** — 편집 모드(칸을 손으로 채우는 꼴)에는 얹을 항목이 없다.
      */
     renderCellAction?: (index: number, item: WordSearchResultItem) => ReactNode;
+    /**
+     * **액션 줄 왼쪽 무리에 부르는 쪽이 덧붙이는 것** — '모두 선택 해제' 다음, '불러오기' 앞에 선다.
+     *
+     * 그 줄 왼쪽은 **표를 손보는 단추들**이고 뒤쪽(불러오기 · 새 창으로 보기)은 **표를 드나드는
+     * 단추들**이다. 덧붙는 것이 앞 무리에 드는 것은 그 까닭이다 — '모두 다른 단어로' 처럼 표
+     * 내용을 바꾸는 단추가 '표를 나가는' 단추들 사이에 끼면 무리가 안 읽힌다(말귀 요청 ㉕,
+     * 2026-09-28). `onReset` 을 안 주면 맨 앞에 선다.
+     *
+     * **동작이 아니라 그릴 것을 받는다.** 화면마다 무엇을 얹을지 다르고(한쪽은 '모두 다른 단어로',
+     * 다른 쪽은 '모두 다른 대립쌍으로'), 코어가 아는 것은 **어디에 놓느냐**뿐이다. 코어가 세우는
+     * 단추와 같아 보이려면 `<Button size={40} type="bar">` 로 지으면 된다.
+     *
+     * `saveOnly` 에서는 안 그린다 — 그때 이 줄 왼쪽은 통째로 빈다.
+     *
+     * 이 자리가 나기 전에는 앱이 `.word-table-block__actions-left` 를 찾아 포털로 얹고 CSS
+     * `order` 로 차례를 맞추고 있었다. 남의 마디에 얹는 것이라 **코어가 class 이름이나 마디를
+     * 바꾸면 조용히 어긋난다** — 그 길을 닫으려고 낸 자리다.
+     */
+    actionsLeftExtra?: ReactNode;
 }
 export declare const CELL_COUNTS: number[];
 /** 표시(인쇄) 모드에서 선택 가능한 "페이지당 개수"(단어/대립쌍 수) — 이 값 그대로 페이지당 칸 수가 된다 */

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

@@ -323,6 +323,9 @@ function searchPairsCore(selectedList, words, debug, enforcePosition, phonemic =
         const parsed = Number.parseInt(g ?? '', 10);
         return Number.isFinite(parsed) ? parsed : 99;
     };
+    /* 묶음마다 '어느 자리를 비운 열쇠인가'(비운자리)를 함께 든다 — 견주기 전에 그 자리만 보고 거르기 위해서다.
+       열쇠 글에서 `*` 가 든 토막의 자리가 곧 그 자리이고, `*` 는 encodeWild 로만 들어가므로
+       한 묶음의 낱말은 모두 같은 자리를 비운 것이다. 분해한 음절도 함께 든다(견줄 때마다 다시 분해하지 않게). */
     const groups = new Map();
     /* 표기가 같아도 뜻마다 칸이 하나다 — 판정은 대표로 한 번만 하고 결과에서 뜻을 펼친다 */
     const { 대표들, 뜻들 } = 뜻묶기(words);
@@ -336,28 +339,57 @@ function searchPairsCore(selectedList, words, debug, enforcePosition, phonemic =
         const syls = syllables;
         for (let p = 0; p < syls.length; p++) {
             const key = makeKeyForPosition(syls, p);
-            if (!groups.has(key))
-                groups.set(key, []);
-            groups.get(key).push(entry);
+            let 묶음 = groups.get(key);
+            if (!묶음) {
+                묶음 = { 비운자리: p, 낱말들: [] };
+                groups.set(key, 묶음);
+            }
+            묶음.낱말들.push({ entry, syls });
         }
     }
     const results = [];
-    const seenPairs = new Set();
     const rejectCounts = createRejectCounter();
     const rejectSamples = [];
     let comparedPairs = 0;
-    for (const group of groups.values()) {
-        if (group.length < 2)
+    for (const { 비운자리, 낱말들 } of groups.values()) {
+        if (낱말들.length < 2)
             continue;
-        for (let i = 0; i < group.length; i++) {
-            for (let j = i + 1; j < group.length; j++) {
-                const w1 = group[i];
-                const w2 = group[j];
-                const dedupKey = w1.word < w2.word ? `${w1.word}|${w2.word}` : `${w2.word}|${w1.word}`;
-                if (seenPairs.has(dedupKey))
+        for (let i = 0; i < 낱말들.length; i++) {
+            for (let j = i + 1; j < 낱말들.length; j++) {
+                const w1 = 낱말들[i].entry;
+                const w2 = 낱말들[j].entry;
+                /* 같은 표기가 발음만 다르게 두 번 들어온 자료(김밥[김밥]·김밥[김빱])는 짝으로 세지 않는다 —
+                   칸 둘의 이름이 같은 '김밥/김밥' 쌍이 된다. 견준 쌍을 다 기억하던 전에는 이것이
+                   덤으로 막히고 있었다(같은 표기면 열쇠가 하나라 한 번만 지나갔다). */
+                if (w1.word === w2.word)
                     continue;
-                seenPairs.add(dedupKey);
+                /* **견준 쌍을 기억하지 않는다.** 전에는 모든 쌍을 `Set` 에 담아 겹침을 걸렀는데, 그 수가
+                   낱말 수의 제곱이라 자바스크립트 `Set` 상한(2^24)에 닿아 6,200 낱말에서 화면이 통째로
+                   넘어졌다(말귀 요청 ㉔, 2026-09-28). 기억하지 않아도 되는 까닭:
+        
+                   한 묶음 안의 두 낱말은 비운 자리 밖이 모두 같다. 그러니 다른 데가 정확히 한 군데인
+                   쌍 — 곧 최소대립쌍이 될 수 있는 쌍 — 은 비운 자리가 바로 그 자리인 묶음 **하나에만**
+                   든다(다른 자리를 비운 묶음은 그 자리가 같기를 요구하므로 둘 다 들 수 없다). 그래서
+                   한 번씩만 지나간다. 두 번 지나가는 쌍은 발음이 아주 같은 쌍뿐이고, 그것은 아래
+                   `no_difference` 로 떨어져 결과에 못 든다.
+        
+                   남은 것은 '한 군데만 다른가' 를 쌍 문자열·발음 분해 전에 여기서 재는 일이다 —
+                   analyzeMinimalPair 와 같은 잣대(SECTION_KEYS)를 그 한 자리에만 쓴다. 포함 검색
+                   (searchWordsByPhonemes)이 전부터 하던 것과 같은 걸름이다. */
+                const s1 = 낱말들[i].syls[비운자리];
+                const s2 = 낱말들[j].syls[비운자리];
+                let 다른칸수 = 0;
+                for (const sec of SECTION_KEYS)
+                    if (s1[sec] !== s2[sec])
+                        다른칸수 += 1;
                 comparedPairs += 1;
+                if (다른칸수 !== 1) {
+                    const reason = 다른칸수 === 0 ? 'no_difference' : 'multiple_differences';
+                    rejectCounts[reason] += 1;
+                    if (debug && rejectSamples.length < 20)
+                        rejectSamples.push({ id: `${w1.word}|${w2.word}`, reason });
+                    continue;
+                }
                 const pairId = `${w1.word}|${w2.word}`;
                 const analysis = analyzeMinimalPair(cleanPron(w1.pronunciation), cleanPron(w2.pronunciation), phonemic);
                 if (analysis.ok && enforcePosition !== undefined && analysis.diff.idx !== enforcePosition)

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

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

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

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