@q1travel/design-system 0.15.1 → 0.15.2

package/contracts/icon-system.md

@@ -75,3 +75,4 @@ q1travel 的界面图标**目标是**一套自建的线性图标系统：几何
 - **颜色**：不为图标单独设色，依赖 `currentColor` 跟随文本。
 - **间距**：图标与文本之间保留一致间距，并与文本基线对齐。
 - **一致性**：同一控件组内不混用不同描边或尺寸。
+- **光学位移**：16px 线性图标贴文字标签时，图标框几何居中不等于看起来居中。位移统一消费 `--q1-optical-icon-shift-cjk-label`，通过独立的 `translate` 属性施加，不改 `transform`，因此不会冲掉 chevron 的旋转。取值按字体栈校准：包默认 `--q1-font-sans` 为 `0px`；拉丁首选字体决定行盒、中文回退 PingFang SC 的字体栈（web 当前字体栈）为 `-1px`，由消费方在自己的根上覆盖。纯英文标签会因此偏高约 1–2px，这是 x-height 的物理位置，不再按脚本细分。已接入：Navigation 分组图标、分组 chevron、链接项图标；ContextSwitcher 单行条目图标与动作图标。Button 前后缀默认不位移，消费方在已知全是中文的场景把 `--q1-button-affix-optical-y` 设为该 token。数值由 `check:browser` 的光学 fixture 锁定，见 `contracts/token-naming.md` 的 Optical Tokens。

package/contracts/implementation-map.md

@@ -17,6 +17,7 @@ README owns the repository inventory and generated-file boundary. This file owns
 | Component preview tile | Control density sample | Custom preview composition using component token mappings | Surface, border, action, focus, radius tokens | Button and segment visual states | Flex wrap preserves compact layout | Decorative in intro, real controls documented on component pages |
 | Color rods preview | Color scale summary | Custom preview composition using color scale aliases | `--q1-color-scale-*` aliases | None | Rods distribute across available width | Semantic labels identify the represented scale |
 | Color page reference and semantic tokens | Token reference and theme value copy | `ColorSwatch`, `SemanticColorListItem`, and `SemanticColorDemo` inside `ColorsPage` | `--q1-color-*`, semantic color tokens, and semantic action tokens | Left click copies token, context menu copies resolved value. The focus shadow token shows as an applied focus ring, not a flat color swatch | Ten-step grid and semantic rows adapt to available width | Button labels, semantic rows, live copy feedback |
+| Optical alignment | Aligned-looking media, icons, labels, and column edges | `ContextSwitcher` two-line rows, `Navigation` icons and chevron, `Table` edge columns and actions column, `Badge` label wrapper, `Button` affix | Optical tokens: `--q1-optical-icon-shift-cjk-label`, `--q1-optical-media-first-line-offset`, `--q1-surface-inset-inline`, `--q1-table-edge-padding-inline`, `--q1-button-hang-inline`, `--q1-badge-optical-shift`, `--q1-button-affix-optical-y` | Shifts use standalone `translate`; rotations and layout stay intact | Integer-pixel values only; locked by the `check:browser` optical fixture | Wrapper and class changes add no accessible names or roles |
 | Page footer navigation | Sequential documentation reading | `PageNavigation` | Surface, border, text, spacing tokens | Hover, focus, feedback buttons | Three-column footer collapses with content | Links are named and feedback controls are buttons |
 
 ## Implementation Rules

package/contracts/token-naming.md

@@ -51,6 +51,25 @@ The scale stops at 300ms on purpose. Past that, an interface reads as something
 
 An `infinite` loop's period is not on this scale. A spinner at 1.2s and a skeleton sweep at 1.6s are component rhythms, not responses to input; forcing them into the response scale either breaks them or manufactures single-use tokens.
 
