@iyulab/house-style 0.3.0 → 0.5.0

package/CHANGELOG.md

@@ -1,5 +1,84 @@
 # Changelog
 
+## [0.5.0] - 2026-10-14
+
+### Added
+
+- **The inline alert as the house callout.** `u-alert[inline]` lays its footer out as a right-hand action column
+  beside the title and body, at the dense text step (13px · 20px lines), with the body in the weak text colour.
+- `u-tag[size='sm']` — the small step stays an 18px mark (no block padding, 5px sides) under the house tag padding.
+- `u-tab-nav` — the tab strip of links draws the current view in ink (ink text, ink underline, semibold) at the dense
+  text step.
+
+### Changed
+
+- Requires `@iyulab/components` 2.25.0 or later (peer range `^2.25.0`) — the recipes above style its `u-tab-nav`,
+  `u-tag size` and `u-alert inline`.
+
+### Deprecated
+
+- **`.hs-callout` and its parts — use `<u-alert inline open>`** (`@iyulab/components` 2.25): `--warning` / `--info` /
+  `--success` / `--danger` → `status`, `__title` → `title`, `__body` → the content, `__actions` → `slot="footer"`
+  (the house puts it in the right-hand column). A note (`--note`) is `status="notice"` with `role="note"` and its
+  pencil in `slot="icon"`, so it is not announced as news. Removed in 0.6.0.
+- **`.hs-views` / `.hs-views__tab` and `.hs-count` — use `<u-tab-nav label>` with `<u-tab href count>`**
+  (`@iyulab/components` 2.25). Saved views are URLs, so the tabs are links in a navigation landmark: the current view
+  is `aria-current="page"` (set `value` on the strip), and each link is a Tab stop. Removed in 0.6.0.
+- **A whole card as a link (`a.hs-card`, `.hs-card--link`) — use `<u-card href>`** (`@iyulab/components` 2.25): the
+  outer box is the link, the border carries hover, the card does not lift. The titled card itself stays. Removed in
+  0.6.0.
+- **`.hs-attr` — use `<u-tag size="sm" appearance="outlined">`** (`@iyulab/components` 2.25). Removed in 0.6.0.
+
+### Removed
+
+- The 0.4.0 deprecations: `.hs-page-head` and its parts (use `u-page-header`), `.hs-kbd` (use `<kbd>`), `.hs-stats` /
+  `.hs-stat` and its parts including `.hs-stat--hero` (use `u-info-section layout="strip"` with
+  `u-info-field size="lg"`), and `.hs-sheet-footer` and its parts (use `<u-action-bar sticky>`).
+
+### Guide
+
+- The list screen's saved views are a `u-tab-nav`, the attribute next to an order id is a small tag, and the callouts
+  are inline alerts.
+
+## [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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@iyulab/house-style",
-  "version": "0.3.0",
+  "version": "0.5.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": {
@@ -58,7 +58,7 @@
     "pretendard": "^1.3.9"
   },
   "peerDependencies": {
-    "@iyulab/components": "^2.0.0",
+    "@iyulab/components": "^2.25.0",
     "@iyulab/flex-table": ">=0.41.0",
     "@iyulab/modern-app": ">=0.39.0"
   },
@@ -71,11 +71,11 @@
     }
   },
   "devDependencies": {
-    "@iyulab/components": "^2.20.0",
-    "@iyulab/data-components": "^0.48.0",
+    "@iyulab/components": "^2.25.0",
+    "@iyulab/data-components": "^0.49.0",
     "@iyulab/enterprise": "^0.32.0",
-    "@iyulab/flex-table": "^0.66.0",
-    "@iyulab/modern-app": "^0.53.0",
+    "@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",

package/styles/components.css

@@ -64,6 +64,17 @@
 :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);
@@ -129,6 +140,54 @@ u-tag {
   --tag-padding-inline: 8px;
   --tag-gap: 5px;
 }
