@iyulab/house-style 0.2.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,90 @@
 # Changelog
 
+## [0.4.0] - 2026-10-14
+
+### Added
+
+- `<kbd>` outside a component takes the keyboard-hint look (border, canvas background, overline size).
+- `.hs-table-toolbar__actions` — the action group at the end of a table toolbar.
+
+### Changed
+
+- Requires `@iyulab/components` 2.24.0 or later (peer range `^2.24.0`). The house sets the selection role
+  (`--u-selection-color`), which components reads from 2.24.0 — with an older components a checked box, a selected
+  radio and an on switch keep the primary colour.
+
+
+### Deprecated
+
+- **`.hs-page-head` and its parts (`__eyebrow` · `__title` · `__description` · `__actions`) — use `u-page-header`**
+  from `@iyulab/modern-app`. The house already draws that component the same way (label-size eyebrow and
+  description, display-size title), and it carries the page's `h1`, a back link and a status slot the class pattern
+  does not. Move the eyebrow, title and description to its `eyebrow`, `title` and `subtitle` attributes and put each
+  scope picker and action in `slot="actions"`. Removed in 0.5.0.
+- **`.hs-kbd` — use a plain `<kbd>`.** The house now draws `<kbd>` as the same small outlined cap, in the monospace
+  face. Removed in 0.5.0.
+- **`.hs-stats` / `.hs-stat` and its parts — use `u-info-section layout="strip"`** with `u-info-field size="lg"`
+  (`@iyulab/modern-app` 0.54): `__label` → `label`, `__value` → `value`, `__unit` → `unit`, `__sub` → `description`,
+  `--warning` / `--danger` / `--success` → `tone="warning"` / `"negative"` / `"positive"`. The same strip — one surface,
+  hairline dividers, all side by side or all stacked below 640px. `.hs-stat--hero` has no counterpart (nothing used it)
+  and goes with it. Removed in 0.5.0.
+- **`.hs-sheet-footer` and its parts — use `<u-action-bar sticky>`** (`@iyulab/modern-app` 0.54): the change summary in
+  `slot="summary"`, Cancel and Save as its children, the sheet's inset as `--action-bar-padding-inline`. It also keeps
+  a destructive action apart at the leading edge and puts the main actions on top when narrow. Removed in 0.5.0.
+
+### Fixed
+
+- `.hs-views` no longer draws a vertical scrollbar beside its tabs. The selected tab's underline reached 1px
+  past the scrolling strip (a `-1px` margin over the strip's bottom border); the base line is now an inset shadow the
+  underline paints over.
+- `.hs-table--compact` totals rows take the compact height too. `.hs-table tfoot td` set 40px with a higher
+  specificity, so a compact table's subtotal, tax and total rows stood taller than its body rows.
+## [0.3.0] - 2026-10-13
+
+### Changed
+
+- 🔴**The house now sets the text between components.** Paragraphs, headings, lists and code spans an application
+  writes outside any component drew at the browser's defaults — a 16px body with `line-height: normal`, an `h2` of
+  1.5em that outranked every component title, 1em gaps above and below. They now take the house ladder: the body at
+  the body step (14px · 1.571), `h1`/`h2`/`h3` at display/title/subtitle, `h4`–`h6` at the body step in semibold;
+  one gap below each block (`--u-space-sm` after a heading, `--u-space-md` after a paragraph, list, quote, figure or
+  `pre`), none above and none after the last block in its box; `code`, `kbd`, `samp` and `pre` in the house monospace.
+  All zero-specificity inside `iyu.house` — your own rules win. A screen that relied on the browser's defaults draws
+  smaller and tighter; set your own rule on that element to keep the old look.
+- **Native checkboxes, radios and ranges take the selection colour** (`accent-color`), and scrollbars the strong line
+  colour (`scrollbar-color`).
+
+### Added
+
+- **House chart colours** — `--u-chart-color-1` … `-8`, light and dark. Slot one is the interaction blue (`#2F6FEB`;
+  dark `#628FEA`, the dark blue taken to the mark band), so a one-series chart draws in the colour the screen already
+  uses for links, focus and selection; the other seven are muted, warm-leaning hues chosen as a set — neighbours
+  ΔE ≥ 15 for full colour vision and ≥ 8 under red–green deficiency, no slot within ΔE 10 of a status colour, every
+  dark slot ≥ 3:1 on the surfaces. Light slot six (olive) is 2.8:1 on white: six or more series need a legend or
+  labels. Before, the house set no chart colours and series drew in the built-in Material palette. Charts drawn
+  through `@iyulab/u-widgets/themes/components.css` pick them up slot for slot.
+- `--u-selection-color` / `--u-selection-txt-color` — the mark of a chosen option (a checked box, a selected radio) and
+  the check drawn on it: the interaction blue, light and dark, held to 3:1 against the surface and its check.
+- `.hs-prose` and `--hs-measure` (70ch) — running text that can grow wider than reads well stops its paragraphs and
+  lists at the measure.
+
+### Fixed
+
+- **A hovered table header or toolbar strip is visibly different from its rest state.** `--u-bg-color-raised-hover`
+  (light) moves from `#EAEAE7` to `#E5E5E2` — the step from `--u-bg-color-raised` was 0.021 in OKLab lightness, below
+  what reads as a change. The token contract now holds state and depth steps to perception floors in both modes
+  (hover ≥ 0.03, press ≥ 0.05, selection ≥ 0.03, a surface step ≥ 0.025, which also carries a hairline edge).
+
+### Guide and reference app
+
+- The guide's prose follows the new document-flow layer and stops at the measure; the theme and deployment pages
+  take the same page layout as the others; the «Component depth» cards say what the house draws (cards stay flat).
+- Both sites follow the system theme (`Theme.init({ default: 'system' })`) and carry a favicon; the reference app
+  has a theme toggle.
+- Reference app order detail: the items are a `u-rich-table` (the guide's «Line items» pattern) — columns line up,
+  quantity edits in place, rows delete from the table — and the add-item line folds in a narrow pane instead of
+  scrolling it sideways.
+
 ## [0.2.0] - 2026-10-12
 
 ### Changed

package/README.md

@@ -37,7 +37,7 @@ so its preflight would beat the theme; `tailwind.css` imports the theme into Tai
 | `styles/index.css` (package root) | everything below plus Pretendard — for apps without Tailwind |
 | `styles/theme.css` | the theme without fonts (bring your own face) |
 | `styles/tokens.css` | house values for the `--u-*` token axes, light and dark; brand tokens `--hs-brand*` |
-| `styles/components.css` | sizes and finish for `u-button`, `u-card`, `u-drawer`, `flex-table`, the app shell |
+| `styles/components.css` | the document flow (body text, `h1`–`h6`, block gaps, code spans, native control and scrollbar colours) and sizes and finish for `u-button`, `u-card`, `u-drawer`, `flex-table`, the app shell |
 | `styles/patterns.css` | `hs-*` layout patterns — page head, saved views, filter bar, stat strip, table card, callout, form sections, side-sheet footer |
 | `styles/tailwind.css` | the Tailwind v4 entry: fonts + theme (in Tailwind's `components` layer) + role utilities — `bg-canvas`, `text-ink-weak`, `border-line`, `bg-warning-soft`, `rounded-card` … |
 | `styles/tailwind-neutrals.css` | optional: Tailwind's grey ramps (`gray`, `slate`, `zinc`, `neutral`, `stone`) follow the house neutrals |
@@ -82,6 +82,17 @@ The type ladder is the `--u-text-*-size` steps plus two house steps derived from
 `--hs-text-hero-size` (display + 6px: a headline figure). Every pattern reads a step, so rescaling the
 ladder (a larger mode, a product system) carries the patterns along.
 
+### Text outside components
+
+The theme also sets the text an application writes between components, so a screen's own words match
+the components around them: the body draws at the body step (14px · 1.571), `h1`/`h2`/`h3` at the
+display/title/subtitle steps and `h4`–`h6` at the body step in semibold, and paragraphs, lists and
+headings get one gap below (none above, none after the last block in a box). Code spans use the house
+monospace. A checked native checkbox or radio takes the selection colour (`--u-selection-color`, the
+interaction blue) and scrollbars the strong line colour. Running text that can grow wider than reads
+well opts into the measure: `<div class="hs-prose">` stops its paragraphs and lists at `--hs-measure`
+(70ch). All of it is zero-specificity in the house layer — any rule of yours wins.
+
 ## The guide
 
 **Live**: https://iyulab.github.io/house-style/ — this is the guide. There is no

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/house-style",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "The iyulab house theme: a CSS-only theme for @iyulab components — tokens, component recipes, line-of-business layout patterns and a Tailwind CSS v4 preset — plus the guide site that documents it.",
   "license": "MIT",
   "repository": {
@@ -38,6 +38,7 @@
     "check:guide": "node scripts/check-guide.mjs",
     "check:a11y": "node scripts/check-a11y.mjs",
     "check:ladder": "node scripts/check-ladder.mjs",
+    "check:leave": "node scripts/check-leave.mjs",
     "check:start-here": "node scripts/check-start-here.mjs",
     "check:start-here:local": "node scripts/check-start-here.mjs --local",
     "pretest": "node -e \"if(require('fs').existsSync('../../scripts/sibling-dist-check.js'))require('child_process').execFileSync('node',['../../scripts/sibling-dist-check.js'],{stdio:'inherit'})\"",
@@ -57,7 +58,7 @@
     "pretendard": "^1.3.9"
   },
   "peerDependencies": {
-    "@iyulab/components": "^2.0.0",
+    "@iyulab/components": "^2.24.0",
     "@iyulab/flex-table": ">=0.41.0",
     "@iyulab/modern-app": ">=0.39.0"
   },
@@ -70,13 +71,13 @@
     }
   },
   "devDependencies": {
-    "@iyulab/components": "^2.20.0",
-    "@iyulab/data-components": "^0.47.0",
+    "@iyulab/components": "^2.24.0",
+    "@iyulab/data-components": "^0.49.0",
     "@iyulab/enterprise": "^0.32.0",
-    "@iyulab/flex-table": "^0.64.0",
-    "@iyulab/modern-app": "^0.52.0",
-    "@iyulab/router": "^0.23.0",
-    "@iyulab/u-widgets": "^0.30.1",
+    "@iyulab/flex-table": "^0.67.0",
+    "@iyulab/modern-app": "^0.54.0",
+    "@iyulab/router": "^0.24.0",
+    "@iyulab/u-widgets": "^0.31.0",
     "@lit/react": "^1.0.8",
     "@types/node": "^26.1.1",
     "@types/react": "^19.3.0",

package/styles/components.css

@@ -21,6 +21,70 @@
   color: var(--u-txt-color);
   -webkit-font-smoothing: antialiased;
 }
+/* ── Document flow — the text an application writes between components ─────────────────── *
+ * Paragraphs, headings, lists and code spans outside any component would draw at the browser's
+ * defaults — 16px body with `line-height: normal`, an h2 of 1.5em that outranks every component
+ * title, 1em gaps — so a screen's own words looked unlike the components around them. Here they
+ * take the house ladder. Zero specificity inside the house layer: any application rule wins. */
+:where(body) {
+  font-size: var(--u-text-body-size);
+  line-height: var(--u-text-body-leading);
+}
+:where(h1) {
+  font-size: var(--u-text-display-size);
+  font-weight: var(--u-text-display-weight);
+  line-height: var(--u-text-display-leading);
+}
+:where(h2) {
+  font-size: var(--u-text-title-size);
+  font-weight: var(--u-text-title-weight);
+  line-height: var(--u-text-title-leading);
+}
+:where(h3) {
+  font-size: var(--u-text-subtitle-size);
+  font-weight: var(--u-text-subtitle-weight);
+  line-height: var(--u-text-subtitle-leading);
+}
+:where(h4, h5, h6) {
+  font-size: var(--u-text-body-size);
+  font-weight: 600;
+  line-height: var(--u-text-body-leading);
+}
+/* One gap below each block, none above — the gap between two blocks is one step, not two
+ * collapsed margins; the last block in its box adds none. */
+:where(h1, h2, h3, h4, h5, h6) {
+  margin-block: 0 var(--u-space-sm);
+}
+:where(p, ul, ol, dl, blockquote, figure, pre) {
+  margin-block: 0 var(--u-space-md);
+}
+:where(h1, h2, h3, h4, h5, h6, p, ul, ol, dl, blockquote, figure, pre):where(:last-child) {
+  margin-block-end: 0;
+}
+:where(code, kbd, samp, pre) {
+  font-family: var(--u-font-mono);
+}
+/* A key the reader presses — a small outlined cap, quieter than the text around it. */
+:where(kbd) {
+  padding: 0 4px;
+  border: 1px solid var(--u-border-color);
+  border-radius: var(--u-radius-md, 4px);
+  background: var(--u-canvas-bg-color);
+  font-size: var(--u-text-overline-size, 11px);
+  font-weight: 500;
+  line-height: 16px;
+  color: var(--u-txt-color-weak);
+}
+/* A measure for running text — opt in where a paragraph can be wider than reads well. */
+:where(.hs-prose) :where(p, ul, ol, dl, blockquote) {
+  max-inline-size: var(--hs-measure);
+}
+/* Native controls (a checkbox in a plain form, a range) and scrollbars take the house colours. */
+:root {
+  accent-color: var(--u-selection-color);
+  scrollbar-color: var(--u-border-color-strong) transparent;
+}
+
 /* A plain link takes the house link colour instead of the browser's — in light and dark alike.
  * Zero specificity: a class on the link (`hs-*`, an app's own) and any application rule win.
  * Visited links keep the same colour (an application, not a document); the underline stays,

package/styles/patterns.css

@@ -9,9 +9,9 @@
  * Prefix `hs-`. Everything sits in `@layer iyu.house`; an application rule always wins.
  *
  * Screen recipes (the guide shows each one):
- *   list   = .hs-page-head → .hs-filter-bar → .hs-stats → .hs-table-card (toolbar · table · pager)
- *   detail = side sheet: head (id · status · one primary action) → steps → .hs-stats → tabs → cards
- *   edit   = side sheet with .hs-fieldset sections and a pinned .hs-sheet-footer
+ *   list   = u-page-header → .hs-filter-bar → u-info-section layout="strip" → .hs-table-card (toolbar · table · pager)
+ *   detail = side sheet: head (id · status · one primary action) → steps → stat strip → tabs → cards
+ *   edit   = side sheet with .hs-fieldset sections and a pinned u-action-bar (summary slot)
  *
  * Rules the patterns encode:
  *   · one ink (primary) button per view — the rest are outlined, plain or in a menu
@@ -35,7 +35,10 @@
 
 /* Page head — eyebrow · title · one-line description on the left; on the right a scope
    picker (data-wide filters such as a season or period), up to two secondary actions and
-   the single primary action, in that order. */
+   the single primary action, in that order.
+   @deprecated Use `u-page-header` (`@iyulab/modern-app`) — `eyebrow` · `title` · `subtitle`, and the
+   scope picker and actions in its `actions` slot. The house already draws it this way
+   (`components.css`), and it carries the page's h1 and a back link. remove: 0.5.0 */
 .hs-page-head {
   display: flex;
   align-items: flex-end;
@@ -74,7 +77,10 @@
 .hs-views {
   display: flex;
   gap: var(--u-space-2xs, 4px);
-  border-bottom: 1px solid var(--u-border-color);
+  /* The base line is an inset shadow, not a border: a tab's 2px underline paints over it without the tab
+     reaching past the box — with a border and a -1px tab margin the scroll container overflowed by 1px and
+     drew a vertical scrollbar beside the tabs. */
+  box-shadow: inset 0 -1px 0 var(--u-border-color);
   overflow-x: auto;
 }
 .hs-views__tab {
@@ -82,7 +88,6 @@
   align-items: center;
   gap: 6px;
   padding: var(--u-space-sm, 8px) var(--u-space-md, 12px);
-  margin-bottom: -1px;
   border: 0;
   border-bottom: 2px solid transparent;
   background: none;
@@ -150,7 +155,10 @@
 /* Side by side, or stacked when the strip is narrower than 640px — all or nothing, never a ragged row.
  * No size container: the threshold is each stat's flex-basis, calc((640px - 100%) * 999) — negative
  * (so 0) when wide, huge when narrow (the "Holy Albatross"). The dividers are the 1px gap showing the
- * strip's border-coloured background, so they turn from vertical to horizontal on their own. */
+ * strip's border-coloured background, so they turn from vertical to horizontal on their own.
+ * @deprecated Use `u-info-section layout="strip"` with `u-info-field size="lg"` (`@iyulab/modern-app` 0.54) — the
+ * same strip as a component: `label` · `value` · `unit` · `description` (the supporting line) and `tone` for the
+ * warning, danger and success values. `.hs-stat--hero` has no counterpart and goes with it. remove: 0.5.0 */
 .hs-stats {
   display: flex;
   flex-wrap: wrap;
@@ -233,6 +241,12 @@
   font-size: var(--hs-text-dense-size, 13px);
   font-weight: 600;
 }
+.hs-table-toolbar__actions {
+  display: flex;
+  align-items: center;
+  gap: var(--u-space-sm, 8px);
+  flex-wrap: wrap;
+}
 .hs-pager {
   display: flex;
   align-items: center;
@@ -279,7 +293,9 @@
 }
 /* One line separates the totals from the body — not one per totals row (subtotal · tax · total). */
 .hs-table tfoot tr:first-child td { border-top: 1px solid var(--u-border-color); }
-.hs-table--compact td { height: var(--hs-row-compact, 32px); }
+/* Totals rows follow the compact height too (`tfoot td` would otherwise win on specificity). */
+.hs-table--compact td,
+.hs-table--compact tfoot td { height: var(--hs-row-compact, 32px); }
 .hs-table--top td { vertical-align: top; padding-block: var(--u-space-sm, 8px); height: auto; }
 /* Cells (`th` too — header text aligns with its values) */
 .hs-num,
@@ -512,7 +528,10 @@ a.hs-card:hover,
 }
 .hs-span-all { grid-column: 1 / -1; }
 
-/* ── Side sheet footer — change summary on the left, Cancel / Save on the right ── */
+/* ── Side sheet footer — change summary on the left, Cancel / Save on the right ──
+ * @deprecated Use `<u-action-bar sticky>` (`@iyulab/modern-app` 0.54): the summary in `slot="summary"`, Cancel and
+ * Save as its children, the sheet's inset as `--action-bar-padding-inline`. It also keeps a destructive action
+ * apart at the leading edge and puts the main actions on top when narrow. remove: 0.5.0 */
 .hs-sheet-footer {
   display: flex;
   align-items: center;
@@ -563,7 +582,9 @@ a.hs-card:hover,
 }
 .hs-due--soon { background: var(--u-warning-bg-color); color: var(--u-warning-color-strong); }
 .hs-due--over { background: var(--u-danger-bg-color); color: var(--u-danger-color-strong); }
-/* A keyboard hint. */
+/* A keyboard hint.
+   @deprecated Use a plain `<kbd>` — the house draws it the same way (`components.css`), in the
+   monospace face. remove: 0.5.0 */
 .hs-kbd {
   padding: 0 4px;
   border: 1px solid var(--u-border-color);

package/styles/tokens.css

@@ -47,7 +47,7 @@
   --u-panel-bg-color:        #FFFFFF;
   --u-input-bg-color:        #FFFFFF;
   --u-bg-color-raised:       #F1F1EF;   /* table header, toolbar strip, read-only field */
-  --u-bg-color-raised-hover: #EAEAE7;
+  --u-bg-color-raised-hover: #E5E5E2;
   --u-bg-color-hover:        #F1F1EF;
   --u-bg-color-active:       #EAEAE7;
   --u-bg-color-disabled:     #F1F1EF;
@@ -83,9 +83,25 @@
   --u-primary-txt-color:     #FFFFFF;
   --u-primary-bg-color:      #EEF3FD;   /* selected rows, current item */
 
-  /* Interaction — blue, for links and focus only */
+  /* Interaction — blue, for links, focus and the mark of a chosen option (a checked box or radio) */
   --u-link-txt-color:   #1F5FCC;
   --u-focus-ring-color: #2F6FEB;
+  --u-selection-color:     #2F6FEB;
+  --u-selection-txt-color: #FFFFFF;   /* the check drawn on that fill */
+
+  /* Chart series — eight, in order (slot one first, never cycled). Slot one is the interaction blue, so a
+     one-series chart draws in the colour the rest of the screen uses for "this is the thing"; the other seven
+     are muted, warm-leaning hues chosen as a set: OKLCH L 0.50–0.68, chroma ≥ 0.10, neighbours ΔE ≥ 15 for
+     full colour vision and ≥ 8 under red–green deficiency (Machado 2009), every slot at least ΔE 10 from a
+     status colour. Slot six (light olive) is 2.8:1 on white — six or more series need a legend or labels. */
+  --u-chart-color-1: #2F6FEB;
+  --u-chart-color-2: #B55F40;
+  --u-chart-color-3: #14938D;
+  --u-chart-color-4: #AF8020;
+  --u-chart-color-5: #7D4B92;
+  --u-chart-color-6: #86A645;
+  --u-chart-color-7: #C46E83;
+  --u-chart-color-8: #834B14;
 
   /* Status — `-color-strong` is the text step (on surface and on its own tint), `-bg-color`
      the tint, `-color` the solid fill (with `-txt-color` on top). */
@@ -204,6 +220,20 @@
 
   --u-link-txt-color:   #8DB3F7;
   --u-focus-ring-color: #6E9CF7;
+  --u-selection-color:     #6E9CF7;
+  --u-selection-txt-color: #0E0F10;
+
+  /* Chart series, dark — the same hues stepped into the dark band (L 0.52–0.66), every slot ≥ 3:1 on the
+     surface and the raised surface. Slot one is the dark interaction blue taken to the band's top (#6E9CF7
+     itself is lighter than a filled mark should be on this surface). */
+  --u-chart-color-1: #628FEA;
+  --u-chart-color-2: #C97152;
+  --u-chart-color-3: #04A19B;
+  --u-chart-color-4: #B8892D;
+  --u-chart-color-5: #9760AF;
+  --u-chart-color-6: #57833D;
+  --u-chart-color-7: #CF7188;
+  --u-chart-color-8: #9A5F1A;
 
   --u-info-color-weakest:    #1F3152;
   --u-info-color-weaker:     #2C4A7E;
@@ -311,6 +341,9 @@
   --hs-text-dense-size: calc((var(--u-text-body-size) + var(--u-text-label-size)) / 2);
   --hs-text-hero-size:  calc(var(--u-text-display-size) + 6px);
 
+  /* Prose measure — a running paragraph stops around 70 characters a line (`.hs-prose`). */
+  --hs-measure: 70ch;
+
   /* Field box (`@iyulab/components`) — 32px fields beside 32px buttons; 40px inside form sections. In em, so the box
      follows the control density with the buttons (resolved at the field: 4.5px / 12px at the default 14px). */
   --u-field-padding-block:  calc(4.5em / 14);