프리셋 id
Preset id
プリセット id
预设 id
헤더 형태 토큰 델타
Header shape-token delta
ヘッダー形状トークンのデルタ
表头形状令牌增量
Optionalopts: RegisterOptions & { meta?: HeaderPresetMeta }등록 정책 옵션(override·pluginId·priority) + 프리셋 메타
Registration policy options plus preset metadata
登録ポリシーのオプション(override・pluginId・priority)+ プリセットのメタ情報
注册策略选项(override、pluginId、priority)+ 预设元信息
클램프 반영된 델타 + 경고 + 등록 판정
The clamped delta, warnings, and the registration verdict
クランプを反映したデルタ + 警告 + 登録の判定
钳制后的增量 + 警告 + 注册判定
defineHeader('hairline', { '--og-header-rule-width': '1px', '--og-header-hint-opacity': '0.3' });
// 내장 보호 — 덮으려면 명시해야 한다
defineHeader('rule', d).registration.ok; // false (kept)
defineHeader('rule', d, { override: true }).registration.ok; // true (replaced)
// 플러그인이 넣은 것만 골라 해제 — 등록의 대칭
defineHeader('mine', d, { pluginId: 'acme' });
headerRegistry.disposePlugin('acme'); // 1
사용자 정의 프리셋 등록.
색·타이포그래피·밀도·질감 토큰이 섞여 있으면 등록 게이트가 즉시 throw 한다(축 섞임 금지). 특히
--og-header-bg처럼 접두사가 같아 헤더 것처럼 보이는 색 토큰도 거부한다 — 그것은 테마 축 소유다. 불투명도는 0~1 로, 음수 길이는 0 으로 클램프하고 경고한다.Register a user-defined preset.
The registration gate throws on color/typography/density/texture tokens — including
--og-header-*color tokens, which merely share the prefix but belong to the theme axis.내장 5종은 조용히 안 덮인다.
{ override: true }없이'rule'을 다시 등록하면 거부되고 사유가registration으로 돌아온다(throw 하지 않는다). 형제 축(밀도·질감·타이포)에는 이 보호가 없어 내장값이 소리 없이 사라진다 — 헤더 축이 처음으로 갖는 안전장치다.Built-ins are protected: re-registering
'rule'without{ override: true }is rejected and the reason comes back inregistration— it never throws. The sibling axes lack this protection.ユーザー定義プリセットの登録。
色・タイポグラフィ・密度・質感のトークンが混ざっていると、登録ゲートが即座に throw します (軸の混在は禁止)。とくに
--og-header-bgのように接頭辞が同じでヘッダーのものに見える色トークンも 拒否します — それはテーマ軸の所有です。不透明度は 0~1 に、負の長さは 0 にクランプして警告します。組み込み5種は黙って上書きされません。
{ override: true }なしで'rule'を再登録すると拒否され、 理由がregistrationで返ります(throw はしません)。兄弟軸(密度・質感・タイポグラフィ)にはこの保護が なく、組み込みの値が音もなく消えます — ヘッダー軸が初めて持つ安全装置です。注册用户自定义预设。
混进颜色、排版、密度、质感的令牌时，注册关卡立即 throw(禁止轴混用)。尤其是像
--og-header-bg这种前缀相同、看着像表头的颜色令牌也会被拒绝 — 那归主题轴所有。不透明度钳制到 0~1，负长度 钳制到 0，并给出警告。内置5种不会被静默覆盖。 不带
{ override: true }重新注册'rule'会被拒绝，理由通过registration返回(不 throw)。兄弟轴(密度、质感、排版)没有这道保护，内置值会无声消失 — 这是 表头轴第一次拥有的安全装置。