+/* The small step — 18px marks inside a line of text (an attribute next to an id): no block padding, 5px sides. */
+u-tag[size='sm'] {
+  --tag-padding-block: 0;
+  --tag-padding-inline: 5px;
+  --tag-gap: 4px;
+}
+
+/* ── Tab strip of links (saved views) — ink, not blue: the current view is ink text with an ink underline,
+ *    at the dense text step. ── */
+u-tab-nav {
+  --tab-nav-color: var(--u-txt-color);
+  font-size: var(--hs-text-dense-size, 13px);
+}
+u-tab-nav u-tab[active] {
+  font-weight: 600;
+}
+
+/* ── Inline alert — the house callout: actions in a right-hand column beside the title and body, at the dense
+ *    text step. A floating alert (no `inline`) keeps the component layout. ── */
+u-alert[inline]::part(container) {
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto;
+  column-gap: var(--u-space-md, 12px);
+  align-items: center;
+}
+u-alert[inline]::part(header),
+u-alert[inline]::part(content) {
+  grid-column: 1;
+}
+u-alert[inline]::part(footer) {
+  grid-column: 2;
+  grid-row: 1 / span 2;
+  display: flex;
+  gap: var(--u-space-sm, 8px);
+}
+u-alert[inline]::part(header) {
+  margin-bottom: 0;
+  font-size: var(--hs-text-dense-size, 13px);
+}
+u-alert[inline]::part(title) {
+  line-height: 20px;
+}
+u-alert[inline]::part(content) {
+  font-size: var(--hs-text-dense-size, 13px);
+  font-weight: 400;
+  line-height: 20px;
+  color: var(--u-txt-color-weak);
+}
 
 /* ── Card — flat surface, hairline border; shadow is for things that float ── */
 u-card {

package/styles/patterns.css

@@ -2,16 +2,17 @@
  * @iyulab/house-style — layout patterns
  * ==========================================================================
  * Class-based patterns for the arrangements a line-of-business screen repeats and no single
- * component owns: the page head, the filter bar, the stat strip, the plain data table, the
- * callout, the form section, the side-sheet footer. They work in any framework (plain HTML,
- * Lit, React) and read tokens only — no literal colours.
+ * component owns: the filter bar, the table card, the plain data table, the form section, the
+ * detail layout. They work in any framework (plain HTML, Lit, React) and read tokens only — no
+ * literal colours. Where a component owns the arrangement, the component is the canonical form
+ * and the pattern is deprecated with the version it goes in (`remove:`).
  *
  * 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 → u-info-section 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
@@ -33,48 +34,19 @@
   min-width: 0;
 }
 
-/* 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. */
-.hs-page-head {
-  display: flex;
-  align-items: flex-end;
-  justify-content: space-between;
-  gap: var(--u-space-lg, 16px);
-  flex-wrap: wrap;
-}
-.hs-page-head__eyebrow {
-  margin: 0 0 2px;
-  font-size: var(--u-text-label-size, 12px);
-  line-height: 16px;
-  color: var(--u-txt-color-weak);
-}
-.hs-page-head__title {
-  margin: 0;
-  font-size: var(--u-text-display-size, 22px);
-  line-height: var(--u-text-display-leading, 1.364);
-  font-weight: var(--u-text-display-weight, 700);
-  letter-spacing: var(--u-text-display-tracking, -0.01em);
-  color: var(--u-txt-color);
-}
-.hs-page-head__description {
-  margin: 2px 0 0;
-  font-size: var(--u-text-label-size, 12px);
-  line-height: 18px;
-  color: var(--u-txt-color-weak);
-}
-.hs-page-head__actions {
-  display: flex;
-  align-items: center;
-  gap: var(--u-space-sm, 8px);
-  flex-wrap: wrap;
-}
 
 /* ── Saved views — tabs above the filter bar, each with a count ─────────── */
+/* @deprecated Use `<u-tab-nav label>` with `<u-tab href count>` (`@iyulab/components` 2.25) — the same strip as a
+   navigation landmark of links: the current view is `aria-current="page"` (these tabs are URLs, so they are links,
+   not a tablist), each link is a Tab stop, and `count` is the quiet count. The house draws it this way
+   (`components.css`). `.hs-count` goes with it. remove: 0.6.0 */
 .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 +54,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;
@@ -145,63 +116,6 @@
   display: none;
 }
 
