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,44 +1,188 @@
1
1
  import { SkinTokenDelta } from './types.js';
2
- /** 허용되는 FORM 토큰 이름(SkinTokenName 과 동일 집합의 런타임 가드).
3
- * export 이유(DD-11): 테마 델타의 대칭 검증 `assertColorOnly` 가 이 집합을 denylist 로 재사용해
4
- * 색축⊥형태축을 양방향으로 기계강제한다(형태/밀도/질감 shape 토큰이 테마 델타에 오면 거부). */
2
+ /**
3
+ * 스킨(FORM) 델타에 등장할 수 있는 CSS 커스텀 프로퍼티 이름의 허용 목록(런타임 가드).
4
+ * 스킨은 형태(모서리·테두리·그림자·밀도 등)만 다루고 색은 다루지 않는다는 규칙을, 이 목록이
5
+ * 물리적으로 강제한다 — `define()`/`registerBuiltin()` 이 델타를 검사할 때 이 집합에 없는
6
+ * 키는 거부한다. 반대 방향(테마 델타에 형태 토큰이 섞이는 것)도 이 집합을 재사용해 막는다
7
+ * (색⊥형태 축 분리를 양방향으로 기계 강제).
8
+ *
9
+ * Allow-list of CSS custom-property names permitted in a skin (FORM) delta (runtime guard).
10
+ * It physically enforces the rule that skins own shape only (radius/border/elevation/density/…)
11
+ * and never color — `define()`/`registerBuiltin()` reject any key outside this set. The reverse
12
+ * direction (shape tokens leaking into a theme delta) reuses this same set, so the color⊥shape
13
+ * axis separation is mechanically enforced both ways.
14
+ *
15
+ * スキン(FORM)デルタに登場できる CSS カスタムプロパティ名の許可リスト(ランタイムガード)。
16
+ * スキンは形状(角・境界線・影・密度など)だけを扱い色は扱わないというルールを、このリストが
17
+ * 物理的に強制します — `define()`/`registerBuiltin()` がデルタを検査するとき、この集合にない
18
+ * キーは拒否します。逆方向(テーマデルタに形状トークンが混ざること)も、この集合を再利用して
19
+ * 防ぎます(色⊥形状の軸分離を双方向で機械的に強制)。
20
+ *
21
+ * 皮肤(FORM)增量中允许出现的 CSS 自定义属性名白名单(运行时防护)。
22
+ * 这份清单从物理上强制"皮肤只负责形状(圆角、边框、阴影、密度等),不负责颜色"这条规则 —
23
+ * `define()`/`registerBuiltin()` 检查增量时,拒绝该集合之外的键。反方向(形状令牌混入主题增量)
24
+ * 也复用同一集合来阻止,因此色⊥形的轴分离在两个方向上都由机器强制。
25
+ */
5
26
  export declare const FORM_TOKENS: ReadonlySet<string>;
6
- /** 스킨 정의 결과. / Result of a skin definition. */
27
+ /**
28
+ * 스킨 정의 결과.
29
+ *
30
+ * Result of a skin definition.
31
+ *
32
+ * スキン定義の結果。
33
+ *
34
+ * 皮肤定义的结果。
35
+ */
7
36
  export interface SkinDefineResult {
8
- /** 실제 등록된(가드레일 클램프가 반영된) 델타. / The actually registered delta (with guardrail clamps applied). */
37
+ /**
38
+ * 실제 등록된(가드레일 클램프가 반영된) 델타.
39
+ *
40
+ * The actually registered delta (with guardrail clamps applied).
41
+ *
42
+ * 実際に登録された(ガードレールのクランプが反映された)デルタ。
43
+ *
44
+ * 实际注册的增量(已反映防护栏的钳制)。
45
+ */
9
46
  readonly delta: SkinTokenDelta;
10
- /** 접근성 가드레일이 조정한 토큰 경고(있으면 콘솔에도 출력). / Warnings for tokens adjusted by accessibility guardrails (also logged to console when present). */
47
+ /**
48
+ * 접근성 가드레일이 조정한 토큰 경고(있으면 콘솔에도 출력).
49
+ *
50
+ * Warnings for tokens adjusted by accessibility guardrails (also logged to console when present).
51
+ *
52
+ * アクセシビリティガードレールが調整したトークンの警告(あればコンソールにも出力)。
53
+ *
54
+ * 无障碍防护栏所调整令牌的警告(存在时也输出到控制台)。
55
+ */
11
56
  readonly warnings: string[];
12
57
  }
