@ihabdevteam/core 0.179.0 → 0.181.0

package/dist/ihabdevteam-core.d.ts

@@ -389,7 +389,17 @@ export declare interface BarChartProps {
     rate?: boolean;
     /** y축 최대를 데이터 최댓값으로 (10 단위 올림 없이). 가장 큰 막대가 차트 상단에 닿음 */
     tightMax?: boolean;
-    /** 평균 모드 — 합계 대신 경과한 일별 a의 평균을 헤더에 표시(진행률처럼 stacked 라벨). */
+    /** 평균 모드 — 합계 대신 **경과한 날마다의 `a` 평균**을 머리에 보인다(진행률처럼 쌓은 라벨).
+     *
+     *  셈은 이렇다 — **막대는 이 셈에 안 들어간다:**
+     *  - 재는 자료: 주 보기는 그 주의 막대들, **월 보기는 `data[monthRange].daily`**.
+     *    월 보기가 daily 인 것은 주 막대가 **달 경계를 넘기 때문**이다(월요일 시작 7일이라 마지막 주에 다음 달 날이 든다).
+     *  - 분모: 그 자료 중 **`a !== -1` 인 칸 수** — 미래 칸만 뺀다. **기록 없는 날(0)도 분모에 든다.**
+     *  - 분자: 그 칸들의 `a` 가 양수인 것만 더한 값.
+     *  - 그 나눗셈을 `Math.round` 한다.
+     *
+     *  그래서 **막대 평균과는 안 맞는다** — 화면의 막대가 주 단위면 특히 그렇다(말귀 검수 2026-09-18:
+     *  막대 93·22·0·0 인데 머리는 12 였고, 205 / 17(경과일) = 12.06 이 그 수였다). */
     avgMode?: boolean;
     /** 헤더 합계/평균 값 포맷터(예: 분 → 'X시간 Y분'). 지정 시 단위 대신 포맷 문자열 표시. */
     totalFormat?: (n: number) => string;
@@ -1196,10 +1206,6 @@ export declare function ChoiceChips({ subs, selected, onSelect, size }: {
     size?: 'medium' | 'small';
 }): JSX.Element;
 
-/**
- * 한글 음절 분해/조립/거리 계산 유틸
- * @public
- */
 export declare const CHOSEONG: readonly ["ㄱ", "ㄲ", "ㄴ", "ㄷ", "ㄸ", "ㄹ", "ㅁ", "ㅂ", "ㅃ", "ㅅ", "ㅆ", "ㅇ", "ㅈ", "ㅉ", "ㅊ", "ㅋ", "ㅌ", "ㅍ", "ㅎ"];
 
 /**
@@ -1594,7 +1600,7 @@ export declare function copyText(text: string): Promise<boolean>;
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.179.0";
+export declare const CORE_VERSION = "0.181.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -2157,6 +2163,8 @@ export declare interface EmptyStateProps {
         label: string;
         icon?: string;
         onClick: () => void | Promise<unknown>;
+        /** 단추 크기 — 기본 40. 빈 화면이 한 쪽을 통째로 차지하면 48·56 이 어울린다(말귀 고객관리 2026-09-21). */
+        size?: 40 | 48 | 56;
     };
     /** 표 안의 빈 행처럼 좁은 자리에 넣을 때 위아래 여백을 줄인다. */
     compact?: boolean;
@@ -2939,6 +2947,19 @@ export declare function itemCorrectness(r: RawResult): boolean | null;
  */
 export declare function jamoToNamesForSpeech(text: string): string;
 
+/**
+ * @public 종성을 **무엇으로 견줄지.**
+ *
+ * - `'glyph'`(기본) — 쓰인 글자 그대로. 고른 것이 `ㅅ` 이면 받침이 `ㅅ` 인 음절만, `ㅄ` 이면 `ㅄ` 인 음절만.
+ * - `'phoneme'` — **받침 소리**(대표음)로. `ㄱ` 을 고르면 `ㄱ·ㄲ·ㅋ·ㄳ·ㄺ`(박·밖·녘·넋·닭)이 함께 든다.
+ *
+ * 0.181.0 전에는 이름 없는 셋째 규칙이었다 — 원형이 아니면 **겹받침 구성 자모 아무거나** 로 걸렸다.
+ * 그래서 `ㅅ` 에 `값(갑)·넋(넉)·몫(목)·삯(삭)` 이 들고(받침 소리는 ㅂ·ㄱ), `ㄱ` 에는 `넋·닭` 은 드는데
+ * **소리가 같은 `밖·녘` 은 안 들었다** — 한쪽은 넓고 한쪽은 좁았다. 글자도 소리도 아닌 자리였다
+ * (말귀 실측 2026-09-21: 라이브 23,000 낱말 중 겹받침 낱말 308개가 제 받침 소리가 아닌 자모로 한 번씩 더 걸렸다).
+ */
+declare type JongMatch = 'glyph' | 'phoneme';
+
 /** 종성 0번은 받침 없음 */
 export declare const JONGSEONG: readonly ["", "ㄱ", "ㄲ", "ㄳ", "ㄴ", "ㄵ", "ㄶ", "ㄷ", "ㄹ", "ㄺ", "ㄻ", "ㄼ", "ㄽ", "ㄾ", "ㄿ", "ㅀ", "ㅁ", "ㅂ", "ㅄ", "ㅅ", "ㅆ", "ㅇ", "ㅈ", "ㅊ", "ㅋ", "ㅌ", "ㅍ", "ㅎ"];
 
