@ihabdevteam/core 0.415.0 → 0.416.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2067,7 +2067,7 @@ export declare function copyText(text: string): Promise<boolean>;
2067
2067
  *
2068
2068
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
2069
2069
  */
2070
- export declare const CORE_VERSION = "0.415.0";
2070
+ export declare const CORE_VERSION = "0.416.0";
2071
2071
 
2072
2072
  /** @public */
2073
2073
  declare const coreDefault: Record<string, unknown>;
@@ -1,14 +1,34 @@
1
1
  /* BarChart — 막대차트 섹션 (제목 + 구간 네비 + 주/일 토글 + 2계열 막대) */
2
2
  /* 카드/헤더/total/legend 공통 레이아웃은 ChartSection.css 로 이동(RingChart 섹션과 공유) */
3
3
 
4
- /* 월/주 드롭다운 고정 너비 — 가장 긴 글(`2026.11 다섯째주`)을 담는 만큼.
4
+ /* 월/주 드롭다운 — **바닥은 150, 글이 길면 그만큼 늘어난다.**
5
5
  **200 → 150**(사장님 지시 2026-11-02 — "길이도 좀 줄이고"). 글을 `2026년 11월 첫째주`
6
- 에서 `2026.11 첫째주` 로 줄인 만큼 상자도 줄인다. 머리의 조절칸 넷이 416 → 366 이 되어
7
- 카드 폭 540 안에서 제목과 한 줄로 선다. */
6
+ 에서 `2026.11 첫째주` 로 줄인 만큼 상자도 줄였고, 머리의 조절칸 넷이 416 → 366 이 되어
7
+ 카드 폭 540 안에서 제목과 한 줄로 선다.
8
+
9
+ **150 에 못으로 박아 두었더니 이름표가 잘렸다**(청 (365), 실측 2026-11-03). 그때 적은
10
+ 까닭이 *"가장 긴 글(`2026.11 다섯째주`)을 담는 만큼"* 이었는데 **그 말이 틀렸다** —
11
+ 상자 150 의 이름표 칸은 **100**(150 − 좌우 여백 24 − 화살표 16 − 사이 8 − 테두리 2)인데
12
+ `2026.10 다섯째주` 는 **116** 이 필요하다. 그래서 `다섯째주` 만, 열두 달 가운데 열하나에서
13
+ `2026.10 다섯…` 으로 끊겼다(`첫째`~`넷째주` 는 최대 96 으로 들어온다).
14
+
15
+ **고치는 자리는 수가 아니라 못이다.** 150 을 160 으로 올려도 여전히 모자라고(110 < 116),
16
+ 166 으로 맞추면 다음에 글이 한 자 늘 때 또 끊긴다. 그래서 **바닥만 150 으로 남기고
17
+ 글에 맞춰 늘게 한다** — 사장님이 고르신 150 은 짧은 글에서 줄이 흔들리지 않게 지키는
18
+ 바닥으로 남고, 넘칠 때만 그만큼 넓어진다.
19
+
20
+ **카드는 안 커진다**(실측, 카드 540 · 속 폭 500): 늘어난 몫은 제목 칸이 내준다 —
21
+ `2026.10 다섯째주` 에서 상자 166 · 조절칸 382 · 제목 126 → 110 이고 **머리는 한 줄
22
+ 그대로**(키 32). 영어 최장 `May 2026 Week 4` 에서도 상자 180 · 조절칸 396 · 제목 96 ·
23
+ 한 줄이다. 폰 375 에서는 머리가 어차피 접히고 형제끼리 맞대어도 넘침이 없다.
24
+
25
+ **영어 긴 꼴은 이 못으로 못 푼다** — `September 2026 Week 4` 는 상자 229 가 되어 머리가
26
+ 두 줄로 접힌다(32 → 63). 그쪽은 글을 줄여서 막았다(`yearMonthCompact` 가 영어에서
27
+ `Sep 2026` 을 쓴다 — `useBarChartControl` 참고). 이 둘은 **함께** 가야 한다. */
8
28
  .month-dropdown .dropdown__trigger {
9
- width: 150px;
29
+ width: auto;
10
30
  min-width: 150px;
11
- max-width: 150px;
31
+ max-width: none;
12
32
  }