13
58
  /**
14
- * 스킨 델타가 색 리터럴을 담고 있는지 검사하고, 위반 시 던진다(FORM-only, Rule 2).
15
- * / Assert a skin delta carries no color literal; throws on violation (FORM-only, Rule 2).
59
+ * 스킨(FORM)에는 형태만 담고 색은 담지 않는다는 규칙을 실제로 검사하는 함수. 왜 필요한가:
60
+ * 스킨과 테마(색)를 분리해 두어도, 개발자가 실수로 스킨 델타에 `#fff` 같은 색을 넣으면 그
61
+ * 분리가 눈에 안 띄게 무너진다 — 그래서 등록 시점에 색 리터럴이 섞이면 즉시 던져서 알아채게
62
+ * 한다(조용히 무시하지 않음).
63
+ *
64
+ * Actually enforces the rule that a skin (FORM) carries shape only, never color. Why: even with
65
+ * skin/theme separation on paper, a developer slipping `#fff` into a skin delta would quietly
66
+ * break that separation — so this throws immediately at registration time instead of ignoring it.
67
+ *
68
+ * スキン(FORM)には形状だけを入れ、色は入れないというルールを実際に検査する関数です。なぜ必要か:
69
+ * スキンとテーマ(色)を分離しておいても、開発者が誤ってスキンデルタに `#fff` のような色を入れると、
70
+ * その分離は気づかないうちに崩れます — そこで登録の時点で色リテラルが混ざれば即座に throw して
71
+ * 気づかせます(黙って無視しません)。
72
+ *
73
+ * 实际检查"皮肤(FORM)只装形状、不装颜色"这条规则的函数。为什么需要它: 即便皮肤与主题(颜色)
74
+ * 在纸面上已经分离,开发者一旦误把 `#fff` 这样的颜色写进皮肤增量,这层分离就会在无人察觉中瓦解 —
75
+ * 因此本函数在注册的时点立即 throw 让人发现,而不是默默忽略。
76
+ *
77
+ * @param id - 스킨 id
78
+ *
79
+ * Skin id
16
80
  *
17
- * @param id - 스킨 id / Skin id
18
- * @param delta - 검사할 토큰 델타 / Token delta to validate
19
- * @throws FORM 토큰이 아니거나 색 리터럴이 있으면 Error / Throws if a non-FORM token or a color literal is present
81
+ * スキン id
82
+ *
83
+ * 皮肤 id
84
+ * @param delta - 검사할 토큰 델타
85
+ *
86
+ * Token delta to validate
87
+ *
88
+ * 検査するトークンデルタ
89
+ *
90
+ * 待检查的令牌增量
91
+ * @throws FORM 토큰이 아니거나 색 리터럴이 있으면 Error
92
+ *
93
+ * Throws if a non-FORM token or a color literal is present
94
+ *
95
+ * FORM トークンでないか、色リテラルがある場合は Error
96
+ *
97
+ * 存在非 FORM 令牌或颜色字面量时抛出 Error
98
+ * @example
99
+ * skinRegistry.define('my-skin', { '--og-radius-md': '#fff' }); // throws — color literal detected
20
100
  */
21
101
  export declare function assertFormOnly(id: string, delta: SkinTokenDelta): void;
