open-grid 1.3.0 → 1.4.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.
@@ -1,21 +1,74 @@
1
- /** 보간 파라미터. 명명 파라미터만(위치 파라미터 금지 — 어순이 언어마다 다름). / Interpolation params. Named only (positional forbidden — word order differs per language). */
1
+ /**
2
+ * 보간 파라미터. 명명 파라미터만(위치 파라미터 금지 — 어순이 언어마다 다름).
3
+ *
4
+ * Interpolation params. Named only (positional forbidden — word order differs per language).
5
+ *
6
+ * 補間パラメーター。名前付きパラメーターのみ(位置パラメーターは禁止 — 語順が言語ごとに異なるため)。
7
+ *
8
+ * 插值参数。仅限命名参数(禁止位置参数 — 语序因语言而异)。
9
+ */
2
10
  export type MessageParams = Readonly<Record<string, string | number>>;
3
11
  /**
4
12
  * 메시지 값: 평문 문자열('{name}' 보간) 또는 함수(복수형·조사 등 "문법이 데이터인" 케이스의 탈출구).
5
- * ICU/CLDR 복수 엔진은 zero-dependency 정체성 때문에 도입하지 않는다(규칙은 로케일 파일에 둔다).
6
- * / A message value: a plain string ('{name}' interpolation) or a function (escape hatch for
7
- * plurals/particles where "grammar is data"). No ICU/CLDR plural engine (zero-dependency).
13
+ * 왜 함수까지 허용하나: "사과 1개/사과 2개"처럼 복수형 규칙이 언어마다 다른데, ICU/CLDR 같은
14
+ * 범용 복수형 엔진을 넣으면 zero-dependency 원칙이 깨진다. 그래서 그 규칙 자체를 로케일 파일
15
+ * 안의 함수로 옮겨, 각 언어가 자기 문법을 직접 결정하게 한다.
16
+ *
17
+ * A message value: a plain string ('{name}' interpolation) or a function (escape hatch for
18
+ * plurals/particles where "grammar is data"). Why allow a function at all: plural rules differ
19
+ * per language, and pulling in a general ICU/CLDR plural engine would break the
20
+ * zero-dependency principle — so the rule itself moves into a function inside the locale file,
21
+ * letting each language own its own grammar.
22
+ *
23
+ * メッセージ値: プレーン文字列('{name}' 補間)または関数(複数形・助詞など「文法がデータである」
24
+ * ケースの逃げ道)。なぜ関数まで許すのか: 「りんご1個/りんご2個」のように複数形の規則は言語ごとに
25
+ * 異なりますが、ICU/CLDR のような汎用の複数形エンジンを入れると zero-dependency の原則が崩れます。
26
+ * そこでその規則自体をロケールファイル内の関数に移し、各言語が自分の文法を直接決められるようにします。
27
+ *
28
+ * 消息值: 纯字符串('{name}' 插值)或函数(复数、助词等「语法即数据」场景的逃生口)。为什么连函数
29
+ * 也允许: 像「苹果1个/苹果2个」这样,复数规则因语言而异,但引入 ICU/CLDR 这类通用复数引擎会破坏
30
+ * zero-dependency 原则。于是把规则本身移入区域设置文件里的函数,让每种语言直接决定自己的语法。
31
+ *
32
+ * @example
33
+ * const countBadge: MessageValue = (p) => `${p.n}건`; // Korean has no plural form
8
34
  */
9
35
  export type MessageValue = string | ((params: MessageParams) => string);
10
36
  /**
11
- * 로케일 메시지 카탈로그(2단 중첩, 최상위 섹션 = 소비 UI 표면). 파라미터를 받는 값만 `MessageValue`
12
- * (함수형 복수 허용), 정적 라벨은 `string`. 내장 ko 가 SSOT 이며 en 은 동일 키 집합을 갖는다.
13
- * / The locale message catalog (2-level nested, top-level section = consuming UI surface). Only
14
- * parameterized entries are `MessageValue` (allowing plural functions); static labels are
15
- * `string`. Built-in ko is the SSOT; en carries the same key set.
37
+ * 로케일 메시지 카탈로그 전체 형태(2단 중첩, 최상위 섹션 = 소비하는 UI 표면 — 필터 패널, 찾기
38
+ * 바 등). 새 언어를 추가하거나 커스텀 로케일을 만들 때 이 타입에 맞춰 객체를 작성하면 된다.
39
+ * 파라미터를 받는 값만 `MessageValue`(함수형 복수 허용), 정적 라벨은 `string`. 내장 ko 가
40
+ * 단일 진실 공급원(SSOT)이며 en 은 동일 키 집합을 갖는다 — 새 언어도 이 키 집합을 채우면(또는
41
+ * 부분만 채우고 `register()` 의 `missingKeys` 로 진행률을 보면) 된다.
42
+ *
43
+ * Shape of a full locale message catalog (2-level nested; the top-level section is the
44
+ * consuming UI surface — filter panel, find bar, etc.). When adding a new language or building a
45
+ * custom locale, shape your object to satisfy this type. Only parameterized entries are
46
+ * `MessageValue` (allowing plural functions); static labels are `string`. Built-in ko is the
47
+ * single source of truth (SSOT), and en carries the same key set — fill the same keys for a new
48
+ * language (or fill partially and track progress via `register()`'s `missingKeys`).
49
+ *
50
+ * ロケールメッセージカタログ全体の形(2段ネスト、最上位セクション = 消費する UI 表面 —
51
+ * フィルターパネル、検索バーなど)。新しい言語を追加したりカスタムロケールを作ったりするときは、
52
+ * この型に合わせてオブジェクトを書けば大丈夫です。パラメーターを受け取る値だけが `MessageValue`
53
+ * (関数形の複数形を許可)で、静的なラベルは `string` です。組み込みの ko が単一の信頼できる情報源
54
+ * (SSOT)であり、en は同じキー集合を持ちます — 新しい言語もこのキー集合を埋めれば(あるいは一部
55
+ * だけ埋めて `register()` の `missingKeys` で進捗を見れば)よいのです。
56
+ *
57
+ * 完整区域设置消息目录的形态(2 层嵌套,最上层小节 = 消费它的 UI 界面 — 筛选面板、查找栏等)。
58
+ * 添加新语言或制作自定义区域设置时,按此类型编写对象即可。只有接收参数的值才是 `MessageValue`
59
+ * (允许函数形式的复数),静态标签是 `string`。内置的 ko 是单一可信来源(SSOT),en 拥有相同的
60
+ * 键集 — 新语言也只要填满这个键集即可(或只填一部分,用 `register()` 的 `missingKeys` 查看进度)。
16
61
  */