13
33
 
14
34
  /* 월 드롭다운 스크롤 */
@@ -226,10 +226,12 @@
226
226
  펼치면(`:hover`·`:focus-within`) 이 아래가 통째로 안 걸리고 넓은 화면 규칙이 그대로
227
227
  산다. 못 박아 접어 둔 레일은 호버해도 안 펼쳐지므로 늘 걸린다 — 그래서 선택자가
228
228
  둘씩이다. */
229
+ /* 좌우 여백은 **값 하나(`--rail-pad`)로** 정한다(2026-11-03) — 목록이 그 값만큼 밖으로 폈다가
230
+ 안으로 되돌리므로, 여기서 패딩을 직접 적으면 둘이 어긋난다. 변수만 바꾼다. */
229
231
  .header:not(:hover):not(:focus-within) .side-nav__menu,
230
232
  .header--force-collapsed .side-nav__menu {
231
233
  /* 좌우는 여백만으로 같다(실측 8px 기준: 좌 9 / 우 9, 항목 52) */
232
- padding: 0 var(--spacing-xs);
234
+ --rail-pad: var(--spacing-xs);
233
235
  }
234
236
 
235
237
  .header:not(:hover):not(:focus-within) .side-nav__item,
@@ -47,8 +47,16 @@
47
47
 
48
48
  잃는 것은 **"더 있다" 는 신호**다. 메뉴가 길어 잘릴 때 막대가 알려 주던 것이 없어진다 —
49
49
  항목이 화면을 넘는 일이 드문 자리라 가운데 맞춤을 택했다(사장님 지시 2026-09-25). */
50
- padding-left: calc(var(--spacing-s) - 1px);
51
- padding-right: calc(var(--spacing-s) - 1px);
50
+ /* **좌우 여백은 여기 있다 — 목록과 발치가 함께 쓴다.** 값은 `--rail-pad` 한 군데서 정한다
51
+ (접힌 레일은 `Header.css` 가 그 변수만 바꾼다 — 그러면 아래 목록의 음수 여백도 따라온다).
52
+
53
+ 같은 날 이 여백을 목록으로 **내렸다가 되돌렸다.** 내리면 떠 있는 막대는 제자리를 찾는데
54
+ **발치가 여백을 잃어** 단추 다섯이 메뉴 항목과 11px 어긋나고(항목 13 · 단추 2), 알림 배지가
55
+ `left: -6px` 이라 화면 밖(−4)으로 나갔다(말귀_2 실측 2026-11-03, 폭 1440 · 청 (366)).
56
+ 그래서 여백은 여기 두고, **구르는 목록만** 음수 여백으로 그 밖으로 빼낸다(아래). */
57
+ --rail-pad: calc(var(--spacing-s) - 1px);
58
+ padding-left: var(--rail-pad);
59
+ padding-right: var(--rail-pad);
52
60
  scrollbar-width: none;
53
61
  /* **막대가 끝나는 자리를 내용에 맞춘다.** 스크롤바는 이 통의 위아래 끝까지 그려지는데,
54
62
  발치가 제 안쪽에 아래 여백 12px 을 두고 있어 **내용은 12 위에서 끝나고 막대만 바닥까지**
@@ -63,14 +71,14 @@
63
71
  border-left: 1px solid transparent;
64
72
  border-right: 1px solid transparent;
65
73
  background-clip: padding-box;
66
- overflow-y: auto; /* 항상 단일 스크롤 컨테이너 */
67
- overflow-x: hidden;
68
- overscroll-behavior: contain;
69
- -webkit-overflow-scrolling: touch;
74
+ /* **구르는 것은 목록뿐이다**(사장님 지시 2026-11-03) — 전에는 여기가 통이라 발치까지 함께
75
+ 굴러, 칸이 하나 늘자 `설정`·`계정` 이 아래로 잘렸다. 통은 아래 `__menu-list` 가 맡는다. */
76
+ overflow: hidden;
70
77
  }
71
78
 
