@ihabdevteam/core 0.412.0 → 0.414.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.
Files changed (65) hide show
  1. package/CHANGELOG.md +663 -0
  2. package/dist/components.cjs.js +178 -177
  3. package/dist/components.esm.css +2 -2
  4. package/dist/hooks.cjs.js +5 -5
  5. package/dist/i18n.cjs.js +3 -3
  6. package/dist/ihabdevteam-core.cjs.js +184 -183
  7. package/dist/ihabdevteam-core.d.ts +306 -19
  8. package/dist/packages/core/src/components/Accordion.css +16 -0
  9. package/dist/packages/core/src/components/BarChart.css +16 -8
  10. package/dist/packages/core/src/components/BarChart.d.ts +1 -1
  11. package/dist/packages/core/src/components/BarChart.js +13 -11
  12. package/dist/packages/core/src/components/BulkBar.js +2 -1
  13. package/dist/packages/core/src/components/ChartSection.css +193 -25
  14. package/dist/packages/core/src/components/ChartSection.d.ts +94 -2
  15. package/dist/packages/core/src/components/ChartSection.js +92 -7
  16. package/dist/packages/core/src/components/ColorPicker.d.ts +2 -1
  17. package/dist/packages/core/src/components/ColorPicker.js +2 -1
  18. package/dist/packages/core/src/components/DatePicker.css +5 -0
  19. package/dist/packages/core/src/components/DatePicker.d.ts +2 -1
  20. package/dist/packages/core/src/components/DatePicker.js +1 -1
  21. package/dist/packages/core/src/components/Dropdown.css +6 -0
  22. package/dist/packages/core/src/components/Dropdown.d.ts +2 -1
  23. package/dist/packages/core/src/components/FilterPanel.js +17 -3
  24. package/dist/packages/core/src/components/Header.js +4 -4
  25. package/dist/packages/core/src/components/Panel.css +53 -6
  26. package/dist/packages/core/src/components/RingChart.js +10 -6
  27. package/dist/packages/core/src/components/SegmentedControl.css +6 -1
  28. package/dist/packages/core/src/components/SegmentedControl.d.ts +5 -1
  29. package/dist/packages/core/src/components/SegmentedControl.js +2 -1
  30. package/dist/packages/core/src/components/SideNav.js +1 -1
  31. package/dist/packages/core/src/components/StatChart.d.ts +22 -11
  32. package/dist/packages/core/src/components/StatChart.js +17 -37
  33. package/dist/packages/core/src/components/SummaryStrip.d.ts +1 -1
  34. package/dist/packages/core/src/components/SummaryStrip.js +1 -1
  35. package/dist/packages/core/src/components/Table.d.ts +36 -1
  36. package/dist/packages/core/src/components/Table.js +127 -15
  37. package/dist/packages/core/src/components/Tabs.d.ts +2 -1
  38. package/dist/packages/core/src/components/Tabs.js +2 -1
  39. package/dist/packages/core/src/components/TextField.css +20 -1
  40. package/dist/packages/core/src/components/TextField.d.ts +7 -1
  41. package/dist/packages/core/src/components/TextField.js +2 -1
  42. package/dist/packages/core/src/components/Training/TrainingCardGroup.css +22 -3
  43. package/dist/packages/core/src/components/Word/WordSearchResultBlock.js +2 -1
  44. package/dist/packages/core/src/components/Word/WordTableBlock.js +27 -7
  45. package/dist/packages/core/src/components/WordTable.js +25 -1
  46. package/dist/packages/core/src/components/barChartTypes.d.ts +12 -0
  47. package/dist/packages/core/src/components/controlSize.d.ts +87 -1
  48. package/dist/packages/core/src/components/controlSize.js +87 -1
  49. package/dist/packages/core/src/components/tableFitWidths.d.ts +19 -0
  50. package/dist/packages/core/src/components/tableFitWidths.js +26 -0
  51. package/dist/packages/core/src/components/useBarChartControl.js +27 -7
  52. package/dist/packages/core/src/components.d.ts +3 -3
  53. package/dist/packages/core/src/components.js +1 -1
  54. package/dist/packages/core/src/i18n/locales/en.json +1 -0
  55. package/dist/packages/core/src/i18n/locales/ko.json +1 -0
  56. package/dist/packages/core/src/utils/imageCompression.d.ts +109 -0
  57. package/dist/packages/core/src/utils/imageCompression.js +163 -0
  58. package/dist/packages/core/src/utils/legacyBlocks.js +5 -1
  59. package/dist/packages/core/src/utils.d.ts +1 -0
  60. package/dist/packages/core/src/utils.js +3 -0
  61. package/dist/packages/core/src/version.d.ts +1 -1
  62. package/dist/packages/core/src/version.js +1 -1
  63. package/dist/utils.cjs.js +164 -164
  64. package/package.json +1 -1
  65. package/dist/packages/core/src/components/StatChart.css +0 -93