+### Optical Tokens
+
+Optical tokens carry the integer-pixel compensations that make an interface look aligned rather than merely measure aligned. They were introduced in 0.15.2 from the 2026-09-17 optical alignment audit.
+
+Their values hold only for the font stack they were measured with. The package default is calibrated for `--q1-font-sans`; a consumer that overrides the body font stack re-measures and overrides the value on its own root. `check:browser` locks both the package default font stack and the current web font stack with the optical fixture (`/__browser-fixtures__/optical-alignment`): Chinese and mixed samples stay within 1px (plus half a device pixel of quantization), across light and dark themes at DPR 1 and 2.
+
+- `--q1-optical-icon-shift-cjk-label` (`0px`) — vertical shift for a 16px line icon beside a Chinese label. `--q1-font-sans` needs none. The current web stack, whose Latin primary font (Avenir Next) sets the line box while Chinese falls back to PingFang SC, needs `-1px`.
+- `--q1-media-size` (`var(--q1-space-6)`), `--q1-media-first-line-box` (`var(--q1-line-height-label-13)`), and `--q1-optical-media-first-line-offset` (`calc((first-line-box - media-size) / 2)`, `-3px`) — a two-line media row aligns its avatar to the first line's optical center, not to the geometric center of the whole block. The offset resolves once on `:root`, so a surface that changes the media size or first-line box redeclares the offset in the same rule.
+- `--q1-surface-inset-inline` (`var(--q1-space-4)`) — the single content inset that page headers, card content, and table edge columns share as one reference line.
+- `--q1-table-edge-padding-inline` (`var(--q1-surface-inset-inline)`) — outer padding of a table's first and last columns. Inner columns keep `--q1-space-2`.
+- `--q1-button-hang-inline` (`calc(var(--q1-space-3) + 1px)`) — distance from a small button's border edge to its label. Ghost buttons in a table actions column hang by this amount so the label starts on the column line.
+- `--q1-badge-optical-shift` (`0px`) and `--q1-button-affix-optical-y` (`0px`) — opt-in switches for the Badge label and Button affixes. They default to zero because Chinese and Latin labels move in opposite directions; a consumer sets them only where the label script is known.
+
+Rules:
+
+- Values are whole pixels. A compensation never uses a fractional pixel such as `0.5px`.
+- Components apply a shift through the standalone `translate` property, never through `transform`, so an existing `transform: rotate()` keeps working.
+- Where the compensation must change occupied space, use `margin-block-start` with an integer token instead of `translate`.
+
 ### Semantic Tokens
 
 Semantic tokens describe product meaning. Product surfaces should consume these before reaching for reference tokens.

package/dist-pkg/design-system.js