72
79
  /* 표준 속성을 모르는 옛 WebKit 몫 — 접힌 레일과 같은 처리 */
73
- .side-nav__menu::-webkit-scrollbar { display: none; }
80
+ .side-nav__menu::-webkit-scrollbar,
81
+ .side-nav__menu-list::-webkit-scrollbar { display: none; }
74
82
 
75
83
  /* ── 떠 있는 스크롤 막대 ───────────────────────────────────
76
84
  네이티브 막대는 **폭을 정할 수 없고**(전역 `scrollbar-width: thin` 이 이기므로 4px 을 적어도
@@ -89,8 +97,8 @@
89
97
  pointer-events: none;
90
98
  /* **통의 안쪽 여백 바깥까지 편다.** 안 펴면 이 겹이 내용 폭에서 끝나, 막대가 항목 위에
91
99
  얹힌다. 여백만큼 음수로 밀어 두면 막대를 그 **여백 안**에 앉힐 수 있다. */
92
- margin-left: calc(-1 * (var(--spacing-s) - 1px));
93
- margin-right: calc(-1 * (var(--spacing-s) - 1px));
100
+ margin-left: calc(-1 * var(--rail-pad));
101
+ margin-right: calc(-1 * var(--rail-pad));
94
102
  }
95
103
  .side-nav__scroll-thumb {
96
104
  position: absolute;
@@ -115,28 +123,49 @@
115
123
  .side-nav__scroll-thumb::before {
116
124
  content: '';
117
125
  position: absolute;
118
- /* 여백(11) 안에서 좌우로 더 집는다 — 보이는 막대는 6px 그대로 */
119
- inset: 0 -4px;
126
+ /* 여백(11) 안에서 좌우로 더 집는다 — 보이는 막대는 6px 그대로.
127
+ **오른쪽은 1px 뿐이다** — 통(`__menu-list`)의 오른쪽 여백이 거기서 끝난다. 전에는 양쪽 4 라
128
+ 오른쪽 3px 이 통 밖으로 나가 가로 넘침으로 잡혔다(실측 2026-11-03, 폭 1440: `scrollWidth`
129
+ 208 · `clientWidth` 194 중 3). 그만큼을 **왼쪽으로 옮겨** 잡는 폭(18)은 되레 넓혔다. */
130
+ inset: 0 -1px 0 -11px;
120
131
  }
121
132
  .side-nav__scroll-thumb:hover,
122
133
  .side-nav__scroll-thumb:active {
123
134
  background: var(--color-lightGray);
124
135
  }
125
136
 
126
- /* ── list: 자체 스크롤 없음 → side-nav__menu 단일 스크롤에 위임 ──────────────── */
137
+ /* ── list: **구르는 통**(2026-11-03) — 발치는 밖에 남아 늘 보인다 ─────────────── */
127
138
  .side-nav__menu-list {
128
139
  display: flex;
129
140
  flex-direction: column;
130
141
  gap: 4px;
131
- flex: 1 0 auto; /* 공간이 남으면 늘어나 footer를 아래로 밀어냄,
132
- 내용이 많으면 자연 높이 유지 → 부모 스크롤 발생 */
133
- overflow: visible;
142
+ /* 남으면 늘어나 발치를 아래로 밀고, 모자라면 **제가 줄어 구른다**(`min-height: 0` 이 없으면
143
+ flex 자식이 제 속보다 안 줄어 통이 안 생긴다). 2026-11-03 전에는 `1 0 auto` 라 안 줄었고,
144
+ 넘친 만큼이 부모(통)에서 굴러 **발치까지 함께 내려갔다.** */
145
+ flex: 1 1 auto;
146
+ min-height: 0;
147
+ overflow-y: auto;
148
+ overflow-x: hidden;
149
+ overscroll-behavior: contain;
150
+ -webkit-overflow-scrolling: touch;
151
+ /* 네이티브 막대는 안 쓴다 — 위 `__scroll-thumb` 를 직접 그린다(까닭은 그 글에) */
152
+ scrollbar-width: none;
134
153
  /* 예전엔 padding: 4px 16px + margin: 0 -16px 였는데 좌우가 정확히 상쇄돼
135
154
  항목 위치에는 아무 영향이 없고, 폭만 228px로 부풀어 부모(220px)를 넘었다
136
155
  (overflow-x: hidden에 잘려 보이지 않았을 뿐).
137
156
  **위 여백 4px 은 통 바깥(margin-top)으로 옮겼다** — 안에 두면 막대가 첫 단추보다 그만큼
138
157
  위에서 시작한다(2026-09-25). 아래 4px 은 발치와의 사이라 그대로 둔다. */
139
158
  padding: 0 0 4px;
159
+ /* **통은 여백 밖까지 펴고, 여백은 제가 다시 둔다**(2026-11-03). 떠 있는 막대는 음수 여백으로
160
+ **통의 여백 안**에 앉는데, 통이 여백 안쪽에서 끝나면 막대가 통 밖으로 나가 잘린다(실측: 막대
161
+ 211~217 · 통은 207 에서 끝 — 통째로 안 보이고 못 잡혔다).
162
+ 그렇다고 여백을 통으로 **옮기면** 발치가 그것을 잃는다(위 글). 그래서 **둘 다 한다** —
163
+ 밖으로 폈다가(`margin`) 안으로 되돌린다(`padding`). 항목 자리는 그대로고(좌우 틈 12/12),
164
+ 막대가 앉을 11px 이 통 **안**에 생긴다. 두 수는 늘 같아야 하므로 한 변수를 쓴다. */
165
+ margin-left: calc(-1 * var(--rail-pad));
166
+ margin-right: calc(-1 * var(--rail-pad));
167
+ padding-left: var(--rail-pad);
168
+ padding-right: var(--rail-pad);
140
169
  }
141
170
 
142
171
  /* ── footer: 항상 list 아래에 위치, 줄어들지 않음 ─────────────────────────── */
@@ -134,7 +134,7 @@ export default function SideNav(props) {
134
134
  if (e.currentTarget.hasPointerCapture(e.pointerId))
135
135
  e.currentTarget.releasePointerCapture(e.pointerId);
136
136
  }, []);