@@ -59,6 +59,18 @@ export interface BarChartProps {
59
59
  * 굵기는 인라인이 아니라 그 변수로 박혀 있다.
60
60
  */
61
61
  barWidth?: number;
62
+ /**
63
+ * **캔버스 키(px)** — 안 주면 `size` 프리셋이 정한다(small 100 · medium 140 · large 180).
64
+ *
65
+ * 카드가 **정해진 상자에 들어가야 할 때** 쓴다. 말귀 대시보드의 `상세 현황` 차트가
66
+ * `ChartSection` 의 `large` 상자(540×260)에 서야 해서 열었다(사장님 지시 2026-11-02) —
67
+ * 260 에서 겉과 머리를 빼면 몸통에 132 가 남고 x축 라벨이 41 이라 캔버스는 90 이다.
68
+ *
69
+ * **프리셋을 바꾸는 대신 프롭을 연 까닭** — `medium` 을 140 → 90 으로 내려 봤더니
70
+ * 짝 시험 **열넷**이 빨개졌다(막대 자리를 140 으로 셈하는 자들이다). 한 화면 때문에
71
+ * 모든 차트의 막대 셈을 흔들 일이 아니다.
72
+ */
73
+ canvasHeight?: number;
62
74
  /** 섹션 제목 i18n 키 */
63
75
  titleKey: string;
64
76
  /** 제목을 머리글 몇 급으로 그릴지 — 그대로 `ChartSection` 에 넘긴다(말귀 요청 (60)③, 2026-10-02).
@@ -4,6 +4,59 @@
4
4
  * dropdown 등 요소의 size prop을 =40 으로 통일하자"* · 뒤이어 *"header 에 있는 요소들도
5
5
  * 동일하게"*).
6
6
  *
7
+ * ## **32 로 내렸다가 같은 날 되돌렸다**(2026-11-02)
8
+ *
9
+ * 차트 카드 머리의 조절칸 넷을 고르시며 *"size 모두 32 로"* 하셨고, 범위를 여쭈니
10
+ * *"줄·머리 전부"* 라 하셔서 **이 수를 32 로 내렸다.** 코어·회원앱·어드민을 그 수로 쓸었다.
11
+ *
12
+ * 그날 저녁 쓸린 화면을 보시고 **되돌리라 하셨다** — 단어검색 툴바의 드롭다운 둘과
13
+ * `PanelRow` 의 `이름` 글상자(32 · 글자 14px · 키 30)를 고르시며 *"뭐야 이건 또. 별 지랄을
14
+ * 다 해놨구만"*, 이어서 ***"이런거 작게 만든거 다 되돌려놔. chartsection 빼고"***.
15
+ *
16
+ * **그래서 32 로 남는 것은 `ChartSection`·`BarChart` 머리의 조절칸뿐이다** — 애초 지시가
17
+ * 그 넷을 가리킨 것이었으니, 거기만 **손으로 32 를 적는다**(`ChartSection.tsx` 둘 ·
18
+ * `BarChart.tsx` 넷). 그 카드는 540 × 260 에 머리가 한 줄로 서야 해서 수가 작아야 맞고,
19
+ * 그 까닭은 다른 줄·머리에는 없다.
20
+ *
21
+ * **무엇을 배웠나** — *"모두"* 가 어디까지인지는 **여쭤서 정해도 모자랐다.** 글로는
22
+ * "줄·머리 전부" 가 맞았지만, 그 말이 닿는 **화면을 보시기 전까지는 서로 다른 그림**을
23
+ * 보고 있었다. 수 하나로 수백 자리를 움직일 때는 **한 화면을 먼저 보여 드리고** 범위를
24
+ * 넓히는 쪽이 맞다.
25
+ *
26
+ * 32 로 내리며 `Dropdown`·`DatePicker` 에 **32 급을 깔았는데 그것은 남긴다** — 키 32 ·
27
+ * 모서리 8(집안 사다리 32→8 · 40→10 · 48→12). 차트 머리가 그 급을 쓰고, 급이 있는 것
28
+ * 자체는 해롭지 않다.
29
+ *
30
+ * ## 기본값도 이 수를 쓴다 (청 (408), 2026-11-02)
31
+ *
32
+ * **이 절은 수가 32 이던 동안 적혔다** — 수가 40 으로 돌아가도 **맨 것은 그대로 둔다.**
33
+ * 기본값이 이 수를 보면 수가 또 움직여도 따라오고, *"손으로 적은 수를 기본값에 두지
34
+ * 않는다"* 는 까닭은 수와 상관없이 남는다. 아래 실측의 `32` 는 **그때 섰던 수**다.
35
+ *
36
+ * 그때 32 가 깔린 것은 `Dropdown`·`DatePicker` **둘뿐**이고, `TextField`·`SegmentedControl`·
37
+ * `Tabs`·`ColorPicker` 의 기본값은 **40 에 남아 있었다.** 코어가 줄·머리를 지을 때는 이 수를
38
+ * 손에 넘기니 눈에 보이는 흠은 없었는데, **`size` 를 안 주고 부른 자리만 40 으로 섰다.**
39
+ * 실측(2026-11-02): 어드민 `TextField` 다섯 · 회원앱 셋 · 코어 셋, 나머지 셋은 **맨손 자리가
40
+ * 아예 없었다.** 어드민 업체 등록 창에서는 바로 아래 `Dropdown` 이 이미 32 라 **한 창에
41
+ * 40 과 32 가 나란히** 섰다.
42
+ *
43
+ * 그래서 넷의 기본값을 이 수로 바꿨다. 손으로 적은 수를 기본값에 두면 **이 수가 움직일 때
44
+ * 안 주고 부른 자리만 뒤에 남는다** — 2026-11-02 에 그 일이 났고, 말귀_3 이 (405) 에서
45
+ * *"`TextField` 기본을 40 으로"* 를 청했던 것을 스스로 되물렀다. 48·64 가 맞는 자리는
46
+ * **그 자리에 적는다.**
47
+ *
48
+ * ### 곁딸린 흠 하나 — 여러 줄 칸의 글자
49
+ *
50
+ * 기본값이 32 가 되자 **설명·문의 같은 여러 줄 칸의 글자가 14px 로 내려앉았다.**
51
+ * `.text-field--s32` 가 글자를 줄이는 까닭은 *박스가 작아서*인데, 여러 줄 칸의 박스는
52
+ * 작지 않다(키가 `rows` 에서 온다). 키 규칙들은 `--textarea` 를 이미 빼 두었고
53
+ * **글자 규칙만 그 제외를 빠뜨리고 있었다.**
54
+ *
55
+ * 처음에는 부르는 자리마다 `size={40}` 을 적어 막았다. 그건 **부르는 사람이 기억해야
56
+ * 하는 우회**다 — 말귀_1 이 회원앱 `HelpPage` 에서 셋째 자리를 재어 오면서 *"규칙이면
57
+ * 제가 적겠고, CSS 쪽이 맞으면 청하겠다"* 고 물어 왔고, 그 물음이 맞았다.
58
+ * `TextField.css` 의 그 한 줄에 제외를 두고 **우회 둘을 걷었다.** 안 주고 불러도 맞는다.
59
+ *
7
60
  * ## 왜 수를 한 곳에 두나
8
61
  *
9
62
  * 요소마다 기본값이 다르다 — 단추 48 · 드롭다운 48 · 날짜 48 · 글상자 40 · 고르개 40.
@@ -24,6 +77,39 @@
24
77
  * 줄·머리가 아닌 자리는 제 크기를 갖는다 — 쪽 넘김(`Pagination` 32) · 팝업 바닥 단추(`Popup` 의 `buttons` 는 48, 훈련 결과·자료 받기 창이 손으로 적는 자리는 56) ·
25
78
  * 제목 옆 뒤로 화살표(`PageTitle` 48, 글자 없이 서는 과녁이라 일부러 크다) · 단어표 칸 안의
26
79
  * 단추(표 배율을 함께 받는다). 부르는 쪽이 `actions`·`headerActions` 로 **직접 얹는** 것도
27
- * 코어가 쥐지 못한다 — 그쪽은 부르는 쪽이 40 으로 적는다.
80
+ * 코어가 쥐지 못한다 — 그쪽은 부르는 쪽이 적는다. **그 수도 이 수다**(코어가 쥔 자리만
81
+ * 맞추면 한 줄에 두 수가 섞인다). 2026-11-02 에 어드민 20파일 42곳을 32 로 옮겼다가
82
+ * 같은 날 99자리를 40 으로 되돌렸다.
83
+ *
84
+ * ## 코어가 쥐고 있는데 40 으로 남아 있던 자리 (청 (407), 2026-11-02)
85
+ *
86
+ * `BulkBar` 의 단추 둘은 `BulkAction` 으로 받은 할 일만 쓰고 크기는 **코어가 적는다** — 즉
87
+ * 부르는 쪽이 못 고친다. 말귀_3 이 어드민 열두 쪽을 쓸어 조작칸 키를 셌는데 **40 은 그
88
+ * 띠에서만** 나왔다(폭 1024: 쿠폰 쪽 32가 36·40이 4 / 버그·보안·로그 쪽 32가 20·40이 4).
89
+ * 같이 고친 자리 — `FilterPanel` 의 머리 접기 단추와 절 드롭다운, `WordSearchResultBlock` 의
90
+ * 툴바 드롭다운 둘. 셋 다 **글자로 박힌 40 을 이 수로 바꾼 것**이라, 되돌림으로 수가 40 이
91
+ * 된 지금은 **원래 모습 그대로**다 — 고칠 것이 남아 있지 않다.
92
+ *
93
+ * ## 되돌림으로 **다시 생긴 어긋남 둘** (2026-11-02, 적어만 둔다)
94
+ *
95
+ * 32 로 쓸린 동안 우연히 맞았던 자리 둘이 다시 갈렸다. 둘 다 **쓸기 전에도 그랬던 것**이고
96
+ * 지시가 되돌리라는 것이었으니 고치지 않는다 — 다만 다음에 누가 보고 흠으로 읽지 않게
97
+ * 적어 둔다.
98
+ *
99
+ * - `WordSearchResultBlock` 툴바 — 드롭다운 둘이 40, 바로 옆 `Pagination` 이 32.
100
+ * - `FilterPanel` 한 절 안 — 드롭다운 갈래가 40, 고르개 갈래가 32(옆 항목 단추에 맞춘
101
+ * `size="keyboard"` 가 닻이라 이 수와 함께 움직이지 않는다).
28
102
  */
29
103
  export declare const CONTROL_SIZE = 40;
104
+ /**
105
+ * **차트 카드 머리의 조절칸은 32 다** — 공용 수(`CONTROL_SIZE`, 40)와 **일부러 다르다.**
106
+ *
107
+ * 사장님이 2026-11-02 에 *"size 모두 32 로"* 하신 것이 **이 넷을 고르시며**였고, 저녁에
108
+ * 나머지를 다 되돌리시며 ***"chartsection 빼고"*** 라 하셨다. 그래서 여기만 남는다.
109
+ *
110
+ * 까닭이 이 카드에만 있다 — `large` 가 **540 × 260** 이라 머리가 **한 줄로** 서야 하는데,
111
+ * 조절칸 넷(◀ · 달 고르개 · ▶ · 주∣월)이 40 이면 그 줄이 카드를 넘는다(실측 2026-11-02:
112
+ * 조절칸 405 → 366 으로 줄여서야 제목 113 과 함께 속 폭 502 안에 들었고, 머리 키가
113
+ * 63 → 32 로 내려왔다). 다른 줄·머리에는 그런 폭 제약이 없다.
114
+ */
115
+ export declare const CHART_HEAD_SIZE = 32;
@@ -4,6 +4,59 @@
4
4
  * dropdown 등 요소의 size prop을 =40 으로 통일하자"* · 뒤이어 *"header 에 있는 요소들도
5
5
  * 동일하게"*).
6
6
  *
7
+ * ## **32 로 내렸다가 같은 날 되돌렸다**(2026-11-02)
8
+ *
9
+ * 차트 카드 머리의 조절칸 넷을 고르시며 *"size 모두 32 로"* 하셨고, 범위를 여쭈니
10
+ * *"줄·머리 전부"* 라 하셔서 **이 수를 32 로 내렸다.** 코어·회원앱·어드민을 그 수로 쓸었다.
11
+ *
12
+ * 그날 저녁 쓸린 화면을 보시고 **되돌리라 하셨다** — 단어검색 툴바의 드롭다운 둘과
13
+ * `PanelRow` 의 `이름` 글상자(32 · 글자 14px · 키 30)를 고르시며 *"뭐야 이건 또. 별 지랄을
14
+ * 다 해놨구만"*, 이어서 ***"이런거 작게 만든거 다 되돌려놔. chartsection 빼고"***.
15
+ *
16
+ * **그래서 32 로 남는 것은 `ChartSection`·`BarChart` 머리의 조절칸뿐이다** — 애초 지시가
17
+ * 그 넷을 가리킨 것이었으니, 거기만 **손으로 32 를 적는다**(`ChartSection.tsx` 둘 ·
18
+ * `BarChart.tsx` 넷). 그 카드는 540 × 260 에 머리가 한 줄로 서야 해서 수가 작아야 맞고,
19
+ * 그 까닭은 다른 줄·머리에는 없다.
20
+ *
21
+ * **무엇을 배웠나** — *"모두"* 가 어디까지인지는 **여쭤서 정해도 모자랐다.** 글로는
22
+ * "줄·머리 전부" 가 맞았지만, 그 말이 닿는 **화면을 보시기 전까지는 서로 다른 그림**을
23
+ * 보고 있었다. 수 하나로 수백 자리를 움직일 때는 **한 화면을 먼저 보여 드리고** 범위를
24
+ * 넓히는 쪽이 맞다.
25
+ *
26
+ * 32 로 내리며 `Dropdown`·`DatePicker` 에 **32 급을 깔았는데 그것은 남긴다** — 키 32 ·
27
+ * 모서리 8(집안 사다리 32→8 · 40→10 · 48→12). 차트 머리가 그 급을 쓰고, 급이 있는 것
28
+ * 자체는 해롭지 않다.
29
+ *
30
+ * ## 기본값도 이 수를 쓴다 (청 (408), 2026-11-02)
31
+ *
32
+ * **이 절은 수가 32 이던 동안 적혔다** — 수가 40 으로 돌아가도 **맨 것은 그대로 둔다.**
33
+ * 기본값이 이 수를 보면 수가 또 움직여도 따라오고, *"손으로 적은 수를 기본값에 두지
34
+ * 않는다"* 는 까닭은 수와 상관없이 남는다. 아래 실측의 `32` 는 **그때 섰던 수**다.
35
+ *
36
+ * 그때 32 가 깔린 것은 `Dropdown`·`DatePicker` **둘뿐**이고, `TextField`·`SegmentedControl`·
37
+ * `Tabs`·`ColorPicker` 의 기본값은 **40 에 남아 있었다.** 코어가 줄·머리를 지을 때는 이 수를
38
+ * 손에 넘기니 눈에 보이는 흠은 없었는데, **`size` 를 안 주고 부른 자리만 40 으로 섰다.**
39
+ * 실측(2026-11-02): 어드민 `TextField` 다섯 · 회원앱 셋 · 코어 셋, 나머지 셋은 **맨손 자리가
40
+ * 아예 없었다.** 어드민 업체 등록 창에서는 바로 아래 `Dropdown` 이 이미 32 라 **한 창에
41
+ * 40 과 32 가 나란히** 섰다.
42
+ *
43
+ * 그래서 넷의 기본값을 이 수로 바꿨다. 손으로 적은 수를 기본값에 두면 **이 수가 움직일 때
44
+ * 안 주고 부른 자리만 뒤에 남는다** — 2026-11-02 에 그 일이 났고, 말귀_3 이 (405) 에서
45
+ * *"`TextField` 기본을 40 으로"* 를 청했던 것을 스스로 되물렀다. 48·64 가 맞는 자리는
46
+ * **그 자리에 적는다.**
47
+ *
48
+ * ### 곁딸린 흠 하나 — 여러 줄 칸의 글자
49
+ *
50
+ * 기본값이 32 가 되자 **설명·문의 같은 여러 줄 칸의 글자가 14px 로 내려앉았다.**
51
+ * `.text-field--s32` 가 글자를 줄이는 까닭은 *박스가 작아서*인데, 여러 줄 칸의 박스는
52
+ * 작지 않다(키가 `rows` 에서 온다). 키 규칙들은 `--textarea` 를 이미 빼 두었고
53
+ * **글자 규칙만 그 제외를 빠뜨리고 있었다.**
54
+ *
55
+ * 처음에는 부르는 자리마다 `size={40}` 을 적어 막았다. 그건 **부르는 사람이 기억해야
56
+ * 하는 우회**다 — 말귀_1 이 회원앱 `HelpPage` 에서 셋째 자리를 재어 오면서 *"규칙이면
57
+ * 제가 적겠고, CSS 쪽이 맞으면 청하겠다"* 고 물어 왔고, 그 물음이 맞았다.
58
+ * `TextField.css` 의 그 한 줄에 제외를 두고 **우회 둘을 걷었다.** 안 주고 불러도 맞는다.
59
+ *
7
60
  * ## 왜 수를 한 곳에 두나
8
61
  *
9
62
  * 요소마다 기본값이 다르다 — 단추 48 · 드롭다운 48 · 날짜 48 · 글상자 40 · 고르개 40.
@@ -24,6 +77,39 @@
24
77
  * 줄·머리가 아닌 자리는 제 크기를 갖는다 — 쪽 넘김(`Pagination` 32) · 팝업 바닥 단추(`Popup` 의 `buttons` 는 48, 훈련 결과·자료 받기 창이 손으로 적는 자리는 56) ·
25
78
  * 제목 옆 뒤로 화살표(`PageTitle` 48, 글자 없이 서는 과녁이라 일부러 크다) · 단어표 칸 안의
26
79
  * 단추(표 배율을 함께 받는다). 부르는 쪽이 `actions`·`headerActions` 로 **직접 얹는** 것도
27
- * 코어가 쥐지 못한다 — 그쪽은 부르는 쪽이 40 으로 적는다.
80
+ * 코어가 쥐지 못한다 — 그쪽은 부르는 쪽이 적는다. **그 수도 이 수다**(코어가 쥔 자리만
81
+ * 맞추면 한 줄에 두 수가 섞인다). 2026-11-02 에 어드민 20파일 42곳을 32 로 옮겼다가
82
+ * 같은 날 99자리를 40 으로 되돌렸다.
83
+ *
84
+ * ## 코어가 쥐고 있는데 40 으로 남아 있던 자리 (청 (407), 2026-11-02)
85
+ *
86
+ * `BulkBar` 의 단추 둘은 `BulkAction` 으로 받은 할 일만 쓰고 크기는 **코어가 적는다** — 즉
87
+ * 부르는 쪽이 못 고친다. 말귀_3 이 어드민 열두 쪽을 쓸어 조작칸 키를 셌는데 **40 은 그
88
+ * 띠에서만** 나왔다(폭 1024: 쿠폰 쪽 32가 36·40이 4 / 버그·보안·로그 쪽 32가 20·40이 4).
89
+ * 같이 고친 자리 — `FilterPanel` 의 머리 접기 단추와 절 드롭다운, `WordSearchResultBlock` 의
90
+ * 툴바 드롭다운 둘. 셋 다 **글자로 박힌 40 을 이 수로 바꾼 것**이라, 되돌림으로 수가 40 이
91
+ * 된 지금은 **원래 모습 그대로**다 — 고칠 것이 남아 있지 않다.
92
+ *
93
+ * ## 되돌림으로 **다시 생긴 어긋남 둘** (2026-11-02, 적어만 둔다)
94
+ *
95
+ * 32 로 쓸린 동안 우연히 맞았던 자리 둘이 다시 갈렸다. 둘 다 **쓸기 전에도 그랬던 것**이고
96
+ * 지시가 되돌리라는 것이었으니 고치지 않는다 — 다만 다음에 누가 보고 흠으로 읽지 않게
97
+ * 적어 둔다.
98
+ *
99
+ * - `WordSearchResultBlock` 툴바 — 드롭다운 둘이 40, 바로 옆 `Pagination` 이 32.
100
+ * - `FilterPanel` 한 절 안 — 드롭다운 갈래가 40, 고르개 갈래가 32(옆 항목 단추에 맞춘
101
+ * `size="keyboard"` 가 닻이라 이 수와 함께 움직이지 않는다).
28
102
  */
29
103
  export const CONTROL_SIZE = 40;
104
+ /**
105
+ * **차트 카드 머리의 조절칸은 32 다** — 공용 수(`CONTROL_SIZE`, 40)와 **일부러 다르다.**
106
+ *
107
+ * 사장님이 2026-11-02 에 *"size 모두 32 로"* 하신 것이 **이 넷을 고르시며**였고, 저녁에
108
+ * 나머지를 다 되돌리시며 ***"chartsection 빼고"*** 라 하셨다. 그래서 여기만 남는다.
109
+ *
110
+ * 까닭이 이 카드에만 있다 — `large` 가 **540 × 260** 이라 머리가 **한 줄로** 서야 하는데,
111
+ * 조절칸 넷(◀ · 달 고르개 · ▶ · 주∣월)이 40 이면 그 줄이 카드를 넘는다(실측 2026-11-02:
112
+ * 조절칸 405 → 366 으로 줄여서야 제목 113 과 함께 속 폭 502 안에 들었고, 머리 키가
113
+ * 63 → 32 로 내려왔다). 다른 줄·머리에는 그런 폭 제약이 없다.
114
+ */
115
+ export const CHART_HEAD_SIZE = 32;
@@ -23,6 +23,25 @@ export interface FitWidthsOptions {
23
23
  /** 열들이 채울 그릇의 안쪽 폭 */
24
24
  containerWidth: number;
25
25
  }
26
+ /**
27
+ * **줄일 자유가 있는가** — 없으면 맞추려 들면 안 된다(말귀 청 (361), 2026-10-31).
28
+ *
29
+ * `fitFluidWidths` 는 잰 값을 그릇에 맞게 비율로 줄인다. 그런데 **바닥 합이 이미 쓸 수 있는
30
+ * 폭보다 넓으면** 그 식은 `Math.max(floorOf(i), …)` 에서 전부 바닥으로 떨어져 **비율이
31
+ * 사라진다.** 넘치는 것은 그대로인데 비율만 잃으니 더 나쁜 꼴이다.
32
+ *
33
+ * 코어 놀이터 실측(통 778 · 일곱 칸 `minmax(260px,2fr) minmax(150px,0.8fr) …`):
34
+ * 선언된 틀은 `311 150 156 156 140 171 156`(합 1240)인데, 맞추면
35
+ * `260 150 150 150 120 150 150`(합 1130) — **전부 바닥**이다. 바닥 합 1130 이 쓸 수 있는
36
+ * 폭 738 보다 넓어 식에 자유가 없었다.
37
+ *
38
+ * 그리고 **갇힌다** — 한 번 픽셀로 굳으면 다시 재도 같은 바닥이 나온다(세 번 더 눌러도
39
+ * 같은 값이었다). 쪽을 넘길 때마다 재는 표(`refitOn`)에서는 쪽 넘김마다 이것을 밟는다.
40
+ *
41
+ * 그래서 자유가 없으면 부르는 쪽이 **아무것도 쓰지 않고** 선언된 틀을 그대로 둔다 —
42
+ * 브라우저가 `fr` 로 비율을 나눠 주어 **처음 연 모습과 글자까지 같다.**
43
+ */
44
+ export declare function fitHasNoFreedom(measured: readonly number[], opts: FitWidthsOptions): boolean;
26
45
  export declare function fitFluidWidths(measured: readonly number[], opts: FitWidthsOptions): number[];
27
46
  /** 정렬 화살표가 드는 폭 — `SortArrow` 의 `size={16}` 과 같아야 한다(어긋나면 머리가 잘린다) */
28
47
  export declare const SORT_ARROW_W = 16;
@@ -15,6 +15,32 @@
15
15
  * 바닥에 걸린 열이 있으면 합이 그릇을 넘을 수 있다. 그것은 **담을 수 없을 만큼 좁다는 뜻**
16
16
  * 이라 가로 스크롤로 두는 편이 맞다 — 잘려 안 보이는 것보다 밀어서 보는 편이 낫다.
17
17
  */
18
+ /**
19
+ * **줄일 자유가 있는가** — 없으면 맞추려 들면 안 된다(말귀 청 (361), 2026-10-31).
20
+ *
21
+ * `fitFluidWidths` 는 잰 값을 그릇에 맞게 비율로 줄인다. 그런데 **바닥 합이 이미 쓸 수 있는
22
+ * 폭보다 넓으면** 그 식은 `Math.max(floorOf(i), …)` 에서 전부 바닥으로 떨어져 **비율이
23
+ * 사라진다.** 넘치는 것은 그대로인데 비율만 잃으니 더 나쁜 꼴이다.
24
+ *
25
+ * 코어 놀이터 실측(통 778 · 일곱 칸 `minmax(260px,2fr) minmax(150px,0.8fr) …`):
26
+ * 선언된 틀은 `311 150 156 156 140 171 156`(합 1240)인데, 맞추면
27
+ * `260 150 150 150 120 150 150`(합 1130) — **전부 바닥**이다. 바닥 합 1130 이 쓸 수 있는
28
+ * 폭 738 보다 넓어 식에 자유가 없었다.
29
+ *
30
+ * 그리고 **갇힌다** — 한 번 픽셀로 굳으면 다시 재도 같은 바닥이 나온다(세 번 더 눌러도
31
+ * 같은 값이었다). 쪽을 넘길 때마다 재는 표(`refitOn`)에서는 쪽 넘김마다 이것을 밟는다.
32
+ *
33
+ * 그래서 자유가 없으면 부르는 쪽이 **아무것도 쓰지 않고** 선언된 틀을 그대로 둔다 —
34
+ * 브라우저가 `fr` 로 비율을 나눠 주어 **처음 연 모습과 글자까지 같다.**
35
+ */
36
+ export function fitHasNoFreedom(measured, opts) {
37
+ const { isFixed, floorOf, containerWidth } = opts;
38
+ if (!(containerWidth > 0))
39
+ return false; /* 그릇을 아직 모른다 — 여기서 가름하지 않는다 */
40
+ const fixedTotal = measured.reduce((a, w, i) => a + (isFixed(i) ? w : 0), 0);
41
+ const floorTotal = measured.reduce((a, _w, i) => a + (isFixed(i) ? 0 : floorOf(i)), 0);
42
+ return floorTotal > containerWidth - fixedTotal;
43
+ }
18
44
  export function fitFluidWidths(measured, opts) {
19
45
  const { isFixed, floorOf, containerWidth } = opts;
20
46
  const fixedTotal = measured.reduce((a, w, i) => a + (isFixed(i) ? w : 0), 0);
@@ -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 { yearMonthLabel } from '../utils/date';
5
4
  import { firstMondayOfMonth, todayWeekValue, monthOptionsNow, weekLabel } from './barChartData';
5
+ import { yearMonthLabel } from '../utils/date';
6
6
  import { weekValueOf } from './barChartMonthKey';
7
7
  /**
8
8
  * BarChart 기간 상태/옵션/네비게이션을 캡슐화한 훅.
@@ -26,13 +26,33 @@ export function useBarChartControl(data) {
26
26
  }
27
27
  return opts;
28
28
  }, [DATA_MONTH_OPTIONS]);
29
- const weekOptionLabel = useCallback((o) => {
30
- const m = yearMonthLabel(t, i18n.language, o.year, o.month);
31
- return `${m} ${weekLabel(t, o.week)}`;
32
- }, [t]);
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
+ /**
37
+ * **짧은 연월** — `2026년 11월` 이 아니라 `2026.11`(사장님 지시 2026-11-02 —
38
+ * "2026.11 첫째주 로 글씨 줄이고"). 고르개가 차트 카드 머리에 다른 조절칸 셋과 한 줄로
39
+ * 서는데, 긴 꼴로는 그 줄이 카드 폭을 넘어 제목이 아랫줄로 접혔다(실측: 카드 540 ·
40
+ * 조절칸 416 + 제목 113 > 속 폭 502).
41
+ *
42
+ * **어느 꼴로 적을지는 사전이 고른다** — 코드가 말을 보고 가르지 않는다(`langBranchInDict`).
43
+ * 숫자(`year`·`month`)와 Intl 이 지은 긴 꼴(`full`)을 **둘 다 넘기고**, 한국어 사전은
44
+ * 숫자를, 영어 사전은 긴 꼴을 쓴다(영어는 **달 이름**이 보여야 한다 —
45
+ * `yearMonthEverySite`). `yearMonthLabel` 자체는 그대로 둔다 — 달력 머리줄이 쓰는 자리다.
46
+ */
47
+ const yearMonthShort = useCallback((year, month) => t('calendar.yearMonthCompact', {
48
+ year, month,
49
+ full: yearMonthLabel(t, i18n.language, year, month),
50
+ defaultValue: '{{full}}',
51
+ }), [t, i18n.language]);
52
+ const weekOptionLabel = useCallback((o) => `${yearMonthShort(o.year, o.month)} ${weekLabel(t, o.week)}`, [t, yearMonthShort]);
33
53
  const monthOptions = useMemo(() => DATA_MONTH_OPTIONS.map(o => ({
34
- value: o.value, label: yearMonthLabel(t, i18n.language, o.year, o.month),
35
- })), [t, i18n.language, DATA_MONTH_OPTIONS]);
54
+ value: o.value, label: yearMonthShort(o.year, o.month),
55
+ })), [yearMonthShort, DATA_MONTH_OPTIONS]);
36
56
  const weekOptions = useMemo(() => WEEK_OPTIONS.map(o => ({ value: o.value, label: weekOptionLabel(o) })), [WEEK_OPTIONS, weekOptionLabel]);
