@ihabdevteam/core 0.324.0 → 0.325.0

package/dist/ihabdevteam-core.d.ts

@@ -1678,7 +1678,7 @@ export declare function copyText(text: string): Promise<boolean>;
  *
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
  */
-export declare const CORE_VERSION = "0.324.0";
+export declare const CORE_VERSION = "0.325.0";
 
 /** @public */
 declare const coreDefault: Record<string, unknown>;

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

@@ -2,6 +2,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useCallback, useMemo, useState, useRef } from 'react';
 import { useTranslation } from 'react-i18next';
+import { yearMonthLabel } from '../utils/date';
 import Icon from './Icon';
 import { formatTimeHM } from '../utils/format';
 import { todayYmdOr, formatDateLocale } from '../utils/date';
@@ -55,7 +56,7 @@ export default function Calendar({ visits = [], onVisitClick, onVisitMove, onDay
         setMonth(m => m + 1); }, [month]);
     const fmtDate = (d) => `${year}-${String(month + 1).padStart(2, '0')}-${String(d).padStart(2, '0')}`;
     const isToday = (d) => fmtDate(d) === todayYmd;
-    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) => {
+    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: yearMonthLabel(t, i18n.language, year, 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;

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

@@ -8,6 +8,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { cx } from '../utils/cx';
 import { useCallback, useEffect, useId, useMemo, useRef, useState } from 'react';
 import { useTranslation } from 'react-i18next';
+import { yearMonthLabel } from '../utils/date';
 import { createPortal } from 'react-dom';
 import { todayYmdOr } from '../utils/date';
 import Calendar from 'lucide-react/dist/esm/icons/calendar.mjs';
@@ -48,7 +49,7 @@ function buildYMOptions(viewY, ymLabel, min, max) {
     return opts;
 }
 export default function DatePicker({ value, onChange, size = 48, min, max, disabled, placeholder: placeholderProp, className, today, }) {
-    const { t } = useTranslation();
+    const { t, i18n } = useTranslation();
     /* 기본 안내 문구도 사전에서 — 예전에는 '날짜 선택' 이 박혀 있어 영어 화면에서도 한국어였다.
        달력 판의 이름(`datePicker.chooseDate`)과 같은 말이라 같은 열쇠를 쓴다. */
     const placeholder = placeholderProp ?? t('datePicker.chooseDate', '날짜 선택');
@@ -254,7 +255,7 @@ export default function DatePicker({ value, onChange, size = 48, min, max, disab
     for (let d = 1; d <= daysInMonth(viewY, viewM); d++)
         cells.push(d);
     const iconSize = size === 64 ? 20 : size === 40 ? 16 : 18;
-    const ymOptions = buildYMOptions(viewY, (year, month) => t('calendar.yearMonth', { year, month, defaultValue: '{{year}}년 {{month}}월' }), min, max);
+    const ymOptions = buildYMOptions(viewY, (year, month) => yearMonthLabel(t, i18n.language, year, month), min, max);
     const ymValue = `${viewY}-${String(viewM + 1).padStart(2, '0')}`;
     const dropdown = open ? createPortal(_jsxs("div", { ref: menuRef, id: panelId, className: "date-picker__dropdown", style: dropdownStyle, "data-tooltip-ignore": true, role: "dialog", "aria-label": t('datePicker.chooseDate', '날짜 선택'), tabIndex: -1, children: [_jsxs("div", { className: "date-picker__nav", children: [_jsx("button", { type: "button", className: "date-picker__nav-btn", onClick: prevMonth, "aria-label": t('calendar.prevMonth', '이전 달'), children: _jsx(ChevronLeft, { size: 16, strokeWidth: 2 }) }), _jsx(Dropdown, { className: "date-picker__nav-dropdown", ariaLabel: t('datePicker.selectYearMonth', '연월 선택'), options: ymOptions, value: ymValue, onChange: (v) => {
                             const [y, m] = v.split('-');

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

@@ -1,6 +1,7 @@
 'use client';
 import { useState, useEffect, useMemo, useCallback } from 'react';
 import { useTranslation } from 'react-i18next';
+import { yearMonthLabel } from '../utils/date';
 import { firstMondayOfMonth, todayWeekValue, monthOptionsNow, weekLabel } from './barChartData';
 /**
  * BarChart 기간 상태/옵션/네비게이션을 캡슐화한 훅.
@@ -8,7 +9,7 @@ import { firstMondayOfMonth, todayWeekValue, monthOptionsNow, weekLabel } from '
  * @public
  */
 export function useBarChartControl(data) {
-    const { t } = useTranslation();
+    const { t, i18n } = useTranslation();
     const [period, setPeriod] = useState('week');
     // 달 옵션·오늘은 자료가 바뀔 때 다시 센다 — 모듈 로드 때 한 번 세면 자정을 넘긴 탭에서 이번 달·오늘 주가 옛날에 굳었다
     const DATA_MONTH_OPTIONS = useMemo(() => monthOptionsNow().filter(o => o.value in data), [data]);
@@ -25,7 +26,7 @@ export function useBarChartControl(data) {
         return opts;
     }, [DATA_MONTH_OPTIONS]);
     const weekOptionLabel = useCallback((o) => {
-        const m = t('calendar.yearMonth', { year: o.year, month: o.month });
+        const m = yearMonthLabel(t, i18n.language, o.year, o.month);
         return `${m} ${weekLabel(t, o.week)}`;
     }, [t]);
     const monthOptions = useMemo(() => DATA_MONTH_OPTIONS.map(o => ({

package/dist/packages/core/src/i18n/locales/en.json

@@ -115,7 +115,6 @@
             "Sat"
         ],
         "weekLabel": "Week {{ord}}",
-        "yearMonth": "{{month}}/{{year}}",
         "prevMonth": "Previous month",
         "addOnDate": "Add a visit on {{date}}",
         "nextMonth": "Next month",

package/dist/packages/core/src/i18n/locales/ko.json

@@ -120,7 +120,6 @@
             "일곱째"
         ],
         "weekLabel": "{{ord}}주",
-        "yearMonth": "{{year}}년 {{month}}월",
         "prevMonth": "이전 달",
         "addOnDate": "{{date}}에 방문 등록",
         "nextMonth": "다음 달",

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

@@ -12,6 +12,33 @@ export declare function formatDateLongKo(iso: string): string;
  * @param lang useTranslation()의 i18n.language
  */
 export declare function formatDateLocale(iso: string, lang: string): string;
+/**
+ * **연·월 이름표** — `2026년 10월` · `October 2026`. @public
+ *
+ * 사장님 지시(2026-10-14). 전에는 사전 글귀(`calendar.yearMonth`)가 영어에서
+ * `{{month}}/{{year}}` 이라 **`10/2026`** 으로 떴다(말귀_1 이 훈련 현황 도구줄에서 봤다).
+ * 달 이름은 틀로는 못 만든다 — 열두 이름을 두 말로 적거나, 브라우저가 든 것을 쓰거나다.
+ * **브라우저 쪽을 쓴다**: 한 줄이고 두 말이 같이 맞고, 말이 늘어도 따라온다.
+ *
+ * `month` 는 **1 부터**다(화면이 쓰는 꼴). `Date` 의 0 부터와 헷갈리기 쉬워 여기서 받아
+ * 한 번만 내린다 — 부르는 쪽 셋이 저마다 `+1`·`-1` 을 하면 그중 하나가 어긋난다.
+ *
+ * **사전에 그 열쇠가 있으면 그쪽이 이긴다.** 그 글귀는 부르는 쪽이 덮으라고 열어 둔
+ * 자리다(`DatePicker` 머리글). 코어 사전에서는 뺐으므로, 안 덮으면 여기로 온다.
+ */
+export declare function formatYearMonth(year: number, month: number, lang: string): string;
+/**
+ * **연·월 이름표 — 사전이 있으면 사전, 없으면 브라우저.** @public
+ *
+ * `calendar.yearMonth` 는 **부르는 쪽이 덮으라고 열어 둔 자리**다(`DatePicker` 머리글).
+ * 코어 사전에서는 뺐으므로 안 덮으면 `formatYearMonth` 로 온다.
+ *
+ * **이 가름을 한 자리에 둔다.** 쓰는 곳이 셋(`Calendar` 머리줄 · `DatePicker` 연월 고르개 ·
+ * 막대그래프 이름표)인데 저마다 적으면 그중 하나가 안 따라온다 — 이 저장소에서 여러 번 겪은
+ * 꼴이다. `defaultValue: ''` 로 묻는 까닭은 `exists()` 없이도 "사전에 있나" 를 가를 수
+ * 있어서다(없으면 빈 글자가 온다).
+ */
+export declare function yearMonthLabel(t: (key: string, opts?: Record<string, unknown>) => string, lang: string, year: number, month: number): string;
 /** formatDateLongKo의 로케일 인식 버전 — en: "January 15, 2024, 03:30 PM" */
 export declare function formatDateLongLocale(iso: string, lang: string): string;
 /** "2024. 01. 15. 오후 03:30" (2-digit month + time) */

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

@@ -75,6 +75,43 @@ export function formatDateLocale(iso, lang) {
         return '';
     return d.toLocaleDateString(locale, { timeZone: KST, year: 'numeric', month: 'short', day: 'numeric' });
 }
+/**
+ * **연·월 이름표** — `2026년 10월` · `October 2026`. @public
+ *
+ * 사장님 지시(2026-10-14). 전에는 사전 글귀(`calendar.yearMonth`)가 영어에서
+ * `{{month}}/{{year}}` 이라 **`10/2026`** 으로 떴다(말귀_1 이 훈련 현황 도구줄에서 봤다).
+ * 달 이름은 틀로는 못 만든다 — 열두 이름을 두 말로 적거나, 브라우저가 든 것을 쓰거나다.
+ * **브라우저 쪽을 쓴다**: 한 줄이고 두 말이 같이 맞고, 말이 늘어도 따라온다.
+ *
+ * `month` 는 **1 부터**다(화면이 쓰는 꼴). `Date` 의 0 부터와 헷갈리기 쉬워 여기서 받아
+ * 한 번만 내린다 — 부르는 쪽 셋이 저마다 `+1`·`-1` 을 하면 그중 하나가 어긋난다.
+ *
+ * **사전에 그 열쇠가 있으면 그쪽이 이긴다.** 그 글귀는 부르는 쪽이 덮으라고 열어 둔
+ * 자리다(`DatePicker` 머리글). 코어 사전에서는 뺐으므로, 안 덮으면 여기로 온다.
+ */
+export function formatYearMonth(year, month, lang) {
+    /* 달이 범위 밖이면 `Date` 가 해를 넘겨 버린다(13월 → 다음 해 1월). 조용히 딴 해를
+       보여 주느니 받은 그대로 적는다. */
+    if (!Number.isFinite(year) || !Number.isFinite(month) || month < 1 || month > 12)
+        return `${year}-${month}`;
+    const locale = lang && lang.startsWith('ko') ? 'ko-KR' : lang || 'en-US';
+    return new Intl.DateTimeFormat(locale, { year: 'numeric', month: 'long' }).format(new Date(year, month - 1, 1));
+}
+/**
+ * **연·월 이름표 — 사전이 있으면 사전, 없으면 브라우저.** @public
+ *
+ * `calendar.yearMonth` 는 **부르는 쪽이 덮으라고 열어 둔 자리**다(`DatePicker` 머리글).
+ * 코어 사전에서는 뺐으므로 안 덮으면 `formatYearMonth` 로 온다.
+ *
+ * **이 가름을 한 자리에 둔다.** 쓰는 곳이 셋(`Calendar` 머리줄 · `DatePicker` 연월 고르개 ·
+ * 막대그래프 이름표)인데 저마다 적으면 그중 하나가 안 따라온다 — 이 저장소에서 여러 번 겪은
+ * 꼴이다. `defaultValue: ''` 로 묻는 까닭은 `exists()` 없이도 "사전에 있나" 를 가를 수
+ * 있어서다(없으면 빈 글자가 온다).
+ */
+export function yearMonthLabel(t, lang, year, month) {
+    const fromDict = t('calendar.yearMonth', { year, month, defaultValue: '' });
+    return fromDict || formatYearMonth(year, month, lang);
+}
 /** formatDateLongKo의 로케일 인식 버전 — en: "January 15, 2024, 03:30 PM" */
 export function formatDateLongLocale(iso, lang) {
     const locale = lang.startsWith('ko') ? 'ko-KR' : 'en-US';

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

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

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

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