137
- return (_jsxs("nav", { ref: containerRef, "aria-label": t('nav.mainMenu', '메인 메뉴'), className: "side-nav__menu", children: [thumb && (_jsx("div", { className: "side-nav__scroll", "aria-hidden": "true", children: _jsx("div", { className: "side-nav__scroll-thumb", style: { top: thumb.top, height: thumb.height }, onPointerDown: onThumbDown, onPointerMove: onThumbMove, onPointerUp: onThumbUp, onPointerCancel: onThumbUp }) })), _jsxs("div", { className: "side-nav__menu-list", children: [(items || [])
137
+ return (_jsxs("nav", { "aria-label": t('nav.mainMenu', '메인 메뉴'), className: "side-nav__menu", children: [_jsxs("div", { ref: containerRef, className: "side-nav__menu-list", children: [thumb && (_jsx("div", { className: "side-nav__scroll", "aria-hidden": "true", children: _jsx("div", { className: "side-nav__scroll-thumb", style: { top: thumb.top, height: thumb.height }, onPointerDown: onThumbDown, onPointerMove: onThumbMove, onPointerUp: onThumbUp, onPointerCancel: onThumbUp }) })), (items || [])
138
138
  .filter((it) => !it.section && (it.key || it.label))
139
139
  .map((it, idx) => (_jsxs(React.Fragment, { children: [it.divider && _jsx("div", { className: "side-nav__separator" }), _jsx(SideNavButton, { item: it, active: !!it.key && it.key === activeKey, state: it.disabled ? 'disabled' : undefined, onClick: (_key, btnEl, fromPointer) => {
140
140
  if (it.disabled)
@@ -81,3 +81,26 @@ export declare function monthOptionsNow(): {
81
81
  * @public
82
82
  */
83
83
  export declare function weekLabel(t: TFunction, week: number): string;
84
+ /**
85
+ * **차트 카드 머리에 들어가는 짧은 주 이름표** — 영어 `Week 4` 대신 `W4`. @public
86
+ *
87
+ * `weekLabel` 과 **갈라 둔 까닭**: 긴 꼴을 쓰는 자리가 셋인데(차트 막대 밑글 · 고르개 ·
88
+ * 회원앱 `periodLabel`) 그중 **고르개만** 폭이 모자란다. `calendar.weekLabel` 을 통째로
89
+ * 줄이면 나머지 둘의 글까지 바뀐다 — 그래서 `yearMonthCompact` 가 `yearMonth` 의 짧은
90
+ * 짝인 것과 **같은 꼴로** 짝을 하나 둔다. 글귀는 여전히 사전이 쥔다.
91
+ *
92
+ * **왜 짧아야 하나**(실측 2026-11-03 · 카드 540 · 속 폭 500 · 글자 16px):
93
+ * `Sep 2026 Week 4` 는 상자가 **180** 이 되어 제목에 **96** 만 남고, 그러면 실제 영어 제목
94
+ * 셋(`Training Details` 105 · `Homework Detail` 117 · `Homework Completed` 153)에서
95
+ * **머리가 두 줄로 접힌다**(키 32 → 59). 그 카드는 머리가 한 줄이어야 260 을 지킨다.
96
+ * `W4` 로 줄이면 상자 **151** · 제목 **125** 로 넷이 한 줄에 선다.
97
+ *
98
+ * **한국어는 긴 꼴과 같은 값을 적는다** — `첫째주` 가 이미 짧아 줄일 것이 없다
99
+ * (`2026.10 다섯째주` 116 · 상자 166 · 제목 110, 한 줄). 안 적고 아래 물러섬에 맡기려
100
+ * 했는데 **사전 짝 못이 막았다**(`i18nLocaleParity` — *"en 에 있는 열쇠는 ko 에도 있다,
101
+ * 한쪽만 지우면 고아가 남는다"*). 그 못이 옳다 — 짝이 없는 열쇠는 번역을 빠뜨린 것과
102
+ * 일부러 안 적은 것이 **글자로 안 갈린다.** 그래서 같은 값을 적어 둔다.
103
+ *
104
+ * 아래 물러섬은 **두 말 밖**을 위해 남긴다 — 짧은 꼴이 없는 말이 들어오면 긴 꼴로 선다.
105
+ */
106
+ export declare function weekLabelCompact(t: TFunction, week: number): string;
@@ -204,3 +204,33 @@ export function weekLabel(t, week) {
204
204
  숫자 그대로(`'1'`…)여서 `Week {{ord}}` 가 같은 변수로 맞는다. */
205
205
  return t('calendar.weekLabel', { ord: ord ?? String(week + 1) });
206
206
  }
207
+ /**
208
+ * **차트 카드 머리에 들어가는 짧은 주 이름표** — 영어 `Week 4` 대신 `W4`. @public
209
+ *
210
+ * `weekLabel` 과 **갈라 둔 까닭**: 긴 꼴을 쓰는 자리가 셋인데(차트 막대 밑글 · 고르개 ·
211
+ * 회원앱 `periodLabel`) 그중 **고르개만** 폭이 모자란다. `calendar.weekLabel` 을 통째로
212
+ * 줄이면 나머지 둘의 글까지 바뀐다 — 그래서 `yearMonthCompact` 가 `yearMonth` 의 짧은
213
+ * 짝인 것과 **같은 꼴로** 짝을 하나 둔다. 글귀는 여전히 사전이 쥔다.
214
+ *
215
+ * **왜 짧아야 하나**(실측 2026-11-03 · 카드 540 · 속 폭 500 · 글자 16px):
216
+ * `Sep 2026 Week 4` 는 상자가 **180** 이 되어 제목에 **96** 만 남고, 그러면 실제 영어 제목
217
+ * 셋(`Training Details` 105 · `Homework Detail` 117 · `Homework Completed` 153)에서
218
+ * **머리가 두 줄로 접힌다**(키 32 → 59). 그 카드는 머리가 한 줄이어야 260 을 지킨다.
219
+ * `W4` 로 줄이면 상자 **151** · 제목 **125** 로 넷이 한 줄에 선다.
220
+ *
221
+ * **한국어는 긴 꼴과 같은 값을 적는다** — `첫째주` 가 이미 짧아 줄일 것이 없다
222
+ * (`2026.10 다섯째주` 116 · 상자 166 · 제목 110, 한 줄). 안 적고 아래 물러섬에 맡기려
223
+ * 했는데 **사전 짝 못이 막았다**(`i18nLocaleParity` — *"en 에 있는 열쇠는 ko 에도 있다,
224
+ * 한쪽만 지우면 고아가 남는다"*). 그 못이 옳다 — 짝이 없는 열쇠는 번역을 빠뜨린 것과
225
+ * 일부러 안 적은 것이 **글자로 안 갈린다.** 그래서 같은 값을 적어 둔다.
226
+ *
227
+ * 아래 물러섬은 **두 말 밖**을 위해 남긴다 — 짧은 꼴이 없는 말이 들어오면 긴 꼴로 선다.
228
+ */
229
+ export function weekLabelCompact(t, week) {
230
+ const ords = t('calendar.weekOrdinal', { returnObjects: true, defaultValue: [] });
231
+ const ord = Array.isArray(ords) && typeof ords[week] === 'string' ? ords[week] : null;
232
+ const value = ord ?? String(week + 1);
233
+ /* 짧은 꼴이 없으면 **빈 글자**가 오고(`defaultValue: ''`), 그때 긴 꼴로 간다 —
234
+ `exists()` 없이 "사전에 있나" 를 가르는 이 저장소의 결이다(`yearMonthLabel` 참고). */
235
+ return t('calendar.weekLabelCompact', { ord: value, defaultValue: '' }) || weekLabel(t, week);
236
+ }
@@ -1,8 +1,8 @@
1
1
  'use client';
2
2
  import { useState, useEffect, useMemo, useCallback } from 'react';
3
3
  import { useTranslation } from 'react-i18next';
4
- import { firstMondayOfMonth, todayWeekValue, monthOptionsNow, weekLabel } from './barChartData';
5
- import { yearMonthLabel } from '../utils/date';
4
+ import { firstMondayOfMonth, todayWeekValue, monthOptionsNow, weekLabelCompact } from './barChartData';
5
+ import { yearMonthLabel, formatYearMonthShort } from '../utils/date';
6
6
  import { weekValueOf } from './barChartMonthKey';
7
7
  /**
8
8
  * BarChart 기간 상태/옵션/네비게이션을 캡슐화한 훅.
@@ -26,13 +26,6 @@ export function useBarChartControl(data) {
26
26
  }
27
27
  return opts;
28
28
  }, [DATA_MONTH_OPTIONS]);
29
- /* **짧은 연월** — `2026년 11월` 이 아니라 `2026.11`(사장님 지시 2026-11-02 —
30
- "2026.11 첫째주 로 글씨 줄이고"). 고르개가 **차트 카드 머리에 다른 조절칸 셋과 한 줄로
31
- 서는데**, 긴 꼴로는 그 줄이 카드 폭을 넘어 제목이 아랫줄로 접혔다(실측 2026-11-02,
32
- 카드 540: 조절칸 416 + 제목 113 > 속 폭 502).
33
-
34
- `yearMonthLabel`(Intl) 은 **그대로 둔다** — 달력 머리줄(`Calendar`)이 쓰는 자리라
35
- 거기까지 줄이면 달력이 달을 읽기 어려워진다. 짧은 꼴은 사전이 쥔다. */
36
29
  /**
37
30
  * **짧은 연월** — `2026년 11월` 이 아니라 `2026.11`(사장님 지시 2026-11-02 —
38
31
  * "2026.11 첫째주 로 글씨 줄이고"). 고르개가 차트 카드 머리에 다른 조절칸 셋과 한 줄로
@@ -40,16 +33,27 @@ export function useBarChartControl(data) {
40
33
  * 조절칸 416 + 제목 113 > 속 폭 502).
41
34
  *
42
35
  * **어느 꼴로 적을지는 사전이 고른다** — 코드가 말을 보고 가르지 않는다(`langBranchInDict`).
43
- * 숫자(`year`·`month`)와 Intl 이 지은 긴 꼴(`full`)을 **둘 다 넘기고**, 한국어 사전은
44
- * 숫자를, 영어 사전은 긴 꼴을 쓴다(영어는 **달 이름**이 보여야 한다 —
45
- * `yearMonthEverySite`). `yearMonthLabel` 자체는 그대로 둔다 — 달력 머리줄이 쓰는 자리다.
36
+ * 숫자(`year`·`month`)와 Intl 이 지은 두 꼴(`full`·`short`)을 **다 넘기고**, 한국어 사전은
37
+ * 숫자를, 영어 사전은 **줄인 꼴**을 쓴다. 영어에 **달 이름이 보여야 하는 것은 그대로**이고
38
+ * (`yearMonthEverySite`) `Sep` 도 달 이름이다 — 줄인 것은 이름이 아니라 길이다.
39
+ *
40
+ * **영어가 긴 꼴을 쓰던 동안 이름표가 잘렸다**(청 (365), 실측 2026-11-03). 카드 540 ·
41
+ * 글자 16px 에서 이름표 칸은 **100**인데 `September 2026 Week 4` 는 **179** 가 필요해
42
+ * `September …` 로 끊겼다 — **주 수가 통째로 사라지는** 자리다. 상자를 글에 맞춰 늘리면
43
+ * 229 가 되어 **머리가 두 줄로 접힌다**(32 → 63). 줄인 꼴은 가장 긴 `May 2026 Week 4` 가
44
+ * **130**(상자 180)이라 한 줄에 선다. `yearMonthLabel`(긴 꼴)은 그대로 둔다 — 달력
45
+ * 머리줄이 쓰는 자리다.
46
46
  */
47
47
  const yearMonthShort = useCallback((year, month) => t('calendar.yearMonthCompact', {
48
48
  year, month,
49
49
  full: yearMonthLabel(t, i18n.language, year, month),
50
+ short: formatYearMonthShort(year, month, i18n.language),
50
51
  defaultValue: '{{full}}',
51
52
  }), [t, i18n.language]);
52
- const weekOptionLabel = useCallback((o) => `${yearMonthShort(o.year, o.month)} ${weekLabel(t, o.week)}`, [t, yearMonthShort]);
53
+ /* **주 이름표도 짧은 꼴을 쓴다**(`weekLabelCompact`, 영어 `W4`) — 긴 꼴이면 상자가 180 이
54
+ 되어 제목에 96 만 남고 실제 영어 제목 셋에서 머리가 두 줄로 접힌다(청 (365) 실측). 막대
55
+ 밑글과 회원앱 `periodLabel` 은 긴 꼴을 그대로 쓴다 — 모자란 것은 이 자리의 폭뿐이다. */
56
+ const weekOptionLabel = useCallback((o) => `${yearMonthShort(o.year, o.month)} ${weekLabelCompact(t, o.week)}`, [t, yearMonthShort]);
53
57
  const monthOptions = useMemo(() => DATA_MONTH_OPTIONS.map(o => ({
54
58
  value: o.value, label: yearMonthShort(o.year, o.month),
55
59
  })), [yearMonthShort, DATA_MONTH_OPTIONS]);
@@ -115,8 +115,9 @@
115
115
  "Fri",
116
116
  "Sat"
117
117
  ],
118
- "yearMonthCompact": "{{full}}",
118
+ "yearMonthCompact": "{{short}}",
119
119
  "weekLabel": "Week {{ord}}",
120
+ "weekLabelCompact": "W{{ord}}",
120
121
  "prevMonth": "Previous month",
121
122
  "addOnDate": "Add a visit on {{date}}",
122
123
  "nextMonth": "Next month",
@@ -122,6 +122,7 @@
122
122
  ],
123
123
  "yearMonthCompact": "{{year}}.{{month}}",
124
124
  "weekLabel": "{{ord}}주",
125
+ "weekLabelCompact": "{{ord}}주",
125
126
  "prevMonth": "이전 달",
126
127
  "addOnDate": "{{date}}에 방문 등록",
127
128
  "nextMonth": "다음 달",
@@ -41,6 +41,18 @@ export declare function formatDateLocale(iso: string, lang: string): string;
41
41
  */
42
42
  export declare function intlLocale(lang: string): string;
43
43
  export declare function formatYearMonth(year: number, month: number, lang: string): string;
44
+ /**
45
+ * **달 이름을 줄인 연월** — `September 2026` 대신 `Sep 2026`.
46
+ *
47
+ * 긴 꼴은 차트 카드 머리의 기간 고르개에 **안 들어간다.** 실측(2026-11-03, 카드 540 ·
48
+ * 글자 16px): `September 2026 Week 4` 는 이름표 칸 100 에 **179** 가 필요해 `September …`
49
+ * 로 잘렸고, 상자를 글에 맞춰 늘리면 229 가 되어 **머리가 두 줄로 접혔다**(32 → 63).
50
+ * 달 이름을 줄이면 `May 2026 Week 4` 가 가장 길어 **130** — 상자 180 으로 한 줄에 선다.
51
+ *
52
+ * **`formatYearMonth`(긴 꼴)은 그대로 둔다** — 달력 머리줄(`Calendar`)이 쓰는 자리라
53
+ * 거기서는 달 이름이 온전히 보여야 한다. 줄인 꼴이 필요한 자리만 이것을 부른다.
54
+ */
55
+ export declare function formatYearMonthShort(year: number, month: number, lang: string): string;
44
56
  /**
45
57
  * **연·월 이름표 — 사전이 있으면 사전, 없으면 브라우저.** @public
46
58
  *
@@ -122,6 +122,24 @@ export function formatYearMonth(year, month, lang) {
122
122
  return `${year}-${month}`;
123
123
  return new Intl.DateTimeFormat(intlLocale(lang), { year: 'numeric', month: 'long' }).format(new Date(year, month - 1, 1));
124
124
  }
125
+ /**
126
+ * **달 이름을 줄인 연월** — `September 2026` 대신 `Sep 2026`.
127
+ *
128
+ * 긴 꼴은 차트 카드 머리의 기간 고르개에 **안 들어간다.** 실측(2026-11-03, 카드 540 ·
129
+ * 글자 16px): `September 2026 Week 4` 는 이름표 칸 100 에 **179** 가 필요해 `September …`
130
+ * 로 잘렸고, 상자를 글에 맞춰 늘리면 229 가 되어 **머리가 두 줄로 접혔다**(32 → 63).
131
+ * 달 이름을 줄이면 `May 2026 Week 4` 가 가장 길어 **130** — 상자 180 으로 한 줄에 선다.
132
+ *
133
+ * **`formatYearMonth`(긴 꼴)은 그대로 둔다** — 달력 머리줄(`Calendar`)이 쓰는 자리라
134
+ * 거기서는 달 이름이 온전히 보여야 한다. 줄인 꼴이 필요한 자리만 이것을 부른다.
135
+ */
136
+ export function formatYearMonthShort(year, month, lang) {
137
+ /* 범위 밖을 받으면 긴 꼴과 **같은 꼴로** 돌려준다 — 두 함수가 같은 입력에 다른 말을
138
+ 하면 어느 쪽이 맞는지 부르는 쪽이 못 가린다. */
139
+ if (!Number.isFinite(year) || !Number.isFinite(month) || month < 1 || month > 12)
140
+ return `${year}-${month}`;
141
+ return new Intl.DateTimeFormat(intlLocale(lang), { year: 'numeric', month: 'short' }).format(new Date(year, month - 1, 1));
142
+ }
125
143
  /**
126
144
  * **연·월 이름표 — 사전이 있으면 사전, 없으면 브라우저.** @public
127
145
  *
@@ -46,4 +46,4 @@
46
46
  *
47
47
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
48
48
  */
49
- export declare const CORE_VERSION = "0.415.0";
49
+ export declare const CORE_VERSION = "0.416.0";
@@ -46,4 +46,4 @@
46
46
  *
47
47
  * 값은 손으로 적고 `test/coreVersion.test.ts` 가 package.json 과 어긋나면 운다.
48
48
  */
49
- export const CORE_VERSION = '0.415.0';
49
+ export const CORE_VERSION = '0.416.0';