@iyulab/enterprise 0.15.0 → 0.16.0

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## [0.16.0] - 2026-09-22
+
+### Documentation
+
+- 🔴 **`styles/preset.css` now says why its documented usage used to do nothing.** The header's
+  third clause said layer order is decided by load order and is therefore already under the
+  consumer's control. It was not: the defaults layer is injected at runtime by
+  `@iyulab/components`' `Theme.init()`, so until that package's **1.44.0** it landed *after* a
+  statically imported sheet and won. The one-line `import` this file documents had **no effect at
+  all**, silently — and because the two sheets agree on `body`/`label`/`caption`/`overline` and
+  differ only on the upper type steps and the radii, it still looked applied. The clause now
+  states that, names the version where the documented usage starts working, and says what to do
+  on an older one.
+- **`docs/lob-layers.md` carried the same third clause, and the same false statement with it.**
+  A rule that lives in two published documents goes stale in two places; that one now names the
+  premise this package cannot hold on its own -- load order is decided by whoever injects the
+  defaults layer -- and says which version makes the documented arrangement true.
+- **The header also called the `@iyulab/components` peer optional. It is not** — this package's
+  runtime code imports `Locale`, `format` and `icons` from it, so it is required whether or not
+  you load the preset. The prose was the wrong half of that mismatch and has been corrected.
+
+### Changed
+
+- 🔴 **The `@iyulab/components` peer range is now `>=1.44.0`** (was `>=1.27.0`). Every version
+  below that places the defaults layer last, which is exactly the arrangement in which this
+  package's documented preset usage is silently void. A range that admits those versions lets a
+  consumer install a combination where the preset does nothing and nothing says so — declaring
+  the floor is what turns that from a silent failure into an install-time answer.
+
+⚠ **This is the only reason for the minor.** No API changed.
+
 ## [0.15.0] - 2026-09-22
 
 ### Fixed

package/dist/styles/preset.css

@@ -7,9 +7,11 @@
  * ⚠**`@iyulab/components` 1.21.0 이상이 필요하다.** 이 파일은 값만 정하고, 그 값을 **읽는
  *   쪽은 컴포넌트**다. 1.20.0 이하에는 타입 스케일·반경 상단 축이 아예 없어서 여기 적은
  *   `--u-text-*` 는 **아무도 읽지 않는다** — 에러 없이 절반만 적용된 것처럼 보인다.
- *   `peerDependencies` 에 선언해 두었으나 **optional** 이다(프리셋을 쓰지 않는 소비자는
- *   `components` 자체가 필요 없다). 즉 버전 불일치는 **경고 없이 조용하다** — 프리셋을
- *   로드했는데 글자 크기가 안 바뀌면 먼저 이 버전을 본다.
+ *   ⚠**이 peer 는 optional 이 아니다**(종전 판이 그렇게 적고 있었으나 사실이 아니었다 —
+ *   이 패키지의 **런타임 코드가** `@iyulab/components/dist/utilities/` 의 `Locale`·`format`·`icons`
+ *   를 import 한다). 프리셋을 쓰지 않는 소비자에게도 필요하다.
+ *   ⇒ 버전 불일치는 npm 이 설치 단계에서 말해 준다. 프리셋을 로드했는데 글자 크기가 안 바뀌면
+ *   먼저 이 버전을, 그다음 아래 ⑶의 **로드 순서**를 본다.
  *
  * `@iyulab/components` 가 여는 **토큰 축**에 이유랩의 값을 채운 한 장이다.
  * 축(이름·단 수)은 `components` 소유이고, 이 파일은 **값만** 정한다.
@@ -24,10 +26,25 @@
  *      소비자가 그 선택자와 특이도 싸움을 하게 되고, 그때부터 이 파일은 프리셋이 아니라
  *      또 하나의 프레임워크가 된다. (`tests/preset-contract.test.ts` 가 지킨다.)
  *   ⑶ 🔴**층은 «로드 순서»로 선다.** 세 층이 전부 `:root`(0,1,0)이므로 나중에 로드된
- *      것이 이긴다 — 소비자가 이미 통제하는 축이다.
+ *      것이 이긴다.
  *
  *        기본값(components/styles/light.css)  →  하우스(이 파일)  →  소비자 브랜드
  *
+ *      ⚠**그런데 「기본값」 층은 «런타임에» 붙는다 — `@iyulab/components` 1.43.x 이하에서는
+ *        위 그림이 성립하지 않았다.** `Theme.init()` 이 내장 시트를 `document.head` **끝**에
+ *        `appendChild` 했고, 정적 `import` 로 올라온 이 파일은 번들러가 **파싱 시점에** 넣으므로
+ *        ***언제나 기본값이 이겼다.*** 즉 머리말이 안내한 `import` 한 줄이 **아무 효과가 없었다.**
+ *      ★**1.44.0 부터 `Theme.init()` 이 내장 시트를 «첫 스타일 앞»에 넣는다** — 기본값 층은
+ *        이름 그대로 가장 낮은 층이므로 위치도 바닥이다. ⇒ **그 판부터 `import` 한 줄이 문서대로
+ *        동작한다**(`peerDependencies` 가 그 하한을 선언한다).
+ *      ⚠**1.43.x 이하를 쓰는 소비자가 지금 할 일**: 이 파일을 `?inline` 등으로 문자열로 받아
+ *        `await Theme.init(...)` **뒤에** 직접 `<style>` 로 붙인다. 그 우회는 components 를
+ *        1.44.0 이상으로 올리는 즉시 `import` 한 줄로 줄일 수 있다.
+ *      🔴**이 실패는 조용하다 — 그것이 이 문단이 길어진 이유다.** 오류도 경고도 없고, 두 시트의
+ *        값이 일부만 다르면(실측: 상위 세 단과 반경만 다르고 body·label·caption·overline 은 동일)
+ *        **한 군데도 적용되지 않았는데 적용된 것처럼 보인다.** 프리셋을 로드했는데 글자 크기가
+ *        안 바뀌면 **버전 다음으로 이 순서를 본다.**
+ *
  *      ⚠**종전 판(0.7.0)은 이 자리를 `:where()` 로 감싸 특이도 0 으로 만들었고,
  *        그래서 «한 줄도 적용되지 않았다».** 의도는 옳았다 — *"프리셋이 소비자 브랜드를
  *        덮으면 안 된다"*. 그러나 특이도 0 은 **이겨야 할 상대(기본값)와 지지 말아야 할

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/enterprise",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Enterprise utilities and components for iyulab framework",
   "keywords": [
     "enterprise",
@@ -66,6 +66,6 @@
   },
   "peerDependencies": {
     "react": ">=18",
-    "@iyulab/components": ">=1.27.0"
+    "@iyulab/components": ">=1.44.0"
   }
 }