@@ -3788,6 +3809,15 @@ declare type PanelRowChildren = {
     children?: ReactNode;
     align?: 'horizontal' | 'vertical';
     icon?: ReactNode;
+    /** 라벨을 고정 폭으로 두고 **오른쪽이 남는 폭을 채운다** — 그 안의 입력칸도 함께 늘어난다.
+     *
+     *  기본은 오른쪽이 **제 폭만** 차지한다(`flex: 0 0 auto`). 그래서 `TextField`·`Dropdown`·`form-input` 을
+     *  children 으로 넣으면 줄마다 오른쪽 끝이 들쭉날쭉했고, 소비자가 `.panel-row__right { display: flex }` +
+     *  `> * { flex: 1 }` 을 손으로 붙여 왔다 — 같은 한 줄이 말귀 앱 넷 · 어드민 셋에 흩어져 있었다(2026-09-18 전수).
+     *
+     *  `variant='input'`·`'dropdown'` 행은 늘 이 꼴이고, `'text'`·`'custom'` 은 같은 이름의 prop 으로 켠다 —
+     *  children 모드에만 통로가 없었다. 라벨 폭은 `Panel labelWidth` 로 정한다(기본 120px). */
+    useFullWidth?: boolean;
 };
 
 declare type PanelRowCustom = Base & {
@@ -5750,7 +5780,7 @@ export declare interface SearchSummaryProps {
 export declare type SearchSummaryStatus = 'ready' | 'guide' | 'error';
 
 /** @public */
-export declare function Section({ type, title, headingLevel, icon, action, disc, children, className, style }: SectionProps): JSX.Element;
+export declare function Section({ type, title, headingLevel, icon, action, disc, children, inGrid, className, style }: SectionProps): JSX.Element;
 
 /**
  * 섹션·페이지의 머리 — 머리말 · 제목 · 설명.
@@ -5798,6 +5828,17 @@ export declare interface SectionProps {
     action?: ReactNode;
     disc?: ReactNode;
     children?: ReactNode;
+    /**
+     * CSS 격자(한 줄에 여러 칸) 안에 세울 때 켠다 — 아래 여백(`--spacing-page`)을 푼다.
+     *
+     * `Section` 은 **세로로 이어 놓는 것**을 전제로 아래 여백을 두고, 마지막 것만 `:last-child` 로 뺀다.
+     * 격자에 넣으면 그 규칙이 **마지막 칸에만** 걸려 넷 중 셋만 여백을 달고 선다 — 카드 바닥선이 어긋나고
+     * 줄 사이 간격도 달라 보인다(말귀 문장훈련 분석 2×2 실측 2026-09-18: 카드 506 vs 566px).
+     * 격자에서는 칸 사이를 `gap` 이 맡으므로 이 여백은 할 일이 없다.
+     *
+     * `ChartSection inGrid` 와 같은 뜻이다(그쪽은 최소 폭·바닥 맞춤도 함께 푼다).
+     */
+    inGrid?: boolean;
     className?: string;
     style?: CSSProperties;
 }
@@ -9325,8 +9366,8 @@ export declare interface WordComposition {
 export declare function wordContainsChoseong(word: string, jamo: string): boolean;
 
 /** @public 단어가 특정 자모를 종성(coda)으로 포함하는지.
- *  글자 입력: 겹받침 '원형'(ㅄ 등) 정확 매칭. 발음 입력: 겹받침을 구성 자모(ㅂ 등)로 분해해 대표음 매칭. */
-export declare function wordContainsJongseong(word: string, jamo: string): boolean;
+ *  `jongMatch` 로 **글자 그대로**(기본) · **받침 소리**(`'phoneme'`)를 고른다 — `JongMatch` 설명을 본다. */
+export declare function wordContainsJongseong(word: string, jamo: string, jongMatch?: JongMatch): boolean;
 
 /** @public 단어가 특정 모음을 중성(vowel)으로 포함하는지 */
 export declare function wordContainsJungseong(word: string, jamo: string): boolean;
@@ -9433,7 +9474,10 @@ export declare function wordHasSyllableMatching(word: string, parts: {
     jung?: string[] | null;
     jong?: string[] | null;
     jongNone?: boolean;
-}, position?: 'head' | 'mid' | 'tail' | null): boolean;
+}, position?: 'head' | 'mid' | 'tail' | null, 
+/** 종성을 무엇으로 견줄지 — 기본은 **글자 그대로**(`'glyph'`). 받침 **소리**로 모으려면 `'phoneme'`(`JongMatch` 참고).
+ *  발음 입력 화면은 넘기는 낱말 자체가 표준발음이라 겹받침이 안 나온다 — 기본 그대로 두면 된다. */
+jongMatch?: JongMatch): boolean;
 
 /** @public */
 export declare function WordImageTooltip({ words, anchorRect }: WordImageTooltipProps): ReactPortal | null;
@@ -9742,7 +9786,7 @@ export declare type WordTableOrientation = 'landscape' | 'portrait';
  * 표 내부에는 제목을 두지 않아 팝업 헤더 제목과 중복되지 않는다.
  * @public
  */
