open-grid 1.5.1 → 1.6.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 (59) hide show
  1. package/CHANGELOG.md +460 -418
  2. package/README.ja.md +39 -0
  3. package/README.md +39 -0
  4. package/README.zh.md +39 -0
  5. package/dist/{OpenGrid-CT9bV6On.cjs → OpenGrid-DgZtbVD0.cjs} +343 -338
  6. package/dist/{OpenGrid-DACnZdEy.js → OpenGrid-E11B7Xa7.js} +782 -777
  7. package/dist/angular/fesm2022/open-grid-angular.mjs +247 -0
  8. package/dist/angular/index.d.ts +5 -0
  9. package/dist/angular/lib/open-grid.component.d.ts +97 -0
  10. package/dist/angular/public-api.d.ts +6 -0
  11. package/dist/{index-Brfso4Ry.cjs → index-B_e5BXnW.cjs} +2 -2
  12. package/dist/{index-al9Mbv3E.js → index-Brnev66-.js} +2 -2
  13. package/dist/open-grid-base.css +4 -4
  14. package/dist/open-grid-header.cjs +4 -4
  15. package/dist/open-grid-header.css +21 -21
  16. package/dist/open-grid-header.js +4 -4
  17. package/dist/open-grid-react.cjs +1 -1
  18. package/dist/open-grid-react.js +1 -1
  19. package/dist/open-grid-skins.css +2 -2
  20. package/dist/open-grid-themes.css +48 -48
  21. package/dist/open-grid-typography.cjs +2 -2
  22. package/dist/open-grid-typography.js +2 -2
  23. package/dist/open-grid-vue.cjs +1 -1
  24. package/dist/open-grid-vue.js +1 -1
  25. package/dist/open-grid.cjs +1 -1
  26. package/dist/open-grid.js +2 -2
  27. package/dist/types/core/DetailManager.d.ts +1 -1
  28. package/dist/types/core/ExportManager.d.ts +7 -0
  29. package/dist/types/core/ExtensionPointRegistry.d.ts +2 -2
  30. package/dist/types/core/OpenGrid.d.ts +14 -9
  31. package/dist/types/core/appearance/AppearanceAxis.d.ts +54 -6
  32. package/dist/types/core/appearance/HeaderRegistry.d.ts +213 -21
  33. package/dist/types/core/appearance/TypographyRegistry.d.ts +63 -3
  34. package/dist/types/core/chart/DataExtractor.d.ts +1 -1
  35. package/dist/types/core/detail/DetailGlyph.d.ts +3 -3
  36. package/dist/types/core/types.d.ts +9 -9
  37. package/dist/types/header/index.d.ts +146 -6
  38. package/dist/types/typography/index.d.ts +134 -4
  39. package/package.json +42 -13
  40. package/dist/OpenGrid-CT9bV6On.cjs.map +0 -1
  41. package/dist/OpenGrid-DACnZdEy.js.map +0 -1
  42. package/dist/Registry-CPJYOqCn.js.map +0 -1
  43. package/dist/Registry-D74ZmdDz.cjs.map +0 -1
  44. package/dist/index-Brfso4Ry.cjs.map +0 -1
  45. package/dist/index-CeJ-0-80.cjs.map +0 -1
  46. package/dist/index-DnarQ4eR.js.map +0 -1
  47. package/dist/index-al9Mbv3E.js.map +0 -1
  48. package/dist/open-grid-header.cjs.map +0 -1
  49. package/dist/open-grid-header.js.map +0 -1
  50. package/dist/open-grid-react.cjs.map +0 -1
  51. package/dist/open-grid-react.js.map +0 -1
  52. package/dist/open-grid-typography.cjs.map +0 -1
  53. package/dist/open-grid-typography.js.map +0 -1
  54. package/dist/open-grid-vue.cjs.map +0 -1
  55. package/dist/open-grid-vue.js.map +0 -1
  56. package/dist/open-grid.cjs.map +0 -1
  57. package/dist/open-grid.js.map +0 -1
  58. package/dist/xlsx.min-BQ1o3sB6.cjs.map +0 -1
  59. package/dist/xlsx.min-Bbz2ZypC.js.map +0 -1
@@ -1,6 +1,14 @@
1
1
  /** 외관 축 식별자. 이름공간(prefix)이 물리 직교의 열쇠. / Appearance axis id; the token prefix is the key to physical orthogonality. */
2
2
  export type AxisId = 'theme' | 'skin' | 'density' | 'texture' | 'icon' | 'typography' | 'header';
3
- /** 한 축의 CSS 변수 델타(자기 이름공간만). / A CSS-var delta for one axis (own namespace only). */
3
+ /**
4
+ * 한 축의 CSS 변수 델타(자기 이름공간만).
5
+ *
6
+ * A CSS-var delta for one axis (own namespace only).
7
+ *
8
+ * 一つの軸の CSS 変数デルタ(自分の名前空間だけ)。
9
+ *
10
+ * 一个轴的 CSS 变量增量(只含自己的命名空间)。
11
+ */
4
12
  export type TokenDelta = Readonly<Record<string, string>>;
5
13
  /** 컨테이너에 붙일 data-* 속성. / A data-* attribute to place on the container. */