22
102
  /**
23
- * 접근성 가드레일(불변식) 적용 — 정의 시점 클램프(§6.4).
24
- * / Apply accessibility guardrails (invariants) — clamp at definition time (§6.4).
103
+ * 접근성 가드레일(불변식)을 적용해 델타를 정의 시점에 안전값으로 클램프한다. `define()`/
104
+ * `registerBuiltin()` 내부에서 자동 호출되므로 보통 직접 부를 일은 없다(커스텀 등록 파이프라인·
105
+ * 테스트에서 직접 검증할 때만 예외적으로 사용). 스킨 저자가 접근성 최소 기준 이하로 값을
106
+ * 설정해도 조용히 그대로 등록되지 않도록 막는다.
107
+ * - focus-width < 2px → 2px 로 클램프(가시 포커스 비협상).
108
+ * - focus-style: none → solid.
109
+ * 반환은 조정된 델타 + 경고 목록(silent override 아님 — 무엇을 클램프했는지 알린다).
25
110
  *
26
- * - focus-width < 2px → 2px 로 클램프(가시 포커스 비협상). / clamp to 2px (visible focus is non-negotiable).
111
+ * Applies accessibility guardrails (invariants), clamping the delta to a safe value at
112
+ * definition time. Called automatically inside `define()`/`registerBuiltin()`, so you rarely
113
+ * call it directly (only in a custom registration pipeline or a test that checks it directly).
114
+ * Prevents a skin author from silently registering values below the minimum accessibility bar.
115
+ * - focus-width < 2px → clamped to 2px (visible focus is non-negotiable).
27
116
  * - focus-style: none → solid.
117
+ * Returns the adjusted delta plus a warning list (not a silent override — it reports what was
118
+ * clamped).
28
119
  *
29
- * 반환은 조정된 델타 + 경고 목록(silent override 아님 — 무엇을 클램프했는지 알린다).
30
- * / Returns the adjusted delta plus a warning list (not a silent override — it reports what was clamped).
120
+ * アクセシビリティガードレール(不変条件)を適用し、デルタを定義の時点で安全値へクランプします。
121
+ * `define()`/`registerBuiltin()` の内部で自動的に呼ばれるので、通常は直接呼ぶことはありません
122
+ * (カスタム登録パイプラインやテストで直接検証するときだけ例外的に使います)。スキン作者が
123
+ * アクセシビリティの最低基準を下回る値を設定しても、黙ってそのまま登録されないように防ぎます。
124
+ * - focus-width < 2px → 2px にクランプ(可視フォーカスは非交渉)。
125
+ * - focus-style: none → solid。
126
+ * 戻り値は調整されたデルタ + 警告リスト(silent override ではなく、何をクランプしたかを知らせます)。
127
+ *
128
+ * 应用无障碍防护栏(不变式),在定义的时点把增量钳制到安全值。`define()`/`registerBuiltin()`
129
+ * 内部会自动调用,所以很少需要直接调用(只有在自定义注册流水线或直接验证它的测试中才例外使用)。
130
+ * 它防止皮肤作者把值设到无障碍最低标准以下后仍被静默注册。
131
+ * - focus-width < 2px → 钳制为 2px(可见焦点不可协商)。
132
+ * - focus-style: none → solid。
133
+ * 返回调整后的增量加警告列表(并非 silent override — 会告知钳制了什么)。
134
+ *
135
+ * @param id - 스킨 id
136
+ *
137
+ * Skin id
138
+ *
139
+ * スキン id
140
+ *
141
+ * 皮肤 id
142
+ * @param delta - 조정할 토큰 델타
31
143
  *
32
- * @param id - 스킨 id / Skin id
33
- * @param delta - 조정할 토큰 델타 / Token delta to adjust
34
- * @returns 조정된 델타 + 경고 목록 / Adjusted delta plus warnings
144
+ * Token delta to adjust
145
+ *
146
+ * 調整するトークンデルタ
147
+ *
148
+ * 待调整的令牌增量
149
+ * @returns 조정된 델타 + 경고 목록
150
+ *
151
+ * Adjusted delta plus warnings
152
+ *
153
+ * 調整されたデルタ + 警告リスト
154
+ *
155
+ * 调整后的增量加警告列表
35
156
  */
36
157
  export declare function applyGuardrails(id: string, delta: SkinTokenDelta): SkinDefineResult;