@@ -1634,7 +1634,7 @@ function ei({
 }
 const _r = /* @__PURE__ */ new Set(["ArrowLeft", "ArrowRight", "ArrowUp", "ArrowDown", "Home", "End"]);
 function yr(e, n) {
-  return e.find((r) => r.value === n && !r.disabled)?.value ?? e.find((r) => !r.disabled)?.value ?? "";
+  return e.find((r) => r.value === n)?.value ?? e.find((r) => !r.disabled)?.value ?? "";
 }
 function ti({
   options: e,
@@ -1671,7 +1671,7 @@ function ti({
   }
   const p = Y("switch-control", `switch-control--${o}`, c ? "switch-control--full" : "");
   return /* @__PURE__ */ t("div", { className: p, role: "radiogroup", "aria-label": n, children: e.map((k, T) => {
-    const E = k.value === N && !k.disabled;
+    const E = k.value === N;
     return /* @__PURE__ */ l(
       "button",
       {
@@ -3143,10 +3143,13 @@ function Ci({
     i === "md" ? "" : `badge--${i}`,
     o ? "badge--count" : "",
     d
-  ), m = s != null && (b == null || b === "") ? { role: "img", "aria-label": c } : {};
-  return /* @__PURE__ */ l("span", { className: f, title: c, ...m, ...u, children: [
+  ), _ = s != null && (b == null || b === "");
+  return /* @__PURE__ */ l("span", { className: f, title: c, ..._ ? { role: "img", "aria-label": c } : {}, ...u, children: [
     s ? /* @__PURE__ */ t("span", { className: "badge__icon", "aria-hidden": "true", children: s }) : null,
-    b
+    _ || b === void 0 || b === null || b === "" ? null : (
+      // 文字包裹层：光学补偿开关 --q1-badge-optical-shift 的作用点（0.15.2 起的 DOM 结构）。
+      /* @__PURE__ */ t("span", { className: "badge__label", children: b })
+    )
   ] });
 }
 function qi({ href: e, size: n = "md", icon: r, title: a, className: i, children: s, ...o }) {
@@ -5492,7 +5495,7 @@ function Ji({
         ] });
         return /* @__PURE__ */ t("th", { scope: "col", "aria-sort": K, className: Lt(C.align), children: se }, C.key);
       }),
-      x ? /* @__PURE__ */ t("th", { scope: "col", children: x.header }) : null
+      x ? /* @__PURE__ */ t("th", { scope: "col", className: "table__cell--actions", children: x.header }) : null
     ] }) }),
     /* @__PURE__ */ t("tbody", { children: S.map((C) => {
       const K = {
@@ -5513,7 +5516,7 @@ function Ji({
           }
         ) }) }) : null,
         n.map((U) => /* @__PURE__ */ t("td", { className: Lt(U.align), children: U.render(C.row, C.rowIndex) }, U.key)),
-        x ? /* @__PURE__ */ t("td", { children: x.render(C.row, C.rowIndex) }) : null
+        x ? /* @__PURE__ */ t("td", { className: "table__cell--actions", children: x.render(C.row, C.rowIndex) }) : null
       ] });
       return b ? /* @__PURE__ */ t(He, { children: b(C.row, {
         row: C.row,

package/dist-pkg/style.css

@@ -184,6 +184,18 @@
   --q1-space-16: 64px;
   --q1-space-24: 96px;
   --q1-control-height-default: 40px;
+  /* 光学对齐 Token（contracts/token-naming.md · Optical Tokens）：数值只对 --q1-font-sans 与当前 web
+ 字体栈成立，由 check:browser 光学 fixture 锁定。一律整数 px，位移走独立 translate，不覆盖 transform。
+ 媒体偏移在 :root 解析一次；消费方改了媒体尺寸或首行行盒，须在同一规则里重算偏移。 */
+  --q1-optical-icon-shift-cjk-label: 0px;
+  --q1-media-size: var(--q1-space-6);
+  --q1-media-first-line-box: var(--q1-line-height-label-13);
+  --q1-optical-media-first-line-offset: calc((var(--q1-media-first-line-box) - var(--q1-media-size)) / 2);
+  --q1-surface-inset-inline: var(--q1-space-4);
+  --q1-table-edge-padding-inline: var(--q1-surface-inset-inline);
+  --q1-button-hang-inline: calc(var(--q1-space-3) + 1px);
+  --q1-badge-optical-shift: 0px;
+  --q1-button-affix-optical-y: 0px;
   --q1-doc-frame-gutter: 60px;
   --q1-doc-frame-max-width: 1220px;
   --q1-doc-sidebar-width: 260px;
@@ -519,10 +531,13 @@
   }
 }
 
+/* 不做全局光学位移：中文与英文标签方向相反。已知全是中文的场景由消费方把
+ --q1-button-affix-optical-y 设为 var(--q1-optical-icon-shift-cjk-label)。 */
 .button__affix {
   display: inline-flex;
   flex: none;
   align-items: center;
+  translate: 0 var(--q1-button-affix-optical-y);
 }
 
 .button--sm {
@@ -1430,6 +1445,27 @@
 
 /* 列对齐取逻辑值（start/center/end）而非 left/right：RTL 下自动翻转，不必另写一套。
  表头与单元格用同一个类，因为表头和数据错开对齐时，一列会读成两栏。 */
+/* 首末列外侧内缩到表面参考线（--q1-surface-inset-inline），中间列仍用 space-2：
+ 卡片里的表格与卡片正文、页头共用同一条左参考线，不再各自散写内边距。 */
+.table th:first-child,
+.table td:first-child {
+  padding-inline-start: var(--q1-table-edge-padding-inline);
+}
+
+.table th:last-child,
+.table td:last-child {
+  padding-inline-end: var(--q1-table-edge-padding-inline);
+}
+
+/* 操作列悬挂：ghost 按钮的文字首字落在列线上，底色向外悬挂，与表头「操作」对齐。 */
+.table td.table__cell--actions .button--ghost:first-child {
+  margin-inline-start: calc(-1 * var(--q1-button-hang-inline));
+}
+
+.table td.table__cell--actions .button--ghost:not(.button--sm):first-child {
+  margin-inline-start: calc(-1 * (var(--q1-space-4) + 1px));
+}
+
 .table th.table__cell--align-center,
 .table td.table__cell--align-center {
   text-align: center;
@@ -1724,18 +1760,25 @@
   align-items: center;
 }
 
+/* 文字包裹层只作光学补偿开关：默认 0，不改行高（line-height 1 下中文与混排已居中）。 */
+.badge__label {
+  translate: 0 var(--q1-badge-optical-shift);
+}
+
 .badge--neutral {
   background: oklch(from var(--q1-color-gray-700) 0.43 0 0);
   color: var(--q1-color-action-on-primary);
 }
 
+/* 实底档白字须 ≥4.5:1（明暗两主题，issue 250）：info 0.58 在暗色只有 4.27，success 两主题均不足 4；
+ 由 check:browser 光学 fixture 按实际渲染色逐档钉住。 */
 .badge--info {
-  background: oklch(from var(--q1-color-status-info) 0.58 c h);
+  background: oklch(from var(--q1-color-status-info) 0.54 c h);
   color: var(--q1-color-action-on-primary);
 }
 
 .badge--success {
-  background: oklch(from var(--q1-color-status-success) 0.58 c h);
+  background: oklch(from var(--q1-color-status-success) 0.52 c h);
   color: var(--q1-color-action-on-primary);
 }
 
@@ -2777,6 +2820,12 @@ a.breadcrumb__link:hover {
   opacity: 0.5;
 }
 
+/* 禁用只收交互，不收选中（issue 249）：选中项保留底色与描边、文字降为 secondary，与半透明的未选中项仍可分辨。 */
+.switch-control__option[aria-checked='true']:disabled {
+  color: var(--q1-color-text-secondary);
+  opacity: 1;
+}
+
 .switch-control--sm .switch-control__option {
   min-height: 26px;
   padding: 0 var(--q1-space-2);
@@ -4779,7 +4828,7 @@ a.breadcrumb__link:hover {
 
 /* 横向铺开（direction="row"）：段横向排布；等分占位，窄屏也不挤成一条缝。
  特异性用 .q1-card.q1-card--row(0,2,0) 压过可点卡片的 a.q1-card(0,1,1)，否则 <a> 卡片的 display:block 会把 flex 打回竖排。 */
-.q1-card.q1-card--row {
+.q1-card.q1-card--row:not([hidden]) {
   display: flex;
   /* 横排指标块并列需要空间，解除默认 400px 限宽，充满容器（对齐横排充满 demo 框）。 */
   max-width: none;
@@ -5553,7 +5602,7 @@ a.q1-card:focus-visible {
   border-color: var(--q1-color-text-primary);
   background: color-mix(in srgb, var(--q1-color-text-primary) 5%, var(--q1-color-bg-panel));
 }
-.choicebox:has(.choicebox__input:checked) .choicebox__extra {
+.choicebox:has(.choicebox__input:checked) .choicebox__extra:not([hidden]) {
   display: block;
 }
 .choicebox--radio:has(.choicebox__input:checked) .choicebox__indicator {
@@ -5899,7 +5948,7 @@ a.q1-card:focus-visible {
   box-shadow: var(--q1-shadow-focus);
 }
 /* 纵向：上下边缘渐隐 */
-.scroller--vertical .scroller__viewport {
+.scroller--vertical .scroller__viewport:not([hidden]) {
   display: flex;
   flex-direction: column;
   gap: var(--q1-space-2);
@@ -5915,7 +5964,7 @@ a.q1-card:focus-visible {
   );
 }
 /* 横向：左右边缘渐隐 + 吸附 + 禁止横向 overscroll 触发返回手势 */
-.scroller--horizontal .scroller__viewport {
+.scroller--horizontal .scroller__viewport:not([hidden]) {
   display: flex;
   gap: var(--q1-space-2);
   overflow-x: auto;
@@ -8127,6 +8176,7 @@ a.q1-navigation__item[aria-disabled='true'] {
   height: 16px;
   stroke: currentColor;
   stroke-width: 1.8;
+  translate: 0 var(--q1-optical-icon-shift-cjk-label);
 }
 
 .q1-navigation__item-content {
@@ -8186,8 +8236,10 @@ a.q1-navigation__item[aria-disabled='true'] {
   white-space: nowrap;
 }
 
+/* 独立 translate 与展开时的 transform: rotate 叠加，互不覆盖。 */
 .q1-navigation__group-chevron {
   flex: none;
+  translate: 0 var(--q1-optical-icon-shift-cjk-label);
 }
 
 .q1-navigation__group-trigger[aria-expanded='true'] .q1-navigation__group-chevron {
@@ -8202,11 +8254,11 @@ a.q1-navigation__item[aria-disabled='true'] {
 .q1-navigation__group:has(
     > .q1-navigation__group-trigger > .q1-navigation__group-icon,
     > .q1-navigation__group-content > .q1-navigation__item-row > .q1-navigation__item > .q1-navigation__item-icon
-  ) > .q1-navigation__group-trigger,
+  ) > .q1-navigation__group-trigger:not([hidden]),
 .q1-navigation__group:has(
     > .q1-navigation__group-trigger > .q1-navigation__group-icon,
     > .q1-navigation__group-content > .q1-navigation__item-row > .q1-navigation__item > .q1-navigation__item-icon
-  ) > .q1-navigation__group-content > .q1-navigation__item-row > .q1-navigation__item {
+  ) > .q1-navigation__group-content > .q1-navigation__item-row > .q1-navigation__item:not([hidden]) {
   display: grid;
   grid-template-columns: var(--q1-space-4) minmax(0, 1fr) auto;
 }
@@ -8403,9 +8455,29 @@ a.q1-navigation__item[aria-disabled='true'] {
   font-weight: var(--q1-font-weight-semibold);
 }
 
-.q1-context-switcher__trigger .q1-context-switcher__avatar {
-  width: 28px;
-  height: 28px;
+/* 双行图文：媒体对齐首行光学中心，而不是整块几何中心。行内容顶对齐，媒体按
+ (首行行盒 − 媒体尺寸) / 2 上移；尾部 chevron / check / pending 属于控件本身，保持几何居中。 */
+.q1-context-switcher__trigger:has(.q1-context-switcher__description),
+.q1-context-switcher__stacked-header:has(.q1-context-switcher__description),
+.q1-context-switcher__item:has(.q1-context-switcher__description) {
+  align-items: flex-start;
+}
+
+.q1-context-switcher__trigger:has(.q1-context-switcher__description) > .q1-context-switcher__avatar,
+.q1-context-switcher__stacked-header:has(.q1-context-switcher__description) > .q1-context-switcher__avatar,
+.q1-context-switcher__item:has(.q1-context-switcher__description) > .q1-context-switcher__avatar {
+  translate: 0 var(--q1-optical-media-first-line-offset);
+}
+
+.q1-context-switcher__trigger:has(.q1-context-switcher__description) > .q1-context-switcher__chevron,
+.q1-context-switcher__item:has(.q1-context-switcher__description) > :is(.q1-context-switcher__chevron, .q1-context-switcher__check, .q1-context-switcher__pending) {
+  align-self: center;
+}
+
+/* 单行条目的线性图标贴中文标签：与 Navigation 同一口径上移 1px。 */
+.q1-context-switcher__item:not(:has(.q1-context-switcher__description)) > .q1-context-switcher__avatar > svg,
+.q1-context-switcher__action-icon > svg {
+  translate: 0 var(--q1-optical-icon-shift-cjk-label);
 }
 
 .q1-context-switcher__chevron {
@@ -8489,7 +8561,7 @@ a.q1-navigation__item[aria-disabled='true'] {
   padding: var(--q1-space-1);
 }
 
-.q1-context-switcher__popup[role='dialog'] .q1-context-switcher__groups {
+.q1-context-switcher__popup[role='dialog'] .q1-context-switcher__groups:not([hidden]) {
   display: grid;
   overflow-y: hidden;
 }
@@ -8738,7 +8810,7 @@ a.q1-navigation__item[aria-disabled='true'] {
   margin: 0;
 }
 
-.q1-context-switcher__popup.q1-context-switcher__popup--stacked .q1-context-switcher__groups {
+.q1-context-switcher__popup.q1-context-switcher__popup--stacked .q1-context-switcher__groups:not([hidden]) {
   display: block;
   overflow-y: auto;
   padding-block: 0;
@@ -9357,3 +9429,14 @@ a.q1-navigation__item[aria-disabled='true'] {
     color: HighlightText;
   }
 }
+
+/* 原生 hidden 属性守卫（必须留在本文件末尾）。组件规则给容器写 display 时会盖掉 UA 的
+ `[hidden] { display: none }`——两者同为 (0,1,0)，而组件规则后到就赢。这条规则恢复语义：
+ 同特异度且位于全部组件规则之后，因此赢下所有单类组件规则；特异度更高的组件规则改为在自身
+ 主语上写 :not([hidden])，不靠这条兜底。
+ 取舍：本包不发 reset（reset.css 不进包，见 scripts/build-style.mjs），不能用 `!important`
+ 强压消费方，因此选"零外部副作用 + 可被消费方覆盖"的写法——它只把 UA 默认行为还原，对本包不写
+ display 的元素是 no-op。`until-found` 由 :where() 零特异度排除，保持 UA 的可搜索折叠语义。 */
+[hidden]:where(:not([hidden='until-found'])) {
+  display: none;
+}

package/dist-pkg/tokens.css

@@ -180,6 +180,15 @@
   --q1-space-16: 64px;
   --q1-space-24: 96px;
   --q1-control-height-default: 40px;
+  --q1-optical-icon-shift-cjk-label: 0px;
+  --q1-media-size: var(--q1-space-6);
+  --q1-media-first-line-box: var(--q1-line-height-label-13);
+  --q1-optical-media-first-line-offset: calc((var(--q1-media-first-line-box) - var(--q1-media-size)) / 2);
+  --q1-surface-inset-inline: var(--q1-space-4);
+  --q1-table-edge-padding-inline: var(--q1-surface-inset-inline);
+  --q1-button-hang-inline: calc(var(--q1-space-3) + 1px);
+  --q1-badge-optical-shift: 0px;
+  --q1-button-affix-optical-y: 0px;
   --q1-doc-frame-gutter: 60px;
   --q1-doc-frame-max-width: 1220px;
   --q1-doc-sidebar-width: 260px;
@@ -396,6 +405,15 @@
   --q1-space-16: 64px;
   --q1-space-24: 96px;
   --q1-control-height-default: 40px;
+  --q1-optical-icon-shift-cjk-label: 0px;
+  --q1-media-size: var(--q1-space-6);
+  --q1-media-first-line-box: var(--q1-line-height-label-13);
+  --q1-optical-media-first-line-offset: calc((var(--q1-media-first-line-box) - var(--q1-media-size)) / 2);
+  --q1-surface-inset-inline: var(--q1-space-4);
+  --q1-table-edge-padding-inline: var(--q1-surface-inset-inline);
+  --q1-button-hang-inline: calc(var(--q1-space-3) + 1px);
+  --q1-badge-optical-shift: 0px;
+  --q1-button-affix-optical-y: 0px;
   --q1-doc-frame-gutter: 60px;
   --q1-doc-frame-max-width: 1220px;
   --q1-doc-sidebar-width: 260px;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@q1travel/design-system",
-  "version": "0.15.1",
+  "version": "0.15.2",
   "private": false,
   "type": "module",
   "main": "./dist-pkg/design-system.js",
@@ -37,7 +37,7 @@
     "check:shell": "npm run sync:contracts && node scripts/check-shell.mjs && node scripts/check-token-package.mjs && npm run check:release-provenance",
     "check:browser:strictmode": "node scripts/check-browser.mjs --strictmode-ref",
     "check:browser": "npm run check:browser:strictmode && node scripts/check-browser.mjs",
-    "check:package-api": "node scripts/check-package-api.mjs && node --test scripts/check-q1-design-lint.test.mjs && node --test scripts/check-json-view-contract.test.mjs && node --test scripts/check-verification-code-input.test.mjs && node --test scripts/check-controls-contract.test.mjs && node --test scripts/check-pagination-contract.test.mjs && node --test scripts/check-table-core.test.mjs scripts/check-table-interaction.test.mjs scripts/check-table-layout.test.mjs && node --test scripts/check-contrast-contract.test.mjs && node --test scripts/check-overlay-coordination.test.mjs scripts/check-sheet-contract.test.mjs",
+    "check:package-api": "node scripts/check-package-api.mjs && node --test scripts/check-q1-design-lint.test.mjs && node --test scripts/check-json-view-contract.test.mjs && node --test scripts/check-verification-code-input.test.mjs && node --test scripts/check-controls-contract.test.mjs && node --test scripts/check-pagination-contract.test.mjs && node --test scripts/check-table-core.test.mjs scripts/check-table-interaction.test.mjs scripts/check-table-layout.test.mjs && node --test scripts/check-contrast-contract.test.mjs && node --test scripts/check-optical-alignment-contract.test.mjs && node --test scripts/check-overlay-coordination.test.mjs scripts/check-sheet-contract.test.mjs",
     "check:release-provenance": "node --test scripts/check-release-provenance.test.mjs && node scripts/check-release-provenance.mjs",
     "check:release-sync": "node --test scripts/release-npm.test.mjs",
     "release:npm": "node scripts/release-npm.mjs",