17
62
  export interface LocaleMessages {
18
- /** 우클릭 컨텍스트 메뉴 라벨. / Right-click context-menu labels. */
63
+ /**
64
+ * 우클릭 컨텍스트 메뉴 라벨.
65
+ *
66
+ * Right-click context-menu labels.
67
+ *
68
+ * 右クリックのコンテキストメニューのラベル。
69
+ *
70
+ * 右键上下文菜单的标签。
71
+ */
19
72
  contextMenu: {
20
73
  sortAsc: string;
21
74
  sortDesc: string;
@@ -24,7 +77,15 @@ export interface LocaleMessages {
24
77
  exportCsv: string;
25
78
  print: string;
26
79
  };
27
- /** 필터 패널·필터 셀렉트 라벨. / Filter panel & filter-select labels. */
80
+ /**
81
+ * 필터 패널·필터 셀렉트 라벨.
82
+ *
83
+ * Filter panel & filter-select labels.
84
+ *
85
+ * フィルターパネル・フィルターセレクトのラベル。
86
+ *
87
+ * 筛选面板与筛选下拉的标签。
88
+ */
28
89
  filter: {
29
90
  title: string;
30
91
  opContains: string;
@@ -43,28 +104,84 @@ export interface LocaleMessages {
43
104
  clearAria: string;
44
105
  all: string;
45
106
  };
46
- /** 찾기 바 라벨/placeholder/aria/카운트 배지. / Find-bar label/placeholder/aria/count badge. */
107
+ /**
108
+ * 찾기 바 라벨/placeholder/aria/카운트 배지.
109
+ *
110
+ * Find-bar label/placeholder/aria/count badge.
111
+ *
112
+ * 検索バーのラベル/placeholder/aria/件数バッジ。
113
+ *
114
+ * 查找栏的标签/占位符/aria/计数徽标。
115
+ */
47
116
  findBar: {
48
117
  label: string;
49
118
  placeholder: string;
50
119
  searchAria: string;
51
120
  closeAria: string;
52
- /** 결과 개수 배지. 파라미터 {n}. / Result count badge. Param {n}. */
121
+ /**
122
+ * 결과 개수 배지. 파라미터 {n}.
123
+ *
124
+ * Result count badge. Param {n}.
125
+ *
126
+ * 結果件数バッジ。パラメーター {n}。
127
+ *
128
+ * 结果数量徽标。参数 {n}。
129
+ */
53
130
  countBadge: MessageValue;
54
131
  };
55
- /** 페이지네이션 라벨/범위 배지/빈 상태. / Pagination labels/range badge/empty state. */
132
+ /**
133
+ * 페이지네이션 라벨/범위 배지/빈 상태.
134
+ *
135
+ * Pagination labels/range badge/empty state.
136
+ *
137
+ * ページネーションのラベル/範囲バッジ/空の状態。
138
+ *
139
+ * 分页的标签/范围徽标/空状态。
140
+ */
56
141
  pagination: {
57
142
  rowsPerPage: string;
58
- /** 현재 범위 배지. 파라미터 {from} {to} {total}. / Current range badge. Params {from} {to} {total}. */
143
+ /**
144
+ * 현재 범위 배지. 파라미터 {from} {to} {total}.
145
+ *
146
+ * Current range badge. Params {from} {to} {total}.
147
+ *
148
+ * 現在の範囲バッジ。パラメーター {from} {to} {total}。
149
+ *
150
+ * 当前范围徽标。参数 {from} {to} {total}。
151
+ */
59
152
  rangeBadge: MessageValue;
60
153
  empty: string;
61
154
  };
62
- /** 행 드래그 고스트 라벨. / Row-drag ghost label. */
155
+ /**
156
+ * 행 드래그 고스트 라벨.
157
+ *
158
+ * Row-drag ghost label.
159
+ *
160
+ * 行ドラッグのゴーストラベル。
161
+ *
162
+ * 行拖拽虚影的标签。
163
+ */
63
164
  drag: {
64
- /** 드래그 중 행 개수. 파라미터 {count}. / Rows being dragged. Param {count}. */
165
+ /**
166
+ * 드래그 중 행 개수. 파라미터 {count}.
167
+ *
168
+ * Rows being dragged. Param {count}.
169
+ *
170
+ * ドラッグ中の行数。パラメーター {count}。
171
+ *
172
+ * 拖拽中的行数。参数 {count}。
173
+ */
65
174
  rowCount: MessageValue;
66
175
  };
67
- /** 크로스그리드 매핑 다이얼로그(디자인타임 헬퍼). / Cross-grid mapping dialog (design-time helper). */
176
+ /**
177
+ * 크로스그리드 매핑 다이얼로그(디자인타임 헬퍼).
178
+ *
179
+ * Cross-grid mapping dialog (design-time helper).
180
+ *
181
+ * クロスグリッドのマッピングダイアログ(デザインタイムのヘルパー)。
182
+ *
183
+ * 跨表格映射对话框(设计时的辅助工具)。
184
+ */
68
185
  crossGrid: {
69
186
  overlayAria: string;
70
187
  title: string;
@@ -79,19 +196,43 @@ export interface LocaleMessages {
79
196
  applyMove: string;
80
197
  scriptComment: string;
81
198
  };
82
- /** 그리드↔그리드 셔틀 버튼 aria/tooltip. / Grid-to-grid shuttle button aria/tooltip. */
199
+ /**
200
+ * 그리드↔그리드 셔틀 버튼 aria/tooltip.
201
+ *
202
+ * Grid-to-grid shuttle button aria/tooltip.
203
+ *
204
+ * グリッド↔グリッドのシャトルボタンの aria/tooltip。
205
+ *
206
+ * 表格↔表格穿梭按钮的 aria/tooltip。
207
+ */
83
208
  shuttle: {
84
209
  toRight: string;
85
210
  toLeft: string;
86
211
  allRight: string;
87
212
  allLeft: string;
88
213
  };
89
- /** 트리 노드 확장/접기 aria. / Tree node expand/collapse aria. */
214
+ /**
215
+ * 트리 노드 확장/접기 aria.
216
+ *
217
+ * Tree node expand/collapse aria.
218
+ *
219
+ * ツリーノードの展開/折りたたみの aria。
220
+ *
221
+ * 树节点展开/折叠的 aria。
222
+ */
90
223
  tree: {
91
224
  collapse: string;
92
225
  expand: string;
93
226
  };
94
- /** 마스터/디테일 글리프·announce. / Master/detail glyph & announce. */
227
+ /**
228
+ * 마스터/디테일 글리프·announce.
229
+ *
230
+ * Master/detail glyph & announce.
231
+ *
232
+ * マスター/ディテールのグリフ・announce。
233
+ *
234
+ * 主/明细的字形与 announce。
235
+ */
95
236
  detail: {
96
237
  glyphLabel: string;
97
238
  glyphTooltip: string;
@@ -100,99 +241,347 @@ export interface LocaleMessages {
100
241
  expandedAnnounce: string;
101
242
  collapsedAnnounce: string;
102
243
  collapsedAllAnnounce: string;
103
- /** 상세 패널 깊이 한계. 파라미터 {max}. / Detail depth limit. Param {max}. */
244
+ /**
245
+ * 상세 패널 깊이 한계. 파라미터 {max}.
246
+ *
247
+ * Detail depth limit. Param {max}.
248
+ *
249
+ * 詳細パネルの深さ制限。パラメーター {max}。
250
+ *
251
+ * 明细面板的深度上限。参数 {max}。
252
+ */
104
253
  depthLimitOpen: MessageValue;
105
- /** 서브그리드 깊이 한계. 파라미터 {max}. / Subgrid depth limit. Param {max}. */
254
+ /**
255
+ * 서브그리드 깊이 한계. 파라미터 {max}.
256
+ *
257
+ * Subgrid depth limit. Param {max}.
258
+ *
259
+ * サブグリッドの深さ制限。パラメーター {max}。
260
+ *
261
+ * 子表格的深度上限。参数 {max}。
262
+ */
106
263
  depthLimitSubgrid: MessageValue;
107
264
  };
108
- /** 워크시트 탭 UI. / Worksheet tab UI. */
265
+ /**
266
+ * 워크시트 탭 UI.
267
+ *
268
+ * Worksheet tab UI.
269
+ *
270
+ * ワークシートのタブ UI。
271
+ *
272
+ * 工作表标签页 UI。
273
+ */
109
274
  worksheet: {
110
275
  addAria: string;
111
276
  };
112
- /** 인라인 에디터 aria/announce. / Inline editor aria/announce. */
277
+ /**
278
+ * 인라인 에디터 aria/announce.
279
+ *
280
+ * Inline editor aria/announce.
281
+ *
282
+ * インラインエディターの aria/announce。
283
+ *
284
+ * 内联编辑器的 aria/announce。
285
+ */
113
286
  editor: {
114
287
  datePick: string;
115
288
  select: string;
116
- /** 편집 셀 위치 announce. 파라미터 {row} {col} {header} {value}. / Edited-cell position announce. Params {row} {col} {header} {value}. */
289
+ /**
290
+ * 편집 셀 위치 announce. 파라미터 {row} {col} {header} {value}.
291
+ *
292
+ * Edited-cell position announce. Params {row} {col} {header} {value}.
293
+ *
294
+ * 編集セルの位置の announce。パラメーター {row} {col} {header} {value}。
295
+ *
296
+ * 编辑单元格位置的 announce。参数 {row} {col} {header} {value}。
297
+ */
117
298
  cellPositionAnnounce: MessageValue;
118
299
  };
119
- /** 셀 렌더러(마스킹·라디오·바코드·수식 빈값). / Cell renderer (masking/radio/barcode/formula empty). */
300
+ /**
301
+ * 셀 렌더러(마스킹·라디오·바코드·수식 빈값).
302
+ *
303
+ * Cell renderer (masking/radio/barcode/formula empty).
304
+ *
305
+ * セルレンダラー(マスキング・ラジオ・バーコード・数式の空値)。
306
+ *
307
+ * 单元格渲染器(掩码·单选·条形码·公式空值)。
308
+ */
120
309
  cell: {
121
310
  emptyValue: string;
122
311
  revealTooltip: string;
123
312
  revealAria: string;
124
313
  radioAria: string;
125
- /** 바코드 셀 aria. 파라미터 {value}. / Barcode cell aria. Param {value}. */
314
+ /**
315
+ * 바코드 셀 aria. 파라미터 {value}.
316
+ *
317
+ * Barcode cell aria. Param {value}.
318
+ *
319
+ * バーコードセルの aria。パラメーター {value}。
320
+ *
321
+ * 条形码单元格的 aria。参数 {value}。
322
+ */
126
323
  barcodeAria: MessageValue;
127
324
  };
128
- /** 행 선택 aria + 행 이동 announce. / Row selection aria + row-move announce. */
325
+ /**
326
+ * 행 선택 aria + 행 이동 announce.
327
+ *
328
+ * Row selection aria + row-move announce.
329
+ *
330
+ * 行選択の aria + 行移動の announce。
331
+ *
332
+ * 行选择的 aria + 行移动的 announce。
333
+ */
129
334
  row: {
130
335
  selectAllAria: string;
131
- /** 행 체크박스 aria. 파라미터 {n}. / Row checkbox aria. Param {n}. */
336
+ /**
337
+ * 행 체크박스 aria. 파라미터 {n}.
338
+ *
339
+ * Row checkbox aria. Param {n}.
340
+ *
341
+ * 行チェックボックスの aria。パラメーター {n}。
342
+ *
343
+ * 行复选框的 aria。参数 {n}。
344
+ */
132
345
  selectAria: MessageValue;
133
- /** 행 이동 announce. 파라미터 {from} {to}. / Row-move announce. Params {from} {to}. */
346
+ /**
347
+ * 행 이동 announce. 파라미터 {from} {to}.
348
+ *
349
+ * Row-move announce. Params {from} {to}.
350
+ *
351
+ * 行移動の announce。パラメーター {from} {to}。
352
+ *
353
+ * 行移动的 announce。参数 {from} {to}。
354
+ */
134
355
  moveAnnounce: MessageValue;
135
356
  };
136
- /** 그룹 행 배지/null 라벨. / Group-row badge / null label. */
357
+ /**
358
+ * 그룹 행 배지/null 라벨.
359
+ *
360
+ * Group-row badge / null label.
361
+ *
362
+ * グループ行のバッジ/null ラベル。
363
+ *
364
+ * 分组行的徽标/null 标签。
365
+ */
137
366
  group: {
138
- /** 그룹 배지. 파라미터 {label} {count}. / Group badge. Params {label} {count}. */
367
+ /**
368
+ * 그룹 배지. 파라미터 {label} {count}.
369
+ *
370
+ * Group badge. Params {label} {count}.
371
+ *
372
+ * グループバッジ。パラメーター {label} {count}。
373
+ *
374
+ * 分组徽标。参数 {label} {count}。
375
+ */
139
376
  badge: MessageValue;
140
377
  nullLabel: string;
141
378
  };
142
- /** 피벗 총계 행. / Pivot total row. */
379
+ /**
380
+ * 피벗 총계 행.
381
+ *
382
+ * Pivot total row.
383
+ *
384
+ * ピボットの総計行。
385
+ *
386
+ * 透视表的总计行。
387
+ */
143
388
  pivot: {
144
389
  totalLabel: string;
145
390
  };
146
- /** 데이터 로드/스킵 announce. / Data load/skip announce. */
391
+ /**
392
+ * 데이터 로드/스킵 announce.
393
+ *
394
+ * Data load/skip announce.
395
+ *
396
+ * データのロード/スキップの announce。
397
+ *
398
+ * 数据加载/跳过的 announce。
399
+ */
147
400
  data: {
148
- /** 데이터 로드 announce. 파라미터 {count}. / Data-loaded announce. Param {count}. */
401
+ /**
402
+ * 데이터 로드 announce. 파라미터 {count}.
403
+ *
404
+ * Data-loaded announce. Param {count}.
405
+ *
406
+ * データロードの announce。パラメーター {count}。
407
+ *
408
+ * 数据加载完成的 announce。参数 {count}。
409
+ */
149
410
  loadedAnnounce: MessageValue;
150
- /** 쓰기 대상 아닌 셀 스킵 announce. 파라미터 {count}. / Non-writable cells skipped announce. Param {count}. */
411
+ /**
412
+ * 쓰기 대상 아닌 셀 스킵 announce. 파라미터 {count}.
413
+ *
414
+ * Non-writable cells skipped announce. Param {count}.
415
+ *
416
+ * 書き込み対象でないセルをスキップした announce。パラメーター {count}。
417
+ *
418
+ * 跳过非写入目标单元格的 announce。参数 {count}。
419
+ */
151
420
  skippedCellsAnnounce: MessageValue;
152
421
  };
153
- /** 범위 선택 + 채우기 announce/aria. / Range selection + fill announce/aria. */
422
+ /**
423
+ * 범위 선택 + 채우기 announce/aria.
424
+ *
425
+ * Range selection + fill announce/aria.
426
+ *
427
+ * 範囲選択 + フィルの announce/aria。
428
+ *
429
+ * 范围选择 + 填充的 announce/aria。
430
+ */
154
431
  range: {
155
- /** 범위 선택 announce. 파라미터 {r1} {c1} {r2} {c2} {n}. / Range selection announce. Params {r1} {c1} {r2} {c2} {n}. */
432
+ /**
433
+ * 범위 선택 announce. 파라미터 {r1} {c1} {r2} {c2} {n}.
434
+ *
435
+ * Range selection announce. Params {r1} {c1} {r2} {c2} {n}.
436
+ *
437
+ * 範囲選択の announce。パラメーター {r1} {c1} {r2} {c2} {n}。
438
+ *
439
+ * 范围选择的 announce。参数 {r1} {c1} {r2} {c2} {n}。
440
+ */
156
441
  selectionAnnounce: MessageValue;
157
- /** 수식 셀 보존 announce. 파라미터 {count}. / Formula cells preserved announce. Param {count}. */
442
+ /**
443
+ * 수식 셀 보존 announce. 파라미터 {count}.
444
+ *
445
+ * Formula cells preserved announce. Param {count}.
446
+ *
447
+ * 数式セルを保持した announce。パラメーター {count}。
448
+ *
449
+ * 保留公式单元格的 announce。参数 {count}。
450
+ */
158
451
  formulaPreserved: MessageValue;
159
- /** 채우기 스킵 announce. 파라미터 {count}. / Fill-skipped announce. Param {count}. */
452
+ /**
453
+ * 채우기 스킵 announce. 파라미터 {count}.
454
+ *
455
+ * Fill-skipped announce. Param {count}.
456
+ *
457
+ * フィルをスキップした announce。パラメーター {count}。
458
+ *
459
+ * 跳过填充的 announce。参数 {count}。
460
+ */
160
461
  fillSkipped: MessageValue;
161
462
  fillHandleAria: string;
162
463
  };
163
- /** 정렬 상태어 + announce. / Sort state words + announce. */
464
+ /**
465
+ * 정렬 상태어 + announce.
466
+ *
467
+ * Sort state words + announce.
468
+ *
469
+ * ソートの状態語 + announce。
470
+ *
471
+ * 排序的状态词 + announce。
472
+ */
164
473
  sort: {
165
474
  asc: string;
166
475
  desc: string;
167
476
  none: string;
168
- /** 정렬 announce. 파라미터 {field} {dir}. / Sort announce. Params {field} {dir}. */
477
+ /**
478
+ * 정렬 announce. 파라미터 {field} {dir}.
479
+ *
480
+ * Sort announce. Params {field} {dir}.
481
+ *
482
+ * ソートの announce。パラメーター {field} {dir}。
483
+ *
484
+ * 排序的 announce。参数 {field} {dir}。
485
+ */
169
486
  announce: MessageValue;
170
487
  };
171
- /** F4 차트 배지·announce·접근성 요약. / F4 chart badges/announce/a11y summary. */
488
+ /**
489
+ * F4 차트 배지·announce·접근성 요약.
490
+ *
491
+ * F4 chart badges/announce/a11y summary.
492
+ *
493
+ * F4 チャートのバッジ・announce・アクセシビリティ要約。
494
+ *
495
+ * F4 图表的徽标·announce·无障碍摘要。
496
+ */
172
497
  chart: {
173
498
  defaultTitle: string;
174
- /** 샘플링 배지. 파라미터 {to} {from}. / Sampled badge. Params {to} {from}. */
499
+ /**
500
+ * 샘플링 배지. 파라미터 {to} {from}.
501
+ *
502
+ * Sampled badge. Params {to} {from}.
503
+ *
504
+ * サンプリングバッジ。パラメーター {to} {from}。
505
+ *
506
+ * 采样徽标。参数 {to} {from}。
507
+ */
175
508
  badgeSampled: MessageValue;
176
- /** 집계 배지. 파라미터 {op}. / Aggregated badge. Param {op}. */
509
+ /**
510
+ * 집계 배지. 파라미터 {op}.
511
+ *
512
+ * Aggregated badge. Param {op}.
513
+ *
514
+ * 集計バッジ。パラメーター {op}。
515
+ *
516
+ * 聚合徽标。参数 {op}。
517
+ */
177
518
  badgeAggregated: MessageValue;
178
519
  badgePieFirstSeries: string;
179
520
  badgeNegativesAbs: string;
180
521
  badgeRangeFallback: string;
181
- /** 엔진 폴백 배지. 파라미터 {engine}. / Engine-fallback badge. Param {engine}. */
522
+ /**
523
+ * 엔진 폴백 배지. 파라미터 {engine}.
524
+ *
525
+ * Engine-fallback badge. Param {engine}.
526
+ *
527
+ * エンジンフォールバックバッジ。パラメーター {engine}。
528
+ *
529
+ * 引擎回退徽标。参数 {engine}。
530
+ */
182
531
  badgeEngineFallback: MessageValue;
183
- /** 배지 announce 접두. 파라미터 {badges}. / Badge announce prefix. Param {badges}. */
532
+ /**
533
+ * 배지 announce 접두. 파라미터 {badges}.
534
+ *
535
+ * Badge announce prefix. Param {badges}.
536
+ *
537
+ * バッジ announce の接頭辞。パラメーター {badges}。
538
+ *
539
+ * 徽标 announce 的前缀。参数 {badges}。
540
+ */
184
541
  announcePrefix: MessageValue;
185
- /** 접근성 요약. 파라미터 {title} {categories} {series}. / A11y summary. Params {title} {categories} {series}. */
542
+ /**
543
+ * 접근성 요약. 파라미터 {title} {categories} {series}.
544
+ *
545
+ * A11y summary. Params {title} {categories} {series}.
546
+ *
547
+ * アクセシビリティ要約。パラメーター {title} {categories} {series}。
548
+ *
549
+ * 无障碍摘要。参数 {title} {categories} {series}。
550
+ */
186
551
  a11ySummary: MessageValue;
187
- /** 무제목 접근성 요약. 파라미터 {categories} {series}. / Titleless a11y summary. Params {categories} {series}. */
552
+ /**
553
+ * 무제목 접근성 요약. 파라미터 {categories} {series}.
554
+ *
555
+ * Titleless a11y summary. Params {categories} {series}.
556
+ *
557
+ * 無題のアクセシビリティ要約。パラメーター {categories} {series}。
558
+ *
559
+ * 无标题的无障碍摘要。参数 {categories} {series}。
560
+ */
188
561
  a11ySummaryNoTitle: MessageValue;
189
- /** 캔버스 대체 텍스트. 파라미터 {title} {categories} {series}. / Canvas alt text. Params {title} {categories} {series}. */
562
+ /**
563
+ * 캔버스 대체 텍스트. 파라미터 {title} {categories} {series}.
564
+ *
565
+ * Canvas alt text. Params {title} {categories} {series}.
566
+ *
567
+ * キャンバスの代替テキスト。パラメーター {title} {categories} {series}。
568
+ *
569
+ * 画布的替代文本。参数 {title} {categories} {series}。
570
+ */
190
571
  a11yAltText: MessageValue;
191
572
  a11yNoData: string;
192
573
  tooltipEmpty: string;
193
574
  canvasDefault: string;
194
575
  };
195
- /** 사용자 노출 수식 오류 셀 라벨. / User-facing formula error cell labels. */
576
+ /**
577
+ * 사용자 노출 수식 오류 셀 라벨.
578
+ *
579
+ * User-facing formula error cell labels.
580
+ *
581
+ * ユーザーに見える数式エラーセルのラベル。
582
+ *
583
+ * 面向用户的公式错误单元格标签。
584
+ */
196
585
  formulaError: {
197
586
  err: string;
198
587
  ref: string;
@@ -203,72 +592,265 @@ export interface LocaleMessages {
203
592
  num: string;
204
593
  fallback: string;
205
594
  };
206
- /** 수식 셀 announce/aria(파라미터형). / Formula cell announce/aria (parameterized). */
595
+ /**
596
+ * 수식 셀 announce/aria(파라미터형).
597
+ *
598
+ * Formula cell announce/aria (parameterized).
599
+ *
600
+ * 数式セルの announce/aria(パラメーター形)。
601
+ *
602
+ * 公式单元格的 announce/aria(参数形式)。
603
+ */
207
604
  formula: {
208
- /** 셀 오류 announce. 파라미터 {field} {message}. / Cell error announce. Params {field} {message}. */
605
+ /**
606
+ * 셀 오류 announce. 파라미터 {field} {message}.
607
+ *
608
+ * Cell error announce. Params {field} {message}.
609
+ *
610
+ * セルエラーの announce。パラメーター {field} {message}。
611
+ *
612
+ * 单元格错误的 announce。参数 {field} {message}。
613
+ */
209
614
  cellErrorAnnounce: MessageValue;
210
- /** 수식 오류 셀 aria. 파라미터 {src} {message}. / Formula error cell aria. Params {src} {message}. */
615
+ /**
616
+ * 수식 오류 셀 aria. 파라미터 {src} {message}.
617
+ *
618
+ * Formula error cell aria. Params {src} {message}.
619
+ *
620
+ * 数式エラーセルの aria。パラメーター {src} {message}。
621
+ *
622
+ * 公式错误单元格的 aria。参数 {src} {message}。
623
+ */
211
624
  ariaError: MessageValue;
212
- /** 수식 값 셀 aria. 파라미터 {src} {value} {approx}. / Formula value cell aria. Params {src} {value} {approx}. */
625
+ /**
626
+ * 수식 값 셀 aria. 파라미터 {src} {value} {approx}.
627
+ *
628
+ * Formula value cell aria. Params {src} {value} {approx}.
629
+ *
630
+ * 数式値セルの aria。パラメーター {src} {value} {approx}。
631
+ *
632
+ * 公式值单元格的 aria。参数 {src} {value} {approx}。
633
+ */
213
634
  ariaValue: MessageValue;
214
635
  approxSuffix: string;
215
636
  };
216
- /** 컨테이너·빈 상태·헤더 필터 아이콘·디테일 영역 aria/tooltip. / Container/empty/header-filter/detail-region aria & tooltip. */
637
+ /**
638
+ * 컨테이너·빈 상태·헤더 필터 아이콘·디테일 영역 aria/tooltip.
639
+ *
640
+ * Container/empty/header-filter/detail-region aria & tooltip.
641
+ *
642
+ * コンテナー・空の状態・ヘッダーフィルターアイコン・ディテール領域の aria/tooltip。
643
+ *
644
+ * 容器·空状态·表头筛选图标·明细区域的 aria/tooltip。
645
+ */
217
646
  grid: {
218
647
  containerAria: string;
219
648
  emptyMessage: string;
220
649
  filterTooltip: string;
221
650
  detailRegion: string;
222
651
  };
223
- /** 인쇄/내보내기 문서 문구(포맷 파라미터형). / Print/export document strings (parameterized). */
652
+ /**
653
+ * 인쇄/내보내기 문서 문구(포맷 파라미터형).
654
+ *
655
+ * Print/export document strings (parameterized).
656
+ *
657
+ * 印刷/エクスポート文書の文言(フォーマットパラメーター形)。
658
+ *
659
+ * 打印/导出文档的文案(格式参数形式)。
660
+ */
224
661
  export: {
225
- /** 인쇄 요약행. 파라미터 {rows} {cols} {date}. / Print summary row. Params {rows} {cols} {date}. */
662
+ /**
663
+ * 인쇄 요약행. 파라미터 {rows} {cols} {date}.
664
+ *
665
+ * Print summary row. Params {rows} {cols} {date}.
666
+ *
667
+ * 印刷の要約行。パラメーター {rows} {cols} {date}。
668
+ *
669
+ * 打印的摘要行。参数 {rows} {cols} {date}。
670
+ */
226
671
  printSummary: MessageValue;
227
672
  };
228
673
  }
229
- /** 부분 오버라이드(2단 딥머지, 카탈로그 위). / Partial override (2-level deep-merge over the catalog). */
674
+ /**
675
+ * `register()`/`extend()` 에 일부 섹션·키만 넘길 때 쓰는 타입(2단 딥머지로 카탈로그 위에 얹힌다).
676
+ * 전체 언어를 다 채우지 않아도 로케일을 등록할 수 있게 해 준다.
677
+ *
678
+ * Type used when passing only some sections/keys to `register()`/`extend()` (layered onto the
679
+ * catalog via 2-level deep-merge) — lets you register a locale before every key is translated.
680
+ *
681
+ * `register()`/`extend()` に一部のセクション・キーだけを渡すときに使う型です(2段のディープマージで
682
+ * カタログの上に重なります)。全言語を埋めきらなくてもロケールを登録できるようにしてくれます。
683
+ *
684
+ * 向 `register()`/`extend()` 只传部分小节或键时使用的类型(通过 2 层深合并叠加到目录之上)。
685
+ * 不必填满全部语言也能注册区域设置。
686
+ */
230
687
  export type PartialLocaleMessages = {
231
688
  [S in keyof LocaleMessages]?: Partial<LocaleMessages[S]>;
232
689
  };
233
- /** dot-key 유니온(`'filter.apply'` 등) — 오타를 컴파일 에러화. / Dot-key union (e.g. `'filter.apply'`) — typos become compile errors. */
690
+ /**
691
+ * `t()` 에 넘길 수 있는 모든 유효 키의 유니온 타입(예: `'filter.apply'`). 왜 필요한가:
692
+ * `t('filter.aply')` 처럼 오타가 나면 이 타입이 없을 때는 런타임에야 "키 없음" 경고로 드러난다 —
693
+ * 유니온으로 묶어 두면 컴파일 타임에 바로 에러가 난다.
694
+ *
695
+ * Union of every key valid for `t()` (e.g. `'filter.apply'`). Why this exists: without it, a typo
696
+ * like `t('filter.aply')` only surfaces as a runtime "unknown key" warning; unioning the keys
697
+ * turns it into a compile-time error instead.
698
+ *
699
+ * `t()` に渡せるすべての有効なキーのユニオン型です(例: `'filter.apply'`)。なぜ必要なのか:
700
+ * `t('filter.aply')` のようなタイプミスは、この型がないと実行時になってようやく「キーがありません」
701
+ * という警告として現れます — ユニオンにまとめておけば、コンパイル時にすぐエラーになります。
702
+ *
703
+ * 可传给 `t()` 的所有有效键的联合类型(例如 `'filter.apply'`)。为什么需要它: 没有这个类型时,
704
+ * `t('filter.aply')` 这样的拼写错误要到运行时才会以「找不到键」的警告暴露出来 — 把键收拢成联合类型,
705
+ * 编译时就直接报错。
706
+ */
234
707
  export type LocaleMessageKey = {
235
708
  [S in keyof LocaleMessages]: `${S & string}.${keyof LocaleMessages[S] & string}`;
236
709
  }[keyof LocaleMessages];
237
710
  /**
238
- * 문화 규칙 단일 컨텍스트(REQ-T9-816, DD-12 §2.4). 값객체·포맷터·정렬·검색이 문화를 **오직 여기서만**
239
- * 조회한다(불변식 3). 아래 확장 필드는 전부 additive·옵셔널 — 기존 3필드·소비처 불변(semver 하위호환).
240
- * ★대표 소유 = DD-12: DD-04 `FormatContext.locale`·DD-15 `ExportRunCtx.locale` 는 이 타입을 import(재선언 금지).
241
- * / Single culture context (REQ-T9-816, DD-12 §2.4). The only lawful culture-lookup path (invariant 3).
242
- * The extension fields below are all additive & optional — original 3 fields/consumers unchanged.
243
- * ★Canonical owner = DD-12; DD-04/DD-15 import this type (no re-declaration).
711
+ * 문화(지역) 규칙을 담는 단일 컨텍스트 타입. 통화·날짜·정렬·검색 등 "문화마다 다른 규칙"을
712
+ * 여러 군데서 각자 조회하게 두면, 그리드와 내보내기(export) 가 서로 다른 로케일을 참조하는
713
+ * 불일치가 생길 수 있다 — 그래서 값객체·포맷터·정렬·검색이 문화 정보를 **오직 이 타입을
714
+ * 통해서만** 조회하도록 강제한다(단일 진실 공급원). 아래 확장 필드는 전부 추가·옵셔널이라
715
+ * 기존 3필드를 쓰던 코드는 그대로 동작한다(semver 하위 호환).
716
+ *
717
+ * A single context type carrying culture (locale) rules. Letting currency/date/sort/search each
718
+ * look up their own culture rules independently could let the grid and the export path silently
719
+ * disagree on locale — so value objects, formatters, sort, and search look up culture
720
+ * information **only through this type** (single source of truth). The extension fields below
721
+ * are all additive and optional, so code written against the original 3 fields keeps working
722
+ * unchanged (semver-compatible).
723
+ *
724
+ * 文化(地域)の規則を持つ単一のコンテキスト型です。通貨・日付・ソート・検索など「文化ごとに
725
+ * 異なる規則」を複数の箇所でそれぞれ調べさせておくと、グリッドとエクスポートが互いに違うロケールを
726
+ * 参照する不一致が起こりえます — そこで値オブジェクト・フォーマッター・ソート・検索が文化情報を
727
+ * **この型を通してのみ**調べるように強制します(単一の信頼できる情報源)。以下の拡張フィールドは
728
+ * すべて追加・オプショナルなので、既存の3フィールドを使っていたコードはそのまま動作します
729
+ * (semver 後方互換)。
730
+ *
731
+ * 承载文化(地区)规则的单一上下文类型。货币、日期、排序、搜索等「因文化而异的规则」如果任由多处
732
+ * 各自查询,表格与导出就可能参照不同的区域设置而出现不一致 — 因此强制值对象、格式化器、排序、搜索
733
+ * **只通过此类型**查询文化信息(单一可信来源)。下面的扩展字段全部是追加且可选的,因此使用原有
734
+ * 3 个字段的代码照常运行(semver 向后兼容)。
244
735
  */
245
736
  export interface LocaleMeta {
246
- /** BCP-47 태그(toLocaleString/lang/인쇄 템플릿용). 예 'ko-KR'. / BCP-47 tag (for toLocaleString/lang/print template). e.g. 'ko-KR'. */
737
+ /**
738
+ * BCP-47 태그(toLocaleString/lang/인쇄 템플릿용). 예 'ko-KR'.
739
+ *
740
+ * BCP-47 tag (for toLocaleString/lang/print template). e.g. 'ko-KR'.
741
+ *
742
+ * BCP-47 タグ(toLocaleString/lang/印刷テンプレート用)。例 'ko-KR'。
743
+ *
744
+ * BCP-47 标记(用于 toLocaleString/lang/打印模板)。例如 'ko-KR'。
745
+ */
247
746
  readonly intlLocale: string;
248
- /** 텍스트 방향(현 코어는 ltr 검증). / Text direction (core validated for ltr). */
747
+ /**
748
+ * 텍스트 방향(현 코어는 ltr 검증).
749
+ *
750
+ * Text direction (core validated for ltr).
751
+ *
752
+ * テキストの方向(現在のコアは ltr を検証)。
753
+ *
754
+ * 文本方向(当前核心验证 ltr)。
755
+ */
249
756
  readonly dir?: 'ltr' | 'rtl';
250
- /** Excel 내보내기 기본 폰트. / Default font for Excel export. */
757
+ /**
758
+ * Excel 내보내기 기본 폰트.
759
+ *
760
+ * Default font for Excel export.
761
+ *
762
+ * Excel エクスポートの既定フォント。
763
+ *
764
+ * Excel 导出的默认字体。
765
+ */
251
766
  readonly exportFont?: string;
252
- /** 기본 통화코드(ISO 4217) — Money 미지정 시 폴백. / Default currency (ISO 4217). */
767
+ /**
768
+ * 기본 통화코드(ISO 4217) — Money 미지정 시 폴백.
769
+ *
770
+ * Default currency (ISO 4217).
771
+ *
772
+ * 既定の通貨コード(ISO 4217) — Money 未指定時のフォールバック。
773
+ *
774
+ * 默认货币代码(ISO 4217) — Money 未指定时的回退值。
775
+ */
253
776
  readonly currency?: string;
254
- /** 달력 체계(gregory/japanese/…) — Intl.DateTimeFormat 위임. / Calendar system. */
777
+ /**
778
+ * 달력 체계(gregory/japanese/…) — Intl.DateTimeFormat 위임.
779
+ *
780
+ * Calendar system.
781
+ *
782
+ * 暦の体系(gregory/japanese/…) — Intl.DateTimeFormat に委譲。
783
+ *
784
+ * 历法体系(gregory/japanese/…) — 委托给 Intl.DateTimeFormat。
785
+ */
255
786
  readonly calendar?: string;
256
- /** 콜레이션 규칙(정렬 tie-break·대소문자·발음구별) — Intl.Collator 옵션. / Collation for sort/search. */
787
+ /**
788
+ * 콜레이션 규칙(정렬 tie-break·대소문자·발음구별) — Intl.Collator 옵션.
789
+ *
790
+ * Collation for sort/search.
791
+ *
792
+ * コレーションの規則(ソートの tie-break・大文字小文字・発音区別) — Intl.Collator のオプション。
793
+ *
794
+ * 排序规则(排序的 tie-break·大小写·变音符号) — Intl.Collator 的选项。
795
+ */
257
796
  readonly collation?: {
258
797
  readonly sensitivity?: 'base' | 'accent' | 'case' | 'variant';
259
798
  readonly numeric?: boolean;
260
799
  readonly caseFirst?: 'upper' | 'lower' | 'false';
261
800
  };
262
- /** 숫자 체계(latn/arab/…). / Numbering system. */
801
+ /**
802
+ * 숫자 체계(latn/arab/…).
803
+ *
804
+ * Numbering system.
805
+ *
806
+ * 数字の体系(latn/arab/…)。
807
+ *
808
+ * 数字体系(latn/arab/…)。
809
+ */
263
810
  readonly numbering?: string;
264
- /** 시간대. / Time zone. */
811
+ /**
812
+ * 시간대.
813
+ *
814
+ * Time zone.
815
+ *
816
+ * タイムゾーン。
817
+ *
818
+ * 时区。
819
+ */
265
820
  readonly timeZone?: string;
266
- /** 주 시작요일(0=일·1=월·6=토). / First day of week. */
821
+ /**
822
+ * 주 시작요일(0=일·1=월·6=토).
823
+ *
824
+ * First day of week.
825
+ *
826
+ * 週の開始曜日(0=日・1=月・6=土)。
827
+ *
828
+ * 每周的起始日(0=周日·1=周一·6=周六)。
829
+ */
267
830
  readonly firstDayOfWeek?: 0 | 1 | 6;
268
- /** 텍스트팽창 계수(레이아웃 예산 힌트·의사로케일). 예 de≈1.35, 의사로케일=1.4(REQ-T9-817). / Text-expansion factor. */
831
+ /**
832
+ * 번역하면 글자 수가 얼마나 늘어나는지를 나타내는 계수입니다. 레이아웃 폭을 잡을 때 참고합니다.
833
+ * 예를 들어 독일어는 약 1.35배, 의사 로케일은 1.4배로 잡습니다.
834
+ *
835
+ * How much longer the text gets once translated — used as a hint when budgeting layout width.
836
+ * German runs about 1.35×, and the pseudo-locale uses 1.4×.
837
+ *
838
+ * 翻訳すると文字数がどれだけ増えるかを表す係数です。レイアウト幅を決めるときの目安に使います。
839
+ * 例えばドイツ語は約1.35倍、擬似ロケールは1.4倍とします。
840
+ *
841
+ * 表示文本翻译后长度增加的系数,用于估算布局宽度。例如德语约为 1.35 倍,伪区域设置取 1.4 倍。
842
+ */
269
843
  readonly textExpansion?: number;
270
844
  }
271
- /** register() 결과 — 누락 키 정직 신호(막지 않음). / register() result — honest missing-key signal (never blocks). */
845
+ /**
846
+ * register() 결과 — 누락 키 신호(막지 않음).
847
+ *
848
+ * register() result — missing-key signal (never blocks).
849
+ *
850
+ * register() の結果 — 不足キーのシグナル(ブロックしません)。
851
+ *
852
+ * register() 的结果 — 缺失键的信号(不阻断)。
853
+ */
272
854
  export interface LocaleRegisterResult {
273
855
  readonly missingKeys: string[];
274
856
  }