37
158
  /**
38
- * 프로세스 전역 스킨 등록소. defineSkin(사용자) 는 검증+가드레일+`<style>` 주입,
39
- * registerBuiltin(내장) 은 검증+가드레일만(CSS 는 skins.css 정적 번들 소유).
40
- * / Process-global skin registry. `define` (user) does validation + guardrails + `<style>` injection;
41
- * `registerBuiltin` (built-in) does validation + guardrails only (CSS is owned by the skins.css static bundle).
159
+ * 스킨(FORM 축 — 모서리·테두리·그림자·밀도 등 "생김새")을 등록하는 전역 레지스트리. 등록하면
160
+ * 내부에서 벌어지는 일: `define()` 은 색 리터럴이 없는지 검사 → 접근성 가드레일 클램프 →
161
+ * `.og-container[data-og-skin="id"] { ... }` 규칙을 담은 `<style>` 태그를 문서 head 에 주입한다.
162
+ * 그리드 쪽에서 `data-og-skin="id"` 속성만 설정하면 이 CSS 가 매치되어 적용된다. 내장 스킨은
163
+ * `registerBuiltin()` 으로 검증+가드레일만 거치고 실제 CSS 는 정적 번들 skins.css 가 이미
164
+ * 담당하므로 별도 주입이 없다.
165
+ *
166
+ * A global registry for registering skins (the FORM axis — corner/border/shadow/density, i.e.
167
+ * "shape"). What happens internally when you register: `define()` checks for no color literals
168
+ * → clamps via accessibility guardrails → injects a `<style>` tag into document head containing
169
+ * a `.og-container[data-og-skin="id"] { ... }` rule. The grid side only needs to set the
170
+ * `data-og-skin="id"` attribute for this CSS to match and apply. Built-in skins go through
171
+ * `registerBuiltin()` for validation + guardrails only — their CSS is already owned by the
172
+ * static skins.css bundle, so no injection happens.
173
+ *
174
+ * スキン(FORM 軸 — 角・境界線・影・密度などの「見た目」)を登録するグローバルレジストリです。
175
+ * 登録すると内部で起きること: `define()` は色リテラルがないかを検査 → アクセシビリティ
176
+ * ガードレールでクランプ → `.og-container[data-og-skin="id"] { ... }` ルールを収めた `<style>`
177
+ * タグをドキュメントの head に注入します。グリッド側で `data-og-skin="id"` 属性を設定するだけで、
178
+ * この CSS がマッチして適用されます。内蔵スキンは `registerBuiltin()` で検証 + ガードレールだけを
179
+ * 通り、実際の CSS は静的バンドルの skins.css がすでに担当するので、別途の注入はありません。
180
+ *
181
+ * 注册皮肤(FORM 轴 — 圆角、边框、阴影、密度等"外观")的全局注册表。注册时内部发生的事:
182
+ * `define()` 先检查有无颜色字面量 → 用无障碍防护栏钳制 → 把含 `.og-container[data-og-skin="id"]
183
+ * { ... }` 规则的 `<style>` 标签注入文档 head。表格一侧只需设置 `data-og-skin="id"` 属性,这段 CSS
184
+ * 就会匹配并生效。内置皮肤经 `registerBuiltin()` 只走检查 + 防护栏,实际 CSS 已由静态包 skins.css
185
+ * 负责,因此不做注入。
42
186
  *
43
187
  * @example
44
188
  * skinRegistry.define('my-skin', { '--og-radius-md': '10px', '--og-border-style': 'solid' });
@@ -48,46 +192,200 @@ export declare class SkinRegistry {
48
192
  private _styleEl;
49
193
  /**
50
194
  * 내장 스킨 등록(주입 없음 — CSS 는 skins.css 가 전달). 검증/가드레일은 동일 적용.
51
- * / Register a built-in skin (no injection — CSS is delivered by skins.css). Validation/guardrails still apply.
52
195
  *
53
- * @param id - 스킨 id / Skin id
54
- * @param delta - FORM 토큰 델타 / FORM token delta
196
+ * Register a built-in skin (no injection — CSS is delivered by skins.css). Validation/guardrails still apply.
197
+ *
198
+ * 内蔵スキンの登録(注入なし — CSS は skins.css が届けます)。検証/ガードレールは同じく適用します。
199
+ *
200
+ * 注册内置皮肤(不注入 — CSS 由 skins.css 交付)。检查/防护栏照常适用。
201
+ *
202
+ * @param id - 스킨 id
203
+ *
204
+ * Skin id
205
+ *
206
+ * スキン id
207
+ *
208
+ * 皮肤 id
209
+ * @param delta - FORM 토큰 델타
210
+ *
211
+ * FORM token delta
212
+ *
213
+ * FORM トークンデルタ
214
+ *
215
+ * FORM 令牌增量
55
216
  */
