Class HeaderAxis

HeaderAxis — 헤더 제6축. 상속으로 SPI 를, 합성으로 등록 정책을 얻는다.

  IAppearanceAxis  (5축 공통 SPI)
        ▲ implements
    TokenAxis      (기존 — 한 글자도 안 고쳤다)
        ▲ extends           ← ① 축 불변식은 상속으로. 형제 축과 리스코프 치환 가능
    HeaderAxis
        │ has-a             ← ② 등록 정책은 합성으로. is-a 가 아니다
        ▼
  TypedRegistry<HeaderPresetMeta>   (v1.4.0 공개 확장점)
Copy

왜 extends TokenAxis 인가(상속을 쓰는 자리). assertNamespace · resolve 의 never-throw 폴백 · default → 빈 델타(byte-identical) · attr 생략 규칙 — 이 넷은 여섯 축이 똑같아야 하는 불변식이다. 베끼면 여섯 벌이 갈라진다. 상속이 정확한 도구다.

왜 TypedRegistry 를 상속하지 않고 안에 두는가(합성을 쓰는 자리). TypedRegistry<V> 는 키→값 저장소고 HeaderAxis 는 축이다. is-a 가 아니다. 그리고 TokenAxis 를 고쳐 저장소를 갈아끼우면 기존 5축의 코드 경로가 바뀐다 — 「기본값 불변」 금지선에 직접 닿는다. 합성이면 헤더 축만 새 정책을 갖고 나머지 다섯은 한 바이트도 안 변한다(개방-폐쇄 원칙).

이 축이 형제 축보다 더 갖는 것 — 기존 축들은 생 Map 이라 아래가 전부 없다: 내장 보호(protect-builtin) · 출처(origin) · 플러그인 수명(disposePlugin) · SPI 버전 검증 · og:* 예약 대역 보호 · never-throw 등록 결과. 그래서 이 축에서는 사용자가 define('rule', …) 해도 내장 프리셋이 조용히 사라지지 않는다.

HeaderAxis — the 6th (header) axis: SPI conformance by inheritance, registration policy by composition. TokenAxis supplies the six-axis invariants; a composed TypedRegistry supplies built-in protection, origin tracking, plugin lifecycle and SPI checks that the sibling axes lack. Composition (not inheritance) is used because a registry is not a kind of axis, and because swapping TokenAxis's store would change the code path of the five existing axes.

HeaderAxis — ヘッダー第6軸。SPI は継承で、登録ポリシーはコンポジションで得ます。

なぜ extends TokenAxis なのか(継承を使う場所)。 assertNamespace・resolve の never-throw フォールバック・default → 空デルタ(byte-identical)・attr の省略規則 — この4つは6つの軸が 同じでなければならない不変条件です。写し取れば6つに分かれてしまいます。ここは継承が正確な道具です。

なぜ TypedRegistry を継承せず中に持つのか(コンポジションを使う場所)。 TypedRegistry<V> は キー→値の保管庫で、HeaderAxis は軸です。is-a ではありません。そして TokenAxis を直して 保管庫を差し替えると、既存5軸のコード経路が変わります — 「既定値は変えない」という禁止線に直接 触れます。コンポジションならヘッダー軸だけが新しいポリシーを持ち、残りの5軸は1バイトも変わりません (開放閉鎖の原則)。

この軸が兄弟軸より多く持つもの — 既存の軸は素の Map なので、以下がすべてありません: 組み込み保護(protect-builtin)・登録元(origin)・プラグインの寿命管理(disposePlugin)・ SPI バージョン検証・og:* 予約領域の保護・never-throw の登録結果。 そのためこの軸では、利用者が define('rule', …) しても組み込みプリセットが黙って消えることは ありません。

HeaderAxis — 表头第6轴。用继承拿到 SPI，用组合拿到注册策略。

为什么 extends TokenAxis(用继承的地方)。 assertNamespace、resolve 的 never-throw 回退、 default → 空增量(byte-identical)、attr 的省略规则 — 这4条是6个轴必须一致的不变式。抄一遍 就会分成6份。这里继承才是准确的工具。

为什么不继承 TypedRegistry 而是放在里面(用组合的地方)。 TypedRegistry<V> 是键→值的存储， 而 HeaderAxis 是轴。不是 is-a。而且改 TokenAxis 去换掉存储，现有5个轴的代码路径就会变 — 直接碰到「默认值不变」这条禁止线。用组合的话，只有表头轴拿到新策略，其余5个轴一个字节也不变 (开闭原则)。

这个轴比兄弟轴多出来的东西 — 现有的轴是裸 Map，所以下面这些一个都没有: 内置保护(protect-builtin)、注册来源(origin)、插件生命周期(disposePlugin)、SPI 版本校验、 og:* 保留区段的保护、never-throw 的注册结果。 因此在这个轴上，即使用户调用 define('rule', …)，内置预设也不会静默消失。