@dsh-workbench/shared 0.1.0

package/src/lib/ui.test.ts

@@ -0,0 +1,93 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import {
+  cx,
+  parseLocalTimestamp,
+  relativeTime,
+  shortenPath,
+  type TimeTranslate,
+} from './ui';
+
+const t: TimeTranslate = (key, params) =>
+  params === undefined ? key : `${key}:${String(params.n ?? '')}`;
+
+const NOW = Date.parse('2026-09-27T12:00:00.000Z');
+
+describe('cx', () => {
+  it('拼上真值、丢掉假值', () => {
+    expect(cx('a', false, undefined, null, '', 'b')).toBe('a b');
+  });
+
+  it('全假值给空串', () => {
+    expect(cx(false, undefined)).toBe('');
+  });
+});
+
+describe('relativeTime', () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+    vi.setSystemTime(NOW);
+  });
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
+  it('按档位取词：刚刚 / 分钟 / 小时 / 天', () => {
+    expect(relativeTime(NOW - 30_000, t)).toBe('time.now');
+    expect(relativeTime(NOW - 3 * 60_000, t)).toBe('time.minutes:3');
+    expect(relativeTime(NOW - 5 * 60 * 60_000, t)).toBe('time.hours:5');
+    expect(relativeTime(NOW - 3 * 24 * 60 * 60_000, t)).toBe('time.days:3');
+  });
+
+  it('档位边界落在正确的一侧', () => {
+    expect(relativeTime(NOW - (60 * 60_000 - 1), t)).toBe('time.minutes:59');
+    expect(relativeTime(NOW - 60 * 60_000, t)).toBe('time.hours:1');
+    expect(relativeTime(NOW - 6 * 24 * 60 * 60_000, t)).toBe('time.days:6');
+    expect(relativeTime(NOW - 7 * 24 * 60 * 60_000, t)).not.toContain('time.');
+  });
+
+  it('非法时间戳给空串而不是 NaN', () => {
+    expect(relativeTime(Number.NaN, t)).toBe('');
+    expect(relativeTime(Number.POSITIVE_INFINITY, t)).toBe('');
+  });
+});
+
+describe('shortenPath', () => {
+  it('把用户主目录缩成 ~', () => {
+    expect(shortenPath('/Users/you/dev/app')).toBe('~/dev/app');
+  });
+
+  it('非用户目录原样返回', () => {
+    expect(shortenPath('/Volumes/dev/app')).toBe('/Volumes/dev/app');
+  });
+
+  it('非字符串给空串', () => {
+    expect(shortenPath(undefined)).toBe('');
+    expect(shortenPath(42)).toBe('');
+  });
+});
+
+describe('parseLocalTimestamp', () => {
+  it('按本地时区解析 Coding 的时间戳形态', () => {
+    const parsed = parseLocalTimestamp('2026-09-27 08:18:36');
+    expect(Number.isFinite(parsed)).toBe(true);
+    expect(parsed).toBe(new Date('2026-09-27T08:18:36').getTime());
+  });
+
+  it('也接受 ISO 的 T 分隔写法', () => {
+    expect(parseLocalTimestamp('2026-09-27T08:18:36')).toBe(
+      new Date('2026-09-27T08:18:36').getTime(),
+    );
+  });
+
+  it('形态不认识给 NaN（调用方回退到原始字符串，宁可不换算也不显示错时间）', () => {
+    for (const raw of ['', '  ', null, undefined, '2026-09-27', '2026/09/27 08:18:36', 'abc']) {
+      expect(Number.isNaN(parseLocalTimestamp(raw)), String(raw)).toBe(true);
+    }
+  });
+
+  it('容忍首尾空白', () => {
+    expect(parseLocalTimestamp('  2026-09-27 08:18:36  ')).toBe(
+      new Date('2026-09-27T08:18:36').getTime(),
+    );
+  });
+});

package/src/lib/ui.ts

@@ -0,0 +1,38 @@
+export function cx(...parts: Array<string | false | null | undefined>): string {
+  return parts.filter(Boolean).join(' ');
+}
+
+const MINUTE = 60 * 1000;
+
+export type TimeTranslate = (key: string, params?: Record<string, unknown>) => string;
+
+export function relativeTime(epochMs: number, t: TimeTranslate): string {
+  if (!Number.isFinite(epochMs)) return '';
+  const diff = Date.now() - epochMs;
+  if (diff < MINUTE) return t('time.now');
+  if (diff < 60 * MINUTE) return t('time.minutes', { n: Math.floor(diff / MINUTE) });
+  if (diff < 24 * 60 * MINUTE) return t('time.hours', { n: Math.floor(diff / (60 * MINUTE)) });
+  if (diff < 7 * 24 * 60 * MINUTE) return t('time.days', { n: Math.floor(diff / (24 * 60 * MINUTE)) });
+  return new Date(epochMs).toLocaleDateString();
+}
+
+export function shortenPath(path: unknown): string {
+  if (typeof path !== 'string') return '';
+  const hit = path.match(/^\/Users\/[^/]+/);
+  return hit === null ? path : path.replace(hit[0], '~');
+}
+
+export const LINK_BUTTON_STYLE = {
+  display: 'inline-flex',
+  alignItems: 'center',
+  gap: 'var(--wb-gap-xs)',
+  textDecoration: 'none',
+} as const;
+
+const LOCAL_TIMESTAMP = /^(\d{4})-(\d{2})-(\d{2})[ T](\d{2}):(\d{2}):(\d{2})$/;
+
+export function parseLocalTimestamp(text: string | null | undefined): number {
+  const raw = String(text ?? '').trim();
+  if (!LOCAL_TIMESTAMP.test(raw)) return Number.NaN;
+  return new Date(raw.replace(' ', 'T')).getTime();
+}