6
14
  export interface AxisAttr {
@@ -19,7 +27,15 @@ export interface AxisResolution {
19
27
  /** 이 선택이 재계산을 요구하는가(밀도 = 행높이 relayout). / Does this selection require recompute (density → row-height relayout)? */
20
28
  readonly requiresRelayout?: boolean;
21
29
  }
22
- /** 축 정의 결과 — 등록된(가드레일 반영) 델타 + 경고. / Axis-definition result — registered (clamped) delta + warnings. */
30
+ /**
31
+ * 축 정의 결과 — 등록된(가드레일 반영) 델타 + 경고.
32
+ *
33
+ * Axis-definition result — registered (clamped) delta + warnings.
34
+ *
35
+ * 軸の定義結果 — 登録された(ガードレール反映後の)デルタ + 警告。
36
+ *
37
+ * 轴的定义结果 — 注册后(经护栏钳制)的增量 + 警告。
38
+ */
23
39
  export interface AxisDefineResult {
24
40
  readonly delta: TokenDelta;
25
41
  readonly warnings: string[];
@@ -31,15 +47,47 @@ export interface AxisDefineResult {
31
47
  */
32
48
  export interface IAppearanceAxis {
33
49
  readonly id: AxisId;
34
- /** 이 축이 소유하는 토큰 이름공간(검증용). / Token namespace this axis owns (for validation). */
50
+ /**
51
+ * 이 축이 소유하는 토큰 이름공간(검증용).
52
+ *
53
+ * Token namespace this axis owns (for validation).
54
+ *
55
+ * この軸が所有するトークンの名前空間(検証用)。
56
+ *
57
+ * 这个轴所有的令牌命名空间(供校验使用)。
58
+ */
35
59
  readonly namespace: ReadonlySet<string>;
36
60
  /** 값 등록(사용자 확장). 축 오염·정직성 위반 시 throw 또는 클램프+경고. / Register a value; throws on axis-pollution, clamps+warns on honesty violations. */
37
61
  define(id: string, delta: TokenDelta): AxisDefineResult;
38
- /** 등록 여부. / Whether registered. */
62
+ /**
63
+ * 등록 여부.
64
+ *
65
+ * Whether registered.
66
+ *
67
+ * 登録されているか。
68
+ *
69
+ * 是否已注册。
70
+ */
39
71
  has(id: string): boolean;
40
- /** 축값 → 해소(토큰·속성·relayout 플래그). 미등록/default → 빈 델타. / Value id → resolution; unknown/default → empty delta. */
72
+ /**
73
+ * 축값 → 해소(토큰·속성·relayout 플래그). 미등록/default → 빈 델타.
74
+ *
75
+ * Value id → resolution; unknown/default → empty delta.
76
+ *
77
+ * 軸の値 → 解決(トークン・属性・relayout フラグ)。未登録/default → 空のデルタ。
78
+ *
79
+ * 轴的值 → 解析(令牌、属性、relayout 标志)。未注册/default → 空增量。
80
+ */
41
81
  resolve(valueId: string): AxisResolution;
42
- /** 등록된 값 id 목록(카탈로그·인스펙터용). / Registered value ids (for catalog/inspector). */
82
+ /**
83
+ * 등록된 값 id 목록(카탈로그·인스펙터용).
84
+ *
85
+ * Registered value ids (for catalog/inspector).
86
+ *
87
+ * 登録された値 id の一覧(カタログ・インスペクター用)。
88
+ *
89
+ * 已注册的值 id 列表(供目录与检查器使用)。
90
+ */
43
91
  list(): string[];
44
92
  }
45
93
  /** 축값이 default 인가(빈-델타·attr 생략 경로). / Is a value id the default (empty-delta / attr-omitted path)? */
@@ -1,25 +1,40 @@
1
1
  import { TokenAxis, TokenDelta, AxisDefineResult } from './AppearanceAxis.js';
2
2
  import { RegisterOptions, RegisterResult, RegistryEntry } from '../extension/Registry.js';
3
3
  /**
4
- * 헤더 축 이름공간(자기 소유 **형태** 토큰 8개 — 축 오염 검증용).
4
+ * 헤더 축 이름공간(자기 소유 **형태** 토큰 8개 — 축 섞임 검증용).
5
5
  *
6
- * 색(`--og-header-bg`·`--og-header-color` …)과 조판(`--og-header-font-weight` …)은
6
+ * 색(`--og-header-bg`·`--og-header-color` …)과 타이포그래피(`--og-header-font-weight` …)는
7
7
  * **의도적으로 빠져 있다.** 각각 theme 축·typography 축 소유다. 접두사가 같다고 같은 축이 아니다.
8
8
  *
9
9
  * The header axis namespace — the 8 own **shape** tokens (used for the axis-pollution check).
10
10
  *
11
11
  * Color and typography `--og-header-*` tokens are deliberately absent: they belong to the theme
12
12
  * and typography axes respectively. A shared prefix does not mean a shared axis.
13
+ *
14
+ * ヘッダー軸の名前空間(自分が所有する**形状**トークン8個 — 軸の混在を検査するために使います)。
15
+ *
16
+ * 色(`--og-header-bg`・`--og-header-color` …)とタイポグラフィ(`--og-header-font-weight` …)は
17
+ * **意図的に外してあります。** それぞれテーマ軸・タイポグラフィ軸の所有です。接頭辞が同じでも
18
+ * 同じ軸ではありません。
19
+ *
20
+ * 表头轴的命名空间(自己所有的**形状**令牌8个 — 用于轴混用检查)。
21
+ *
22
+ * 颜色(`--og-header-bg`、`--og-header-color` …)和排版(`--og-header-font-weight` …)是**有意排除的**,
23
+ * 它们分别归主题轴和排版轴所有。前缀相同并不等于同一个轴。
13
24
  */
14
25
  export declare const HEADER_TOKENS: ReadonlySet<string>;
15
26
  /**
16
27
  * 컨테이너에 붙는 축 속성명.
17
28
  *
18
29
  * The container attribute name for this axis.
30
+ *
31
+ * コンテナに付く軸の属性名。
32
+ *
33
+ * 加在容器上的轴属性名。
19
34
  */
20
35
  export declare const HEADER_ATTR = "data-og-header";
21
36
  /**
22
- * assertHeaderOnly — 헤더 델타가 색/조판/밀도/질감 토큰을 담지 않는지 검사(축 대칭).
37
+ * assertHeaderOnly — 헤더 델타가 색/타이포그래피/밀도/질감 토큰을 담지 않는지 검사(축 대칭).
23
38
  *
24
39
  * `assertColorOnly`(ThemeMetaRegistry)·`assertFormOnly`(SkinRegistry)·
25
40
  * `assertTypographyOnly`(TypographyRegistry)의 네 번째 대칭항이다. 불변식 1(각 축은 자기
@@ -30,15 +45,40 @@ export declare const HEADER_ATTR = "data-og-header";
30
45
  * The fourth symmetric counterpart to `assertColorOnly`, `assertFormOnly` and
31
46
  * `assertTypographyOnly`, enforcing invariant 1 in the header direction.
32
47
  *
48
+ * assertHeaderOnly — ヘッダーのデルタが色/タイポグラフィ/密度/質感のトークンを含まないかを検査します
49
+ * (軸の対称)。
50
+ *
51
+ * `assertColorOnly`(ThemeMetaRegistry)・`assertFormOnly`(SkinRegistry)・
52
+ * `assertTypographyOnly`(TypographyRegistry)に続く4つめの対称項です。不変条件1(各軸は自分の
53
+ * 名前空間だけを出す)をヘッダーの方向でも機械的に強制します。
54
+ *
55
+ * assertHeaderOnly — 检查表头增量是否含有颜色/排版/密度/质感的令牌(轴的对称)。
56
+ *
57
+ * 它是 `assertColorOnly`(ThemeMetaRegistry)、`assertFormOnly`(SkinRegistry)、
58
+ * `assertTypographyOnly`(TypographyRegistry)之后的第四个对称项。把不变式1(每个轴只发出自己的
59
+ * 命名空间)在表头方向上也机械强制。
60
+ *
33
61
  * @param id - 헤더 프리셋 id
34
62
  *
35
63
  * Header preset id
64
+ *
65
+ * ヘッダープリセット id
66
+ *
67
+ * 表头预设 id
36
68
  * @param delta - 검사할 헤더 델타
37
69
  *
38
70
  * Header delta to validate
71
+ *
72
+ * 検査するヘッダーのデルタ
73
+ *
74
+ * 要检查的表头增量
39
75
  * @throws 이름공간 밖 토큰이 있으면 Error
40
76
  *
41
77
  * Throws if a token outside the namespace is present
78
+ *
79
+ * 名前空間の外のトークンがあれば Error
80
+ *
81
+ * 有命名空间之外的令牌时抛出 Error
42
82
  * @example
43
83
  * assertHeaderOnly('my-header', { '--og-header-bg': 'red' }); // throws — 색은 theme 축 소유
44
84
  */
@@ -53,11 +93,37 @@ export declare function assertHeaderOnly(id: string, delta: TokenDelta): void;
53
93
  *
54
94
  * The delta itself lives in `TokenAxis`; this carries only policy/diagnostic information, so the
55
95
  * two stores never hold duplicate copies of the same thing.
96
+ *
97
+ * プリセット1件の登録メタ情報 — `TypedRegistry` に載る値です。
98
+ *
99
+ * デルタそのものは `TokenAxis` が持ちます。ここに入るのは**ポリシーと診断に使う情報**だけなので、
100
+ * 2つの保管先が同じものを二重に持つことはありません。
101
+ *
102
+ * 单个预设的注册元信息 — 存进 `TypedRegistry` 的值。
103
+ *
104
+ * 增量本身归 `TokenAxis` 所有。这里装的只有**策略与诊断用的信息**,因此两个存储不会重复持有同一
105
+ * 份东西。
56
106
  */
57
107
  export interface HeaderPresetMeta {
58
- /** 이 프리셋이 CSS 규칙을 요구하는가. 내장 5종 중 `default` 만 false. / Does this preset need CSS rules? Only `default` is false. */
108
+ /**
109
+ * 이 프리셋이 CSS 규칙을 요구하는가. 내장 5종 중 `default` 만 false.
110
+ *
111
+ * Does this preset need CSS rules? Only `default` is false.
112
+ *
113
+ * このプリセットが CSS 規則を必要とするか。組み込み5種のうち `default` だけが false。
114
+ *
115
+ * 这个预设是否需要 CSS 规则。内置5种里只有 `default` 为 false。
116
+ */
59
117
  readonly needsCss: boolean;
60
- /** 사람이 읽는 한 줄 설명(피커 UI·인스펙터용). / One-line human label (for picker UIs and inspectors). */
118
+ /**
119
+ * 사람이 읽는 한 줄 설명(피커 UI·인스펙터용).
120
+ *
121
+ * One-line human label (for picker UIs and inspectors).
122
+ *
123
+ * 人が読む一行の説明(ピッカー UI・インスペクター用)。
124
+ *
125
+ * 人读的一行说明(供预设选择 UI 与检查器使用)。
126
+ */
61
127
  readonly label?: string;
62
128
  }
63
129
  /**
@@ -94,6 +160,40 @@ export interface HeaderPresetMeta {
94
160
  * Composition (not inheritance) is used because a registry is not a kind of axis, and because
95
161
  * swapping `TokenAxis`'s store would change the code path of the five existing axes.
96
162
  *
163
+ * HeaderAxis — ヘッダー第6軸。**SPI は継承で、登録ポリシーはコンポジションで**得ます。
164
+ *
165
+ * **なぜ `extends TokenAxis` なのか(継承を使う場所)。** `assertNamespace`・`resolve` の never-throw
166
+ * フォールバック・`default` → 空デルタ(byte-identical)・`attr` の省略規則 — この4つは**6つの軸が
167
+ * 同じでなければならない不変条件**です。写し取れば6つに分かれてしまいます。ここは継承が正確な道具です。
168
+ *
169
+ * **なぜ `TypedRegistry` を継承せず中に持つのか(コンポジションを使う場所)。** `TypedRegistry<V>` は
170
+ * **キー→値の保管庫**で、`HeaderAxis` は**軸**です。is-a ではありません。そして `TokenAxis` を直して
171
+ * 保管庫を差し替えると、**既存5軸のコード経路が変わります** — 「既定値は変えない」という禁止線に直接
172
+ * 触れます。コンポジションなら**ヘッダー軸だけ**が新しいポリシーを持ち、残りの5軸は1バイトも変わりません
173
+ * (開放閉鎖の原則)。
174
+ *
175
+ * **この軸が兄弟軸より多く持つもの** — 既存の軸は素の `Map` なので、以下がすべてありません:
176
+ * 組み込み保護(`protect-builtin`)・登録元(`origin`)・プラグインの寿命管理(`disposePlugin`)・
177
+ * SPI バージョン検証・`og:*` 予約領域の保護・never-throw の登録結果。
178
+ * そのためこの軸では、利用者が `define('rule', …)` しても**組み込みプリセットが黙って消えることは
179
+ * ありません。**
180
+ *
181
+ * HeaderAxis — 表头第6轴。**用继承拿到 SPI,用组合拿到注册策略。**
182
+ *
183
+ * **为什么 `extends TokenAxis`(用继承的地方)。** `assertNamespace`、`resolve` 的 never-throw 回退、
184
+ * `default` → 空增量(byte-identical)、`attr` 的省略规则 — 这4条是**6个轴必须一致的不变式**。抄一遍
185
+ * 就会分成6份。这里继承才是准确的工具。
186
+ *
187
+ * **为什么不继承 `TypedRegistry` 而是放在里面(用组合的地方)。** `TypedRegistry<V>` 是**键→值的存储**,
188
+ * 而 `HeaderAxis` 是**轴**。不是 is-a。而且改 `TokenAxis` 去换掉存储,**现有5个轴的代码路径就会变** —
189
+ * 直接碰到「默认值不变」这条禁止线。用组合的话,**只有表头轴**拿到新策略,其余5个轴一个字节也不变
190
+ * (开闭原则)。
191
+ *
192
+ * **这个轴比兄弟轴多出来的东西** — 现有的轴是裸 `Map`,所以下面这些一个都没有:
193
+ * 内置保护(`protect-builtin`)、注册来源(`origin`)、插件生命周期(`disposePlugin`)、SPI 版本校验、
194
+ * `og:*` 保留区段的保护、never-throw 的注册结果。
195
+ * 因此在这个轴上,即使用户调用 `define('rule', …)`,**内置预设也不会静默消失。**
196
+ *
97
197
  * @example
98
198
  * headerRegistry.resolve('rule'); // { tokens:{'--og-header-rule-width':'2px',…}, attr:{name:'data-og-header',value:'rule'} }
99
199
  * headerRegistry.resolve('default'); // { tokens:{} } — 속성 미부착, byte-identical
@@ -107,7 +207,13 @@ export declare class HeaderAxis extends TokenAxis {
107
207
  */
108
208
  private readonly _policy;
109
209
  constructor();
110
- /** 등록 게이트에 축 오염 검사를 선행시킨다(`assertTypographyOnly` 와 동형 배선). */
210
+ /**
211
+ * 등록 게이트에 축 섞임 검사를 선행시킨다(`assertTypographyOnly` 와 동형 배선).
212
+ *
213
+ * 登録ゲートの手前で軸の混在を検査します(`assertTypographyOnly` と同じ形の配線)。
214
+ *
215
+ * 在注册关卡之前先做轴混用检查(与 `assertTypographyOnly` 同形的接线)。
216
+ */
111
217
  registerBuiltin(id: string, delta: TokenDelta): void;
112
218
  /**
113
219
  * 내장 `default` 를 정책 레지스트리에만 올린다(델타는 등록하지 않는다).
@@ -129,18 +235,67 @@ export declare class HeaderAxis extends TokenAxis {
129
235
  * `origin:'builtin'` 으로 등록돼 있어 `{ override: true }` 없이는 교체되지 않고, 거부 사유가
130
236
  * `registration` 으로 돌아온다(never-throw).
131
237
  *
132
- * 축 오염(색·조판 토큰)은 **상속받은 검사가 throw** 한다 — 정책보다 먼저 걸린다.
238
+ * 축 섞임(색·타이포그래피 토큰)은 **상속받은 검사가 throw** 한다 — 정책보다 먼저 걸린다.
133
239
  * 순서가 중요하다: 오염된 델타는 애초에 등록 후보가 아니므로 정책 판정까지 갈 이유가 없다.
134
240
  *
135
241
  * Registers a user-defined preset. Unlike `TokenAxis.define`, built-ins are **not silently
136
242
  * replaced**: without `{ override: true }` the registration is rejected and the reason is
137
243
  * returned in `registration` (never throws). Axis pollution throws first, before policy runs.
138
244
  *
139
- * @param id - 프리셋 id / Preset id
140
- * @param delta - 헤더 형태 토큰 델타 / Header shape-token delta
141
- * @param opts - 등록 정책 옵션(+ 프리셋 메타) / Registration policy options (plus preset meta)
142
- * @returns 클램프 반영 델타 + 경고 + 등록 판정 / Clamped delta, warnings, and the registration verdict
143
- * @throws 색·조판 등 이름공간 밖 토큰이 있으면 Error / Throws on out-of-namespace tokens
245
+ * ユーザー定義プリセットの登録。
246
+ *
247
+ * `TokenAxis.define` と違い、**黙って上書きしません。** 組み込み5種
248
+ * (`default`・`rule`・`quiet`・`band`・`pill`)は `origin:'builtin'` で登録されているため、
249
+ * `{ override: true }` なしでは置き換わらず、拒否の理由が `registration` で返ります(never-throw)。
250
+ *
251
+ * 軸の混在(色・タイポグラフィのトークン)は**継承した検査が throw** します — ポリシーより先に
252
+ * 引っかかります。順序が大事です: 混ざったデルタはそもそも登録の候補ではないので、ポリシーの判定まで
253
+ * 進む理由がありません。
254
+ *
255
+ * 注册用户自定义预设。
256
+ *
257
+ * 与 `TokenAxis.define` 不同,**不会静默覆盖**。内置5种(`default`、`rule`、`quiet`、`band`、`pill`)
258
+ * 以 `origin:'builtin'` 注册,不带 `{ override: true }` 就不会被替换,拒绝的理由通过 `registration`
259
+ * 返回(never-throw)。
260
+ *
261
+ * 轴混用(颜色、排版的令牌)由**继承来的检查 throw** — 比策略更先拦下。顺序很重要: 混了的增量本来
262
+ * 就不是注册的候选,没有理由走到策略判定。
263
+ *
264
+ * @param id - 프리셋 id
265
+ *
266
+ * Preset id
267
+ *
268
+ * プリセット id
269
+ *
270
+ * 预设 id
271
+ * @param delta - 헤더 형태 토큰 델타
272
+ *
273
+ * Header shape-token delta
274
+ *
275
+ * ヘッダー形状トークンのデルタ
276
+ *
277
+ * 表头形状令牌增量
278
+ * @param opts - 등록 정책 옵션(+ 프리셋 메타)
279
+ *
280
+ * Registration policy options (plus preset meta)
281
+ *
282
+ * 登録ポリシーのオプション(+ プリセットのメタ情報)
283
+ *
284
+ * 注册策略选项(+ 预设元信息)
285
+ * @returns 클램프 반영 델타 + 경고 + 등록 판정
286
+ *
287
+ * Clamped delta, warnings, and the registration verdict
288
+ *
289
+ * クランプを反映したデルタ + 警告 + 登録の判定
290
+ *
291
+ * 钳制后的增量 + 警告 + 注册判定
292
+ * @throws 색·타이포그래피 등 이름공간 밖 토큰이 있으면 Error
293
+ *
294
+ * Throws on out-of-namespace tokens
295
+ *
296
+ * 色・タイポグラフィなど名前空間の外のトークンがあれば Error
297
+ *
298
+ * 有颜色、排版等命名空间之外的令牌时抛出 Error
144
299
  */
145
300
  define(id: string, delta: TokenDelta, opts?: RegisterOptions & {
146
301
  meta?: HeaderPresetMeta;
@@ -151,6 +306,10 @@ export declare class HeaderAxis extends TokenAxis {
151
306
  * 등록 기록(출처·플러그인·우선순위·SPI 버전). 진단·카탈로그용.
152
307
  *
153
308
  * Registration records (origin, plugin, priority, SPI version) — for diagnostics and catalogs.
309
+ *
310
+ * 登録の記録(登録元・プラグイン・優先度・SPI バージョン)。診断とカタログ用。
311
+ *
312
+ * 注册记录(注册来源、插件、优先级、SPI 版本)。供诊断与目录使用。
154
313
  */
155
314
  entries(): ReadonlyArray<RegistryEntry<HeaderPresetMeta>>;
156
315
  /**
@@ -161,8 +320,28 @@ export declare class HeaderAxis extends TokenAxis {
161
320
  * Disposes only the presets registered by one plugin — the symmetric counterpart to registration,
162
321
  * which the sibling axes lack. Returns the number of entries removed.
163
322
  *
164
- * @param pluginId - 해제할 플러그인 id / The plugin id to dispose
165
- * @returns 해제된 건수 / Number of entries removed
323
+ * あるプラグインが入れたプリセットだけを選んで解除します — **登録の対称**です。
324
+ *
325
+ * 兄弟軸にはこの対称がありません(素の `Map` なので、誰が入れたか分かりません)。解除した件数を返します。
326
+ *
327
+ * 只挑出某一个插件注册的预设并解除 — **与注册对称**。
328
+ *
329
+ * 兄弟轴没有这个对称(裸 `Map`,不知道是谁放进去的)。返回解除的数量。
330
+ *
331
+ * @param pluginId - 해제할 플러그인 id
332
+ *
333
+ * The plugin id to dispose
334
+ *
335
+ * 解除するプラグイン id
336
+ *
337
+ * 要解除的插件 id
338
+ * @returns 해제된 건수
339
+ *
340
+ * Number of entries removed
341
+ *
342
+ * 解除した件数
343
+ *
344
+ * 解除的数量
166
345
  */
167
346
  disposePlugin(pluginId: string): number;
168
347
  /**
@@ -185,25 +364,25 @@ export declare class HeaderAxis extends TokenAxis {
185
364
  };
186
365
  }
187
366
  /**
188
- * rule — 규칙선. 머리글의 배경을 지우고 아래로 굵은 선 하나만 남긴다.
367
+ * rule — 규칙선. 헤더의 배경을 지우고 아래로 굵은 선 하나만 남긴다.
189
368
  *
190
369
  * rule — a single heavy rule under a background-less header.
191
370
  */
192
371
  export declare const HEADER_RULE: TokenDelta;
193
372
  /**
194
- * quiet — 조용한 머리글. 선도 배경도 거의 없애고 글자만 남긴다.
373
+ * quiet — 조용한 헤더. 선도 배경도 거의 없애고 글자만 남긴다.
195
374
  *
196
375
  * quiet — nearly no rule and no fill; the label alone carries the header.
197
376
  */
198
377
  export declare const HEADER_QUIET: TokenDelta;
199
378
  /**
200
- * band — 띠. 머리글을 채워 표의 지붕으로 세운다(오늘의 기본형에 가장 가깝다).
379
+ * band — 띠. 헤더를 채워 표의 머리가 어디인지 멀리서도 보이게 한다(오늘의 기본형에 가장 가깝다).
201
380
  *
202
381
  * band — a filled band; the closest of the four to today's default header.
203
382
  */
204
383
  export declare const HEADER_BAND: TokenDelta;
205
384
  /**
206
- * pill — 알약. 각 머리글 칸을 떠 있는 알약으로 만든다.
385
+ * pill — 둥근 배지. 각 헤더 칸을 떠 있는 배지로 만든다.
207
386
  *
208
387
  * pill — each header cell floats as a rounded pill.
209
388
  */
@@ -214,6 +393,9 @@ export declare const HEADER_PILL: TokenDelta;
214
393
  * Built-in header catalog (default excluded — default is an empty delta).
215
394
  */
216
395
  export declare const BUILTIN_HEADERS: ReadonlyArray<readonly [string, TokenDelta]>;
396
+ declare class BootstrappedHeaderAxis extends HeaderAxis {
397
+ constructor();
398
+ }
217
399
  /**
218
400
  * 프로세스 전역 기본 헤더 축(내장 부트스트랩).
219
401
  *
@@ -223,10 +405,20 @@ export declare const BUILTIN_HEADERS: ReadonlyArray<readonly [string, TokenDelta
223
405
  * 컨테이너를 못 얻어 조용히 반쪽만 작동한다 — 타이포 트랙이 실측으로 확인한 것이다.
224
406
  *
225
407
  * Process-global default header axis (built-ins bootstrapped) — same shape as `typographyRegistry`.
408
+ *
409
+ * プロセス全体の既定ヘッダー軸(組み込みをブートストラップ済み)。
410
+ *
411
+ * タイポグラフィの実物(`typographyRegistry`)と同じ形です — モジュール全体のシングルトン + 自由関数の境界。
412
+ * `dispose()` を持つインスタンスハンドルを使わないのは、`OpenGrid` がコンテナ要素を返す公開アクセサーを
413
+ * 提供しないからです(`_container` は private)。その前提の上に立てた設計は、コンテナを得られず黙って
414
+ * 半分しか働きません — タイポグラフィのトラックが実測で確かめたことです。
415
+ *
416
+ * 进程全局的默认表头轴(内置已完成引导)。
417
+ *
418
+ * 与排版的实物(`typographyRegistry`)形状相同 — 模块全局单例 + 自由函数边界。不用带 `dispose()` 的
419
+ * 实例句柄,是因为 `OpenGrid` 不提供返回容器元素的公开访问器(`_container` 是 private)。建立在那个
420
+ * 前提上的设计拿不到容器,只会静默地工作一半 — 这是排版那条线用实测确认过的。
226
421
  */
227
- declare class BootstrappedHeaderAxis extends HeaderAxis {
228
- constructor();
229
- }
230
422
  export declare const headerRegistry: BootstrappedHeaderAxis;
231
423
  /**
232
424
  * `HeaderAxis` 의 별칭 — 파일명·형제 축 이름(`TypographyRegistry`·`TextureRegistry`)과 맞춘다.
@@ -1,18 +1,30 @@
1
1
  import { TokenAxis, TokenDelta } from './AppearanceAxis.js';
2
2
  /**
3
- * 타이포그래피 축 이름공간(자기 소유 토큰 9개 — 축 오염 검증용).
3
+ * 타이포그래피 축 이름공간(자기 소유 토큰 9개 — 축 섞임 검증용).
4
4
  *
5
5
  * `--og-font-size`·`--og-line-height` 는 **의도적으로 빠져 있다**. 둘은 density 축 소유다.
6
6
  *
7
7
  * Typography namespace (the 9 own tokens — used for the axis-pollution check).
8
8
  *
9
9
  * `--og-font-size` and `--og-line-height` are deliberately absent: they belong to the density axis.
10
+ *
11
+ * タイポグラフィ軸の名前空間(自分が所有するトークン9個 — 軸の混在を検査するために使います)。
12
+ *
13
+ * `--og-font-size`・`--og-line-height` は**意図的に外してあります**。どちらも密度軸の所有です。
14
+ *
15
+ * 排版轴的命名空间(自己所有的令牌9个 — 用于轴混用检查)。
16
+ *
17
+ * `--og-font-size`、`--og-line-height` 是**有意排除的**。两者都归密度轴所有。
10
18
  */
11
19
  export declare const TYPOGRAPHY_TOKENS: ReadonlySet<string>;
12
20
  /**
13
21
  * 컨테이너에 붙는 축 속성명.
14
22
  *
15
23
  * The container attribute name for this axis.
24
+ *
25
+ * コンテナに付く軸の属性名。
26
+ *
27
+ * 加在容器上的轴属性名。
16
28
  */
17
29
  export declare const TYPOGRAPHY_ATTR = "data-og-typography";
18
30
  /**
@@ -27,15 +39,38 @@ export declare const TYPOGRAPHY_ATTR = "data-og-typography";
27
39
  * (each axis emits only its own namespace) is now mechanically enforced in the typography
28
40
  * direction too.
29
41
  *
42
+ * assertTypographyOnly — タイポグラフィのデルタが色/形状/密度/質感のトークンを含まないかを検査します
43
+ * (4軸の対称)。
44
+ *
45
+ * `assertColorOnly`(ThemeMetaRegistry)・`assertFormOnly`(SkinRegistry)に続く3つめの対称項です。
46
+ * 各軸は自分の名前空間だけを出すという不変条件1を、タイポグラフィの方向でも機械的に強制します。
47
+ *
48
+ * assertTypographyOnly — 检查排版增量是否含有颜色/形状/密度/质感的令牌(4轴的对称)。
49
+ *
50
+ * 它是 `assertColorOnly`(ThemeMetaRegistry)、`assertFormOnly`(SkinRegistry)之后的第三个对称项。
51
+ * 把「每个轴只发出自己的命名空间」这条不变式1,在排版方向上也机械强制。
52
+ *
30
53
  * @param id - 타이포 프리셋 id
31
54
  *
32
55
  * Typography preset id
56
+ *
57
+ * タイポグラフィプリセット id
58
+ *
59
+ * 排版预设 id
33
60
  * @param delta - 검사할 타이포 델타
34
61
  *
35
62
  * Typography delta to validate
63
+ *
64
+ * 検査するタイポグラフィのデルタ
65
+ *
66
+ * 要检查的排版增量
36
67
  * @throws 이름공간 밖 토큰이 있으면 Error
37
68
  *
38
69
  * Throws if a token outside the namespace is present
70
+ *
71
+ * 名前空間の外のトークンがあれば Error
72
+ *
73
+ * 有命名空间之外的令牌时抛出 Error
39
74
  * @example
40
75
  * assertTypographyOnly('my-typo', { '--og-font-size': '12px' }); // throws — --og-font-size 는 density 소유
41
76
  */
@@ -49,15 +84,36 @@ export declare function assertTypographyOnly(id: string, delta: TokenDelta): voi
49
84
  *
50
85
  * Named values do not require relayout: swapping a face only repaints, and row height belongs to density.
51
86
  *
87
+ * TypographyRegistry — タイポグラフィ第5軸。登録ゲートが2種類の正直ガードを執行します。
88
+ *
89
+ * named の値は relayout を要求しません(書体の入れ替えは CSS の再ペイントで、行の高さは密度の所有なので
90
+ * 座標は変わりません)。
91
+ *
92
+ * TypographyRegistry — 排版第5轴。注册关卡执行两种如实防护。
93
+ *
94
+ * named 的值不要求 relayout(换字体只是 CSS 重绘,行高归密度所有,所以坐标不变)。
95
+ *
52
96
  * @example
53
97
  * typographyRegistry.resolve('ledger'); // { tokens:{'--og-font-family':…,'--og-font-variant-numeric':'tabular-nums slashed-zero'}, attr:{name:'data-og-typography',value:'ledger'} }
54
98
  * typographyRegistry.resolve('default'); // { tokens:{} } — 속성 미부착, byte-identical
55
99
  */
56
100
  export declare class TypographyRegistry extends TokenAxis {
57
101
  constructor();
58
- /** 등록 게이트에 축 오염 검사를 선행시킨다(`assertFormOnly`·`assertColorOnly` 와 동형 배선). */
102
+ /**
103
+ * 등록 게이트에 축 섞임 검사를 선행시킨다(`assertFormOnly`·`assertColorOnly` 와 동형 배선).
104
+ *
105
+ * 登録ゲートの手前で軸の混在を検査します(`assertFormOnly`・`assertColorOnly` と同じ形の配線)。
106
+ *
107
+ * 在注册关卡之前先做轴混用检查(与 `assertFormOnly`、`assertColorOnly` 同形的接线)。
108
+ */
59
109
  registerBuiltin(id: string, delta: TokenDelta): void;
60
- /** 사용자 정의 등록. 축 오염은 throw, 정직 가드는 클램프+경고. */
110
+ /**
111
+ * 사용자 정의 등록. 축 섞임은 throw, 정직 가드는 클램프+경고.
112
+ *
113
+ * ユーザー定義の登録。軸の混在は throw、正直ガードはクランプ+警告。
114
+ *
115
+ * 用户自定义的注册。轴混用 throw,如实防护则钳制 + 警告。
116
+ */
61
117
  define(id: string, delta: TokenDelta): {
62
118
  delta: TokenDelta;
63
119
  warnings: string[];
@@ -118,5 +174,9 @@ export declare const BUILTIN_TYPOGRAPHIES: ReadonlyArray<readonly [string, Token
118
174
  * 프로세스 전역 기본 타이포 레지스트리(내장 부트스트랩).
119
175
  *
120
176
  * Process-global default typography registry (built-ins bootstrapped).
177
+ *
178
+ * プロセス全体の既定タイポグラフィレジストリ(組み込みをブートストラップ済み)。
179
+ *
180
+ * 进程全局的默认排版注册表(内置已完成引导)。
121
181
  */
122
182
  export declare const typographyRegistry: TypographyRegistry;
@@ -67,7 +67,7 @@ export interface ChartExtractConfig {
67
67
  export interface ChartExtractResult {
68
68
  /** 산출된 차트 데이터 모델. / The produced chart data model. */
69
69
  model: ChartDataModel;
70
- /** true 면 kind='range' 요청이 selection 으로 강등됐다(F1 부재/range 미해소, §7 HANMS-04). / true when a kind='range' request was downgraded to selection (F1 absent/range unresolved, §7). */
70
+ /** true 면 kind='range' 요청이 selection 으로 강등됐다(F1 부재/range 미해소, §7 UX-REVIEW-04). / true when a kind='range' request was downgraded to selection (F1 absent/range unresolved, §7). */
71
71
  rangeFallback: boolean;
72
72
  }
73
73
  /**
@@ -1,6 +1,6 @@
1
1
  /**
2
- * DetailGlyph — F2 디테일 expander 글리프/aria 정책 (C10 R-DETAIL-GLYPH, HANMS-06 해소).
3
- * / DetailGlyph — F2 detail-expander glyph / aria policy (C10 R-DETAIL-GLYPH, resolves review item HANMS-06).
2
+ * DetailGlyph — F2 디테일 expander 글리프/aria 정책 (C10 R-DETAIL-GLYPH, UX-REVIEW-06 해소).
3
+ * / DetailGlyph — F2 detail-expander glyph / aria policy (C10 R-DETAIL-GLYPH, resolves review item UX-REVIEW-06).
4
4
  *
5
5
  * 계약 근거:
6
6
  * - docs/design/grid-features-2026-07/15_cross_contracts.md C10 "R-DETAIL-GLYPH": detail expander는
@@ -37,7 +37,7 @@ export declare const DETAIL_EXPANDER_MIN_HIT_TARGET_PX = 44;
37
37
  export interface DetailGlyphInfo {
38
38
  /** 화면에 그릴 문자(셰브론 아님, C10). / Character to render (not a chevron, C10). */
39
39
  glyph: string;
40
- /** expander 자체 aria-label(NFR-5, HANMS-06 — SR 에서 트리 토글과 구분). / The expander's own aria-label (NFR-5, HANMS-06 — distinguished from the tree toggle for screen readers). */
40
+ /** expander 자체 aria-label(NFR-5, UX-REVIEW-06 — SR 에서 트리 토글과 구분). / The expander's own aria-label (NFR-5, UX-REVIEW-06 — distinguished from the tree toggle for screen readers). */
41
41
  ariaLabel: string;
42
42
  /** 툴팁 title 속성(C10 "상세 보기" 고정 문구). / Tooltip title attribute (C10 fixed text "View detail"). */
43
43
  title: string;