37
57
  // 진입 시 기본 선택을 오늘 기준으로 — 오늘이 속한 월/주(데이터에 있으면), 없으면 최신
38
58
  // eslint-disable-next-line react-hooks/exhaustive-deps
@@ -159,10 +159,10 @@ export type { LineChartProps, LineChartPoint, LineChartScales } from './componen
159
159
  export type { GameIntroProps, GameIntroTip, GameIntroTipGroup, GameIntroStart } from './components/GameIntro';
160
160
  export { default as RingChart } from './components/RingChart';
161
161
  export type { RingChartProps, RingChartSize, RingChartSegment } from './components/RingChart';
162
- export { default as ChartSection, ChartTotal, ChartLegend } from './components/ChartSection';
163
- export type { ChartSectionProps, ChartTotalProps, ChartLegendItem } from './components/ChartSection';
162
+ export { default as ChartSection, ChartTotal, ChartLegend, chartTotalNumClass } from './components/ChartSection';
163
+ export type { ChartSectionProps, ChartTotalProps, ChartLegendItem, ChartSectionType, StatChartSize, StatChartChangeType, StatChartBodyAlign } from './components/ChartSection';
164
164
  export { default as StatChart } from './components/StatChart';
165
- export type { StatChartProps, StatChartChangeType } from './components/StatChart';
165
+ export type { StatChartProps } from './components/StatChart';
166
166
  export { default as Slider } from './components/Slider';