-/* ── Stat strip — the result's totals as cells, not a sentence ───────────
- * 3–5 cells: label → value → one supporting line. One hero value per screen at most. */
-/* 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. */
-.hs-stats {
-  display: flex;
-  flex-wrap: wrap;
-  gap: 1px;
-  background: var(--u-border-color);
-  border: 1px solid var(--u-border-color);
-  border-radius: var(--u-radius-xl, 10px);
-  overflow: hidden;
-}
-.hs-stat {
-  flex: 1 1 calc((640px - 100%) * 999);
-  min-width: 0;
-  padding: var(--u-space-md, 12px) var(--u-space-lg, 16px);
-  background: var(--u-bg-color);
-}
-.hs-stat__label {
-  font-size: var(--u-text-label-size, 12px);
-  line-height: 16px;
-  font-weight: 500;
-  color: var(--u-txt-color-weak);
-}
-.hs-stat__value {
-  margin-top: 2px;
-  font-size: var(--u-text-title-size, 18px);
-  line-height: 26px;
-  font-weight: 700;
-  font-variant-numeric: tabular-nums;
-  white-space: nowrap;
-  overflow: hidden;
-  text-overflow: ellipsis;
-  color: var(--u-txt-color);
-}
-.hs-stat__unit {
-  margin-inline-start: 2px;
-  font-size: var(--u-text-caption-size, 12px);
-  font-weight: 500;
-  color: var(--u-txt-color-weak);
-}
-.hs-stat__sub {
-  font-size: var(--u-text-caption-size, 12px);
-  line-height: 18px;
-  color: var(--u-txt-color-weaker);
-}
-.hs-stat--hero .hs-stat__value {
-  font-size: var(--hs-text-hero-size, 28px);
-  line-height: 34px;
-  letter-spacing: -0.01em;
-}
-.hs-stat--warning .hs-stat__value { color: var(--u-warning-color-strong); }
-.hs-stat--danger .hs-stat__value { color: var(--u-danger-color-strong); }
-.hs-stat--success .hs-stat__value { color: var(--u-success-color-strong); }
 
 /* ── Table card — toolbar · table · pager on one surface ──────────────── */
 .hs-table-card {
@@ -233,6 +147,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 +199,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,
@@ -357,6 +279,8 @@ tr[aria-selected='true'] .hs-row-actions {
   text-decoration: none;
 }
 .hs-card__link:hover { text-decoration: underline; }
+/* @deprecated A whole card as a link: use `<u-card href>` (`@iyulab/components` 2.25) — the outer box is the link,
+   the border carries hover and the card does not lift. remove: 0.6.0 */
 a.hs-card,
 .hs-card--link { cursor: pointer; transition: border-color 0.12s ease-out; }
 /* A whole card as a link reads as a card: ink text, no underline — the border carries hover. */
@@ -380,7 +304,8 @@ a.hs-card:hover,
 .hs-dl > dd { margin: 0; min-width: 0; }
 
 /* Two-column detail: main column plus a 340px side panel once the columns are 960px wide, one column
- * below that. No size container — the threshold is each column's flex-basis (see .hs-stats). */
+ * below that. No size container — the threshold is each column's flex-basis, calc((960px - 100%) * 999):
+ * negative (so 0) when wide, huge when narrow (the "Holy Albatross"). */
 .hs-detail__cols {
   display: flex;
   flex-wrap: wrap;
@@ -403,6 +328,10 @@ a.hs-card:hover,
 }
 
 /* ── Callout — a conclusion in the title, two lines of body at most ──────
+ * @deprecated Use `<u-alert inline open>` (`@iyulab/components` 2.25) — `status` for the tone, `title` for the
+ * conclusion, the body as content, actions in `slot="footer"`, and `slot="icon"` for a note's pencil; a note is a
+ * neutral alert with `role="note"`. The house lays the footer out as the right-hand action column
+ * (`components.css`). remove: 0.6.0
  * No thick coloured edge: an icon and a tint carry the tone. `--note` is a person's note
  * (a remark on a record), not a warning — it is neutral on purpose. */
 .hs-callout {
@@ -512,27 +441,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 ── */
-.hs-sheet-footer {
-  display: flex;
-  align-items: center;
-  justify-content: space-between;
-  gap: var(--u-space-sm, 8px);
-  padding: var(--u-space-md, 12px) var(--u-space-xl, 20px);
-  border-top: 1px solid var(--u-border-color);
-  background: var(--u-bg-color);
-}
-.hs-sheet-footer__summary {
-  font-size: var(--u-text-caption-size, 12px);
-  color: var(--u-txt-color-weak);
-}
-.hs-sheet-footer__actions {
-  display: flex;
-  gap: var(--u-space-sm, 8px);
-}
 
 /* ── Small marks ───────────────────────────────────────────────────────── */
-/* A quiet attribute label next to an identifier (not a status — no colour). */
+/* A quiet attribute label next to an identifier (not a status — no colour).
+   @deprecated Use `<u-tag size="sm" appearance="outlined">` (`@iyulab/components` 2.25). remove: 0.6.0 */
 .hs-attr {
   display: inline-flex;
   align-items: center;
@@ -563,14 +475,5 @@ 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. */
-.hs-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: 500 11px/16px var(--u-font-base);
-  color: var(--u-txt-color-weak);
-}
 
 } /* @layer iyu.house */