@ihabdevteam/core 0.204.0 → 0.206.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.204.0";
+export declare const CORE_VERSION = "0.206.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -2350,7 +2350,7 @@ export declare const FILTER_ALL_VALUE = "\uC804\uCCB4";
 export declare function filterContrastCandidates(answer: string, candidates: Iterable<string>, opts: ContrastFilterOpts): string[];
 
 /** @public */
-export declare function FilterPanel({ title, headerAction, collapsible, defaultCollapsed, collapsed: controlledCollapsed, onCollapsedChange, footer, sections, selected, onSelect, align, sectionAlign, className, }: FilterPanelProps): JSX.Element;
+export declare function FilterPanel({ title, headerAction, headerSummary, collapsible, defaultCollapsed, collapsed: controlledCollapsed, onCollapsedChange, footer, sections, selected, onSelect, align, sectionAlign, className, }: FilterPanelProps): JSX.Element;
 
 /** @public */
 export declare interface FilterPanelItem {
@@ -2372,7 +2372,20 @@ export declare interface FilterPanelItem {
 export declare interface FilterPanelProps {
     title?: ReactNode;
     headerAction?: ReactNode;
-    /** 헤더 우측에 접기/펼치기 토글 버튼을 노출하고, 접으면 본문(섹션)을 숨긴다. */
+    /** 머리 오른쪽에 **접혀도 남는** 자리 — 접힌 판이 제 속을 한 줄로 말하게 한다("등급 전체 · 품사 전체" 같은 요약).
+     *
+     *  `headerAction` 은 펼쳤을 때만 서고 접으면 사라진다(본문을 다루는 단추라 접힌 판에서는 할 일이 없다).
+     *  그래서 접힌 판이 무엇을 담고 있는지 말할 자리가 `title` 밖에 없었고, 소비자가 제목 안에 요약을 싣고
+     *  CSS 로 오른쪽 끝까지 미는 억지를 썼다(말귀 단어표 만들기 2026-09-29).
+     *  **펼치면 그 자리를 `headerAction` 이 쓴다** — 둘은 같은 칸을 번갈아 쓴다.
+     *
+     *  요약 **글월을 짓는 셈은 부르는 쪽** 에 있다. 코어는 자리만 낸다 —
+     *  여러 조각을 넣을 때는 묶음에 `role="group"` 과 한 줄짜리 `aria-label` 을 주고 낱개는 `aria-hidden` 으로
+     *  숨기는 편이 낫다(낭독기가 조각마다 끊어 읽지 않게). */
+    headerSummary?: ReactNode;
+    /** 헤더 우측에 접기/펼치기 토글 버튼을 노출하고, 접으면 본문(섹션)을 숨긴다.
+     *  **머리 줄 전체가 손잡이다** — 머리 아무 데나 눌러도 접힌다(사용자 지시 2026-09-29).
+     *  `headerAction`·`headerSummary` 안의 단추·입력칸을 누른 것은 접지 않는다. */
     collapsible?: boolean;
     /** collapsible일 때 초기 접힘 상태 */
     defaultCollapsed?: boolean;
@@ -7265,6 +7278,16 @@ export declare function TableFilterPanel(props: TableFilterPanelProps): JSX.Elem
 declare interface TableFilterPanelBaseProps {
     /** 패널 제목. 미지정 시 i18n(wordTable.filterTitle) 기본값 사용. */
     title?: ReactNode;
+    /** 머리에 접기 손잡이를 두고 머리 줄 전체를 손잡이로 만든다(`FilterPanel` 의 것). */
+    collapsible?: boolean;
+    /** 처음에 접힌 채로 연다. */
+    defaultCollapsed?: boolean;
+    /** 접힘을 바깥에서 쥔다(controlled). */
+    collapsed?: boolean;
+    /** 접힘이 바뀔 때 알린다. */
+    onCollapsedChange?: (collapsed: boolean) => void;
+    /** 접혀도 남는 머리 오른쪽 자리 — 요약. */
+    headerSummary?: ReactNode;
     className?: string;
 }
 
@@ -10223,7 +10246,7 @@ export declare interface WordRow {
  * [단어 선정] 패널이 원 출처(섹션 구성은 다르지만 같은 셸을 공용).
  * @public
  */
-export declare function WordSearchFilterPanel({ title, sections, selected, onSelect, className }: WordSearchFilterPanelProps): JSX.Element;
+export declare function WordSearchFilterPanel({ title, sections, selected, onSelect, collapsible, defaultCollapsed, collapsed, onCollapsedChange, headerSummary, headerAction, className, }: WordSearchFilterPanelProps): JSX.Element;
 
 /** @public */
 export declare interface WordSearchFilterPanelProps {
@@ -10237,6 +10260,18 @@ export declare interface WordSearchFilterPanelProps {
     sections: FilterPanelSection[];
     selected: Record<string, string | string[]>;
     onSelect: (value: string, sectionLabel: string) => void;
+    /** 머리에 접기 손잡이를 두고 머리 줄 전체를 손잡이로 만든다 — `FilterPanel` 의 것을 그대로 넘긴다. */
+    collapsible?: boolean;
+    /** 처음에 접힌 채로 연다(`collapsible` 과 함께). */
+    defaultCollapsed?: boolean;
+    /** 접힘을 바깥에서 쥔다(controlled). */
+    collapsed?: boolean;
+    /** 접힘이 바뀔 때 알린다. */
+    onCollapsedChange?: (collapsed: boolean) => void;
+    /** 접혀도 남는 머리 오른쪽 자리 — 접힌 판이 제 속을 말하는 요약(`FilterPanel headerSummary`). */
+    headerSummary?: ReactNode;
+    /** 펼쳤을 때 머리 오른쪽에 서는 조작부(`FilterPanel headerAction`). */
+    headerAction?: ReactNode;
     className?: string;
 }
 
@@ -10326,12 +10361,24 @@ 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, filterTitle, filterCollapsible, filterDefaultCollapsed, filterHeaderSummary, 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 {
     title?: ReactNode;
     titleIcon?: string;
+    /** 안쪽 **표 설정 판의 제목** — 안 주면 코어 기본값(`wordTable.filterTitle`, '표 설정').
+     *
+     *  화면마다 달라야 한다(단어표는 '단어표 설정', 대립쌍표는 그 화면 말) — 그래서 코어 기본값을 바꾸는 것으로는 안 되고,
+     *  앱 사전으로 코어 열쇠를 덮는 것은 말귀의 `guards/i18nOwnership` 이 막는다(옳은 규칙이다).
+     *  **부르는 쪽이 제 열쇠로 지어 넘긴다**(말귀 2026-09-29). */
+    filterTitle?: ReactNode;
+    /** 안쪽 표 설정 판을 접을 수 있게 한다 — 머리 줄 전체가 손잡이다. */
+    filterCollapsible?: boolean;
+    /** 그 판을 처음에 접힌 채로 연다(`filterCollapsible` 과 함께). */
+    filterDefaultCollapsed?: boolean;
+    /** 그 판이 접혀도 머리 오른쪽에 남는 자리 — 요약. */
+    filterHeaderSummary?: ReactNode;
     disc?: ReactNode;
     /** 현재 표의 저장된 이름(불러온 표 등). 있으면 인쇄/PDF 저장 시 파일명으로 사용, 없으면 "오늘 날짜 + 단어표/대립쌍표" */
     tableName?: string;
@@ -10421,6 +10468,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/FilterPanel.css

@@ -26,6 +26,18 @@
 .filter-panel--collapsible .filter-panel__header {
     min-height: 60px;
     flex-shrink: 0;
+    /* 머리 줄 전체가 손잡이다(사용자 지시 2026-09-29) — 소비자가 감싸개에 onClick 을 달아
+       머리 안을 눌렀는지 보던 자리다. 안의 단추·입력칸을 누른 것은 컴포넌트가 걸러 낸다. */
+    cursor: pointer;
+}
+/* 접기 손잡이는 **아이콘만** 보인다 — 단추의 바탕·네모 티를 지운다(사용자 지시).
+   포커스 테두리는 남긴다: 키보드 쓰는 사람에게 그 자리가 어디인지 알리는 유일한 표시다. */
+.filter-panel__collapse-toggle,
+.filter-panel__collapse-toggle:hover,
+.filter-panel__collapse-toggle:active {
+    background: transparent;
+    border: none;
+    box-shadow: none;
 }
 .filter-panel--collapsible .filter-panel__sections {
     padding-bottom: var(--spacing-m);

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

@@ -7,7 +7,20 @@ import type { FilterPanelSection } from '../types/filterPanel';
 export interface FilterPanelProps {
     title?: ReactNode;
     headerAction?: ReactNode;
-    /** 헤더 우측에 접기/펼치기 토글 버튼을 노출하고, 접으면 본문(섹션)을 숨긴다. */
+    /** 머리 오른쪽에 **접혀도 남는** 자리 — 접힌 판이 제 속을 한 줄로 말하게 한다("등급 전체 · 품사 전체" 같은 요약).
+     *
+     *  `headerAction` 은 펼쳤을 때만 서고 접으면 사라진다(본문을 다루는 단추라 접힌 판에서는 할 일이 없다).
+     *  그래서 접힌 판이 무엇을 담고 있는지 말할 자리가 `title` 밖에 없었고, 소비자가 제목 안에 요약을 싣고
+     *  CSS 로 오른쪽 끝까지 미는 억지를 썼다(말귀 단어표 만들기 2026-09-29).
+     *  **펼치면 그 자리를 `headerAction` 이 쓴다** — 둘은 같은 칸을 번갈아 쓴다.
+     *
+     *  요약 **글월을 짓는 셈은 부르는 쪽** 에 있다. 코어는 자리만 낸다 —
+     *  여러 조각을 넣을 때는 묶음에 `role="group"` 과 한 줄짜리 `aria-label` 을 주고 낱개는 `aria-hidden` 으로
+     *  숨기는 편이 낫다(낭독기가 조각마다 끊어 읽지 않게). */
+    headerSummary?: ReactNode;
+    /** 헤더 우측에 접기/펼치기 토글 버튼을 노출하고, 접으면 본문(섹션)을 숨긴다.
+     *  **머리 줄 전체가 손잡이다** — 머리 아무 데나 눌러도 접힌다(사용자 지시 2026-09-29).
+     *  `headerAction`·`headerSummary` 안의 단추·입력칸을 누른 것은 접지 않는다. */
     collapsible?: boolean;
     /** collapsible일 때 초기 접힘 상태 */
     defaultCollapsed?: boolean;
@@ -31,4 +44,4 @@ export interface FilterPanelProps {
     className?: string;
 }
 /** @public */
-export default function FilterPanel({ title, headerAction, collapsible, defaultCollapsed, collapsed: controlledCollapsed, onCollapsedChange, footer, sections, selected, onSelect, align, sectionAlign, className, }: FilterPanelProps): import("react").JSX.Element;
+export default function FilterPanel({ title, headerAction, headerSummary, collapsible, defaultCollapsed, collapsed: controlledCollapsed, onCollapsedChange, footer, sections, selected, onSelect, align, sectionAlign, className, }: FilterPanelProps): import("react").JSX.Element;

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

@@ -13,7 +13,7 @@ import { FILTER_ALL_VALUE } from '../types/filterPanel';
 import FilterSectionInfo from './FilterSectionInfo';
 import { devWarnOnce } from '../utils/devWarn';
 /** @public */
-export default function FilterPanel({ title, headerAction, collapsible = false, defaultCollapsed = false, collapsed: controlledCollapsed, onCollapsedChange, footer, sections, selected = {}, onSelect, align, sectionAlign, className, }) {
+export default function FilterPanel({ title, headerAction, headerSummary, collapsible = false, defaultCollapsed = false, collapsed: controlledCollapsed, onCollapsedChange, footer, sections, selected = {}, onSelect, align, sectionAlign, className, }) {
     // align 우선. 없으면 구 prop(sectionAlign) 매핑, 그것도 없으면 inline 기본.
     const isRow = (align ?? (sectionAlign === 'vertical' ? 'newline' : sectionAlign === 'horizontal' ? 'inline' : 'inline')) === 'inline';
     const { t } = useTranslation();
@@ -24,13 +24,28 @@ export default function FilterPanel({ title, headerAction, collapsible = false,
         setInternalCollapsed(next);
         onCollapsedChange?.(next);
     };
-    const showHeader = title || headerAction || collapsible;
-    return (_jsxs("div", { className: cx('filter-panel', collapsible ? 'filter-panel--collapsible' : '', collapsed ? 'filter-panel--collapsed' : '', className), children: [showHeader && (_jsxs("div", { className: "filter-panel__header", children: [_jsxs("div", { className: "filter-panel__title-row", children: [collapsible && (_jsx(Button, { htmlType: "button", size: 40, type: "dot", variant: "transparent-gray", useBorder: false, icon: collapsed ? 'chevron-down' : 'chevron-up', 
+    /* 머리 아무 데나 눌러도 접힌다. 다만 **그 안의 조작부를 누른 것은 아니다** —
+       `headerAction` 의 단추(초기화 등)를 누르면 그 일만 하고 판은 그대로 둔다.
+       chevron 단추는 제 `onClick` 으로 접으므로 여기서 한 번 더 접지 않는다(두 번 접히면 제자리다). */
+    const 머리누름 = (e) => {
+        if (!collapsible)
+            return;
+        const el = e.target;
+        if (!el || typeof el.closest !== 'function')
+            return;
+        if (el.closest('.filter-panel__collapse-toggle'))
+            return;
+        if (el.closest('button, a, input, select, textarea, label, [role="radiogroup"], [role="button"], [role="menu"]'))
+            return;
+        toggleCollapsed();
+    };
+    const showHeader = title || headerAction || headerSummary || collapsible;
+    return (_jsxs("div", { className: cx('filter-panel', collapsible ? 'filter-panel--collapsible' : '', collapsed ? 'filter-panel--collapsed' : '', className), children: [showHeader && (_jsxs("div", { className: "filter-panel__header", onClick: collapsible ? 머리누름 : undefined, children: [_jsxs("div", { className: "filter-panel__title-row", children: [collapsible && (_jsx(Button, { htmlType: "button", size: 40, type: "dot", variant: "transparent-gray", useBorder: false, icon: collapsed ? 'chevron-down' : 'chevron-up', 
                                 /* Button은 aria-label을 자기 ariaLabel prop으로 덮어쓴다({...rest} 뒤에
                                    aria-label={ariaLabelString}을 다시 쓴다) — kebab으로 넘기면 undefined가
                                    되어 이름이 통째로 사라진다. 저장소의 다른 호출부는 모두 ariaLabel을 쓴다.
                                    문구도 이 파일만 한국어로 박혀 있었다(키는 이미 있다). */
-                                ariaLabel: collapsed ? t('common.expand', '펼치기') : t('common.collapse', '접기'), "aria-expanded": !collapsed, onClick: toggleCollapsed })), title && _jsx("span", { className: "filter-panel__title h4", children: title })] }), _jsx("div", { className: "filter-panel__header-actions", children: !collapsed && headerAction })] })), !collapsed && (_jsxs(_Fragment, { children: [_jsx("div", { className: cx('filter-panel__sections', isRow ? 'filter-panel__sections--row' : ''), children: sections.map(section => {
+                                className: "filter-panel__collapse-toggle", ariaLabel: collapsed ? t('common.expand', '펼치기') : t('common.collapse', '접기'), "aria-expanded": !collapsed, onClick: toggleCollapsed })), title && _jsx("span", { className: "filter-panel__title h4", children: title })] }), _jsx("div", { className: "filter-panel__header-actions", children: collapsed ? headerSummary : headerAction })] })), !collapsed && (_jsxs(_Fragment, { children: [_jsx("div", { className: cx('filter-panel__sections', isRow ? 'filter-panel__sections--row' : ''), children: sections.map(section => {
                             const sel = selected[section.label];
                             const isAllSelected = sel === undefined || (Array.isArray(sel) ? sel.length === 0 : false);
                             // section.items에 빈 항목(null/undefined)이 섞여 들어오면 item.value 접근에서

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

@@ -5,6 +5,16 @@ import { type TableSettingsSetters } from './wordTableSettings';
 interface TableFilterPanelBaseProps {
     /** 패널 제목. 미지정 시 i18n(wordTable.filterTitle) 기본값 사용. */
     title?: ReactNode;
+    /** 머리에 접기 손잡이를 두고 머리 줄 전체를 손잡이로 만든다(`FilterPanel` 의 것). */
+    collapsible?: boolean;
+    /** 처음에 접힌 채로 연다. */
+    defaultCollapsed?: boolean;
+    /** 접힘을 바깥에서 쥔다(controlled). */
+    collapsed?: boolean;
+    /** 접힘이 바뀔 때 알린다. */
+    onCollapsedChange?: (collapsed: boolean) => void;
+    /** 접혀도 남는 머리 오른쪽 자리 — 요약. */
+    headerSummary?: ReactNode;
     className?: string;
 }
 /**

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

@@ -16,9 +16,11 @@ function isShellProps(props) {
  */
 export default function TableFilterPanel(props) {
     const { t } = useTranslation();
-    const { title, className } = props;
+    const { title, className, collapsible, defaultCollapsed, collapsed, onCollapsedChange, headerSummary } = props;
+    /* 두 갈래(껍데기 모드·표 설정 모드)가 같은 접기 값을 쓴다 — 한쪽만 넘기면 화면마다 다르게 접힌다 */
+    const 접기 = { collapsible, defaultCollapsed, collapsed, onCollapsedChange, headerSummary };
     if (isShellProps(props)) {
-        return (_jsx(FilterPanel, { className: className, title: title ?? t('wordTable.filterTitle', '표 설정'), sections: props.sections, selected: props.selected, onSelect: props.onSelect, align: "inline" }));
+        return (_jsx(FilterPanel, { className: className, title: title ?? t('wordTable.filterTitle', '표 설정'), sections: props.sections, selected: props.selected, onSelect: props.onSelect, ...접기, align: "inline" }));
     }
     const { hasImage, hasColloquial, contentTypes, orientation, showOutline, cutLine, showDivLine, setters, showCutLine = false, showDivLine2 = false, middleSections = [], extraSelected = {}, onExtraSelect, } = props;
     const sections = [
@@ -38,5 +40,5 @@ export default function TableFilterPanel(props) {
             return;
         onExtraSelect?.(value, sectionLabel);
     };
-    return (_jsx(FilterPanel, { className: className, title: title ?? t('wordTable.filterTitle', '표 설정'), sections: sections, selected: selected, onSelect: onSelect, sectionAlign: "horizontal" }));
+    return (_jsx(FilterPanel, { className: className, title: title ?? t('wordTable.filterTitle', '표 설정'), sections: sections, selected: selected, onSelect: onSelect, ...접기, sectionAlign: "horizontal" }));
 }

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

@@ -12,6 +12,18 @@ export interface WordSearchFilterPanelProps {
     sections: FilterPanelSection[];
     selected: Record<string, string | string[]>;
     onSelect: (value: string, sectionLabel: string) => void;
+    /** 머리에 접기 손잡이를 두고 머리 줄 전체를 손잡이로 만든다 — `FilterPanel` 의 것을 그대로 넘긴다. */
+    collapsible?: boolean;
+    /** 처음에 접힌 채로 연다(`collapsible` 과 함께). */
+    defaultCollapsed?: boolean;
+    /** 접힘을 바깥에서 쥔다(controlled). */
+    collapsed?: boolean;
+    /** 접힘이 바뀔 때 알린다. */
+    onCollapsedChange?: (collapsed: boolean) => void;
+    /** 접혀도 남는 머리 오른쪽 자리 — 접힌 판이 제 속을 말하는 요약(`FilterPanel headerSummary`). */
+    headerSummary?: ReactNode;
+    /** 펼쳤을 때 머리 오른쪽에 서는 조작부(`FilterPanel headerAction`). */
+    headerAction?: ReactNode;
     className?: string;
 }
 /**
@@ -20,4 +32,4 @@ export interface WordSearchFilterPanelProps {
  * [단어 선정] 패널이 원 출처(섹션 구성은 다르지만 같은 셸을 공용).
  * @public
  */
-export default function WordSearchFilterPanel({ title, sections, selected, onSelect, className }: WordSearchFilterPanelProps): import("react").JSX.Element;
+export default function WordSearchFilterPanel({ title, sections, selected, onSelect, collapsible, defaultCollapsed, collapsed, onCollapsedChange, headerSummary, headerAction, className, }: WordSearchFilterPanelProps): import("react").JSX.Element;

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

@@ -2,13 +2,15 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useTranslation } from 'react-i18next';
 import FilterPanel from '../FilterPanel';
+/* 이 넷이 없어서 소비자가 **껍데기를 건너뛰고 `FilterPanel` 을 직접** 쓰고 있었다 —
+   그러면 이 껍데기가 쥔 두 줄(i18n 제목·`align="inline"`)이 소비자 쪽에 복사된다(말귀 2026-09-29). */
 /**
  * 단어를 어떤 조건으로 좁힐지 고르는 FilterPanel 셸(shell) — 등급/품사/어종/음절 수/선택 섹션 자체는
  * 호출부가 구성해 넘긴다. WordSearchPage의 [단어 검색 설정] 패널과 WordTrainingFilterPanels의
  * [단어 선정] 패널이 원 출처(섹션 구성은 다르지만 같은 셸을 공용).
  * @public
  */
-export default function WordSearchFilterPanel({ title, sections, selected, onSelect, className }) {
+export default function WordSearchFilterPanel({ title, sections, selected, onSelect, collapsible, defaultCollapsed, collapsed, onCollapsedChange, headerSummary, headerAction, className, }) {
     const { t } = useTranslation();
-    return (_jsx(FilterPanel, { className: className, title: title ?? t('wordSearch.filterTitle', '단어 검색 설정'), sections: sections, selected: selected, onSelect: onSelect, align: "inline" }));
+    return (_jsx(FilterPanel, { className: className, title: title ?? t('wordSearch.filterTitle', '단어 검색 설정'), sections: sections, selected: selected, onSelect: onSelect, collapsible: collapsible, defaultCollapsed: defaultCollapsed, collapsed: collapsed, onCollapsedChange: onCollapsedChange, headerSummary: headerSummary, headerAction: headerAction, align: "inline" }));
 }

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

@@ -20,7 +20,46 @@
     border: 1px solid var(--color-darkWhite);
     background: var(--color-white);
     border-radius: var(--radius-m);
-    padding: var(--spacing-content);
+    /* 옆에 서는 `FilterPanel` 과 같은 여백(사용자 지시 2026-09-29) */
+    padding: var(--spacing-l);
+    display: flex;
+    flex-direction: column;
+    gap: var(--spacing-m);
+}
+
+/* 상자 안 머리 — `FilterPanel` 의 머리와 같은 결(제목 h4 · 부제 body-3 회색).
+   설명은 한 줄을 통째로 쓴다(제목 옆에 두면 조작부를 다음 줄로 밀어낸다). */
+.word-search-result-block__head {
+    display: flex;
+    align-items: center;
+    flex-wrap: wrap;
+    gap: var(--spacing-xs);
+}
+.word-search-result-block__head-main {
+    display: flex;
+    align-items: center;
+    gap: var(--spacing-xs);
+    min-width: 0;
+}
+.word-search-result-block__head-icon {
+    flex-shrink: 0;
+    color: var(--color-gray);
+}
+.word-search-result-block__title {
+    text-align: left;
+    min-width: 0;
+}
+.word-search-result-block__head-actions {
+    display: flex;
+    align-items: center;
+    gap: var(--spacing-xs);
+    margin-left: auto;
+}
+.word-search-result-block__head-disc {
+    flex: 0 0 100%;
+    min-width: 0;
+    color: var(--color-gray);
+    margin: 0;
 }
 
 /* 박스↔액션 간격은 '내용이 있는' 액션(더보기/선택초기화/인쇄)이 뒤에 올 때만 준다.

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

@@ -7,6 +7,7 @@ import { useTranslation } from 'react-i18next';
 import './WordSearchResultBlock.css';
 import Button from '../Button';
 import Section from '../Section';
+import Icon from '../Icon';
 import Dropdown from '../Dropdown';
 import Pagination from '../Pagination';
 import WordImageTooltip from '../Tooltip/WordImageTooltip';
@@ -158,7 +159,11 @@ export default function WordSearchResultBlock({ titleIcon, resultCount, resultUn
     const discNode = disc ?? (notice
         ? _jsxs(_Fragment, { children: [_jsx("span", { className: "word-search-result-block__notice", children: notice }), discLabel ? _jsx("span", { className: "word-search-result-block__disc", children: discLabel }) : null] })
         : discLabel);
-    return (_jsxs(Section, { type: sectionType, icon: titleIcon, title: titleLabel, action: toolbar, disc: discNode, className: cx('word-search-result-block', className), children: [_jsxs("div", { className: "word-search-result-block__inner", children: [(groups ? groups.length === 0 : items.length === 0) && (_jsxs("div", { className: "word-search-result-block__empty-wrap", children: [_jsx("p", { className: "word-search-result-block__empty body-3", children: t('wordSearch.emptyResult', '검색 결과가 없습니다.') }), emptyHint && _jsx("p", { className: "word-search-result-block__empty-hint body-3", children: emptyHint })] })), groups ? ((pagedGroups ?? []).map((group) => (_jsx("div", { className: "word-search-result-block__group", children: _jsx("div", { className: "word-search-result-block__items", children: group.items.map((item) => {
+    return (
+    /* 제목·부제·조작부가 **상자 안** 에 선다(사용자 지시 2026-09-29) — 전에는 `Section` 의 머리가
+       상자 밖에 서서 제목이 테두리 위에 뜨고 좌우 여백도 옆의 `FilterPanel` 과 달라 보였다.
+       이제 여백(--spacing-l)·제목 등급(h4)·부제(body-3 회색)를 그 판과 맞춘다. */
+    _jsxs(Section, { type: sectionType, className: cx('word-search-result-block', className), children: [_jsxs("div", { className: "word-search-result-block__inner", children: [(titleLabel || toolbar || discNode) && (_jsxs("div", { className: "word-search-result-block__head", children: [_jsxs("div", { className: "word-search-result-block__head-main", children: [titleIcon && _jsx(Icon, { icon: titleIcon, className: "word-search-result-block__head-icon" }), titleLabel && _jsx("span", { className: "word-search-result-block__title h4", children: titleLabel })] }), toolbar && _jsx("div", { className: "word-search-result-block__head-actions", children: toolbar }), discNode && _jsx("div", { className: "word-search-result-block__head-disc body-3", children: discNode })] })), (groups ? groups.length === 0 : items.length === 0) && (_jsxs("div", { className: "word-search-result-block__empty-wrap", children: [_jsx("p", { className: "word-search-result-block__empty body-3", children: t('wordSearch.emptyResult', '검색 결과가 없습니다.') }), emptyHint && _jsx("p", { className: "word-search-result-block__empty-hint body-3", children: emptyHint })] })), groups ? ((pagedGroups ?? []).map((group) => (_jsx("div", { className: "word-search-result-block__group", children: _jsx("div", { className: "word-search-result-block__items", children: group.items.map((item) => {
                                 const isSelected = selected.includes(item.id);
                                 return (_jsx("div", { onMouseEnter: e => {
                                         openHover(e.currentTarget);

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, filterTitle, filterCollapsible, filterDefaultCollapsed, filterHeaderSummary, 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, filterTitle, filterCollapsible, filterDefaultCollapsed, filterHeaderSummary, 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;
@@ -318,7 +318,7 @@ export default function WordTableBlock({ title, titleIcon, disc, items, onSaveCo
                             setActiveCell(null);
                         },
                         onClose: handleCloseWordSearch,
-                    }), !hideControls && (_jsx(TableFilterPanel, { hasImage: hasImage, hasColloquial: hasColloquial, contentTypes: contentTypes, orientation: orientation, showOutline: showOutline, cutLine: cutLine, showDivLine: showDivLine, setters: { setContentTypes, setOrientation, setShowOutline, setCutLine, setShowDivLine }, showCutLine: (pagesEnabled ? itemsPerPage : count) > 1, showDivLine2: hasPairs, middleSections: middleSections, extraSelected: middleSelected, onExtraSelect: handleMiddleSelect })), isPaginated && pages ? (_jsx("div", { className: "word-table-block__pages", children: pages.map((page, i) => (_jsx(WordTable, { orientation: orientation, contentTypes: contentTypes, cutLine: cutLine, showOutline: showOutline, showDivLine: showDivLine, count: itemsPerPage, items: page, onRemoveItem: onRemoveItem, 
+                    }), !hideControls && (_jsx(TableFilterPanel, { title: filterTitle, collapsible: filterCollapsible, defaultCollapsed: filterDefaultCollapsed, headerSummary: filterHeaderSummary, hasImage: hasImage, hasColloquial: hasColloquial, contentTypes: contentTypes, orientation: orientation, showOutline: showOutline, cutLine: cutLine, showDivLine: showDivLine, setters: { setContentTypes, setOrientation, setShowOutline, setCutLine, setShowDivLine }, showCutLine: (pagesEnabled ? itemsPerPage : count) > 1, showDivLine2: hasPairs, middleSections: middleSections, extraSelected: middleSelected, onExtraSelect: handleMiddleSelect })), isPaginated && pages ? (_jsx("div", { className: "word-table-block__pages", children: pages.map((page, i) => (_jsx(WordTable, { orientation: orientation, contentTypes: contentTypes, cutLine: cutLine, showOutline: showOutline, showDivLine: showDivLine, count: itemsPerPage, items: page, onRemoveItem: onRemoveItem, 
                             /* 쪽이 나뉘면 끌어 옮기기가 통째로 꺼졌다(말귀 단어 찾기: 9개부터). 쪽 안의 자리를 전체 자리로 옮겨 넘긴다 —
                                쪽을 넘는 이동은 하지 않는다. */
                             onReorder: onReorder && ((from, to) => onReorder(from + i * itemsPerPage, to + i * itemsPerPage)), 
@@ -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

@@ -18,6 +18,18 @@ export interface WordEntry {
 export interface WordTableBlockProps {
     title?: ReactNode;
     titleIcon?: string;
+    /** 안쪽 **표 설정 판의 제목** — 안 주면 코어 기본값(`wordTable.filterTitle`, '표 설정').
+     *
+     *  화면마다 달라야 한다(단어표는 '단어표 설정', 대립쌍표는 그 화면 말) — 그래서 코어 기본값을 바꾸는 것으로는 안 되고,
+     *  앱 사전으로 코어 열쇠를 덮는 것은 말귀의 `guards/i18nOwnership` 이 막는다(옳은 규칙이다).
+     *  **부르는 쪽이 제 열쇠로 지어 넘긴다**(말귀 2026-09-29). */
+    filterTitle?: ReactNode;
+    /** 안쪽 표 설정 판을 접을 수 있게 한다 — 머리 줄 전체가 손잡이다. */
+    filterCollapsible?: boolean;
+    /** 그 판을 처음에 접힌 채로 연다(`filterCollapsible` 과 함께). */
+    filterDefaultCollapsed?: boolean;
+    /** 그 판이 접혀도 머리 오른쪽에 남는 자리 — 요약. */
+    filterHeaderSummary?: ReactNode;
     disc?: ReactNode;
     /** 현재 표의 저장된 이름(불러온 표 등). 있으면 인쇄/PDF 저장 시 파일명으로 사용, 없으면 "오늘 날짜 + 단어표/대립쌍표" */
     tableName?: string;
@@ -107,6 +119,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/version.d.ts

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

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

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