@linhey/rhine-design 0.11.1 → 0.11.2

package/tests/SkillInstallation.test.tsx

@@ -0,0 +1,77 @@
+import { cpSync, existsSync, mkdtempSync, readFileSync, readdirSync, realpathSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
+import { afterEach, describe, expect, it } from 'vitest';
+
+const source = resolve(process.env.RHINE_SKILL_SOURCE ?? 'skills/rhine-design');
+const sandboxes: string[] = [];
+
+afterEach(() => {
+  for (const sandbox of sandboxes.splice(0)) rmSync(sandbox, { recursive: true, force: true });
+});
+
+function install(fromPackage: boolean) {
+  const sandbox = mkdtempSync(join(tmpdir(), 'rhine-skill-'));
+  sandboxes.push(sandbox);
+  const target = join(sandbox, fromPackage ? '.agents/skills/rhine-design' : 'skills/rhine-design');
+  if (fromPackage) {
+    const packaged = join(sandbox, 'node_modules/@linhey/rhine-design/skills/rhine-design');
+    cpSync(source, packaged, { recursive: true });
+    // Same source and destination layout as the README's cp -R command.
+    cpSync(packaged, target, { recursive: true });
+  } else {
+    // Only the skill directory is available: no adjacent repository docs.
+    cpSync(source, target, { recursive: true });
+  }
+  return target;
+}
+
+function checkLinks(root: string) {
+  let localLinks = 0;
+  for (const file of readdirSync(root, { recursive: true, encoding: 'utf8' }).filter(file => file.endsWith('.md'))) {
+    const document = join(root, file);
+    const markdown = readFileSync(document, 'utf8');
+    // The skill uses inline Markdown links; code-formatted package paths are not links.
+    for (const [, href] of markdown.matchAll(/\[[^\]]*\]\(([^\s)]+)\)/g)) {
+      if (/^https?:\/\//.test(href)) {
+        const url = new URL(href);
+        if (url.hostname === 'github.com' && /^\/linhay\/rhine-design\/(blob|tree)\//.test(url.pathname)) {
+          const revision = url.pathname.split('/')[4];
+          if (!/^(?:[a-f0-9]{40}|v?\d+\.\d+\.\d+)$/.test(revision)) throw new Error(`Floating source link: ${href}`);
+        }
+        continue;
+      }
+      const [path, fragment] = href.split('#');
+      const target = path ? resolve(dirname(document), decodeURIComponent(path)) : document;
+      const within = relative(root, target);
+      if (isAbsolute(within) || within === '..' || within.startsWith('../')) throw new Error(`Link escapes skill: ${href}`);
+      if (!existsSync(target)) throw new Error(`Missing link target: ${href}`);
+      const realWithin = relative(realpathSync(root), realpathSync(target));
+      if (isAbsolute(realWithin) || realWithin === '..' || realWithin.startsWith('../')) throw new Error(`Link escapes skill: ${href}`);
+      if (fragment) {
+        const headings = [...readFileSync(target, 'utf8').matchAll(/^#{1,6}\s+(.+)$/gm)]
+          .map(([, heading]) => heading.toLowerCase().replace(/[^\p{L}\p{N}_\-\s]/gu, '').replace(/\s/g, '-'));
+        if (!headings.includes(decodeURIComponent(fragment))) throw new Error(`Missing heading: ${href}`);
+      }
+      localLinks++;
+    }
+  }
+  return localLinks;
+}
+
+describe('portable skill installation', () => {
+  it.each([true, false])('keeps links reachable outside the repository (package copy: %s)', fromPackage => {
+    expect(checkLinks(install(fromPackage))).toBeGreaterThan(0);
+  });
+
+  it.each([
+    ['../../../docs/THEMING.md', 'Link escapes skill'],
+    ['missing.md', 'Missing link target'],
+    ['../SKILL.md#missing-heading', 'Missing heading'],
+    ['https://github.com/linhay/rhine-design/blob/main/docs/THEMING.md', 'Floating source link'],
+  ])('rejects an invalid installed reference: %s', (href, error) => {
+    const root = install(false);
+    writeFileSync(join(root, 'references/regression.md'), `[contract](${href})\n`);
+    expect(() => checkLinks(root)).toThrow(error);
+  });
+});

package/tests/TrayUsage.test.tsx

@@ -0,0 +1,70 @@
+import { act, fireEvent, render, screen, within } from '@testing-library/react';
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { Button, Popover } from '../components';
+import { ThemeProvider } from '../components/theme';
+import { TrayUsageGallery } from '../preview/TrayUsageGallery';
+
+afterEach(() => vi.useRealTimers());
+function demo() { return render(<ThemeProvider><TrayUsageGallery /></ThemeProvider>); }
+const account = () => screen.getByRole('combobox', { name: 'Agent A 当前账号' });
+const panel = () => screen.getByRole('dialog', { name: '账号与用量概览' });
+
+describe('headerless Popover and synthetic usage host', () => {
+  it('preserves the accessible name and default header compatibility', () => {
+    const { rerender } = render(<ThemeProvider><Popover title="详情名称" trigger={<Button>详情</Button>} open>内容</Popover></ThemeProvider>);
+    expect(screen.getByRole('button', { name: '关闭详情' })).toBeVisible();
+    rerender(<ThemeProvider><Popover title="详情名称" showHeader={false} trigger={<Button>详情</Button>} open>内容</Popover></ThemeProvider>);
+    expect(screen.getByRole('dialog', { name: '详情名称' })).toBeVisible();
+    expect(screen.queryByRole('button', { name: '关闭详情' })).toBeNull();
+    expect(screen.queryByText('详情名称')).toBeNull();
+  });
+  it('keeps committed account and unrelated data while pending, locks duplicates, and retries a failure', () => {
+    demo(); vi.useFakeTimers();
+    fireEvent.click(screen.getByLabelText('首次切换失败'));
+    const other = screen.getByTestId('other-agent').textContent, summary = screen.getByTestId('usage-summary').textContent;
+    fireEvent.change(account(), { target: { value: 'b' } });
+    fireEvent.change(account(), { target: { value: 'b' } });
+    expect(account()).toBeDisabled(); expect(account()).toHaveValue('a');
+    expect(screen.getByTestId('current-account')).toHaveTextContent('研究账号 A');
+    expect(screen.getByTestId('request-count')).toHaveTextContent('1');
+    act(() => vi.advanceTimersByTime(1200));
+    expect(account()).toHaveValue('a'); expect(account()).not.toBeDisabled();
+    expect(within(panel()).getByRole('alert')).toHaveTextContent('切换失败');
+    fireEvent.click(screen.getByRole('button', { name: '重试切换' }));
+    act(() => vi.advanceTimersByTime(1200));
+    expect(account()).toHaveValue('b');
+    expect(screen.getByTestId('request-count')).toHaveTextContent('2');
+    expect(screen.getByTestId('other-agent').textContent).toBe(other);
+    expect(screen.getByTestId('usage-summary').textContent).toBe(summary);
+  });
+  it('blocks unavailable directories and cancels a late result on logout/reset', () => {
+    demo(); vi.useFakeTimers();
+    for (const state of ['loading', 'stale', 'connecting', 'unmatched']) {
+      fireEvent.change(screen.getByLabelText('用量场景'), { target: { value: state } });
+      expect(account()).toBeDisabled();
+      fireEvent.change(account(), { target: { value: 'b' } });
+      expect(screen.getByTestId('request-count')).toHaveTextContent('0');
+    }
+    fireEvent.change(screen.getByLabelText('用量场景'), { target: { value: 'normal' } });
+    fireEvent.change(account(), { target: { value: 'b' } });
+    fireEvent.change(screen.getByLabelText('用量场景'), { target: { value: 'signed-out' } });
+    act(() => vi.advanceTimersByTime(1200));
+    expect(within(panel()).queryByText(/研究账号|协作账号|1.28|128/)).toBeNull();
+    expect(screen.queryByTestId('usage-summary')).toBeNull();
+    fireEvent.click(screen.getByRole('button', { name: '重置托盘示例' }));
+    expect(account()).toHaveValue('a');
+    fireEvent.change(account(), { target: { value: 'b' } });
+    fireEvent.click(screen.getByRole('button', { name: '重置托盘示例' }));
+    act(() => vi.advanceTimersByTime(1200));
+    expect(account()).toHaveValue('a'); expect(screen.getByTestId('request-count')).toHaveTextContent('0');
+  });
+  it('keeps unknown quota distinct from zero and stale cache explicitly marked', () => {
+    demo();
+    fireEvent.change(screen.getByLabelText('用量场景'), { target: { value: 'unknown' } });
+    expect(within(panel()).getByText('未知')).toBeVisible();
+    expect(within(panel()).queryByRole('progressbar')).toBeNull();
+    fireEvent.change(screen.getByLabelText('用量场景'), { target: { value: 'stale' } });
+    expect(within(panel()).getByText('上次数据 · 目录已过期')).toBeVisible();
+    expect(screen.getByTestId('usage-summary')).toHaveTextContent('上次更新');
+  });
+});