-export declare function WordTablePopup({ items, words, title, subtitle, emptyText, buttons, renderButtons, renderFooter, footerClassName, printFileName, showSettings, autoPrint, className, onClose, scoring, onScoreChange, printHeader, beforeClose }: WordTablePopupProps): JSX.Element;
+export declare function WordTablePopup({ items, words, title, subtitle, emptyText, buttons, renderButtons, renderFooter, footerClassName, footerLayout, printFileName, showSettings, autoPrint, className, onClose, scoring, onScoreChange, printHeader, beforeClose }: WordTablePopupProps): JSX.Element;
 
 /** @public */
 export declare interface WordTablePopupActions {
@@ -9774,6 +9818,10 @@ export declare interface WordTablePopupProps {
     renderFooter?: (actions: WordTablePopupActions) => PopupProps['footer'];
     /** renderFooter 사용 시 footer 래퍼에 추가할 클래스(정렬·간격 override용). */
     footerClassName?: string;
+    /** 바닥 줄의 가로 배치 — `Popup footerLayout` 을 그대로 내려보낸다(`'center'` 기본 · `'fill'` · `'between'`).
+     *  이 감싸개만 `footerClassName` 을 소비자에게 열고 있어, 여기 없으면 **이 창만** 앱 CSS 로 정렬을 칠해야 했다
+     *  (말귀 단어표 미리보기 창, 2026-09-18). */
+    footerLayout?: PopupProps['footerLayout'];
     /** 지정하면 하단에 "인쇄하기"·"새 창으로 보기" 버튼을 추가하고, 이 값을 PDF 저장 기본 파일명으로 쓴다. */
     printFileName?: string;
     /** 표 위에 '표 설정'(구성·용지 방향·외곽선 등) FilterPanel을 노출한다. */

package/dist/packages/core/src/components/EmptyState.d.ts

@@ -15,6 +15,8 @@ export interface EmptyStateProps {
         label: string;
         icon?: string;
         onClick: () => void | Promise<unknown>;
+        /** 단추 크기 — 기본 40. 빈 화면이 한 쪽을 통째로 차지하면 48·56 이 어울린다(말귀 고객관리 2026-09-21). */
+        size?: 40 | 48 | 56;
     };
     /** 표 안의 빈 행처럼 좁은 자리에 넣을 때 위아래 여백을 줄인다. */
     compact?: boolean;

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

@@ -8,5 +8,8 @@ export default function EmptyState({ icon, emoji, title, message, hint, action,
     const { pending, press } = usePendingPress(action?.onClick);
     return (_jsxs("div", { className: cx('empty-state', compact && 'empty-state--compact', className), children: [emoji && _jsx("span", { className: "empty-state__emoji", children: emoji }), icon && _jsx(Icon, { icon: icon, className: "empty-state__icon" }), title && _jsx("p", { className: "empty-state__title body-2", children: title }), message && _jsx("p", { className: "empty-state__message body-3", children: message }), hint && _jsx("p", { className: "empty-state__hint caption-1", children: hint }), action && (
             // type="button" — 없으면 폼 안에서 누르는 순간 폼이 제출된다
-            _jsxs("button", { type: "button", className: "empty-state__action button button40 button40--bar button--variant-main button--align-center button--shape-rounded", onClick: press, disabled: pending, "aria-busy": pending || undefined, children: [action.icon && _jsx(Icon, { icon: action.icon, className: "button__icon" }), _jsx("span", { className: "button__label button-1", children: action.label })] }))] }));
+            _jsxs("button", { type: "button", 
+                /* 코어 `Button` 을 안 쓰고 클래스를 적는 것은 `aria-busy` 때문이다 — 약속이 끝날 때까지 알린다.
+                   크기만 `action.size` 로 받는다(그 값이 `button{n}`·`button{n}--bar` 두 이름을 함께 정한다). */
+                className: cx('empty-state__action button', `button${action.size ?? 40}`, `button${action.size ?? 40}--bar`, 'button--variant-main button--align-center button--shape-rounded'), onClick: press, disabled: pending, "aria-busy": pending || undefined, children: [action.icon && _jsx(Icon, { icon: action.icon, className: "button__icon" }), _jsx("span", { className: "button__label button-1", children: action.label })] }))] }));
 }

package/dist/packages/core/src/components/Panel.css

@@ -236,6 +236,25 @@
   flex: 1;
   min-width: 0;
 }
