@ihabdevteam/core 0.142.0 → 0.144.0

package/dist/ihabdevteam-core.d.ts

@@ -293,7 +293,7 @@ export declare type BadgeType = 'bar' | 'dot';
 /**
  * 막대차트 섹션 — 제목 + 구간 네비게이션(이전/다음 + 드롭다운) + 월/주 토글 + 2계열 막대차트.
  *  - 월(month): 월 드롭다운 + 주별 막대(1주~5주)
- *  - 주(week):  'YYYY년 M월 N째주' 드롭다운 + 그 주의 요일(일~토) 막대
+ *  - 주(week):  'YYYY년 M월 N째주' 드롭다운 + 그 주의 요일(월~일) 막대
  * 원시 렌더링은 내부 BarChartCanvas가 담당한다.
  */
 export declare function BarChart({ size, barWidth, titleKey, data, colorA, colorB, labelAKey, labelBKey, showTotal, totalUnitKey, totalLabelKey, control: controlProp, hideControls, rate, tightMax, avgMode, totalFormat, series, loading, onDetail, inGrid, }: BarChartProps): JSX.Element;
@@ -395,10 +395,6 @@ export declare interface BarChartProps {
 /** 시맨틱 사이즈 — 차트 캔버스 높이·막대 너비 프리셋 */
 export declare type BarChartSize = 'small' | 'medium' | 'large';
 
-/**
- * barChartData.ts
- * BarChart의 순수 데이터 계층 — 날짜→월/주/일 막대 데이터 집계 (React 무관).
- */
 /** 막대 하나의 데이터 — a/b 두 계열. a === -1 이면 미래(데이터 없음)로 표시하지 않음.
  *  parts: 다계열 stacked용 계열별 값(있으면 a는 합계로 사용). */
 export declare interface BarData {
@@ -906,7 +902,9 @@ export declare interface ChartLegendItem {
 /** 글자→발음: 자모를 해당 발음 버튼 값으로. 대응 버튼이 없으면 null(선택 해제). */
 export declare function charToPronValue(part: CompositionPart, jamo: string): string | null;
 
-/** 날짜별 카운트 포인트 — a/b 2계열 또는 parts(다계열 stacked, a는 합계) */
+/** 날짜별 카운트 포인트 — a/b 2계열 또는 parts(다계열 stacked, a는 합계).
+ *  `date` 는 **KST 달력 날짜를 기기 달력 자정 Date 로** 옮긴 것: 시각이면 `parseLocalYmd(toKstYmd(createdAt))`,
+ *  서버가 KST 로 집계한 'YYYY-MM-DD' 면 `parseLocalYmd(log_date)`. */
 export declare interface ChartPoint {
     date: Date;
     a: number;
@@ -1314,6 +1312,18 @@ export declare interface ContrastFilterPanelProps {
     className?: string;
 }
 
+/** @public getControlDateRange 의 결과 — 기간의 첫날 00:00 KST ~ 끝날 23:59:59.999 KST 순간과, 그 두 날의 KST 달력 날짜 */
+export declare interface ControlDateRange {
+    /** 첫날 00:00:00.000 KST 순간 — 서버에 물을 때 `from.toISOString()` */
+    from: Date;
+    /** 끝날 23:59:59.999 KST 순간 */
+    to: Date;
+    /** 첫날 KST 'YYYY-MM-DD' — 이름표·달력 셈은 `parseLocalYmd(fromYmd)` 로(순간 `from` 을 기기 getter 로 읽으면 해외에서 하루 어긋난다) */
+    fromYmd: string;
+    /** 끝날 KST 'YYYY-MM-DD' */
+    toYmd: string;
+}
+
 /** 모드 전환 시 composition의 초성/모음/종성을 대상 모드 값으로 변환. 종성 '없음'(NO_CODA)은 유지. */
 export declare function convertComposition(c: WordComposition, to: 'char' | 'pron', preferredCharJung?: string | null, preferredCharJong?: string | null): WordComposition;
 
@@ -1376,7 +1386,7 @@ export declare function copyText(text: string): Promise<boolean>;
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.142.0";
+export declare const CORE_VERSION = "0.144.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;
@@ -1820,7 +1830,7 @@ export declare interface DraftItem<T> {
 export declare function draftValues<T>(draft: readonly DraftItem<T>[]): T[];
 
 /** @public */
-export declare function Dropdown({ options, value, onChange, placeholder, disabled, block, size, error, className, ariaLabel }: DropdownProps): JSX.Element;
+export declare function Dropdown({ options, value, onChange, placeholder, disabled, block, size, error, className, ariaLabel, ariaDescribedBy }: DropdownProps): JSX.Element;
 
 export declare type DropdownItem = {
     options: {
@@ -1857,6 +1867,8 @@ export declare interface DropdownProps {
     className?: string;
     /** 화면에 보이는 라벨 없이 스크린리더용 이름을 지정할 때 사용 */
     ariaLabel?: string;
+    /** 트리거를 설명할 요소 id(들) — 오류 문구 등. 고른 값은 이것과 함께 설명으로 따로 읽힌다. */
+    ariaDescribedBy?: string;
 }
 
 /**
@@ -2267,11 +2279,13 @@ export declare interface FormatYmdOptions {
 /** @public */
 export declare function getAssetBaseUrl(): string;
 
-/** 현재 컨트롤 선택(주/월)의 날짜 범위 — 상세보기(기간별 리스트)용 */
-export declare function getControlDateRange(control: BarChartControl): {
-    from: Date;
-    to: Date;
-};
+/**
+ * 현재 컨트롤 선택(주/월)의 기간 — 상세보기(기간별 리스트)용. **KST 의 날로 자른다**(해외 기기도 같은 기간).
+ *
+ * @param offset 몇 기간 앞·뒤인가 — `-1` 이면 앞 달 한 달(달력 달 그대로, 30일 앞이 아니다) · 앞 주 한 주.
+ * @public
+ */
+export declare function getControlDateRange(control: BarChartControl, offset?: number): ControlDateRange;
 
 /** @public */
 export declare function getDailySelection(): {
@@ -2383,6 +2397,14 @@ export declare function getSteppedPayload(pageAnswers: unknown, itemIndex: numbe
 /** KST(Asia/Seoul) 기준 오늘 날짜를 'YYYY-MM-DD'로 반환. DB 날짜 비교 기준선으로 사용. */
 export declare function getTodayKst(): string;
 
+/**
+ * KST 오늘을 **기기 달력의 자정 Date** 로 — 연·월·일 칸을 `getFullYear()/getMonth()/getDate()` 로 세는 곳(BarChart)의
+ * '지금'. 칸에 넣는 자료도 같은 모양(`parseLocalYmd(toKstYmd(시각))`)이어야 해외 기기에서도 KST 의 날에 선다.
+ *
+ * @public
+ */
+export declare function getTodayKstDate(): Date;
+
 /**
  * 등록된 주제 카테고리 목록을 반환합니다.
  * configureTrainingCategories() 미호출 시 기본값을 반환합니다.
@@ -2647,6 +2669,14 @@ export declare const JONGSEONG: readonly ["", "ㄱ", "ㄲ", "ㄳ", "ㄴ", "ㄵ",
 
 export declare const JUNGSEONG: readonly ["ㅏ", "ㅐ", "ㅑ", "ㅒ", "ㅓ", "ㅔ", "ㅕ", "ㅖ", "ㅗ", "ㅘ", "ㅙ", "ㅚ", "ㅛ", "ㅜ", "ㅝ", "ㅞ", "ㅟ", "ㅠ", "ㅡ", "ㅢ", "ㅣ"];
 
+/**
+ * KST 달력 날짜(연, 0부터 세는 월, 일)의 **00:00 KST 순간.** 일·월은 넘쳐도 된다(`Date.UTC` 처럼 — 32일은 다음 달 1일).
+ * 서버에 기간을 물을 때(`toISOString()`) 기기 시간대가 아니라 KST 의 하루로 자르려고 쓴다.
+ *
+ * @public
+ */
+export declare function kstStartOfDay(year: number, month0: number, day: number): Date;
+
 /**
  * 칸 번호 → 그때 보인 낱말. 채점과 **함께 저장한다.**
  *
@@ -3543,6 +3573,18 @@ export declare type PanelRowToggle = Base & {
 
 declare type PanelSize = 'small' | 'medium' | 'large';
 
+/**
+ * 'YYYY-MM-DD' 날짜 전용 문자열(예: 서버가 KST 기준으로 집계해 내려주는 log_date)을
+ * 로컬 타임존 자정 Date로 파싱한다. new Date('YYYY-MM-DD')는 UTC 자정으로 해석되어,
+ * UTC보다 서쪽 시간대(예: 미국)에서 getDate()/getMonth() 같은 로컬 getter로 읽으면
+ * 하루 전으로 밀린다 — 차트를 날짜별로 버킷팅할 때 특히 문제가 된다.
+ *
+ * 시각(ISO)에서 KST 의 날을 달력 Date 로 얻으려면 `parseLocalYmd(toKstYmd(시각))`.
+ *
+ * @public
+ */
+export declare function parseLocalYmd(ymd: string): Date;
+
 /**
  * 드롭다운 값을 정렬 상태로 되돌린다.
  *
@@ -4113,7 +4155,7 @@ export declare type PopupOptions = {
 /** @public */
 export declare interface PopupProps {
     title?: ReactNode;
-    /** 제목 아래 보조 설명(부제). title이 있을 때만 렌더된다. */
+    /** 제목 아래 보조 설명(부제). 제목 줄이 그려질 때(useTitle 이고 title·headerActions·onClose 중 하나가 있을 때) 보인다. */
     subtitle?: ReactNode;
     headerActions?: ReactNode;
     children?: ReactNode | ((opts: PopupOptions) => ReactNode);
@@ -6484,6 +6526,8 @@ export declare const toBase64UrlSafe: typeof toStorageName;
 export declare function toChoseong(text: string): string;
 
 /**
+ * 오늘의 **KST** 연·월·일(두 자리 월·일). 방문 폼의 기본 날짜 — 소비자가 이 칸을 KST 벽시계로 읽어 저장하므로, 기기 달력이면
+ * 해외 기기에서 손대지 않고 등록한 방문이 하루 전으로 저장됐다(해외 기기 공식 지원).
  * @public
  */
 export declare const today: () => {
@@ -7296,7 +7340,7 @@ export declare type TrainingPagePopupProps = {
      * 판에 실제로 걸린 값은 `NoiseSettingsStore.applied` 로 받는다.
      */
     noiseOverride?: Partial<CoreNoiseSettings> | ((saved: CoreNoiseSettings) => Partial<CoreNoiseSettings>);
-    /** 훈련 결과 팝업 렌더러 — 없으면 결과 팝업을 표시하지 않음 */
+    /** 훈련 결과 팝업 렌더러 — 없으면 기본 결과 팝업(TrainingResultPopup)을 띄운다 */
     renderResultPopup?: (props: {
         score?: number | null;
         results?: unknown[];
@@ -8715,9 +8759,9 @@ export declare interface WordFilterSnapshot {
     sameStructureOnly: boolean;
     phonemeView: 'char' | 'pron' | 'direct';
     gradeFilter: string[];
-    /** 품사 필터. 없으면(예전에 뜬 스냅샷) 되돌릴 때 지금 값을 그대로 둔다. */
+    /** 품사 필터 — 고정 코드(noun·verb·modifier). 라벨(옛 스냅샷)도 받는다. 없으면 되돌릴 때 지금 값을 그대로 둔다. */
     posFilter?: string[];
-    /** 어종 필터. 없으면(예전에 뜬 스냅샷) 되돌릴 때 지금 값을 그대로 둔다. */
+    /** 어종 필터 — 고정 코드(native·sino·foreign·mixed). 라벨(옛 스냅샷)도 받는다. 없으면 되돌릴 때 지금 값을 그대로 둔다. */
     wordTypeFilter?: string[];
 }
 
@@ -8900,7 +8944,7 @@ export declare interface WordTableBlockProps {
     tableName?: string;
     /** 전달하면 외부 데이터 표시 모드, 없으면 편집 모드 */
     items?: WordSearchResultItem[];
-    /** 전달하면 저장 팝업을 내부에서 열고 확인 후 name·items·description을 전달.
+    /** 전달하면 저장하기가 저장 팝업(`renderSavePopup` 이 그림 — 없으면 아무것도 뜨지 않는다)을 열고 확인 후 name·items·description을 전달.
      *  saveAsNew=true면 '다른 이름으로 저장'(수정 대신 새 표 생성)을 뜻한다. */
     onSaveComplete?: (name: string, items: WordSearchResultItem[], description?: string, saveAsNew?: boolean) => void;
     onLoad?: () => void;
@@ -8926,7 +8970,7 @@ export declare interface WordTableBlockProps {
     editingName?: string;
     /** 지정하면 인쇄하기 왼쪽에 '취소' 버튼을 표시(PagePopup 닫기 등). */
     onCancel?: () => void;
-    /** 전달하면 카드 드래그로 순서 변경 가능 */
+    /** 전달하면 카드 드래그로 순서 변경 가능. 쪽이 나뉘면 같은 쪽 안에서만 옮기며, 자리는 전체 목록 기준이다. */
     onReorder?: (fromIndex: number, toIndex: number) => void;
     /** display 모드에서도 칸 수 조절 허용 */
     showCellCount?: boolean;
@@ -8960,19 +9004,19 @@ export declare interface WordTableBlockProps {
 
 /**
  * @public 단어표를 '문서형' 미리보기 카드로 표현하는 컴포넌트.
- * 내용 썸네일(WordTableThumbnail) + 이름 + 날짜·개수 + (발행 배지 / 더보기 / 스토어 푸터).
+ * 내용 썸네일(WordTableThumbnail) + 이름 + 날짜 + (발행 배지 / 더보기 / 스토어 푸터).
  */
 export declare function WordTableButton({ items, name, description, createdAt, published, publishedLabel, shared, sharedLabel, isNew, publisherName, publishedAt, likeCount, downloadCount, onPublisherClick, selected, onClick, onMore, titleNode, className, }: WordTableButtonProps): JSX.Element;
 
 /** @public */
 export declare interface WordTableButtonProps {
-    /** 단어표 내용(썸네일 미리보기 + 개수) */
+    /** 단어표 내용(썸네일 미리보기) */
     items: WordSearchResultItem[];
     /** 단어표 이름 */
     name: string;
     /** 설명 — 제목 아래 body-3로 표시(있을 때만) */
     description?: string;
-    /** 생성일(ISO) — 메타(날짜)에 표시. 없으면 개수만. */
+    /** 생성일(ISO) — 메타(날짜)에 표시. */
     createdAt?: string;
     /** 스토어 발행 배지 표시 */
     published?: boolean;

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

@@ -49,7 +49,9 @@ export default function Badge(props) {
                    내게** 한다 — 그래야 이벤트의 target·currentTarget 도 실제와 같다. */
                 e.preventDefault();
                 e.currentTarget.click();
-            } : undefined, "aria-label": ariaHidden ? undefined : ariaLabel ?? defaultLabel, "aria-hidden": ariaHidden || undefined, role: onClick ? 'button' : undefined, tabIndex: onClick ? 0 : undefined, children: [number !== undefined && number, number === undefined && dotIcon === 'check' && _jsx(CheckIcon, {}), number === undefined && dotIcon === 'remove' && _jsx(RemoveIcon, {}), number === undefined && dotIcon === 'minus' && _jsx(MinusIcon, {})] }));
+            } : undefined, "aria-label": ariaHidden ? undefined : ariaLabel ?? defaultLabel, "aria-hidden": ariaHidden || undefined, 
+            // 누를 수 없는 점도 이름이 있으면 그림(img)으로 — 역할 없는 span 의 aria-label 은 낭독기가 버려 "선택됨" 이 안 들렸다(bar 와 같게)
+            role: onClick ? 'button' : (ariaHidden ? undefined : 'img'), tabIndex: onClick ? 0 : undefined, children: [number !== undefined && number, number === undefined && dotIcon === 'check' && _jsx(CheckIcon, {}), number === undefined && dotIcon === 'remove' && _jsx(RemoveIcon, {}), number === undefined && dotIcon === 'minus' && _jsx(MinusIcon, {})] }));
     }
     // ── bar (텍스트) ────────────────────────────────────────────────────────
     const { label, children, variant = 'default', fill = 'filled', minWidth, iconLeft, iconRight, color } = props;

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

@@ -10,7 +10,7 @@ import type { BarChartProps } from './barChartTypes';
 /**
  * 막대차트 섹션 — 제목 + 구간 네비게이션(이전/다음 + 드롭다운) + 월/주 토글 + 2계열 막대차트.
  *  - 월(month): 월 드롭다운 + 주별 막대(1주~5주)
- *  - 주(week):  'YYYY년 M월 N째주' 드롭다운 + 그 주의 요일(일~토) 막대
+ *  - 주(week):  'YYYY년 M월 N째주' 드롭다운 + 그 주의 요일(월~일) 막대
  * 원시 렌더링은 내부 BarChartCanvas가 담당한다.
  */
 export default function BarChart({ size, barWidth, titleKey, data, colorA, colorB, labelAKey, labelBKey, showTotal, totalUnitKey, totalLabelKey, control: controlProp, hideControls, rate, tightMax, avgMode, totalFormat, series, loading, onDetail, inGrid, }: BarChartProps): import("react").JSX.Element;

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

@@ -7,6 +7,7 @@ import Dropdown from './Dropdown';
 import SegmentedControl from './SegmentedControl';
 import Button from './Button';
 import Loader from './Loader';
+import { getTodayKstDate } from '../utils/date';
 import DescriptionTooltip from './Tooltip/DescriptionTooltip';
 import ChartSection, { ChartTotal, ChartLegend } from './ChartSection';
 import { firstMondayOfMonth, KO_ORD } from './barChartData';
@@ -142,7 +143,7 @@ function 주의날들(data, monday, now) {
 function barsFromControl(data, control, t, lang) {
     const { period, monthRange, weekRange, weekRanges, DOW } = control;
     const isKo = lang?.startsWith('ko');
-    const now = new Date();
+    const now = getTodayKstDate(); // 칸은 KST 달력 — 오늘·이번 주 표시도 KST 로
     const nowY = now.getFullYear(), nowM = now.getMonth() + 1, nowD = now.getDate();
     if (period === 'month') {
         const md = data[monthRange] ?? { weekly: [], daily: [] };
@@ -197,7 +198,7 @@ const BAR_SIZE_PRESET = {
 /**
  * 막대차트 섹션 — 제목 + 구간 네비게이션(이전/다음 + 드롭다운) + 월/주 토글 + 2계열 막대차트.
  *  - 월(month): 월 드롭다운 + 주별 막대(1주~5주)
- *  - 주(week):  'YYYY년 M월 N째주' 드롭다운 + 그 주의 요일(일~토) 막대
+ *  - 주(week):  'YYYY년 M월 N째주' 드롭다운 + 그 주의 요일(월~일) 막대
  * 원시 렌더링은 내부 BarChartCanvas가 담당한다.
  */
 export default function BarChart({ size = 'medium', barWidth, titleKey, data, colorA, colorB, labelAKey, labelBKey, showTotal = false, totalUnitKey, totalLabelKey, control: controlProp, hideControls = false, rate = false, tightMax = false, avgMode = false, totalFormat, series, loading = false, onDetail, inGrid = false, }) {
@@ -216,7 +217,7 @@ export default function BarChart({ size = 'medium', barWidth, titleKey, data, co
         if (!rate)
             return rawBars;
         const 월 = control.period === 'month' ? control.monthRange.match(/^(\d+)년 (\d+)월$/) : null;
-        const now = new Date();
+        const now = getTodayKstDate();
         return rawBars.map((d, i) => {
             let a = d.a === -1 ? -1 : (d.b > 0 ? Math.round((d.a / d.b) * 100) : 0);
             if (월 && d.a !== -1) {

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

@@ -76,7 +76,11 @@ export default function BottomNav({ items = [], activeKey, onChange, appMode, on
                     badgeCount: it.badgeCount,
                     selected: it.key === activeKey,
                     closeOnSelect: true,
+                    // "…" 로 넘어간 꺼진 항목도 꺼진 채로 — 줄에서는 막히는데 메뉴에서는 골라졌다
+                    disabled: it.state === 'disabled',
                     onClick: () => {
+                        if (it.state === 'disabled')
+                            return;
                         if (it.key && onChange)
                             onChange(it.key);
                         handleCloseMore();

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

@@ -77,5 +77,5 @@ export default function BulkBar({ count, actions, onClear, clearLabel: clearLabe
            단추가 Tab 순서와 낭독기에 남아, 보이지 않는 '선택 해제'·'삭제' 에 포커스가 갔다.
            inert 로 포커스·낭독기에서 함께 뺀다(보이는 모양은 CSS 그대로). aria-hidden 은
            inert 를 모르는 오래된 브라우저를 위한 덧댐이다. */
-        inert: !show || undefined, "aria-hidden": show ? undefined : true, children: [_jsx("span", { ref: contentRef, className: "bulk-bar__count body-2", children: content ?? _jsx("b", { children: t('common.selectedCount', { count }) }) }), max !== undefined && (_jsx(Badge, { size: "small", fill: "soft", variant: "main", label: `${count} / ${max}` })), _jsxs("div", { className: `bulk-bar__actions${stacked ? ' bulk-bar__actions--stacked' : ''}`, children: [_jsx(Button, { htmlType: "button", size: 40, label: clearLabel, onClick: onClear }), actions.map((a, i) => (_jsx(Button, { htmlType: "button", size: 40, variant: a.variant ?? 'default', icon: a.icon, label: a.label, onClick: a.onClick }, i)))] })] }));
+        inert: !show || undefined, "aria-hidden": show ? undefined : true, children: [_jsx("span", { ref: contentRef, className: "bulk-bar__count body-2", role: "status", children: content ?? _jsx("b", { children: t('common.selectedCount', { count }) }) }), max !== undefined && (_jsx(Badge, { size: "small", fill: "soft", variant: "main", label: `${count} / ${max}` })), _jsxs("div", { className: `bulk-bar__actions${stacked ? ' bulk-bar__actions--stacked' : ''}`, children: [_jsx(Button, { htmlType: "button", size: 40, label: clearLabel, onClick: onClear }), actions.map((a, i) => (_jsx(Button, { htmlType: "button", size: 40, variant: a.variant ?? 'default', icon: a.icon, label: a.label, onClick: a.onClick }, i)))] })] }));
 }

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

@@ -91,9 +91,10 @@ export default function Button(props) {
     }, [disabledProp]);
     const isSelected = typeof selected === 'boolean' ? Boolean(selected) : internalSelected;
     // toggleable 또는 controlled selected가 있을 때만 aria-pressed 설정
+    // 그 밖에는 소비자가 넘긴 aria-pressed 를 그대로 둔다(아이콘이 바뀌는 재생/멈춤 단추 등) — 전에는 undefined 로 덮었다
     const ariaPressed = (toggleable || typeof selected === 'boolean')
         ? (isSelected ? 'true' : 'false')
-        : undefined;
+        : rest['aria-pressed'];
     const classes = cx('button', sizeBase, sizeTypeClass, variantClass, alignClass, shapeClass, isSelected ? 'is-selected' : null, !useBG ? 'button--no-bg' : null, tooltipOnly ? 'button--tooltip-only' : null, className);
     const iconClassName = `button__icon button__icon--${iconSize}`;
     const subLabels = Array.isArray(subLabel) ? subLabel : (subLabel !== undefined ? [subLabel] : []);
@@ -107,14 +108,19 @@ export default function Button(props) {
         const hasSub = subLabel !== undefined;
         return (_jsxs("span", { className: `button__label-text${hasSub ? ' button__label-text--has-sub' : ''}`, children: [displayedLabel, count != null && _jsx("span", { className: "button__count", children: count }), hasSub && _jsx("span", { className: "button__sub-label-text caption-1", children: subLabel })] }));
     };
+    /* 떠날 때 비제어 선택 표시를 푼다 — **toggleable 은 제외**(눌러 켠 것이 포인터가 떠나면 꺼졌다).
+       blur 도 이 정리를 쓰지만 소비자의 onMouseLeave 는 부르지 않는다(포커스를 잃은 것은 마우스가 떠난 것이 아니다). */
+    const 떠남정리 = (e) => {
+        if (typeof selected !== 'boolean' && !toggleable)
+            setInternalSelected(false);
+        e.currentTarget.blur();
+    };
     const handleMouseLeave = (e) => {
         if (disabledProp)
             return;
         if (typeof rest.onMouseLeave === 'function')
             rest.onMouseLeave(e);
-        if (typeof selected !== 'boolean')
-            setInternalSelected(false);
-        e.currentTarget.blur();
+        떠남정리(e);
     };
     const handleClickInternal = (e) => {
         if (disabledProp) {
@@ -202,7 +208,8 @@ export default function Button(props) {
                     if (!disabledProp && typeof rest.onFocus === 'function')
                         rest.onFocus(e);
                 }, onBlur: (e) => {
-                    handleMouseLeave(e);
+                    if (!disabledProp)
+                        떠남정리(e);
                     hideTooltipFn();
                     if (!disabledProp && typeof rest.onBlur === 'function')
                         rest.onBlur(e);

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

@@ -4,6 +4,7 @@ import { useCallback, useMemo, useState, useRef } from 'react';
 import { useTranslation } from 'react-i18next';
 import Icon from './Icon';
 import { formatTimeHM } from '../utils/format';
+import { getTodayKst } from '../utils/date';
 import './Calendar.css';
 import { pressable } from '../utils/pressable';
 function daysInMonth(year, month) { return new Date(year, month + 1, 0).getDate(); }
@@ -12,11 +13,13 @@ function firstDayOfMonth(year, month) { return new Date(year, month, 1).getDay()
 export default function Calendar({ visits = [], onVisitClick, onVisitMove, onDayClick, }) {
     const { t } = useTranslation();
     const DOW = useMemo(() => t('calendar.dow', { returnObjects: true }), [t]);
-    const [year, setYear] = useState(new Date().getFullYear());
-    const [month, setMonth] = useState(new Date().getMonth());
+    /* '오늘' 은 KST 의 날 — 방문 날짜가 KST 달력(toKstYmd)이라, 기기 달력으로 열면 해외 기기에서 오늘 방문이 안 보이는 달에 있고
+       오늘 표시가 다른 날에 붙었다(해외 기기 공식 지원) */
+    const 오늘Ymd = getTodayKst();
+    const [year, setYear] = useState(() => Number(오늘Ymd.slice(0, 4)));
+    const [month, setMonth] = useState(() => Number(오늘Ymd.slice(5, 7)) - 1);
     const [dragOverDate, setDragOverDate] = useState(null);
     const dragVisitId = useRef(null);
-    const today = new Date();
     const visitsByDate = useMemo(() => {
         const map = {};
         visits.forEach((v) => {
@@ -51,15 +54,15 @@ export default function Calendar({ visits = [], onVisitClick, onVisitMove, onDay
     else
         setMonth(m => m + 1); }, [month]);
     const fmtDate = (d) => `${year}-${String(month + 1).padStart(2, '0')}-${String(d).padStart(2, '0')}`;
-    const isToday = (d) => today.getFullYear() === year && today.getMonth() === month && today.getDate() === d;
-    return (_jsxs("div", { children: [_jsxs("div", { className: "calendar-nav", children: [_jsx("button", { type: "button", className: "calendar-nav__button", onClick: prev, "aria-label": t('calendar.prevMonth', '이전 달'), children: _jsx(Icon, { icon: "chevron-left", label: "", className: "", svgClassName: "calendar-nav__button-icon", size: 18 }) }), _jsx("span", { className: "calendar-nav__title h5", children: t('calendar.yearMonth', { year, month: month + 1 }) }), _jsx("button", { type: "button", className: "calendar-nav__button", onClick: next, "aria-label": t('calendar.nextMonth', '다음 달'), children: _jsx(Icon, { icon: "chevron-right", label: "", className: "", svgClassName: "calendar-nav__button-icon", size: 18 }) }), _jsxs("div", { className: "calendar-nav__legend", children: [_jsx("span", { className: "calendar-nav__legend-dot calendar-nav__legend-dot--main" }), _jsx("span", { className: "caption-1", children: t('calendar.legend.visited', '방문') }), _jsx("span", { className: "calendar-nav__legend-dot calendar-nav__legend-dot--sub" }), _jsx("span", { className: "caption-1", children: t('calendar.legend.scheduled', '예약') }), _jsx("span", { className: "calendar-nav__legend-dot calendar-nav__legend-dot--disabled" }), _jsx("span", { className: "caption-1", children: t('calendar.legend.noVisit', '미방문') })] })] }), _jsxs("div", { className: "calendar-grid", children: [DOW.map(d => _jsx("div", { className: "calendar-day-header body-3", children: d }, d)), cells.map((d, i) => {
+    const isToday = (d) => fmtDate(d) === 오늘Ymd;
+    return (_jsxs("div", { children: [_jsxs("div", { className: "calendar-nav", children: [_jsx("button", { type: "button", className: "calendar-nav__button", onClick: prev, "aria-label": t('calendar.prevMonth', '이전 달'), children: _jsx(Icon, { icon: "chevron-left", label: "", className: "", svgClassName: "calendar-nav__button-icon", size: 18 }) }), _jsx("span", { className: "calendar-nav__title h5", "aria-live": "polite", children: t('calendar.yearMonth', { year, month: month + 1 }) }), _jsx("button", { type: "button", className: "calendar-nav__button", onClick: next, "aria-label": t('calendar.nextMonth', '다음 달'), children: _jsx(Icon, { icon: "chevron-right", label: "", className: "", svgClassName: "calendar-nav__button-icon", size: 18 }) }), _jsxs("div", { className: "calendar-nav__legend", children: [_jsx("span", { className: "calendar-nav__legend-dot calendar-nav__legend-dot--main" }), _jsx("span", { className: "caption-1", children: t('calendar.legend.visited', '방문') }), _jsx("span", { className: "calendar-nav__legend-dot calendar-nav__legend-dot--sub" }), _jsx("span", { className: "caption-1", children: t('calendar.legend.scheduled', '예약') }), _jsx("span", { className: "calendar-nav__legend-dot calendar-nav__legend-dot--disabled" }), _jsx("span", { className: "caption-1", children: t('calendar.legend.noVisit', '미방문') })] })] }), _jsxs("div", { className: "calendar-grid", children: [DOW.map(d => _jsx("div", { className: "calendar-day-header body-3", children: d }, d)), cells.map((d, i) => {
                         if (d === null)
                             return _jsx("div", { className: "calendar-cell empty" }, `empty-${i}`);
                         const day = d;
                         const dateKey = fmtDate(day);
                         const dayVisits = visitsByDate[dateKey] ?? [];
                         const isDragOver = dragOverDate === dateKey;
-                        return (_jsxs("div", { className: `calendar-cell${isToday(day) ? ' today' : ''}${isDragOver ? ' drag-over' : ''}${onDayClick ? ' calendar-cell--clickable' : ''}`, role: onDayClick ? 'button' : undefined, tabIndex: onDayClick ? 0 : undefined, "aria-label": onDayClick ? t('calendar.addOnDate', { date: dateKey }) : undefined, onClick: onDayClick ? () => onDayClick(dateKey) : undefined, 
+                        return (_jsxs("div", { className: `calendar-cell${isToday(day) ? ' today' : ''}${isDragOver ? ' drag-over' : ''}${onDayClick ? ' calendar-cell--clickable' : ''}`, role: onDayClick ? 'button' : undefined, tabIndex: onDayClick ? 0 : undefined, "aria-label": onDayClick ? t('calendar.addOnDate', { date: dateKey }) : undefined, "aria-current": isToday(day) ? 'date' : undefined, onClick: onDayClick ? () => onDayClick(dateKey) : undefined, 
                             /* `<div role="button">` 은 브라우저가 Enter·Space 를 눌림으로 바꿔 주지 않는다 */
                             onKeyDown: onDayClick ? (e) => {
                                 /* 칸 안의 방문 표시에서 누른 Enter 가 올라온 것이면 넘긴다 — 마우스 click 은 표시가

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

@@ -9,6 +9,7 @@ import { cx } from '../utils/cx';
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { useTranslation } from 'react-i18next';
 import { createPortal } from 'react-dom';
+import { getTodayKst } from '../utils/date';
 import Calendar from 'lucide-react/dist/esm/icons/calendar.mjs';
 import ChevronLeft from 'lucide-react/dist/esm/icons/chevron-left.mjs';
 import ChevronRight from 'lucide-react/dist/esm/icons/chevron-right.mjs';
@@ -55,7 +56,8 @@ export default function DatePicker({ value, onChange, size = 48, min, max, disab
        영어 화면의 날짜 고르개만 한국어 요일이 떴다 — 같은 저장소의 `Calendar` 는
        진작 `calendar.dow` 를 쓰고 있었고, 사전에는 영어(`Sun`·`Mon`…)도 들어 있었다. */
     const DOW = useMemo(() => t('calendar.dow', { returnObjects: true }), [t]);
-    const today = new Date();
+    // 오늘 표시·열 때 포커스는 KST 의 날 — 기기 달력이면 해외 기기에서 하루 어긋나 min=오늘 달력이 앞 달로 열렸다
+    const 오늘ISO = getTodayKst();
     const { viewY, viewM, prevMonth, nextMonth, setViewYM } = useCalendarMonth(value);
     const computeStyle = useCallback((rect) => {
         const spaceBelow = window.innerHeight - rect.bottom;
@@ -122,7 +124,6 @@ export default function DatePicker({ value, onChange, size = 48, min, max, disab
     useEffect(() => {
         if (!open)
             return;
-        const 오늘ISO = toISO(today.getFullYear(), today.getMonth(), today.getDate());
         const 첫자리 = value && value.slice(0, 7) === `${viewY}-${String(viewM + 1).padStart(2, '0')}` ? +value.slice(8)
             : 오늘ISO.slice(0, 7) === `${viewY}-${String(viewM + 1).padStart(2, '0')}` ? +오늘ISO.slice(8)
                 : 1;
@@ -195,9 +196,13 @@ export default function DatePicker({ value, onChange, size = 48, min, max, disab
         e.preventDefault();
     }, [viewY, viewM, 활성일, 옮기기]);
     const selectDay = useCallback((d) => {
+        if (disabled)
+            return; // 열린 채 disabled 가 되면 남은 달력에서 고른 날이 그대로 나갔다
         onChange(toISO(viewY, viewM, d));
         setOpen(false);
-    }, [viewY, viewM, onChange, setOpen]);
+    }, [viewY, viewM, onChange, setOpen, disabled]);
+    useEffect(() => { if (disabled)
+        setOpen(false); }, [disabled, setOpen]);
     const isDisabledDay = (d) => {
         const iso = toISO(viewY, viewM, d);
         if (min && iso < min)
@@ -233,7 +238,7 @@ export default function DatePicker({ value, onChange, size = 48, min, max, disab
                             return _jsx("div", {}, `e${i}`);
                         const iso = toISO(viewY, viewM, d);
                         const isSelected = iso === value;
-                        const isToday = iso === toISO(today.getFullYear(), today.getMonth(), today.getDate());
+                        const isToday = iso === 오늘ISO;
                         const dis = isDisabledDay(d);
                         const col = (i % 7);
                         return (_jsx("button", { type: "button", disabled: dis, "data-day": d, tabIndex: d === 탭자리 ? 0 : -1, "aria-current": isToday ? 'date' : undefined, onClick: () => !dis && selectDay(d), className: cx('date-picker__day caption-1', isSelected && 'date-picker__day--selected', isToday && !isSelected && 'date-picker__day--today', dis && 'date-picker__day--disabled', col === 0 && 'date-picker__day--sun', col === 6 && 'date-picker__day--sat'), children: d }, d));

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

@@ -7,6 +7,7 @@ import { cx } from '../utils/cx';
 import { lockBodyScroll } from '../hooks/bodyScrollLock';
 import { pushEsc } from '../hooks/escStack';
 import { useFocusTrap } from '../hooks/useFocusTrap';
+import { rememberFocusReturn, resolveFocusReturn } from '../hooks/focusReturn';
 import './Dialog.css';
 function CloseIcon() {
     return (_jsx("svg", { viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 2, strokeLinecap: "round", "aria-hidden": true, children: _jsx("path", { d: "M6 6l12 12M18 6 6 18" }) }));
@@ -45,13 +46,14 @@ export default function Dialog({ open, onClose, ariaLabel, title, children, size
            닫으면 overflow:hidden 으로 영영 굳었다. */
         const 풀기 = lockBodyScroll();
         const 판 = surfaceRef.current;
+        rememberFocusReturn(판, 돌아갈곳);
         판?.focus();
         return () => {
             풀기();
             // 포커스가 이 창 안이거나 갈 곳을 잃었을 때만 되돌린다 — 이미 다른 창으로 옮겨 갔으면 빼앗지 않는다(Popup 과 같다)
             const 지금 = document.activeElement;
             if (!지금 || 지금 === document.body || (판 && 판.contains(지금)))
-                돌아갈곳?.focus?.();
+                resolveFocusReturn(돌아갈곳)?.focus?.();
         };
     }, [open]);
     /* ESC 는 **공유 스택**에 맡긴다 — 예전에는 window 에서 직접 들었다.

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

@@ -18,6 +18,8 @@ export interface DropdownProps {
     className?: string;
     /** 화면에 보이는 라벨 없이 스크린리더용 이름을 지정할 때 사용 */
     ariaLabel?: string;
+    /** 트리거를 설명할 요소 id(들) — 오류 문구 등. 고른 값은 이것과 함께 설명으로 따로 읽힌다. */
+    ariaDescribedBy?: string;
 }
 /** @public */
-export default function Dropdown({ options, value, onChange, placeholder, disabled, block, size, error, className, ariaLabel }: DropdownProps): import("react").JSX.Element;
+export default function Dropdown({ options, value, onChange, placeholder, disabled, block, size, error, className, ariaLabel, ariaDescribedBy }: DropdownProps): import("react").JSX.Element;

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

@@ -7,10 +7,11 @@ import { useTranslation } from 'react-i18next';
 import { useAnchoredMenu } from '../hooks/useAnchoredMenu';
 import './Dropdown.css';
 /** @public */
-export default function Dropdown({ options, value, onChange, placeholder, disabled = false, block = false, size = 48, error = false, className = '', ariaLabel }) {
+export default function Dropdown({ options, value, onChange, placeholder, disabled = false, block = false, size = 48, error = false, className = '', ariaLabel, ariaDescribedBy }) {
     const { t } = useTranslation();
     const resolvedPlaceholder = placeholder ?? t('dropdown.placeholder', '선택');
     const listId = useId();
+    const valueId = useId();
     const containerRef = useRef(null);
     const computeStyle = useCallback((rect) => {
         // 아래쪽 공간이 메뉴 최대 높이(260px, Dropdown.css)보다 부족하고 위쪽에 공간이
@@ -62,11 +63,15 @@ export default function Dropdown({ options, value, onChange, placeholder, disabl
     const toggle = useCallback(() => { if (!disabled)
         rawToggle(); }, [disabled, rawToggle]);
     const select = useCallback((opt) => {
-        if (opt.disabled)
+        // 열린 채 disabled 가 되면(저장 중 잠금) 남은 메뉴에서 고른 것이 그대로 onChange 로 나갔다
+        if (opt.disabled || disabled)
             return;
         onChange?.(opt.value);
         setOpen(false);
-    }, [onChange, setOpen]);
+    }, [onChange, setOpen, disabled]);
+    // 막히면 열린 메뉴도 닫는다
+    useEffect(() => { if (disabled)
+        setOpen(false); }, [disabled, setOpen]);
     const handleKeyDown = useCallback((e) => {
         if (disabled)
             return;
@@ -113,12 +118,12 @@ export default function Dropdown({ options, value, onChange, placeholder, disabl
             // mousedown 에서는 기본 동작(포커스 이동 → 트리거 blur → 메뉴 닫힘)만 막아,
             // click 이 도달하기 전에 메뉴가 사라지지 않게 한다.
             onMouseDown: e => e.preventDefault(), onClick: () => select(opt), onMouseEnter: () => setActiveIdx(i), disabled: opt.disabled, children: [_jsx("span", { className: "dropdown__option-check", children: opt.value === value && (_jsx("svg", { viewBox: "0 0 14 14", fill: "none", stroke: "currentColor", strokeWidth: "2.5", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("polyline", { points: "2 7 5.5 10.5 12 3.5" }) })) }), opt.label] }, opt.value))) })) : null;
-    return (_jsxs("div", { ref: containerRef, className: cx('dropdown', `dropdown--s${size}`, open ? 'dropdown--open' : '', block ? 'dropdown--block' : '', error ? 'dropdown--error' : '', className), onKeyDown: handleKeyDown, children: [_jsxs("button", { ref: triggerRef, type: "button", className: "dropdown__trigger", "aria-haspopup": "listbox", "aria-expanded": open, "aria-controls": open ? listId : undefined, "aria-activedescendant": open && activeIdx >= 0 ? `${listId}-option-${activeIdx}` : undefined, "aria-label": ariaLabel, "aria-invalid": error || undefined, disabled: disabled, onClick: toggle, 
+    return (_jsxs("div", { ref: containerRef, className: cx('dropdown', `dropdown--s${size}`, open ? 'dropdown--open' : '', block ? 'dropdown--block' : '', error ? 'dropdown--error' : '', className), onKeyDown: handleKeyDown, children: [_jsxs("button", { ref: triggerRef, type: "button", className: "dropdown__trigger", "aria-haspopup": "listbox", "aria-expanded": open, "aria-controls": open ? listId : undefined, "aria-activedescendant": open && activeIdx >= 0 ? `${listId}-option-${activeIdx}` : undefined, "aria-label": ariaLabel, "aria-describedby": [ariaLabel && selected ? valueId : '', ariaDescribedBy ?? ''].filter(Boolean).join(' ') || undefined, "aria-invalid": error || undefined, disabled: disabled, onClick: toggle, 
                 /* Tab 으로 포커스가 떠나면 닫는다 — 포커스는 트리거에 두고 aria-activedescendant 로 가리키는 목록이라, 떠난 뒤
                    열린 채 남으면 화살표·Enter 가 더는 메뉴로 가지 않는 죽은 메뉴가 된다. 항목·메뉴를 누르는 것은 위에서
                    mousedown 기본 동작을 막아 blur 가 나지 않는다. */
                 onBlur: e => { if (open && !menuRef.current?.contains(e.relatedTarget))
-                    setOpen(false); }, children: [_jsx("span", { className: `dropdown__trigger-label body-2${!selected ? ' dropdown__trigger-label--placeholder' : ''}`, children: selected ? selected.label : resolvedPlaceholder }), _jsx("svg", { className: "dropdown__chevron", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("polyline", { points: "4 6 8 10 12 6" }) })] }), typeof document !== 'undefined' && createPortal(menu, 
+                    setOpen(false); }, children: [_jsx("span", { id: valueId, className: `dropdown__trigger-label body-2${!selected ? ' dropdown__trigger-label--placeholder' : ''}`, children: selected ? selected.label : resolvedPlaceholder }), _jsx("svg", { className: "dropdown__chevron", viewBox: "0 0 16 16", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round", strokeLinejoin: "round", children: _jsx("polyline", { points: "4 6 8 10 12 6" }) })] }), typeof document !== 'undefined' && createPortal(menu, 
             // 코어 CSS를 .ihabdevteam-core-scope 로 스코프한 소비자(플레이그라운드 등)에서도
             // body로 portal된 메뉴가 스타일을 잃지 않도록, 가까운 scope 안으로 portal
             // createPortal의 target은 렌더링 시점에 동기적으로 결정되어야 하므로 ref 읽기를 effect로 옮길 수 없다

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

@@ -92,6 +92,8 @@ export default function FileUpload({ onFilesSelected, accept, multiple = false,
         inputRef.current?.click();
     };
     const handleRemove = (index) => {
+        if (disabled)
+            return; // 꺼진 칸의 목록 제거 단추가 눌렸다
         /* onRemove 를 주면 알림은 그쪽 한 번으로 끝낸다(onFilesSelected 로 이중으로 알리지 않는다). 다만 비제어 모드에서는
            **보이는 목록도 줄인다** — 전에는 줄이기 전에 돌아가 버려 뺀 파일이 화면에 남았다. 제어 모드(files 를 부모가
            쥠)는 부모가 onRemove 에서 줄인다. */
@@ -108,5 +110,5 @@ export default function FileUpload({ onFilesSelected, accept, multiple = false,
     return (_jsxs("div", { className: `file-upload ${className}`.trim(), children: [_jsxs("div", { className: cx('file-upload__dropzone', isDragging && 'file-upload__dropzone--dragging', disabled && 'file-upload__dropzone--disabled'), role: "button", tabIndex: disabled ? -1 : 0, "aria-disabled": disabled, onClick: handleBrowseClick, onKeyDown: e => { if (e.key === 'Enter' || e.key === ' ') {
                     e.preventDefault();
                     handleBrowseClick();
-                } }, onDragOver: handleDragOver, onDragLeave: handleDragLeave, onDrop: handleDrop, children: [_jsx(Icon, { icon: "upload", size: 24, className: "file-upload__icon" }), _jsx("span", { className: "file-upload__prompt body-2", children: t('fileUpload.dragPrompt', '파일을 이곳에 드래그하여 업로드') }), _jsx("button", { type: "button", className: "file-upload__browse-button body-3", disabled: disabled, onClick: e => { e.stopPropagation(); handleBrowseClick(); }, children: t('fileUpload.browseButton', '파일 선택') }), _jsx("input", { ref: inputRef, type: "file", className: "file-upload__input", accept: accept, multiple: multiple, disabled: disabled, onChange: handleInputChange, tabIndex: -1 })] }), showFileList && files.length > 0 && (_jsx("ul", { className: "file-upload__list", children: files.map((file, index) => (_jsxs("li", { className: "file-upload__list-item body-3", children: [_jsx("span", { className: "file-upload__file-name body-3", children: file.name }), _jsx("button", { type: "button", className: "file-upload__remove-button", "aria-label": t('fileUpload.removeAriaLabel', { name: file.name }), onClick: () => handleRemove(index), children: _jsx(Icon, { icon: "x", size: 14 }) })] }, `${file.name}-${index}`))) }))] }));
+                } }, onDragOver: handleDragOver, onDragLeave: handleDragLeave, onDrop: handleDrop, children: [_jsx(Icon, { icon: "upload", size: 24, className: "file-upload__icon" }), _jsx("span", { className: "file-upload__prompt body-2", children: t('fileUpload.dragPrompt', '파일을 이곳에 드래그하여 업로드') }), _jsx("button", { type: "button", className: "file-upload__browse-button body-3", disabled: disabled, onClick: e => { e.stopPropagation(); handleBrowseClick(); }, children: t('fileUpload.browseButton', '파일 선택') }), _jsx("input", { ref: inputRef, type: "file", className: "file-upload__input", accept: accept, multiple: multiple, disabled: disabled, onChange: handleInputChange, tabIndex: -1 })] }), showFileList && files.length > 0 && (_jsx("ul", { className: "file-upload__list", children: files.map((file, index) => (_jsxs("li", { className: "file-upload__list-item body-3", children: [_jsx("span", { className: "file-upload__file-name body-3", children: file.name }), _jsx("button", { type: "button", className: "file-upload__remove-button", "aria-label": t('fileUpload.removeAriaLabel', { name: file.name }), disabled: disabled, onClick: () => handleRemove(index), children: _jsx(Icon, { icon: "x", size: 14 }) })] }, `${file.name}-${index}`))) }))] }));
 }

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

@@ -66,7 +66,8 @@ export default function FilterPanel({ title, headerAction, collapsible = false,
                                                    기본값 '선택 탭'으로 읽혀, 필터가 여럿인 화면에서 어느 그룹인지
                                                    구분이 안 된다(단어표 검색 설정은 세그먼트가 열 개 가까이 된다). */
                                                 ariaLabel: section.displayLabel ?? section.label, options: [
-                                                    ...(section.allOption ? [{ key: FILTER_ALL_VALUE, label: section.allLabel ?? t('common.all', '전체') }] : []),
+                                                    // allOptionDisabled 가 버튼 표시에서만 먹고 segmented·dropdown 의 '전체' 는 눌렸다
+                                                    ...(section.allOption ? [{ key: FILTER_ALL_VALUE, label: section.allLabel ?? t('common.all', '전체'), disabled: section.allOptionDisabled }] : []),
                                                     ...items.map(item => {
                                                         const value = typeof item === 'string' ? item : item.value;
                                                         const displayLabel = typeof item !== 'string' ? item.displayLabel : undefined;
@@ -77,7 +78,7 @@ export default function FilterPanel({ title, headerAction, collapsible = false,
                                                 /* 아무것도 안 골랐으면 빈 값 — undefined 를 넘기면 SegmentedControl 의 기본값(첫 보기)이 걸려, 상태는
                                                    비었는데 첫 보기가 골라진 것처럼 보였다(필터는 걸리지 않았는데 걸린 듯). */
                                                 value: isAllSelected && section.allOption ? FILTER_ALL_VALUE : selected[section.label] ?? '', onChange: (value) => onSelect?.(value, section.label), size: 32 })) : (!section.multiple && section.display === 'dropdown') ? (_jsx(Dropdown, { className: "filter-panel__dropdown", size: 40, options: [
-                                                    ...(section.allOption ? [{ value: FILTER_ALL_VALUE, label: section.allLabel ?? t('common.all', '전체') }] : []),
+                                                    ...(section.allOption ? [{ value: FILTER_ALL_VALUE, label: section.allLabel ?? t('common.all', '전체'), disabled: section.allOptionDisabled }] : []),
                                                     ...items.map(item => {
                                                         const value = typeof item === 'string' ? item : item.value;
                                                         const displayLabel = typeof item !== 'string' ? item.displayLabel : undefined;

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

@@ -2,6 +2,11 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useTranslation } from 'react-i18next';
 import './Loader.css';
+/** 눈에는 안 보이고 낭독기에는 읽히는 글자 */
+const 보이지않게 = {
+    position: 'absolute', width: 1, height: 1, margin: -1, padding: 0, overflow: 'hidden',
+    clipPath: 'inset(50%)', whiteSpace: 'nowrap', border: 0,
+};
 /** @public */
 export default function Loader(props) {
     const { t } = useTranslation();
@@ -13,5 +18,5 @@ export default function Loader(props) {
         return (_jsx("div", { className: "loader-bar", role: "progressbar", "aria-valuemin": 0, "aria-valuemax": 100, "aria-valuenow": pct, "aria-label": name, children: _jsx("div", { className: "loader-bar__inner", style: { width: `${pct}%` } }) }));
     }
     const dim = typeof size === 'number' ? `${size}px` : size;
-    return (_jsx("div", { className: "loader-spinner", style: { width: dim, height: dim }, role: "status", "aria-label": name, children: _jsxs("svg", { className: "loader-spinner__svg", viewBox: "0 0 50 50", width: size, height: size, children: [_jsx("circle", { className: "loader-spinner__bg", cx: "25", cy: "25", r: "20", fill: "none", strokeWidth: "4" }), _jsx("circle", { className: "loader-spinner__fg", cx: "25", cy: "25", r: "20", fill: "none", strokeWidth: "4", strokeLinecap: "round" })] }) }));
+    return (_jsxs("div", { className: "loader-spinner", style: { width: dim, height: dim }, role: "status", "aria-label": name, children: [_jsx("span", { style: 보이지않게, children: name }), _jsxs("svg", { className: "loader-spinner__svg", viewBox: "0 0 50 50", width: size, height: size, children: [_jsx("circle", { className: "loader-spinner__bg", cx: "25", cy: "25", r: "20", fill: "none", strokeWidth: "4" }), _jsx("circle", { className: "loader-spinner__fg", cx: "25", cy: "25", r: "20", fill: "none", strokeWidth: "4", strokeLinecap: "round" })] })] }));
 }