167
167
  export type { SliderProps } from './components/Slider';
168
168
  export { default as AudioMeter } from './components/AudioMeter';
@@ -108,7 +108,7 @@ export { buildMonthChartData } from './components/barChartData';
108
108
  export { monthKeyOf, monthKeyOfDate, parseMonthKey, weekValueOf } from './components/barChartMonthKey';
109
109
  export { getControlDateRange } from './components/barChartTypes';
110
110
  export { default as RingChart } from './components/RingChart';
111
- export { default as ChartSection, ChartTotal, ChartLegend } from './components/ChartSection';
111
+ export { default as ChartSection, ChartTotal, ChartLegend, chartTotalNumClass } from './components/ChartSection';
112
112
  export { default as StatChart } from './components/StatChart';
113
113
  export { default as Slider } from './components/Slider';
114
114
  export { default as AudioMeter } from './components/AudioMeter';
@@ -115,6 +115,7 @@
115
115
  "Fri",
116
116
  "Sat"
117
117
  ],
118
+ "yearMonthCompact": "{{full}}",
118
119
  "weekLabel": "Week {{ord}}",
119
120
  "prevMonth": "Previous month",
120
121
  "addOnDate": "Add a visit on {{date}}",
@@ -120,6 +120,7 @@
120
120
  "여섯째",
