open-grid 1.5.2 → 1.6.1
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.
- package/CHANGELOG.md +475 -416
- package/README.ja.md +39 -0
- package/README.md +39 -0
- package/README.zh.md +39 -0
- package/dist/{OpenGrid-CT9bV6On.cjs → OpenGrid-CLk8Vt7j.cjs} +1390 -1316
- package/dist/{OpenGrid-DACnZdEy.js → OpenGrid-D6YxCsnV.js} +1757 -1683
- package/dist/angular/fesm2022/open-grid-angular.mjs +247 -0
- package/dist/angular/index.d.ts +5 -0
- package/dist/angular/lib/open-grid.component.d.ts +97 -0
- package/dist/angular/public-api.d.ts +6 -0
- package/dist/{index-Brfso4Ry.cjs → index-D0DJtKYI.cjs} +2 -2
- package/dist/{index-al9Mbv3E.js → index-VkKgQ506.js} +2 -2
- package/dist/open-grid-a11y.cjs +216 -0
- package/dist/open-grid-a11y.js +219 -0
- package/dist/open-grid-base.css +13 -4
- package/dist/open-grid-header.cjs +4 -4
- package/dist/open-grid-header.css +18 -27
- package/dist/open-grid-header.js +4 -4
- package/dist/open-grid-react.cjs +1 -1
- package/dist/open-grid-react.js +1 -1
- package/dist/open-grid-skins.css +2 -2
- package/dist/open-grid-themes.css +19 -19
- package/dist/open-grid-typography.cjs +2 -2
- package/dist/open-grid-typography.js +2 -2
- package/dist/open-grid-vue.cjs +1 -1
- package/dist/open-grid-vue.js +1 -1
- package/dist/open-grid.cjs +5 -2
- package/dist/open-grid.js +6 -3
- package/dist/types/a11y/index.d.ts +37 -0
- package/dist/types/core/ColumnLayout.d.ts +3 -3
- package/dist/types/core/DetailManager.d.ts +1 -1
- package/dist/types/core/ExportManager.d.ts +9 -6
- package/dist/types/core/ExtensionPointRegistry.d.ts +2 -2
- package/dist/types/core/FlatRowModel.d.ts +8 -0
- package/dist/types/core/MergeEngine.d.ts +45 -5
- package/dist/types/core/MutationService.d.ts +4 -9
- package/dist/types/core/OpenGrid.d.ts +357 -16
- package/dist/types/core/OrgChart.d.ts +24 -0
- package/dist/types/core/RowDragDrop.d.ts +2 -0
- package/dist/types/core/SortFilterManager.d.ts +8 -0
- package/dist/types/core/WorksheetManager.d.ts +2 -2
- package/dist/types/core/a11y/KeyboardInteractionModel.d.ts +321 -20
- package/dist/types/core/a11y/LiveRegionController.d.ts +229 -27
- package/dist/types/core/a11y/VisualEquivRegistry.d.ts +199 -14
- package/dist/types/core/appearance/AppearanceAxis.d.ts +54 -6
- package/dist/types/core/appearance/HeaderRegistry.d.ts +213 -21
- package/dist/types/core/appearance/TextureRegistry.d.ts +10 -0
- package/dist/types/core/appearance/TypographyRegistry.d.ts +63 -3
- package/dist/types/core/cf/CFRule.d.ts +145 -22
- package/dist/types/core/chart/DataExtractor.d.ts +1 -1
- package/dist/types/core/detail/DetailGlyph.d.ts +3 -3
- package/dist/types/core/types.d.ts +511 -31
- package/dist/types/header/index.d.ts +146 -6
- package/dist/types/index.d.ts +31 -1
- package/dist/types/typography/index.d.ts +134 -4
- package/dist/types/vue/OpenGrid.vue.d.ts +1 -1
- package/package.json +47 -13
- package/dist/OpenGrid-CT9bV6On.cjs.map +0 -1
- package/dist/OpenGrid-DACnZdEy.js.map +0 -1
- package/dist/Registry-CPJYOqCn.js.map +0 -1
- package/dist/Registry-D74ZmdDz.cjs.map +0 -1
- package/dist/index-Brfso4Ry.cjs.map +0 -1
- package/dist/index-CeJ-0-80.cjs.map +0 -1
- package/dist/index-DnarQ4eR.js.map +0 -1
- package/dist/index-al9Mbv3E.js.map +0 -1
- package/dist/open-grid-header.cjs.map +0 -1
- package/dist/open-grid-header.js.map +0 -1
- package/dist/open-grid-react.cjs.map +0 -1
- package/dist/open-grid-react.js.map +0 -1
- package/dist/open-grid-typography.cjs.map +0 -1
- package/dist/open-grid-typography.js.map +0 -1
- package/dist/open-grid-vue.cjs.map +0 -1
- package/dist/open-grid-vue.js.map +0 -1
- package/dist/open-grid.cjs.map +0 -1
- package/dist/open-grid.js.map +0 -1
- package/dist/xlsx.min-BQ1o3sB6.cjs.map +0 -1
- package/dist/xlsx.min-Bbz2ZypC.js.map +0 -1
|
@@ -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` …)과
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
/**
|
|
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
|
-
* 축
|
|
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
|
-
*
|
|
140
|
-
*
|
|
141
|
-
*
|
|
142
|
-
*
|
|
143
|
-
*
|
|
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
|
-
*
|
|
165
|
-
*
|
|
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`)과 맞춘다.
|
|
@@ -8,6 +8,16 @@ export declare const TEXTURE_OPACITY_CAP = 0.1;
|
|
|
8
8
|
* named 값은 relayout 을 요구하지 않는다(질감은 배경 페인트만 — 좌표 불변).
|
|
9
9
|
* / TextureRegistry — the 3rd texture axis. The registration gate clamps texture-opacity to ≤0.1.
|
|
10
10
|
*
|
|
11
|
+
* 새 질감을 등록할 때: `--og-texture-bg` 는 **필수**다 — 빠뜨리면 질감을 켠 그리드의 크롬에서
|
|
12
|
+
* `background-image` 가 none 이 되어 테마가 머리글에 깐 그림(예: stitch 능직)까지 지워진다(칠 규칙이
|
|
13
|
+
* !important 이기 때문). 잉크는 `rgba(var(--og-texture-ink, 0, 0, 0), a)` 처럼 **폴백을 함께** 적는다 —
|
|
14
|
+
* 잉크를 정의하지 않은 테마에서 폴백 없는 참조는 무효 값이 되어 아무것도 칠해지지 않는다. 결의 세기는
|
|
15
|
+
* 잉크 알파로 정한다(`--og-texture-opacity` 는 그 상한 검사값이지 칠하는 데 쓰지 않는다).
|
|
16
|
+
* / When registering a texture: `--og-texture-bg` is required (missing it blanks the chrome's
|
|
17
|
+
* background-image, wiping theme header patterns, because the paint rule is !important). Write the ink
|
|
18
|
+
* with a fallback, `rgba(var(--og-texture-ink, 0, 0, 0), a)`; strength comes from that alpha
|
|
19
|
+
* (`--og-texture-opacity` is only the cap checked at registration).
|
|
20
|
+
*
|
|
11
21
|
* @example
|
|
12
22
|
* textureRegistry.resolve('linen'); // { tokens:{'--og-texture-bg':…,'--og-texture-opacity':'0.06',…}, attr:{name:'data-og-texture',value:'linen'} }
|
|
13
23
|
* textureRegistry.resolve('default'); // { tokens:{} } — byte-identical
|
|
@@ -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
|
-
/**
|
|
102
|
+
/**
|
|
103
|
+
* 등록 게이트에 축 섞임 검사를 선행시킨다(`assertFormOnly`·`assertColorOnly` 와 동형 배선).
|
|
104
|
+
*
|
|
105
|
+
* 登録ゲートの手前で軸の混在を検査します(`assertFormOnly`・`assertColorOnly` と同じ形の配線)。
|
|
106
|
+
*
|
|
107
|
+
* 在注册关卡之前先做轴混用检查(与 `assertFormOnly`、`assertColorOnly` 同形的接线)。
|
|
108
|
+
*/
|
|
59
109
|
registerBuiltin(id: string, delta: TokenDelta): void;
|
|
60
|
-
/**
|
|
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;
|