56
217
  registerBuiltin(id: string, delta: SkinTokenDelta): void;
57
218
  /**
58
219
  * 사용자 스킨 등록. FORM-only 검증 + 가드레일 클램프 후 런타임 `<style>` 로
59
220
  * `.og-container[data-og-skin="id"]` 블록을 주입(브라우저 환경). 반환은 조정 결과.
60
- * / Register a user skin. After FORM-only validation and guardrail clamps, injects a
221
+ *
222
+ * Register a user skin. After FORM-only validation and guardrail clamps, injects a
61
223
  * `.og-container[data-og-skin="id"]` block via a runtime `<style>` (browser env). Returns the adjusted result.
62
224
  *
63
- * @param id - 스킨 id / Skin id
64
- * @param delta - FORM 토큰 델타 / FORM token delta
65
- * @returns 조정된 델타 + 경고 목록 / Adjusted delta plus warnings
225
+ * ユーザースキンの登録。FORM-only 検証 + ガードレールのクランプのあと、ランタイムの `<style>` で
226
+ * `.og-container[data-og-skin="id"]` ブロックを注入します(ブラウザ環境)。戻り値は調整の結果です。
227
+ *
228
+ * 注册用户皮肤。经 FORM-only 检查 + 防护栏钳制后,用运行时 `<style>` 注入
229
+ * `.og-container[data-og-skin="id"]` 块(浏览器环境)。返回调整的结果。
230
+ *
231
+ * @param id - 스킨 id
232
+ *
233
+ * Skin id
234
+ *
235
+ * スキン id
236
+ *
237
+ * 皮肤 id
238
+ * @param delta - FORM 토큰 델타
239
+ *
240
+ * FORM token delta
241
+ *
242
+ * FORM トークンデルタ
243
+ *
244
+ * FORM 令牌增量
245
+ * @returns 조정된 델타 + 경고 목록
246
+ *
247
+ * Adjusted delta plus warnings
248
+ *
249
+ * 調整されたデルタ + 警告リスト
250
+ *
251
+ * 调整后的增量加警告列表
66
252
  */
67
253
  define(id: string, delta: SkinTokenDelta): SkinDefineResult;
68
- /** 스킨 id 등록 여부. / Whether a skin id is registered. */
254
+ /**
255
+ * 스킨 id 등록 여부.
256
+ *
257
+ * Whether a skin id is registered.
258
+ *
259
+ * スキン id が登録されているかどうか。
260
+ *
261
+ * 皮肤 id 是否已注册。
262
+ */
69
263
  has(id: string): boolean;
70
- /** 등록된 스킨 델타 조회(없으면 undefined). / Get a registered skin delta (undefined if absent). */
264
+ /**
265
+ * 등록된 스킨 델타 조회(없으면 undefined).
266
+ *
267
+ * Get a registered skin delta (undefined if absent).
268
+ *
269
+ * 登録されたスキンデルタの取得(なければ undefined)。
270
+ *
271
+ * 获取已注册的皮肤增量(不存在则为 undefined)。
272
+ */
71
273
  get(id: string): SkinTokenDelta | undefined;
72
- /** 등록된 모든 스킨 id(내장 + 사용자). / All registered skin ids (built-in + user). */
274
+ /**
275
+ * 등록된 모든 스킨 id(내장 + 사용자).
276
+ *
277
+ * All registered skin ids (built-in + user).
278
+ *
279
+ * 登録されたすべてのスキン id(内蔵 + ユーザー)。
280
+ *
281
+ * 已注册的全部皮肤 id(内置 + 用户)。
282
+ */
73
283
  list(): string[];
74
- /** 런타임 `<style>` 주입(테스트/SSR 등 document 없으면 no-op). 같은 태그를 누적 사용. */
284
+ /**
285
+ * 런타임 `<style>` 주입(테스트/SSR 등 document 없으면 no-op). 같은 태그를 누적 사용.
286
+ *
287
+ * ランタイムの `<style>` 注入(テスト/SSR など document がなければ no-op)。同じタグを累積して使います。
288
+ *
289
+ * 运行时 `<style>` 注入(测试/SSR 等无 document 时为 no-op)。累积使用同一个标签。
290
+ */
75
291
  private _inject;