121
121
  "일곱째"
122
122
  ],
123
+ "yearMonthCompact": "{{year}}.{{month}}",
123
124
  "weekLabel": "{{ord}}주",
124
125
  "prevMonth": "이전 달",
125
126
  "addOnDate": "{{date}}에 방문 등록",
@@ -0,0 +1,109 @@
1
+ /**
2
+ * **그림을 가볍게 하는 한 벌** — 올릴 때 줄이고, 내려받을 때 줄여 받는다.
3
+ *
4
+ * 두 앱이 같은 그림을 다르게 다루고 있었다(2026-10-31 실측) —
5
+ *
6
+ * | 통 | 장수 | 합 | 평균 | 가장 큰 것 |
7
+ * |---|---|---|---|---|
8
+ * | `WordImage`(사전, NAS 에이전트가 올린다) | 2,252 | **631 MB** | 287 kB | 1,047 kB |
9
+ * | `WordImageCustom`(사람이 더한 낱말) | 9 | 826 kB | 92 kB | 244 kB |
10
+ *
11
+ * 그런데 **그려지는 가장 큰 자리가 360px** 이다(훈련 카드. 표 썸네일 28 · 호버 풍선 120 ·
12
+ * 추가 창 미리보기 160). 287 kB 를 받아 28px 로 그리는 셈이었다.
13
+ *
14
+ * 그래서 두 길을 둔다 —
15
+ *
16
+ * **① 올릴 때 줄인다**(`compressImageFile`) — 브라우저 캔버스로 다시 그린다. 사람이 고른
17
+ * 원본이 들어오는 자리(말귀 '단어 추가', 말귀어드민)가 그 자리다.
18
+ *
19
+ * **② 내려받을 때 줄여 받는다**(`imageTransformUrl`) — Supabase 의 그림 변환이다. 파일은
20
+ * 그대로 두고 **받는 양만** 줄인다. 이미 올라간 631 MB 에 손대지 않고 듣는다.
21
+ *
22
+ * 둘이 **같은 수**를 봐야 한다 — 한쪽만 고치면 올린 것과 받는 것이 어긋난다. 그래서 수가
23
+ * 이 파일 한 자리에 있고, 말귀·말귀어드민이 여기서 읽어 간다(말귀어드민 '데이터 · 단어
24
+ * 이미지' 판이 이 수를 그대로 화면에 적는다).
25
+ *
26
+ * **NAS 에이전트는 이 저장소 밖이다** — 사전 그림을 올리는 자가 그쪽이라, ① 은 아직
27
+ * 그 길에 없다. 판에 적힌 수가 그쪽이 따라야 할 약속이다.
28
+ */
29
+ /** 올릴 때의 잣대 — 긴 변과 품질과 꼴 */
30
+ export interface ImageCompressionPolicy {
31
+ /** 긴 변을 이 길이로 줄인다(짧은 변은 비율대로). 이보다 작으면 **안 늘린다** */
32
+ maxEdge: number;
33
+ /** 0~1. `image/webp` 와 `image/jpeg` 에만 듣는다 */
34
+ quality: number;
35
+ /** 다시 구울 꼴 */
36
+ type: 'image/webp' | 'image/jpeg';
37
+ }
38
+ /**
39
+ * **기본 잣대** — 긴 변 720 · 품질 0.8 · webp.
40
+ *
41
+ * 720 은 **가장 큰 자리(360px)의 두 배**다 — 레티나에서 1:1 로 찍힌다. 그보다 크게 두면
42
+ * 아무 데서도 안 쓰이는 화소를 지고 다닌다.
43
+ */
44
+ export declare const imageCompressionPolicy: ImageCompressionPolicy;
45
+ /**
46
+ * **그려지는 자리마다의 폭**(CSS 픽셀의 두 배 — 레티나 기준).
47
+ *
48
+ * 받을 때 이 수를 `imageTransformUrl` 에 준다. 자리마다 손으로 수를 적으면 한 자리만
49
+ * 고쳐지고 나머지는 옛 수로 남는다.
50
+ */
51
+ export declare const imageViewWidth: {
52
+ /** 표 썸네일 28px */
53
+ readonly thumb: 56;
54
+ /** 호버 풍선 120px */
55
+ readonly tip: 240;
56
+ /** 훈련 카드 360px */
57
+ readonly card: 720;
58
+ };
59
+ /** 받을 때의 품질 — 변환이 돌려주는 그림의 품질이다(올릴 때의 것과 다른 수다) */
60
+ export declare const imageTransformQuality = 70;
61
+ /** 다시 구워도 되는 꼴인가 — **움직이는 GIF 는 뺀다**(캔버스로 그리면 첫 장만 남는다) */
62
+ export declare function canCompressImageType(type: string): boolean;
63
+ /**
64
+ * **줄인 뒤의 크기** — 긴 변이 `maxEdge` 를 넘을 때만 줄인다.
65
+ *
66
+ * 올림이 아니라 **버림**이다(`Math.round`) — 반올림하면 비율이 한 화소 어긋나 가장자리에
67
+ * 빈 줄이 생기는 그림이 있다.
68
+ */
69
+ export declare function fittedSize(width: number, height: number, maxEdge?: number): {
70
+ width: number;
71
+ height: number;
72
+ };
73
+ /**
74
+ * **받는 주소를 줄여 받는 주소로** — Supabase 의 그림 변환이다.
75
+ *
76
+ * `…/storage/v1/object/public/<통>/<자리>` 를 `…/storage/v1/render/image/public/<통>/<자리>`
77
+ * 로 바꾸고 폭과 품질을 붙인다. 실측(2026-10-31, 사전 그림 한 장 311 kB) —
78
+ *
79
+ * | 폭 | 받은 양 |
80
+ * |---|---|
81
+ * | 56 | **4.4 kB** |
82
+ * | 120 | 7.5 kB |
83
+ * | 240 | 14.8 kB |
84
+ * | 360 | 21.3 kB |
85
+ * | 720 | 42.2 kB |
86
+ *
87
+ * **이 통의 주소가 아니면 그대로 돌려준다** — 밖에서 온 주소(`blob:` 미리보기, 다른 호스트)
88
+ * 에 이 길을 붙이면 **404 가 아니라 안 그려지는 그림**이 된다.
89
+ */
90
+ export declare function imageTransformUrl(url: string, option: {
91
+ width: number;
92
+ height?: number;
93
+ quality?: number;
94
+ } | undefined): string;
95
+ /**
96
+ * **그림 하나를 줄여 다시 굽는다** — 브라우저에서만 돈다(캔버스를 쓴다).
97
+ *
98
+ * 돌려주는 것은 **새 `File`** 이다. 이름의 확장자도 꼴에 맞춰 바꾼다 — 올리는 쪽이
99
+ * 확장자로 경로를 지으므로, 안 바꾸면 `.png` 라는 이름의 webp 가 올라간다.
100
+ *
101
+ * **원본을 그대로 돌려주는 때가 셋** 있다. 어느 쪽이든 **올리는 일은 그대로 된다** —
102
+ * 줄이기는 덤이지 조건이 아니다.
103
+ * · 다시 구울 수 없는 꼴(움직이는 GIF)
104
+ * · 캔버스가 없거나 굽기가 실패한 때(옛 브라우저·웹워커 밖)
105
+ * · **구운 것이 원본보다 큰 때** — 이미 잘 눌린 작은 그림이 그렇다
106
+ */
107
+ export declare function compressImageFile(file: File, policy?: ImageCompressionPolicy): Promise<File>;
108
+ /** 꼴에 맞게 확장자를 바꾼 이름 — `사진.png` → `사진.webp` */
109
+ export declare function renamedForType(name: string, type: ImageCompressionPolicy['type']): string;
@@ -0,0 +1,163 @@
1
+ /**
2
+ * **그림을 가볍게 하는 한 벌** — 올릴 때 줄이고, 내려받을 때 줄여 받는다.
3
+ *
4
+ * 두 앱이 같은 그림을 다르게 다루고 있었다(2026-10-31 실측) —
5
+ *
6
+ * | 통 | 장수 | 합 | 평균 | 가장 큰 것 |
7
+ * |---|---|---|---|---|
8
+ * | `WordImage`(사전, NAS 에이전트가 올린다) | 2,252 | **631 MB** | 287 kB | 1,047 kB |
9
+ * | `WordImageCustom`(사람이 더한 낱말) | 9 | 826 kB | 92 kB | 244 kB |
10
+ *
11
+ * 그런데 **그려지는 가장 큰 자리가 360px** 이다(훈련 카드. 표 썸네일 28 · 호버 풍선 120 ·
12
+ * 추가 창 미리보기 160). 287 kB 를 받아 28px 로 그리는 셈이었다.
13
+ *
14
+ * 그래서 두 길을 둔다 —
15
+ *
16
+ * **① 올릴 때 줄인다**(`compressImageFile`) — 브라우저 캔버스로 다시 그린다. 사람이 고른
17
+ * 원본이 들어오는 자리(말귀 '단어 추가', 말귀어드민)가 그 자리다.
18
+ *
19
+ * **② 내려받을 때 줄여 받는다**(`imageTransformUrl`) — Supabase 의 그림 변환이다. 파일은
20
+ * 그대로 두고 **받는 양만** 줄인다. 이미 올라간 631 MB 에 손대지 않고 듣는다.
21
+ *
22
+ * 둘이 **같은 수**를 봐야 한다 — 한쪽만 고치면 올린 것과 받는 것이 어긋난다. 그래서 수가
23
+ * 이 파일 한 자리에 있고, 말귀·말귀어드민이 여기서 읽어 간다(말귀어드민 '데이터 · 단어
24
+ * 이미지' 판이 이 수를 그대로 화면에 적는다).
25
+ *
26
+ * **NAS 에이전트는 이 저장소 밖이다** — 사전 그림을 올리는 자가 그쪽이라, ① 은 아직
27
+ * 그 길에 없다. 판에 적힌 수가 그쪽이 따라야 할 약속이다.
28
+ */
29
+ /**
30
+ * **기본 잣대** — 긴 변 720 · 품질 0.8 · webp.
31
+ *
32
+ * 720 은 **가장 큰 자리(360px)의 두 배**다 — 레티나에서 1:1 로 찍힌다. 그보다 크게 두면
33
+ * 아무 데서도 안 쓰이는 화소를 지고 다닌다.
34
+ */
35
+ export const imageCompressionPolicy = {
36
+ maxEdge: 720,
37
+ quality: 0.8,
38
+ type: 'image/webp',
39
+ };
40
+ /**
41
+ * **그려지는 자리마다의 폭**(CSS 픽셀의 두 배 — 레티나 기준).
42
+ *
43
+ * 받을 때 이 수를 `imageTransformUrl` 에 준다. 자리마다 손으로 수를 적으면 한 자리만
44
+ * 고쳐지고 나머지는 옛 수로 남는다.
45
+ */
46
+ export const imageViewWidth = {
47
+ /** 표 썸네일 28px */
48
+ thumb: 56,
49
+ /** 호버 풍선 120px */
50
+ tip: 240,
51
+ /** 훈련 카드 360px */
52
+ card: 720,
53
+ };
54
+ /** 받을 때의 품질 — 변환이 돌려주는 그림의 품질이다(올릴 때의 것과 다른 수다) */
55
+ export const imageTransformQuality = 70;
56
+ /** 다시 구워도 되는 꼴인가 — **움직이는 GIF 는 뺀다**(캔버스로 그리면 첫 장만 남는다) */
57
+ export function canCompressImageType(type) {
58
+ return type === 'image/jpeg' || type === 'image/png' || type === 'image/webp';
59
+ }
60
+ /**
61
+ * **줄인 뒤의 크기** — 긴 변이 `maxEdge` 를 넘을 때만 줄인다.
62
+ *
63
+ * 올림이 아니라 **버림**이다(`Math.round`) — 반올림하면 비율이 한 화소 어긋나 가장자리에
64
+ * 빈 줄이 생기는 그림이 있다.
65
+ */
66
+ export function fittedSize(width, height, maxEdge = imageCompressionPolicy.maxEdge) {
67
+ const longest = Math.max(width, height);
68
+ if (longest <= maxEdge || longest === 0)
69
+ return { width, height };
70
+ const scale = maxEdge / longest;
71
+ return { width: Math.max(1, Math.round(width * scale)), height: Math.max(1, Math.round(height * scale)) };
72
+ }
73
+ /**
74
+ * **받는 주소를 줄여 받는 주소로** — Supabase 의 그림 변환이다.
75
+ *
76
+ * `…/storage/v1/object/public/<통>/<자리>` 를 `…/storage/v1/render/image/public/<통>/<자리>`
77
+ * 로 바꾸고 폭과 품질을 붙인다. 실측(2026-10-31, 사전 그림 한 장 311 kB) —
78
+ *
79
+ * | 폭 | 받은 양 |
80
+ * |---|---|
81
+ * | 56 | **4.4 kB** |
82
+ * | 120 | 7.5 kB |
83
+ * | 240 | 14.8 kB |
84
+ * | 360 | 21.3 kB |
85
+ * | 720 | 42.2 kB |
86
+ *
87
+ * **이 통의 주소가 아니면 그대로 돌려준다** — 밖에서 온 주소(`blob:` 미리보기, 다른 호스트)
88
+ * 에 이 길을 붙이면 **404 가 아니라 안 그려지는 그림**이 된다.
89
+ */
90
+ export function imageTransformUrl(url, option) {
91
+ if (!url || !option)
92
+ return url;
93
+ const mark = '/storage/v1/object/public/';
94
+ const at = url.indexOf(mark);
95
+ if (at < 0)
96
+ return url;
97
+ const head = url.slice(0, at);
98
+ const tail = url.slice(at + mark.length);
99
+ /* 이미 물음표가 붙어 있으면(`?v=…` 같은 것) 그 뒤에 잇는다 */
100
+ const join = tail.includes('?') ? '&' : '?';
101
+ const quality = option.quality ?? imageTransformQuality;
102
+ /**
103
+ * **키까지 주면 네모 안에 다 담아 받는다**(`resize=contain`).
104
+ *
105
+ * 폭만 주면 비율대로 **키가 제멋대로 길어진다** — 28px 네모에 그릴 그림을 56×532 로
106
+ * 받는 식이다. 네모를 주면 긴 변이 그 네모에 맞는다. **여백은 안 붙는다**(실측
107
+ * 2026-10-31: 56×532 짜리가 `width=56&height=56&resize=contain` 에서 **56×50**,
108
+ * 3,197 → **1,386 바이트**).
109
+ *
110
+ * 그릴 때 `object-fit: contain` 과 짝이다 — 받는 쪽과 그리는 쪽이 같은 말을 해야
111
+ * 그림이 안 잘린다.
112
+ */
113
+ const box = option.height != null ? `&height=${option.height}&resize=contain` : '';
114
+ return `${head}/storage/v1/render/image/public/${tail}${join}width=${option.width}${box}&quality=${quality}`;
115
+ }
116
+ /**
117
+ * **그림 하나를 줄여 다시 굽는다** — 브라우저에서만 돈다(캔버스를 쓴다).
118
+ *
119
+ * 돌려주는 것은 **새 `File`** 이다. 이름의 확장자도 꼴에 맞춰 바꾼다 — 올리는 쪽이
120
+ * 확장자로 경로를 지으므로, 안 바꾸면 `.png` 라는 이름의 webp 가 올라간다.
121
+ *
122
+ * **원본을 그대로 돌려주는 때가 셋** 있다. 어느 쪽이든 **올리는 일은 그대로 된다** —
123
+ * 줄이기는 덤이지 조건이 아니다.
124
+ * · 다시 구울 수 없는 꼴(움직이는 GIF)
125
+ * · 캔버스가 없거나 굽기가 실패한 때(옛 브라우저·웹워커 밖)
126
+ * · **구운 것이 원본보다 큰 때** — 이미 잘 눌린 작은 그림이 그렇다
127
+ */
128
+ export async function compressImageFile(file, policy = imageCompressionPolicy) {
129
+ if (!canCompressImageType(file.type))
130
+ return file;
131
+ if (typeof document === 'undefined' || typeof createImageBitmap !== 'function')
132
+ return file;
133
+ try {
134
+ const source = await createImageBitmap(file);
135
+ const size = fittedSize(source.width, source.height, policy.maxEdge);
136
+ const canvas = document.createElement('canvas');
137
+ canvas.width = size.width;
138
+ canvas.height = size.height;
139
+ const paint = canvas.getContext('2d');
140
+ if (!paint)
141
+ return file;
142
+ paint.drawImage(source, 0, 0, size.width, size.height);
143
+ source.close?.();
144
+ const blob = await new Promise(done => canvas.toBlob(done, policy.type, policy.quality));
145
+ if (!blob || blob.size >= file.size)
146
+ return file;
147
+ return new File([blob], renamedForType(file.name, policy.type), {
148
+ type: policy.type,
149
+ lastModified: file.lastModified,
150
+ });
151
+ }
152
+ catch {
153
+ /* 못 구웠으면 원본으로 간다 — 줄이기는 덤이다 */
154
+ return file;
155
+ }
156
+ }
157
+ /** 꼴에 맞게 확장자를 바꾼 이름 — `사진.png` → `사진.webp` */
158
+ export function renamedForType(name, type) {
159
+ const ext = type === 'image/webp' ? '.webp' : '.jpg';
160
+ const dot = name.lastIndexOf('.');
161
+ const stem = dot > 0 ? name.slice(0, dot) : name;
162
+ return `${stem}${ext}`;
163
+ }