@iyulab/data-components 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [0.17.0] - 2026-08-17
+
+### Added
+
+- **`u-simple-sheet` gained a `--dc-sheet-height` custom property**, defaulting to `400px` — the
+  value the host was previously hardcoded to. Every other size axis on this component (row height,
+  cell padding, font size) was already a consumer-adjustable custom property; the host's own height
+  was the one dimension left as a literal, so a consumer embedding the sheet in a constrained layout
+  (a form, a panel with a fixed footer) had no supported way to make it shorter or taller — only an
+  external `height` override that fought the component's own `:host` rule on specificity. Unset,
+  rendering is byte-identical to before. Like the other five tokens on this component, it does not
+  derive from a role-layer token and is set with an element selector (`u-simple-sheet { … }`) rather
+  than `:root`.
+
+  This token sets an upper bound, not a natural height: `rows` governs the grid's minimum row
+  *capacity*, not how many rows are visible, so lowering `--dc-sheet-height` does not shrink the
+  number of rows rendered — it constrains the box and leaves the existing `overflow-y: auto` to
+  reach the rest.
+
 ## [0.16.0] - 2026-08-16
 
 ### Added

package/README.md

@@ -221,6 +221,12 @@ u-rich-table { --dc-icon-color: #B0B0B0; }
 | `--dc-font-size` | `13px`(`var(--u-density, 13px)`) | 본문 셀 · 편집 입력 · 드롭다운 항목 |
 | `--dc-header-font-size` | `12px` | 열 머리 — `--u-density` 와 무관(본문과 독립) |
 | `--dc-header-font-weight` | `600` | 〃 |
+| `--dc-sheet-height` | `400px` | `:host` 전체 높이 (0.17.0~) |
+
+⚠**`--dc-sheet-height` 는 "자연 높이로 준다"가 아니라 "상한을 정한다"입니다.** `rows` 는
+표시 개수가 아니라 데이터 격자의 **최소 용량**이라, 이 값을 낮춰도 `rows` 만큼의 빈 행이
+줄지는 않습니다 — 그 안에서 내장 `overflow-y: auto` 로 스크롤해 접근하십시오. 콘텐츠
+분량에 맞춰 자동으로 줄어드는 옵트인은 별도 스코프입니다.
 
 ⚠**`--dc-font-size` 만 예외입니다 — `@iyulab/components`/`@iyulab/flex-table` 의 밀도
 스위치(`--u-density`)를 폴백 원본으로 갖습니다**(0.15.0~). 조상에 `--u-density` 를 걸면
@@ -245,11 +251,11 @@ u-simple-sheet {
 `30.5px` 를 선언하십시오. (같은 이유로 **빈 행은 데이터 행보다 1.5px 낮습니다** —
 `0.11.0` 이전부터 그랬고, 교정하면 기본 렌더가 바뀌므로 이 릴리스에서는 두었습니다.)
 
-⚠**`0.11.0` 도 조절점만 엽니다** — 선언하지 않으면 종전과 같은 값으로 그려집니다.
+⚠**조절점만 엽니다** — 선언하지 않으면 종전과 같은 값으로 그려집니다.
 `--dc-row-height`·`--dc-cell-padding-block`·`--dc-cell-padding-inline`·
-`--dc-header-font-size`·`--dc-header-font-weight` 다섯은 `u-simple-sheet` 전용입니다
-(`u-data-view`·`u-rich-table` 은 읽지 않습니다). `--dc-font-size` 만 예외입니다 — 바로
-아래 `u-rich-table` 절 참조.
+`--dc-header-font-size`·`--dc-header-font-weight`·`--dc-sheet-height` 여섯은
+`u-simple-sheet` 전용입니다(`u-data-view`·`u-rich-table` 은 읽지 않습니다).
+`--dc-font-size` 만 예외입니다 — 바로 아래 `u-rich-table` 절 참조.
 
 ### 그리드 밀도 조절 (`u-rich-table` · 0.16.0~)
 

package/dist/components/simple-sheet/USimpleSheet.styles.js

@@ -44,9 +44,23 @@ var baseStyles = css`
     --dc-header-font-size:    12px;   /* 열 머리 — --u-density 와 무관(독립 계약 유지) */
     --dc-header-font-weight:   600;   /* 〃 */
 
+    /* ── 소비자 조절점 — 호스트 높이 ──
+       ★위 다섯과 같은 이유로 열렸지만 축이 다르다 — 저것들은 "셀 하나"의 치수이고
+       이것은 "시트 전체(:host)"의 치수다. 종전에는 여기만 리터럴이라, 셀 치수는 전부
+       조절되는데 그 합인 호스트 크기만 조절 불가능한 비대칭이 있었다.
+       ⚠**역할 토큰에서 파생하지 않는다** — --dc-font-size 와 달리 대응하는 --u- 층
+       스위치가 없다(호스트 크기는 밀도 개념이 아니다). 그래서 var() 폴백이 아니라
+       이 리터럴 기본값 자체가 정본이다.
+       ⚠**rows 를 낮춰도 이 값은 안 줄어든다 — 그리고 그것이 의도다.** rows 는 표시
+       개수가 아니라 데이터 격자의 최소 용량이라, 자연 높이로 접으면 빈 행 개수만큼
+       상자가 늘어나는 별개 결함이 생긴다. 이 토큰이 여는 것은 "소비자가 상한을
+       명시하고 그 안에서 overflow-y:auto 로 스크롤"이지 "내용에 맞춰 줄어든다"가
+       아니다 — 후자가 필요하면 별도 옵트인으로 낸다. */
+    --dc-sheet-height:       400px;
+
     display: block;
     width: 100%;
-    height: 400px;
+    height: var(--dc-sheet-height);
   }
 
   .sheet-container {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@iyulab/data-components",
   "description": "iyulab data visualization components",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "keywords": [
     "iyulab",
     "web-components",