76
292
  }
77
- /** Sharp/Gothic — 엔터프라이즈 고밀도·각짐(§3.1). / Sharp/Gothic — enterprise high-density, squared corners (§3.1). */
293
+ /**
294
+ * Sharp/Gothic — 엔터프라이즈 고밀도 화면에 맞춘 각진(라운드 0) 형태. 데이터 밀도가 중요한
295
+ * 백오피스·트레이딩 화면에 어울린다.
296
+ *
297
+ * Sharp/Gothic — squared (zero-radius) shape tuned for high-density enterprise screens; suits
298
+ * back-office/trading UIs where data density matters.
299
+ *
300
+ * Sharp/Gothic — エンタープライズの高密度画面に合わせた角張った(ラウンド 0)形状。データ密度が
301
+ * 重要なバックオフィス・トレーディング画面に向いています。
302
+ *
303
+ * Sharp/Gothic — 为企业级高密度画面而生的方正(圆角为 0)形状。适合数据密度至关重要的
304
+ * 后台管理、交易画面。
305
+ */
78
306
  export declare const SKIN_SHARP: SkinTokenDelta;
79
- /** Rounded — 소비자 SaaS 소프트(§3.2). / Rounded — consumer-SaaS soft look (§3.2). */
307
+ /**
308
+ * Rounded — 소비자 SaaS 에 어울리는 부드러운(둥근 모서리·큰 그림자) 형태.
309
+ *
310
+ * Rounded — soft shape (rounded corners, larger shadows) suited to consumer-SaaS products.
311
+ *
312
+ * Rounded — コンシューマー SaaS に向いた柔らかい(丸い角・大きな影)形状。
313
+ *
314
+ * Rounded — 适合消费级 SaaS 的柔和(圆角、大阴影)形状。
315
+ */
80
316
  export declare const SKIN_ROUNDED: SkinTokenDelta;
81
- /** Stitch — 핸드크래프트(§3.3). 색(리넨/자수)은 theme 축. / Stitch — handcrafted look (§3.3); color (linen/embroidery) lives on the theme axis. */
317
+ /**
318
+ * Stitch — 손바느질/리넨 소재 느낌을 주는 형태(점선 테두리·텍스처). 리넨 색·자수 색 자체는
319
+ * 이 스킨이 아니라 theme(색) 축이 담당한다(색⊥형태 분리).
320
+ *
321
+ * Stitch — a handcrafted, linen-textured shape (dashed borders, texture). The linen/embroidery
322
+ * color itself belongs to the theme (color) axis, not this skin (color⊥shape separation).
323
+ *
324
+ * Stitch — 手縫い/リネン素材の質感を与える形状(破線の境界線・テクスチャ)。リネンの色・刺繍の色
325
+ * 自体は、このスキンではなく theme(色)軸が担当します(色⊥形状の分離)。
326
+ *
327
+ * Stitch — 呈现手工缝制/亚麻材质感的形状(虚线边框、纹理)。亚麻色、刺绣色本身不由该皮肤负责,
328
+ * 而由 theme(颜色)轴负责(色⊥形的分离)。
329
+ */
82
330
  export declare const SKIN_STITCH: SkinTokenDelta;
83
- /** Flat/Minimal — 플랫 2.0(§3.5). / Flat/Minimal — flat 2.0 (§3.5). */
331
+ /**
332
+ * Flat/Minimal — 그림자·입체감을 없앤 평평한(flat 2.0) 형태. 미니멀한 대시보드에 어울린다.
333
+ *
334
+ * Flat/Minimal — a flat (flat 2.0) shape with shadows/depth removed; suits minimal dashboards.
335
+ *
336
+ * Flat/Minimal — 影・立体感をなくした平らな(flat 2.0)形状。ミニマルなダッシュボードに向いています。
337
+ *
338
+ * Flat/Minimal — 去掉阴影与立体感的扁平(flat 2.0)形状。适合极简风的仪表盘。
339
+ */
84
340
  export declare const SKIN_FLAT: SkinTokenDelta;
