Skip to content

armgit / peach

Public Imported from GitHub
0

Peach: Local-first video metadata scraper and media manager.

6.4 KB
Raw Blame
/* Board 的卡面。只有这一份出处。
 *
 * 旧样式表里的卡分两族,按页各有各的基线,不能一律画成同一种:
 *
 * - **填充**:`background:var(--ground);border:0`,圆角 16px(图表卡 20px),底下压一层
 *   1px 接触阴影。读数卡 `.metricstrip>button`、口味读数 `.tastesummary`、面板
 *   `.insightpanel`、分区 `.followmanage .fmain>.fsec`、图表卡 `.board-radial-card` 都是这一族。
 *   `--ground` 接的就是 `--color-background-secondary-default`(`web/board.css` 的 `:root`
 *   映射),阴影取上游同一用途的 `--shadow-card`(「1px contact shadow used on white cards
 *   sitting on the secondary background」)。
 * - **描边**:`border:1px solid var(--line-soft);background:var(--color-background-primary-default)`,
 *   复核页的 `body[data-surface="/review"] .reviewitem` 是这一族——卡浮在页面底上,靠一条
 *   发丝线收边,不靠换底色。
 *
 * 旧样式表里还有一批「填充再加一条描边」(活动页 `.cleanupfieldset`、高清版 `.qualityitem`)。
 * 直接摆在页面上的卡已统一成不描边:深色主题下那条线比填充亮得多,同一页里一半卡有框、
 * 一半没有。描边只留给底色和所在表面分不开的卡(白卡压在灰卡里、嵌在卡里的代码块),
 * 是填充之上的一档可选项(`bordered`),不是填充的对立面。
 *
 * 迁移时每页各拼一串 `rounded-2xl border border-separator-border`,同一种卡片在十个文件里
 * 长出二十种描边空心壳,页面整体掉了一层底色——卡面收在这里就是为了不再发生这件事。 */

/** 圆角:读数卡、面板、分区都是 16px;图表卡大一档 20px,和旧 `.board-radial-card` 一致;
 *  描边卡是 Board 那档不浮起的表面 `--surface-radius`(14px),`outlined` 默认取它。 */
export type CardRadius = 'default' | 'chart' | 'surface' | 'plain';

/** 内边距:`none` 交给卡内自己的头、体、脚各自排;`default` 是旧图表卡与面板体的 20px。 */
export type CardPadding = 'none' | 'default';

/** 卡面本身。哪一档由那一页的基线 CSS 说了算,不由「看起来更好」说了算。
 *
 *  - `filled`:`--ground` 填充、无描边。Board 管理区的主力卡。
 *  - `outlined`:`--color-background-primary-default` 底加一条 `--line-soft`。复核页的条目卡。
 *  - `raised`:primary 底、无描边。卡上再浮一层(关注管理里按作者分组的那张卡)。 */
export type CardVariant = 'filled' | 'outlined' | 'raised';

export type CardOptions = {
  variant?: CardVariant;
  radius?: CardRadius;
  padding?: CardPadding;
  /** 卡片本身可点(读数卡兼页签、来源卡):补悬停填充、焦点环与光标。 */
  interactive?: boolean;
  /** 卡片带互斥选中态:选中时换成浮层那一档面、收掉接触阴影,最上层压一圈 2px 的焦点环色描边。 */
  selectable?: boolean;
  /** 填充之上另加的那条描边,只给底色和所在表面分不开的卡:灰卡里的白卡用 `--line`,
   *  嵌在卡里的代码块与错误摘录用 `--line-soft`。`outlined` 自带描边,不必再给。
   *  `error` 是失败的那一轮:整张卡的框线换成 danger 色,不给卡里的字上色。它画成内收的
   *  outline,不占盒子:同一列里失败卡与正常卡的内容起点要对齐,真 border 会把内容挤进 1px。 */
  bordered?: 'line' | 'soft' | 'error';
  className?: string;
};

const FACE = 'min-w-0';

const VARIANT: Record<CardVariant, string> = {
  filled: 'bg-background-secondary-default',
  outlined: 'border border-separator-border bg-background-primary-default',
  raised: 'bg-background-primary-default',
};

/* 圆角与阴影是一件事:旧样式表里有阴影的只有读数卡那一档(`0 1px 2px #00000008`),
 * 图表卡 `.board-radial-card` / `.board-heat-card` / `.board-sankey-card` 都是净面。 */
const RADIUS: Record<CardRadius, string> = {
  default: 'rounded-2xl shadow-card',
  chart: 'rounded-2-5xl',
  surface: 'rounded-surface',
  /* 数据管理那一排净面读数卡(旧 `.board-plain-stat`):同样 16px,但不压接触阴影。 */
  plain: 'rounded-2xl',
};

const BORDER = {
  line: 'border border-border-button-default',
  soft: 'border border-separator-border',
  error: 'outline-1 -outline-offset-1 outline-border-error-default',
};

const PADDING: Record<CardPadding, string> = {
  none: '',
  default: 'p-5',
};

/* 悬停只抬填充,选中时不抬:旧规则里选中态那条排在悬停后面,压着它。工具类的先后由
 * Tailwind 自己排,不是写的顺序,所以把「没选中」写进变体里,不指望顺序。 */
const INTERACTIVE = 'cursor-pointer outline-none not-data-selected:hover:bg-card-hover'
  + ' focus-visible:ring-2 focus-visible:ring-border-focus-ring focus-visible:ring-offset-3';

/* 选中的那一圈画在 `::after` 上、压在最上层,不用 inset 的 box-shadow:内阴影画在子元素底下,
 * 读数卡的脚注带一铺底色,环的下半截就被盖掉,只剩上面三边。旧
 * `.metricstrip>button[aria-selected=true]::after` 就是一层 2px 描边的覆盖层,圆角跟卡走。 */
const SELECTABLE = 'relative data-selected:bg-background-primary-default data-selected:shadow-none'
  + ' data-selected:after:pointer-events-none data-selected:after:absolute data-selected:after:inset-0'
  + ' data-selected:after:z-1 data-selected:after:rounded-[inherit]'
  + ' data-selected:after:border-2 data-selected:after:border-border-focus-ring';

/** 卡面的类名。宿主可能是 `section`、`li`、React Aria 的 `Tab` 或 `Modal`,所以只给类名。 */
export function cardClass(options: CardOptions = {}) {
  const {
    variant = 'filled', padding = 'default', interactive, selectable, bordered, className,
  } = options;
  /* 圆角跟着变体走:填充那一族是 16px 加一层接触阴影,描边那一族是 14px 的净面。
     旧样式表里这两件事本来就绑在一起,拆开写只会让调用方每次都要记住配哪一个。 */
  const radius = options.radius ?? (variant === 'outlined' ? 'surface' : 'default');
  return [
    FACE,
    VARIANT[variant],
    RADIUS[radius],
    PADDING[padding],
    bordered ? BORDER[bordered] : '',
    interactive ? INTERACTIVE : '',
    selectable ? SELECTABLE : '',
    className ?? '',
  ].filter(Boolean).join(' ');
}