/* ==========================================================================
   utilities.css — 原子工具类（仅消费 tokens.css 令牌，R6.1/R6.7）
   ==========================================================================
   低层、单一职责的辅助类，供视图组合使用，避免内联硬编码样式值。
   ========================================================================== */

/* --------------------------------------------------------------------------
   显示与可见性
   -------------------------------------------------------------------------- */
.u-hidden { display: none !important; }
.u-block { display: block !important; }
.u-inline-block { display: inline-block !important; }
.u-flex { display: flex !important; }
.u-inline-flex { display: inline-flex !important; }
.u-grid { display: grid !important; }

/* 屏幕阅读器专用（可访问名称 / 跳过链接），R7.1 */
.u-visually-hidden {
  position: absolute !important;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}

/* --------------------------------------------------------------------------
   Flexbox 布局
   -------------------------------------------------------------------------- */
.u-flex-col { flex-direction: column; }
.u-flex-wrap { flex-wrap: wrap; }
.u-flex-1 { flex: 1 1 0%; }
.u-items-center { align-items: center; }
.u-items-start { align-items: flex-start; }
.u-items-end { align-items: flex-end; }
.u-justify-center { justify-content: center; }
.u-justify-between { justify-content: space-between; }
.u-justify-end { justify-content: flex-end; }

/* 间隙（gap）— 间距令牌 */
.u-gap-1 { gap: var(--sp-1); }
.u-gap-2 { gap: var(--sp-2); }
.u-gap-3 { gap: var(--sp-3); }
.u-gap-4 { gap: var(--sp-4); }
.u-gap-5 { gap: var(--sp-5); }
.u-gap-6 { gap: var(--sp-6); }

/* --------------------------------------------------------------------------
   外边距 / 内边距（间距令牌）
   -------------------------------------------------------------------------- */
.u-m-0 { margin: 0; }
.u-mt-1 { margin-top: var(--sp-1); }
.u-mt-2 { margin-top: var(--sp-2); }
.u-mt-3 { margin-top: var(--sp-3); }
.u-mt-4 { margin-top: var(--sp-4); }
.u-mt-6 { margin-top: var(--sp-6); }
.u-mb-1 { margin-bottom: var(--sp-1); }
.u-mb-2 { margin-bottom: var(--sp-2); }
.u-mb-3 { margin-bottom: var(--sp-3); }
.u-mb-4 { margin-bottom: var(--sp-4); }
.u-mb-6 { margin-bottom: var(--sp-6); }

.u-p-0 { padding: 0; }
.u-p-2 { padding: var(--sp-2); }
.u-p-3 { padding: var(--sp-3); }
.u-p-4 { padding: var(--sp-4); }
.u-p-6 { padding: var(--sp-6); }

/* --------------------------------------------------------------------------
   排版工具
   -------------------------------------------------------------------------- */
.u-text-xs { font-size: var(--fs-xs); }
.u-text-sm { font-size: var(--fs-sm); }
.u-text-base { font-size: var(--fs-base); }
.u-text-md { font-size: var(--fs-md); }
.u-text-lg { font-size: var(--fs-lg); }
.u-text-xl { font-size: var(--fs-xl); }
.u-text-2xl { font-size: var(--fs-2xl); }

.u-fw-normal { font-weight: var(--fw-normal); }
.u-fw-medium { font-weight: var(--fw-medium); }
.u-fw-semibold { font-weight: var(--fw-semibold); }
.u-fw-bold { font-weight: var(--fw-bold); }

.u-text-center { text-align: center; }
.u-text-right { text-align: right; }
.u-truncate {
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}
.u-mono { font-family: var(--font-mono); }

/* 文本颜色（均为登记的前景令牌，对背景满足 ≥ 4.5/3:1） */
.u-fg-default { color: var(--fg-default); }
.u-fg-muted { color: var(--fg-muted); }
.u-fg-subtle { color: var(--fg-subtle); }
.u-fg-success { color: var(--success); }
.u-fg-warning { color: var(--warning); }
.u-fg-danger { color: var(--danger); }
.u-fg-info { color: var(--info); }
.u-fg-accent { color: var(--accent); }

/* --------------------------------------------------------------------------
   背景 / 圆角 / 阴影工具
   -------------------------------------------------------------------------- */
.u-bg-base { background-color: var(--bg-base); }
.u-bg-surface { background-color: var(--bg-surface); }
.u-bg-raised { background-color: var(--bg-raised); }

.u-rounded-sm { border-radius: var(--radius-sm); }
.u-rounded-md { border-radius: var(--radius-md); }
.u-rounded-lg { border-radius: var(--radius-lg); }
.u-rounded-full { border-radius: var(--radius-full); }

.u-shadow-1 { box-shadow: var(--shadow-1); }
.u-shadow-2 { box-shadow: var(--shadow-2); }
.u-shadow-3 { box-shadow: var(--shadow-3); }

.u-border { border: 1px solid var(--border); }
.u-border-subtle { border: 1px solid var(--border-subtle); }
.u-border-top { border-top: 1px solid var(--border-subtle); }
.u-border-bottom { border-bottom: 1px solid var(--border-subtle); }

/* --------------------------------------------------------------------------
   尺寸 / 溢出
   -------------------------------------------------------------------------- */
.u-w-full { width: 100%; }
.u-h-full { height: 100%; }
.u-overflow-auto { overflow: auto; }
.u-overflow-hidden { overflow: hidden; }

/* --------------------------------------------------------------------------
   交互辅助
   -------------------------------------------------------------------------- */
.u-pointer { cursor: pointer; }
.u-not-allowed { cursor: not-allowed; }
.u-select-none { user-select: none; }