85
- /** High-Contrast — 접근성 우선·레퍼런스(§3.6). / High-Contrast — accessibility-first reference skin (§3.6). */
341
+ /**
342
+ * High-Contrast — 접근성을 최우선에 둔 레퍼런스 스킨(굵은 테두리·큰 포커스 링·굵은 아이콘 획).
343
+ * 다른 스킨을 만들 때 "접근성 하한선이 뭔가"를 확인하는 기준으로도 쓸 수 있다.
344
+ *
345
+ * High-Contrast — a reference skin that puts accessibility first (thick borders, a large focus
346
+ * ring, bold icon strokes). Also useful as a baseline for "what's the accessibility floor" when
347
+ * authoring other skins.
348
+ *
349
+ * High-Contrast — アクセシビリティを最優先に置いたリファレンススキン(太い境界線・大きな
350
+ * フォーカスリング・太いアイコンの線)。他のスキンを作るとき「アクセシビリティの下限は何か」を
351
+ * 確認する基準としても使えます。
352
+ *
353
+ * High-Contrast — 把无障碍放在首位的参考皮肤(粗边框、大焦点环、粗图标笔画)。制作其他皮肤时,
354
+ * 也可以拿它作为确认"无障碍下限是什么"的基准。
355
+ */
86
356
  export declare const SKIN_HIGH_CONTRAST: SkinTokenDelta;
87
- /** Material/Elevated — 중간 반경 + 정직한 그림자 엘리베이션. / Material/Elevated — medium radius plus honest shadow elevation. */
357
+ /**
358
+ * Material/Elevated — 중간 정도 반경 + 과장 없는 그림자 엘리베이션을 쓰는 형태.
359
+ *
360
+ * Material/Elevated — a shape using medium-radius corners plus restrained (non-exaggerated)
361
+ * shadow elevation.
362
+ *
363
+ * Material/Elevated — 中程度の半径 + 誇張のない影のエレベーションを使う形状。
364
+ *
365
+ * Material/Elevated — 使用中等半径圆角加不夸张的阴影抬升的形状。
366
+ */
88
367
  export declare const SKIN_MATERIAL: SkinTokenDelta;
89
- /** 내장 스킨 카탈로그(확정 6종). id → 델타. / Built-in skin catalog (6 finalized skins). id → delta. */
368
+ /**
369
+ * 내장 스킨 카탈로그(확정 6종, id → 델타). `skinRegistry.list()`/설정 UI 에서 선택지를 보여줄 때
370
+ * 이 배열을 순회하면 된다.
371
+ *
372
+ * Built-in skin catalog (6 finalized skins, id → delta). Iterate this array when building a
373
+ * picker UI or listing options via `skinRegistry.list()`.
374
+ *
375
+ * 内蔵スキンのカタログ(確定 6 種、id → デルタ)。`skinRegistry.list()`/設定 UI で選択肢を見せる
376
+ * ときは、この配列を走査します。
377
+ *
378
+ * 内置皮肤目录(确定的 6 种,id → 增量)。在 `skinRegistry.list()`/设置 UI 中展示选项时,
379
+ * 遍历这个数组即可。
380
+ */
90
381
  export declare const BUILTIN_SKINS: ReadonlyArray<readonly [string, SkinTokenDelta]>;
91
- /** 프로세스 전역 기본 레지스트리 — 내장 스킨을 부트스트랩 등록(주입 없음, CSS=skins.css).
92
- * / Process-global default registry — bootstraps the built-in skins (no injection; CSS=skins.css). */
382
+ /**
383
+ * 프로세스 전역 기본 레지스트리 — 내장 스킨을 부트스트랩 등록(주입 없음, CSS=skins.css).
384
+ *
385
+ * Process-global default registry — bootstraps the built-in skins (no injection; CSS=skins.css).
386
+ *
387
+ * プロセスグローバルの既定レジストリ — 内蔵スキンをブートストラップ登録(注入なし、CSS=skins.css)。
388
+ *
389
+ * 进程全局的默认注册表 — 引导注册内置皮肤(不注入,CSS=skins.css)。
390
+ */
93
391
  export declare const skinRegistry: SkinRegistry;