+/* 오른쪽 칸이 남은 폭을 채우는 줄(useFullWidth) — **그 안의 것도 함께 늘어난다.**
+   오른쪽 칸만 늘리면 입력칸은 제 폭에 머물러 줄마다 끝이 들쭉날쭉했고, 소비자 일곱 자리가 이
+   `flex: 1` 한 줄을 각자 붙이고 있었다(말귀 앱 넷 · 어드민 셋, 2026-09-18 전수).
+   직계만 본다 — 안쪽 어디까지 늘릴지는 그 입력칸이 정한다(`TextField` 는 제 감싸개를 채운다). */
+.panel-row--fill .panel-row__right {
+  display: flex;
+  align-items: center;
+}
+.panel-row--fill .panel-row__right > * {
+  flex: 1;
+  min-width: 0;
+}
+/* 입력칸을 감싸개 없이 줄에 바로 넣는 자리도 같이 본다(앱이 `.panel-row > .text-field` 를 덮던 꼴) */
+.panel-row--fill > .text-field,
+.panel-row--fill > .dropdown,
+.panel-row--fill > .form-input {
+  flex: 1;
+  min-width: 0;
+}
 .panel-row--clickable {
   cursor: pointer;
   transition: background 0.1s, box-shadow 0.1s;

package/dist/packages/core/src/components/PanelRow.d.ts

@@ -130,6 +130,15 @@ export type PanelRowChildren = {
     children?: ReactNode;
     align?: 'horizontal' | 'vertical';
     icon?: ReactNode;
+    /** 라벨을 고정 폭으로 두고 **오른쪽이 남는 폭을 채운다** — 그 안의 입력칸도 함께 늘어난다.
+     *
+     *  기본은 오른쪽이 **제 폭만** 차지한다(`flex: 0 0 auto`). 그래서 `TextField`·`Dropdown`·`form-input` 을
+     *  children 으로 넣으면 줄마다 오른쪽 끝이 들쭉날쭉했고, 소비자가 `.panel-row__right { display: flex }` +
+     *  `> * { flex: 1 }` 을 손으로 붙여 왔다 — 같은 한 줄이 말귀 앱 넷 · 어드민 셋에 흩어져 있었다(2026-09-18 전수).
+     *
+     *  `variant='input'`·`'dropdown'` 행은 늘 이 꼴이고, `'text'`·`'custom'` 은 같은 이름의 prop 으로 켠다 —
+     *  children 모드에만 통로가 없었다. 라벨 폭은 `Panel labelWidth` 로 정한다(기본 120px). */
+    useFullWidth?: boolean;
 };
 export type PanelRowProps = PanelRowToggle | PanelRowSegmented | PanelRowDropdown | PanelRowButton | PanelRowText | PanelRowInput | PanelRowCustom | PanelRowDescription | PanelRowEmpty | PanelRowLoading | PanelRowChildren;
 export declare function PanelRow(props: PanelRowProps): import("react").JSX.Element;

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

@@ -27,7 +27,7 @@ export function PanelRow(props) {
     const uid = useId();
     // children 기반 하위 호환 모드
     if (!('variant' in props)) {
-        const { label, sub, onClick, children, align = 'horizontal', icon } = props;
+        const { label, sub, onClick, children, align = 'horizontal', icon, useFullWidth = false } = props;
         const handleKeyDown = (e) => {
             if (!onClick)
                 return;
@@ -40,7 +40,7 @@ export function PanelRow(props) {
                 onClick();
             }
         };
-        return (_jsxs("div", { className: cx('panel-row', align === 'vertical' ? 'panel-row--vertical' : '', onClick ? 'panel-row--clickable' : ''), onClick: onClick, onKeyDown: onClick ? handleKeyDown : undefined, role: onClick ? 'button' : undefined, tabIndex: onClick ? 0 : undefined, children: [icon != null && _jsx("div", { className: "panel-row__icon", children: icon }), label != null && (_jsxs("div", { className: "panel-row__left", children: [_jsx("div", { className: "panel-row__label body-3", children: label }), sub && _jsx("div", { className: "panel-row__sub caption-1", children: sub })] })), _jsx("div", { className: "panel-row__right", children: children })] }));
+        return (_jsxs("div", { className: cx('panel-row', align === 'vertical' ? 'panel-row--vertical' : '', useFullWidth ? 'panel-row--label-fixed panel-row--fill' : '', onClick ? 'panel-row--clickable' : ''), onClick: onClick, onKeyDown: onClick ? handleKeyDown : undefined, role: onClick ? 'button' : undefined, tabIndex: onClick ? 0 : undefined, children: [icon != null && _jsx("div", { className: "panel-row__icon", children: icon }), label != null && (_jsxs("div", { className: "panel-row__left", children: [_jsx("div", { className: "panel-row__label body-3", children: label }), sub && _jsx("div", { className: "panel-row__sub caption-1", children: sub })] })), _jsx("div", { className: "panel-row__right", children: children })] }));
     }
     // 설명 전용 행 — 라벨/우측 구조 없이 문단만 렌더
     if (props.variant === 'description') {

package/dist/packages/core/src/components/Section.css

@@ -12,6 +12,10 @@
 
 .section:last-child { padding-bottom: 0; }
 
+/* 격자 칸 안(inGrid) — 아래 여백을 푼다. `:last-child` 는 격자에서 **마지막 칸에만** 걸려
+   넷 중 셋만 여백을 달고 선다(카드 바닥선이 어긋난다). 칸 사이는 격자의 gap 이 맡는다. */
+.section--in-grid { padding-bottom: 0; }
+
 .section {
 }
 

package/dist/packages/core/src/components/Section.d.ts

@@ -15,8 +15,19 @@ export interface SectionProps {
     action?: ReactNode;
     disc?: ReactNode;
     children?: ReactNode;
+    /**
+     * CSS 격자(한 줄에 여러 칸) 안에 세울 때 켠다 — 아래 여백(`--spacing-page`)을 푼다.
+     *
+     * `Section` 은 **세로로 이어 놓는 것**을 전제로 아래 여백을 두고, 마지막 것만 `:last-child` 로 뺀다.
+     * 격자에 넣으면 그 규칙이 **마지막 칸에만** 걸려 넷 중 셋만 여백을 달고 선다 — 카드 바닥선이 어긋나고
+     * 줄 사이 간격도 달라 보인다(말귀 문장훈련 분석 2×2 실측 2026-09-18: 카드 506 vs 566px).
+     * 격자에서는 칸 사이를 `gap` 이 맡으므로 이 여백은 할 일이 없다.
+     *
+     * `ChartSection inGrid` 와 같은 뜻이다(그쪽은 최소 폭·바닥 맞춤도 함께 푼다).
+     */
+    inGrid?: boolean;
     className?: string;
     style?: CSSProperties;
 }
 /** @public */
-export default function Section({ type, title, headingLevel, icon, action, disc, children, className, style }: SectionProps): import("react").JSX.Element;
+export default function Section({ type, title, headingLevel, icon, action, disc, children, inGrid, className, style }: SectionProps): import("react").JSX.Element;

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

@@ -8,7 +8,7 @@ const TITLE_CLASS = {
     popup: 'h5',
 };
 /** @public */
-export default function Section({ type = 'page', title, headingLevel, icon, action, disc, children, className, style }) {
+export default function Section({ type = 'page', title, headingLevel, icon, action, disc, children, inGrid = false, className, style }) {
     const titleClass = TITLE_CLASS[type];
     // action·icon 만 줘도 머리를 그린다 — 제목·설명이 없으면 추가 단추가 조용히 버려졌다
     const hasHeader = title || disc || action || icon;
@@ -16,5 +16,5 @@ export default function Section({ type = 'page', title, headingLevel, icon, acti
        부르는 쪽이 정한다 — 안 주면 예전 그대로 div. 모양은 클래스(h3/h4/h5)가 정하고
        제목 태그의 기본 여백은 .section__title 의 margin:0 이 지운다. */
     const TitleTag = headingLevel ? `h${headingLevel}` : 'div';
-    return (_jsxs("div", { className: cx('section', `section--${type}`, className), style: style, children: [hasHeader && (_jsxs("div", { className: "section__header", children: [_jsxs("div", { className: "section__title-row", children: [icon && (_jsx(Icon, { icon: icon, label: typeof title === 'string' ? title : undefined, className: "section__icon" })), _jsxs("div", { className: "section__title-group", children: [title && _jsx(TitleTag, { className: `section__title ${titleClass}`, children: title }), disc && _jsx("div", { className: "section__disc body-3", children: disc })] })] }), action && _jsx("div", { className: "section__action", children: action })] })), children] }));
+    return (_jsxs("div", { className: cx('section', `section--${type}`, inGrid && 'section--in-grid', className), style: style, children: [hasHeader && (_jsxs("div", { className: "section__header", children: [_jsxs("div", { className: "section__title-row", children: [icon && (_jsx(Icon, { icon: icon, label: typeof title === 'string' ? title : undefined, className: "section__icon" })), _jsxs("div", { className: "section__title-group", children: [title && _jsx(TitleTag, { className: `section__title ${titleClass}`, children: title }), disc && _jsx("div", { className: "section__disc body-3", children: disc })] })] }), action && _jsx("div", { className: "section__action", children: action })] })), children] }));
 }

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

@@ -32,6 +32,10 @@ export interface WordTablePopupProps {
     renderFooter?: (actions: WordTablePopupActions) => PopupProps['footer'];
     /** renderFooter 사용 시 footer 래퍼에 추가할 클래스(정렬·간격 override용). */
     footerClassName?: string;
+    /** 바닥 줄의 가로 배치 — `Popup footerLayout` 을 그대로 내려보낸다(`'center'` 기본 · `'fill'` · `'between'`).
+     *  이 감싸개만 `footerClassName` 을 소비자에게 열고 있어, 여기 없으면 **이 창만** 앱 CSS 로 정렬을 칠해야 했다
+     *  (말귀 단어표 미리보기 창, 2026-09-18). */
+    footerLayout?: PopupProps['footerLayout'];
     /** 지정하면 하단에 "인쇄하기"·"새 창으로 보기" 버튼을 추가하고, 이 값을 PDF 저장 기본 파일명으로 쓴다. */
     printFileName?: string;
     /** 표 위에 '표 설정'(구성·용지 방향·외곽선 등) FilterPanel을 노출한다. */
@@ -58,4 +62,4 @@ export interface WordTablePopupProps {
  * 표 내부에는 제목을 두지 않아 팝업 헤더 제목과 중복되지 않는다.
  * @public
  */
-export default function WordTablePopup({ items, words, title, subtitle, emptyText, buttons, renderButtons, renderFooter, footerClassName, printFileName, showSettings, autoPrint, className, onClose, scoring, onScoreChange, printHeader, beforeClose }: WordTablePopupProps): import("react").JSX.Element;
+export default function WordTablePopup({ items, words, title, subtitle, emptyText, buttons, renderButtons, renderFooter, footerClassName, footerLayout, printFileName, showSettings, autoPrint, className, onClose, scoring, onScoreChange, printHeader, beforeClose }: WordTablePopupProps): import("react").JSX.Element;

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

@@ -19,7 +19,7 @@ import { useToastState } from '../../hooks/useToastState';
  * 표 내부에는 제목을 두지 않아 팝업 헤더 제목과 중복되지 않는다.
  * @public
  */
-export default function WordTablePopup({ items, words, title, subtitle, emptyText, buttons, renderButtons, renderFooter, footerClassName, printFileName, showSettings, autoPrint, className, onClose, scoring = false, onScoreChange, printHeader, beforeClose }) {
+export default function WordTablePopup({ items, words, title, subtitle, emptyText, buttons, renderButtons, renderFooter, footerClassName, footerLayout, printFileName, showSettings, autoPrint, className, onClose, scoring = false, onScoreChange, printHeader, beforeClose }) {
     const { t } = useTranslation();
     // items 우선, 없으면 문자열 words → 한 단어=한 칸으로 매핑
     const tableItems = useMemo(() => {
@@ -115,5 +115,5 @@ export default function WordTablePopup({ items, words, title, subtitle, emptyTex
         }, 100);
         return () => window.clearTimeout(id);
     }, [autoPrint]);
-    return (_jsxs(Popup, { title: title ?? t('keyWords.title', '주요 단어'), subtitle: subtitle, size: "large", className: cx('word-table-popup', className), buttons: footerButtons, footer: customFooter, footerClassName: footerClassName, beforeClose: beforeClose, onClose: onClose, children: [tableItems.length > 0 ? (_jsxs("div", { className: "word-table-popup__body", children: [showSettings && (_jsx(TableFilterPanel, { sections: filterSections, selected: filterSelected, onSelect: handleSelect })), isPaginated ? (_jsx("div", { className: "word-table-popup__pages", children: pages.map((page, i) => (_jsx(WordTable, { items: page, orientation: settings.orientation, contentTypes: settings.contentTypes, cutLine: settings.cutLine, showOutline: settings.showOutline, showDivLine: settings.showDivLine, count: settings.count, contentRef: el => { pageRefs.current[i] = el; }, pageNumber: { current: i + 1, total: pages.length }, pageNumberPosition: pageNumberPosition, scoring: scoring, scoreIndexOffset: pageStart[i], marks: 표에줄채점, onMarkClick: handleMarkClick }, i))) })) : (_jsx("div", { className: "word-table-popup__table", children: _jsx(WordTable, { items: tableItems, orientation: settings.orientation, contentTypes: settings.contentTypes, cutLine: settings.cutLine, showOutline: settings.showOutline, showDivLine: settings.showDivLine, count: settings.count, contentRef: contentRef, fitHeight: true, scoring: scoring, marks: 표에줄채점, onMarkClick: handleMarkClick }) }))] })) : (_jsx("p", { className: "word-table-popup__empty body-3", children: emptyText ?? t('keyWords.empty', '추출된 주요 단어가 없습니다.') })), _jsx(Toast, { message: toastMsg, position: "top", onClose: handleToastClose }, toastKey)] }));
+    return (_jsxs(Popup, { title: title ?? t('keyWords.title', '주요 단어'), subtitle: subtitle, size: "large", className: cx('word-table-popup', className), buttons: footerButtons, footer: customFooter, footerClassName: footerClassName, footerLayout: footerLayout, beforeClose: beforeClose, onClose: onClose, children: [tableItems.length > 0 ? (_jsxs("div", { className: "word-table-popup__body", children: [showSettings && (_jsx(TableFilterPanel, { sections: filterSections, selected: filterSelected, onSelect: handleSelect })), isPaginated ? (_jsx("div", { className: "word-table-popup__pages", children: pages.map((page, i) => (_jsx(WordTable, { items: page, orientation: settings.orientation, contentTypes: settings.contentTypes, cutLine: settings.cutLine, showOutline: settings.showOutline, showDivLine: settings.showDivLine, count: settings.count, contentRef: el => { pageRefs.current[i] = el; }, pageNumber: { current: i + 1, total: pages.length }, pageNumberPosition: pageNumberPosition, scoring: scoring, scoreIndexOffset: pageStart[i], marks: 표에줄채점, onMarkClick: handleMarkClick }, i))) })) : (_jsx("div", { className: "word-table-popup__table", children: _jsx(WordTable, { items: tableItems, orientation: settings.orientation, contentTypes: settings.contentTypes, cutLine: settings.cutLine, showOutline: settings.showOutline, showDivLine: settings.showDivLine, count: settings.count, contentRef: contentRef, fitHeight: true, scoring: scoring, marks: 표에줄채점, onMarkClick: handleMarkClick }) }))] })) : (_jsx("p", { className: "word-table-popup__empty body-3", children: emptyText ?? t('keyWords.empty', '추출된 주요 단어가 없습니다.') })), _jsx(Toast, { message: toastMsg, position: "top", onClose: handleToastClose }, toastKey)] }));
 }

package/dist/packages/core/src/components/barChartTypes.d.ts

@@ -74,7 +74,17 @@ export interface BarChartProps {
     rate?: boolean;
     /** y축 최대를 데이터 최댓값으로 (10 단위 올림 없이). 가장 큰 막대가 차트 상단에 닿음 */
     tightMax?: boolean;
-    /** 평균 모드 — 합계 대신 경과한 일별 a의 평균을 헤더에 표시(진행률처럼 stacked 라벨). */
+    /** 평균 모드 — 합계 대신 **경과한 날마다의 `a` 평균**을 머리에 보인다(진행률처럼 쌓은 라벨).
+     *
+     *  셈은 이렇다 — **막대는 이 셈에 안 들어간다:**
+     *  - 재는 자료: 주 보기는 그 주의 막대들, **월 보기는 `data[monthRange].daily`**.
+     *    월 보기가 daily 인 것은 주 막대가 **달 경계를 넘기 때문**이다(월요일 시작 7일이라 마지막 주에 다음 달 날이 든다).
+     *  - 분모: 그 자료 중 **`a !== -1` 인 칸 수** — 미래 칸만 뺀다. **기록 없는 날(0)도 분모에 든다.**
+     *  - 분자: 그 칸들의 `a` 가 양수인 것만 더한 값.
+     *  - 그 나눗셈을 `Math.round` 한다.
+     *
+     *  그래서 **막대 평균과는 안 맞는다** — 화면의 막대가 주 단위면 특히 그렇다(말귀 검수 2026-09-18:
+     *  막대 93·22·0·0 인데 머리는 12 였고, 205 / 17(경과일) = 12.06 이 그 수였다). */
     avgMode?: boolean;
     /** 헤더 합계/평균 값 포맷터(예: 분 → 'X시간 Y분'). 지정 시 단위 대신 포맷 문자열 표시. */
     totalFormat?: (n: number) => string;

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

@@ -1,8 +1,8 @@
 import type { CompositionPart } from '../utils/koreanSyllable';
 import { type PhonemeGroupItem, type PhoneticFeature } from '../utils/phonemeGroups';
-export declare const FULL_CHOSEONG: ("ㄱ" | "ㄲ" | "ㄴ" | "ㄷ" | "ㄸ" | "ㄹ" | "ㅁ" | "ㅂ" | "ㅃ" | "ㅅ" | "ㅆ" | "ㅇ" | "ㅈ" | "ㅉ" | "ㅊ" | "ㅋ" | "ㅌ" | "ㅍ" | "ㅎ")[];
-export declare const FULL_JUNGSEONG: ("ㅏ" | "ㅐ" | "ㅑ" | "ㅒ" | "ㅓ" | "ㅔ" | "ㅕ" | "ㅖ" | "ㅗ" | "ㅘ" | "ㅙ" | "ㅚ" | "ㅛ" | "ㅜ" | "ㅝ" | "ㅞ" | "ㅟ" | "ㅠ" | "ㅡ" | "ㅢ" | "ㅣ")[];
-export declare const FULL_JONGSEONG: ("ㄱ" | "ㄲ" | "ㄴ" | "ㄷ" | "ㄹ" | "ㅁ" | "ㅂ" | "ㅅ" | "ㅆ" | "ㅇ" | "ㅈ" | "ㅊ" | "ㅋ" | "ㅌ" | "ㅍ" | "ㅎ" | "ㄳ" | "ㄵ" | "ㄶ" | "ㄺ" | "ㄻ" | "ㄼ" | "ㄽ" | "ㄾ" | "ㄿ" | "ㅀ" | "ㅄ")[];
+export declare const FULL_CHOSEONG: ("ㄱ" | "ㄲ" | "ㅋ" | "ㄴ" | "ㄷ" | "ㅅ" | "ㅆ" | "ㅈ" | "ㅊ" | "ㅌ" | "ㅎ" | "ㄹ" | "ㅁ" | "ㅂ" | "ㅍ" | "ㅇ" | "ㄸ" | "ㅃ" | "ㅉ")[];
+export declare const FULL_JUNGSEONG: ("ㅏ" | "ㅓ" | "ㅗ" | "ㅜ" | "ㅣ" | "ㅡ" | "ㅑ" | "ㅕ" | "ㅛ" | "ㅠ" | "ㅐ" | "ㅒ" | "ㅔ" | "ㅖ" | "ㅘ" | "ㅙ" | "ㅚ" | "ㅝ" | "ㅞ" | "ㅟ" | "ㅢ")[];
+export declare const FULL_JONGSEONG: ("ㄱ" | "ㄲ" | "ㅋ" | "ㄳ" | "ㄺ" | "ㄴ" | "ㄵ" | "ㄶ" | "ㄷ" | "ㅅ" | "ㅆ" | "ㅈ" | "ㅊ" | "ㅌ" | "ㅎ" | "ㄹ" | "ㄼ" | "ㄽ" | "ㄾ" | "ㅀ" | "ㅁ" | "ㄻ" | "ㅂ" | "ㅍ" | "ㄿ" | "ㅄ" | "ㅇ")[];
 /** 선택 값(자모 문자열, 병합 버튼은 다자모)을 실제 매칭 자모 배열로 분해. NO_CODA는 빈 배열. */
 export declare const valueToJamos: (v: string) => string[];
 /** 종성 '제외'(받침 없는 단어만) 선택을 나타내는 센티넬 값 */

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

@@ -1,7 +1,3 @@
-/**
- * 한글 음절 분해/조립/거리 계산 유틸
- * @public
- */
 export declare const CHOSEONG: readonly ["ㄱ", "ㄲ", "ㄴ", "ㄷ", "ㄸ", "ㄹ", "ㅁ", "ㅂ", "ㅃ", "ㅅ", "ㅆ", "ㅇ", "ㅈ", "ㅉ", "ㅊ", "ㅋ", "ㅌ", "ㅍ", "ㅎ"];
 export declare const JUNGSEONG: readonly ["ㅏ", "ㅐ", "ㅑ", "ㅒ", "ㅓ", "ㅔ", "ㅕ", "ㅖ", "ㅗ", "ㅘ", "ㅙ", "ㅚ", "ㅛ", "ㅜ", "ㅝ", "ㅞ", "ㅟ", "ㅠ", "ㅡ", "ㅢ", "ㅣ"];
 /** 종성 0번은 받침 없음 */
@@ -63,9 +59,21 @@ export declare function wordContainsPhoneme(word: string, jamo: string): boolean
 export declare function wordContainsChoseong(word: string, jamo: string): boolean;
 /** @public 단어가 특정 모음을 중성(vowel)으로 포함하는지 */
 export declare function wordContainsJungseong(word: string, jamo: string): boolean;
+/**
+ * @public 종성을 **무엇으로 견줄지.**
+ *
+ * - `'glyph'`(기본) — 쓰인 글자 그대로. 고른 것이 `ㅅ` 이면 받침이 `ㅅ` 인 음절만, `ㅄ` 이면 `ㅄ` 인 음절만.
+ * - `'phoneme'` — **받침 소리**(대표음)로. `ㄱ` 을 고르면 `ㄱ·ㄲ·ㅋ·ㄳ·ㄺ`(박·밖·녘·넋·닭)이 함께 든다.
+ *
+ * 0.181.0 전에는 이름 없는 셋째 규칙이었다 — 원형이 아니면 **겹받침 구성 자모 아무거나** 로 걸렸다.
+ * 그래서 `ㅅ` 에 `값(갑)·넋(넉)·몫(목)·삯(삭)` 이 들고(받침 소리는 ㅂ·ㄱ), `ㄱ` 에는 `넋·닭` 은 드는데
+ * **소리가 같은 `밖·녘` 은 안 들었다** — 한쪽은 넓고 한쪽은 좁았다. 글자도 소리도 아닌 자리였다
+ * (말귀 실측 2026-09-21: 라이브 23,000 낱말 중 겹받침 낱말 308개가 제 받침 소리가 아닌 자모로 한 번씩 더 걸렸다).
+ */
+export type JongMatch = 'glyph' | 'phoneme';
 /** @public 단어가 특정 자모를 종성(coda)으로 포함하는지.
- *  글자 입력: 겹받침 '원형'(ㅄ 등) 정확 매칭. 발음 입력: 겹받침을 구성 자모(ㅂ 등)로 분해해 대표음 매칭. */
-export declare function wordContainsJongseong(word: string, jamo: string): boolean;
+ *  `jongMatch` 로 **글자 그대로**(기본) · **받침 소리**(`'phoneme'`)를 고른다 — `JongMatch` 설명을 본다. */
+export declare function wordContainsJongseong(word: string, jamo: string, jongMatch?: JongMatch): boolean;
 /** @public 단어의 한글 음절 개수 (한글 이외 문자는 제외) */
 export declare function syllableLength(word: string): number;
 /** @public 단어의 모든 한글 음절에 종성(받침)이 없는지 (열린 음절로만 구성) */
@@ -81,7 +89,10 @@ export declare function wordHasSyllableMatching(word: string, parts: {
     jung?: string[] | null;
     jong?: string[] | null;
     jongNone?: boolean;
-}, position?: 'head' | 'mid' | 'tail' | null): boolean;
+}, position?: 'head' | 'mid' | 'tail' | null, 
+/** 종성을 무엇으로 견줄지 — 기본은 **글자 그대로**(`'glyph'`). 받침 **소리**로 모으려면 `'phoneme'`(`JongMatch` 참고).
+ *  발음 입력 화면은 넘기는 낱말 자체가 표준발음이라 겹받침이 안 나온다 — 기본 그대로 두면 된다. */
+jongMatch?: JongMatch): boolean;
 /**
  * @public 문자열이 음절 패턴 DSL 문법인지 — 쉼표(,) 포함 여부로 판별한다.
  * 일반 단어 검색어엔 쉼표가 쓰이지 않으므로 충돌 없이 자동 분기할 수 있다.

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

@@ -2,6 +2,7 @@
  * 한글 음절 분해/조립/거리 계산 유틸
  * @public
  */
+import { finalToPhoneme } from './phonemeConvert';
 export const CHOSEONG = ['ㄱ', 'ㄲ', 'ㄴ', 'ㄷ', 'ㄸ', 'ㄹ', 'ㅁ', 'ㅂ', 'ㅃ', 'ㅅ', 'ㅆ', 'ㅇ', 'ㅈ', 'ㅉ', 'ㅊ', 'ㅋ', 'ㅌ', 'ㅍ', 'ㅎ'];
 export const JUNGSEONG = ['ㅏ', 'ㅐ', 'ㅑ', 'ㅒ', 'ㅓ', 'ㅔ', 'ㅕ', 'ㅖ', 'ㅗ', 'ㅘ', 'ㅙ', 'ㅚ', 'ㅛ', 'ㅜ', 'ㅝ', 'ㅞ', 'ㅟ', 'ㅠ', 'ㅡ', 'ㅢ', 'ㅣ'];
 /** 종성 0번은 받침 없음 */
@@ -238,20 +239,24 @@ export function wordContainsJungseong(word, jamo) {
     }
     return false;
 }
+/** 음절의 종성이 고른 자모 하나와 맞는지 — 두 모드의 단일 출처. */
+function jongMatchesJamo(jong, jamo, mode) {
+    const 글자 = JONGSEONG[jong];
+    if (글자 === jamo)
+        return true;
+    return mode === 'phoneme' && finalToPhoneme(글자) === finalToPhoneme(jamo);
+}
 /** @public 단어가 특정 자모를 종성(coda)으로 포함하는지.
- *  글자 입력: 겹받침 '원형'(ㅄ 등) 정확 매칭. 발음 입력: 겹받침을 구성 자모(ㅂ 등)로 분해해 대표음 매칭. */
-export function wordContainsJongseong(word, jamo) {
+ *  `jongMatch` 로 **글자 그대로**(기본) · **받침 소리**(`'phoneme'`)를 고른다 — `JongMatch` 설명을 본다. */
+export function wordContainsJongseong(word, jamo, jongMatch = 'glyph') {
     if (!word || !jamo)
         return false;
     for (const ch of word) {
         const s = parseSyllable(ch);
         if (!s || s.jong <= 0)
             continue;
-        if (JONGSEONG[s.jong] === jamo)
-            return true; // 겹받침 원형 포함 정확 매칭
-        const decomp = JONG_DECOMPOSE[s.jong];
-        if (decomp && decomp.includes(jamo))
-            return true; // 겹받침 구성 자모(대표음) 매칭
+        if (jongMatchesJamo(s.jong, jamo, jongMatch))
+            return true;
     }
     return false;
 }
@@ -280,15 +285,11 @@ export function wordHasNoCoda(word) {
     }
     return sawSyllable;
 }
-/** 한 음절(Syllable)이 주어진 종성 자모 집합 중 하나를 종성으로 갖는지.
- *  글자 입력: 겹받침 원형 정확 매칭. 발음 입력: 겹받침 구성 자모(대표음)도 매칭. */
-function syllableJongMatches(s, jamos) {
+/** 한 음절(Syllable)이 주어진 종성 자모 집합 중 하나를 종성으로 갖는지(`JongMatch` 규칙). */
+function syllableJongMatches(s, jamos, mode) {
     if (s.jong <= 0)
         return false;
-    if (jamos.includes(JONGSEONG[s.jong]))
-        return true;
-    const decomp = JONG_DECOMPOSE[s.jong];
-    return !!decomp && decomp.some(j => jamos.includes(j));
+    return jamos.some(j => jongMatchesJamo(s.jong, j, mode));
 }
 /**
  * @public 단어에 '하나의 음절'이 주어진 초성/중성/종성 제약을 **모두** 만족하는지.
@@ -298,7 +299,10 @@ function syllableJongMatches(s, jamos) {
  */
 export function wordHasSyllableMatching(word, parts, 
 // 위치 제약(선택) — 'head'=어두(첫음절), 'tail'=어말(끝음절), 'mid'=어중(가운데, 3음절+). 미지정=모든 음절.
-position) {
+position, 
+/** 종성을 무엇으로 견줄지 — 기본은 **글자 그대로**(`'glyph'`). 받침 **소리**로 모으려면 `'phoneme'`(`JongMatch` 참고).
+ *  발음 입력 화면은 넘기는 낱말 자체가 표준발음이라 겹받침이 안 나온다 — 기본 그대로 두면 된다. */
+jongMatch = 'glyph') {
     if (!word)
         return false;
     const chars = [...word];
@@ -314,7 +318,7 @@ position) {
             if (s.jong > 0)
                 return false;
         }
-        else if (parts.jong && !syllableJongMatches(s, parts.jong))
+        else if (parts.jong && !syllableJongMatches(s, parts.jong, jongMatch))
             return false;
         return true;
     };

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

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

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

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