feat(ts): 实现 Polaris 可交互首页

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-09-02 23:53:28 +08:00
parent 7eaa9e6f80
commit 9754d61ffe
71 changed files with 15613 additions and 46 deletions
@@ -0,0 +1,89 @@
+import { describe, expect, it } from "vitest"
+
+import categories from "@/data/categories.json"
+import links from "@/data/links.json"
+import settings from "@/data/settings.json"
+import { SEARCH_PROVIDERS } from "@/types/search"
+
+const hasUniqueValues = (values: string[]) =>
+  new Set(values).size === values.length
+
+describe("Polaris 静态数据", () => {
+  it("包含 7 个唯一且结构完整的分类", () => {
+    expect(categories).toHaveLength(7)
+    expect(hasUniqueValues(categories.map(({ id }) => id))).toBe(true)
+
+    for (const category of categories) {
+      expect(category).toEqual({
+        id: expect.any(String),
+        title: expect.any(String),
+        description: expect.any(String),
+        icon: expect.any(String),
+        sort: expect.any(Number),
+      })
+      expect(category.id).not.toBe("")
+      expect(category.title).not.toBe("")
+      expect(Number.isFinite(category.sort)).toBe(true)
+    }
+  })
+
+  it("包含 20 条合法链接且分类引用均存在", () => {
+    const categoryIds = new Set(categories.map(({ id }) => id))
+    expect(links).toHaveLength(20)
+    expect(hasUniqueValues(links.map(({ id }) => id))).toBe(true)
+
+    for (const link of links) {
+      expect(link.id).toEqual(expect.any(String))
+      expect(link.title).toEqual(expect.any(String))
+      expect(link.description).toEqual(expect.any(String))
+      expect(link.url).toEqual(expect.any(String))
+      expect(link.categoryId).toEqual(expect.any(String))
+      expect(link.pinned).toEqual(expect.any(Boolean))
+      expect(link.keywords).toEqual(expect.any(Array))
+      expect(link.sort).toEqual(expect.any(Number))
+      expect(link.id).not.toBe("")
+      expect(link.title).not.toBe("")
+      expect(() => new URL(link.url)).not.toThrow()
+      // 跨分类常用链接仍必须归属于真实分类，避免未来 API 出现悬空外键。
+      expect(categoryIds.has(link.categoryId)).toBe(true)
+      expect(
+        link.keywords.every((keyword) => typeof keyword === "string"),
+      ).toBe(true)
+      expect(Number.isFinite(link.sort)).toBe(true)
+      if (link.icon !== undefined) expect(typeof link.icon).toBe("string")
+      if (!link.pinned) expect(link.pinnedSort).toBeUndefined()
+    }
+  })
+
+  it("8 条常用链接拥有唯一 pinnedSort", () => {
+    const pinned = links.filter(({ pinned }) => pinned)
+    const pinnedSorts = pinned.map(({ pinnedSort }) => pinnedSort)
+
+    expect(pinned).toHaveLength(8)
+    expect(pinnedSorts.every(Number.isFinite)).toBe(true)
+    expect(new Set(pinnedSorts).size).toBe(8)
+  })
+
+  it("设置包含完整且合法的嵌套契约", () => {
+    expect(settings).toEqual({
+      siteName: "Polaris",
+      theme: "light-glass",
+      search: {
+        defaultProvider: "google",
+        enabledProviders: [...SEARCH_PROVIDERS],
+      },
+      background: {
+        type: "gradient",
+        url: null,
+        blur: expect.any(Number),
+        overlay: expect.any(Number),
+      },
+      sidebar: {
+        defaultCollapsed: expect.any(Boolean),
+      },
+    })
+    expect(SEARCH_PROVIDERS).toContain(settings.search.defaultProvider)
+    expect(Number.isFinite(settings.background.blur)).toBe(true)
+    expect(Number.isFinite(settings.background.overlay)).toBe(true)
+  })
+})