@allbluecn/web-app 0.5.0 → 0.6.0

package/src/components/story/views/story-list/__tests__/group-header.test.tsx

@@ -0,0 +1,219 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+// AllBlue - 理想之海
+// Copyright (C) 2026 AllBlue Contributors
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Affero General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+// GNU Affero General Public License for more details.
+//
+// You should have received a copy of the GNU Affero General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { render, screen, fireEvent, waitFor } from "@testing-library/react";
+import { TooltipProvider } from "@/components/ui/tooltip";
+import { VirtualGroupHeader, GroupTailRow } from "../group";
+import { FileText } from "lucide-react";
+
+const renderWithProviders = (ui: React.ReactElement) =>
+  render(<TooltipProvider>{ui}</TooltipProvider>);
+
+vi.mock("react-i18next", () => ({
+  useTranslation: () => ({ t: (key: string) => key }),
+}));
+
+vi.mock("../inline-story-creator", () => ({
+  InlineStoryCreator: ({ onSubmit }: any) => (
+    <button onClick={onSubmit} data-testid="inline-creator">inline-create</button>
+  ),
+}));
+
+const makeNode = (over?: any) => ({
+  key: "todo",
+  label: "待办",
+  color: "text-blue-500",
+  icon: FileText,
+  totalCount: 3,
+  items: [{ id: "s1" }],
+  subGroups: [],
+  ...over,
+});
+
+const baseHeaderProps = {
+  node: makeNode(),
+  depth: 0,
+  collapsed: false,
+  collapseKey: "todo",
+  onToggle: vi.fn(),
+  selectState: false,
+  onToggleSelect: vi.fn(),
+  showSelect: false,
+  showRoleLabel: false,
+};
+
+describe("VirtualGroupHeader", () => {
+  beforeEach(() => vi.clearAllMocks());
+
+  it("基础渲染时 node.label 文本可见", () => {
+    renderWithProviders(<VirtualGroupHeader {...baseHeaderProps} />);
+    expect(screen.getByText("待办")).toBeTruthy();
+  });
+
+  it("collapsed=true 时显示 ChevronRight 图标", () => {
+    renderWithProviders(<VirtualGroupHeader {...baseHeaderProps} collapsed />);
+    const paths = document.querySelectorAll("svg path");
+    expect(Array.from(paths).some((p) => p.getAttribute("d") === "m9 18 6-6-6-6")).toBe(true);
+    expect(Array.from(paths).some((p) => p.getAttribute("d") === "m6 9 6 6 6-6")).toBe(false);
+  });
+
+  it("collapsed=false 时显示 ChevronDown 图标", () => {
+    renderWithProviders(<VirtualGroupHeader {...baseHeaderProps} collapsed={false} />);
+    const paths = document.querySelectorAll("svg path");
+    expect(Array.from(paths).some((p) => p.getAttribute("d") === "m6 9 6 6 6-6")).toBe(true);
+    expect(Array.from(paths).some((p) => p.getAttribute("d") === "m9 18 6-6-6-6")).toBe(false);
+  });
+
+  it("showSelect=true 时渲染 Checkbox", () => {
+    renderWithProviders(
+      <VirtualGroupHeader {...baseHeaderProps} showSelect selectState={false} />,
+    );
+    const checkbox = screen.getByRole("checkbox", {
+      name: /group.selectAll/i,
+    });
+    expect(checkbox).toBeTruthy();
+  });
+
+  it("showRoleLabel=true + groupDimension=assignee 时显示 roleLabel", () => {
+    renderWithProviders(
+      <VirtualGroupHeader
+        {...baseHeaderProps}
+        showRoleLabel
+        groupDimension="assignee"
+      />,
+    );
+    expect(screen.getByText("group.assignee")).toBeTruthy();
+  });
+
+  it("showRoleLabel=true + groupDimension=createdBy 时显示 roleLabel", () => {
+    renderWithProviders(
+      <VirtualGroupHeader
+        {...baseHeaderProps}
+        showRoleLabel
+        groupDimension="createdBy"
+      />,
+    );
+    expect(screen.getByText("group.createdBy")).toBeTruthy();
+  });
+
+  it("showRoleLabel=true 但 groupDimension 不匹配时不显示 roleLabel", () => {
+    renderWithProviders(
+      <VirtualGroupHeader
+        {...baseHeaderProps}
+        showRoleLabel
+        groupDimension="state"
+      />,
+    );
+    expect(screen.queryByText("group.assignee")).toBeFalsy();
+    expect(screen.queryByText("group.createdBy")).toBeFalsy();
+  });
+
+  it("depth=0 + onCreate 存在时渲染 Plus 按钮", () => {
+    const onCreate = vi.fn();
+    renderWithProviders(
+      <VirtualGroupHeader {...baseHeaderProps} depth={0} onCreate={onCreate} />,
+    );
+    fireEvent.click(screen.getByLabelText(/group.addTo/i));
+    expect(onCreate).toHaveBeenCalledTimes(1);
+  });
+
+  it("depth>0 时不渲染 Plus 按钮", () => {
+    const onCreate = vi.fn();
+    renderWithProviders(
+      <VirtualGroupHeader
+        {...baseHeaderProps}
+        depth={1}
+        onCreate={onCreate}
+      />,
+    );
+    expect(screen.queryByLabelText(/group.addTo/i)).toBeFalsy();
+  });
+
+  it("onToggle 点击时传递正确的 collapseKey", () => {
+    const onToggle = vi.fn();
+    renderWithProviders(
+      <VirtualGroupHeader
+        {...baseHeaderProps}
+        collapseKey="custom-key"
+        onToggle={onToggle}
+      />,
+    );
+    fireEvent.click(screen.getByText("待办").parentElement!);
+    expect(onToggle).toHaveBeenCalledWith("custom-key");
+  });
+
+  it("display totalCount 时显示总数", () => {
+    renderWithProviders(<VirtualGroupHeader {...baseHeaderProps} />);
+    expect(screen.getByText("3")).toBeTruthy();
+  });
+});
+
+describe("GroupTailRow", () => {
+  beforeEach(() => vi.clearAllMocks());
+
+  const baseTailProps = {
+    rowKey: "row-1",
+    hasMore: false,
+    loading: false,
+    groupBy: "state",
+    subGroupBy: "priority",
+    groupKey: "todo",
+    setTailHeight: vi.fn(),
+  };
+
+  it("hasMore=false 时只显示「新建需求」按钮", () => {
+    renderWithProviders(<GroupTailRow {...baseTailProps} hasMore={false} />);
+    expect(screen.getByText("group.add")).toBeTruthy();
+    expect(screen.queryByText("group.loadMore")).toBeFalsy();
+  });
+
+  it("hasMore=true 时显示「加载更多」按钮 +「新建需求」按钮", () => {
+    renderWithProviders(<GroupTailRow {...baseTailProps} hasMore={true} />);
+    expect(screen.getByText("group.loadMore")).toBeTruthy();
+    expect(screen.getByText("group.add")).toBeTruthy();
+  });
+
+  it("loading=true 时「加载更多」按钮 disabled", () => {
+    renderWithProviders(<GroupTailRow {...baseTailProps} hasMore={true} loading />);
+    const loadMoreBtn = screen.getByText("group.loading")
+      .closest("button")!;
+    expect(loadMoreBtn).toBeDisabled();
+  });
+
+  it("showEditor 初始状态不渲染 InlineStoryCreator", async () => {
+    renderWithProviders(<GroupTailRow {...baseTailProps} />);
+    await waitFor(() => {
+      expect(screen.queryByTestId("inline-creator")).toBeFalsy();
+    });
+  });
+
+  it("点击「新建需求」按钮后渲染 InlineStoryCreator", () => {
+    renderWithProviders(<GroupTailRow {...baseTailProps} />);
+    fireEvent.click(screen.getByText("group.add"));
+    expect(screen.getByTestId("inline-creator")).toBeTruthy();
+  });
+
+  it("点击「加载更多」按钮触发 onLoadMore", () => {
+    const onLoadMore = vi.fn();
+    renderWithProviders(
+      <GroupTailRow {...baseTailProps} hasMore={true} onLoadMore={onLoadMore} />,
+    );
+    fireEvent.click(screen.getByText("group.loadMore"));
+    expect(onLoadMore).toHaveBeenCalledTimes(1);
+  });
+});

package/src/components/story/views/story-list/group.tsx

@@ -72,7 +72,7 @@ export const VirtualGroupHeader = memo(function VirtualGroupHeader({ node, depth
       <button
         type="button"
         onClick={() => onToggle(collapseKey)}
-        className="flex h-full flex-1 items-center gap-2 px-2 text-sm font-medium hover:brightness-95"
+        className="flex h-full flex-1 select-none items-center gap-2 px-2 text-sm font-medium hover:brightness-95"
       >
         <span className="flex items-center gap-1.5">
           {Icon && <Icon className={cn(iconSize, textColor)} />}

package/src/components/story/views/story-list/inline-story-creator.tsx

@@ -18,7 +18,7 @@
 import { memo, useEffect, useRef, useMemo } from "react";
 import { useTranslation } from "react-i18next";
 import { Loader2, CalendarCheck, CalendarPlus2, Check, X, Trees } from "lucide-react";
-import { ProjectIconDisplay } from "@/components/project/project-icon";
+import { LucideIconByName } from "@/components/shared/lucide-icon-picker/lucide-icon-by-name";
 import type { UserBrief } from "../../types";
 import type { StoryState, StoryPriority } from "../../constants";
 import { PriorityEditor, StateEditor, AssigneeEditor, DateEditor, LabelsEditor } from "../../inline-editors";
@@ -65,7 +65,7 @@ export const InlineStoryCreator = memo(function InlineStoryCreator({ name, setNa
     <div className="flex h-14 items-center gap-2 border-b border-border/40 bg-card px-6">
       {projectContext ? (
         <div className="flex items-center gap-2 shrink-0 text-xs text-muted-foreground">
-          <ProjectIconDisplay name={projectContext.icon} size={14} />
+          <LucideIconByName name={projectContext.icon} size={14} />
           <span className="font-mono">{projectContext.displayId}</span>
         </div>
       ) : (

package/src/components/story/views/story-list/row.tsx

@@ -125,7 +125,7 @@ export const StoryListRow = memo(function StoryListRow({ story, group, indent, i
         <DateEditor value={story.targetDate} onChange={setTargetDate} label={t("row.dueDate")} icon={CalendarCheck} overdue={overdue} />
       )}
       {properties.includes("labels") && (
-        <LabelsEditor labelIds={currentLabelIds} labels={labels} onChange={setLabels} variant="button" />
+        <LabelsEditor labelIds={currentLabelIds} labels={labels} onChange={setLabels} variant="button" aiContext={{ name: () => story.name }} />
       )}
     </div>
   );

package/src/components/workspace/create-workspace-dialog.tsx

@@ -21,17 +21,14 @@ import { useForm } from "@tanstack/react-form";
 import { Link, useRouter } from "@tanstack/react-router";
 import { Button } from "@/components/ui/button";
 import { Input } from "@/components/ui/input";
-import { Textarea } from "@/components/ui/textarea";
 import {
   Dialog,
   DialogContent,
-  DialogDescription,
   DialogFooter,
   DialogHeader,
   DialogTitle,
 } from "@/components/ui/dialog";
-import { IconPicker } from "@/components/shared/icon-picker";
-import { PROJECT_ICONS } from "@/components/shared/icon-packs/project";
+import { LucideIconPicker } from "@/components/shared/lucide-icon-picker";
 import { createWorkspaceFn } from "@/server/serverFns/workspace";
 import { createWorkspaceSchema, type CreateWorkspaceValues } from "./schemas/create-workspace";
 
@@ -56,7 +53,7 @@ export function CreateWorkspaceDialog({
     defaultValues: {
       name: "",
       description: "",
-      icon: "folder-kanban",
+      icon: "",
     },
     validators: [{ run: createWorkspaceSchema as any, triggers: ['change'] }],
   });
@@ -98,7 +95,7 @@ export function CreateWorkspaceDialog({
 
   const handleOpenChange = (newOpen: boolean) => {
     if (newOpen) {
-      form.setFieldValue("icon", "folder-kanban");
+      form.setFieldValue("icon", "");
       form.setFieldValue("name", "");
       form.setFieldValue("description", "");
       setError("");
@@ -109,13 +106,12 @@ export function CreateWorkspaceDialog({
 
   return (
     <Dialog open={open} onOpenChange={handleOpenChange}>
-      <DialogContent className="sm:max-w-200">
-        <DialogHeader className="p-4">
-          <DialogTitle>{t('createWorkspace.title')}</DialogTitle>
-          <DialogDescription>{t('createWorkspace.description')}</DialogDescription>
+      <DialogContent className="sm:max-w-260 -mt-50">
+        <DialogHeader>
+          <DialogTitle className="text-xl">{t('createWorkspace.title')}</DialogTitle>
         </DialogHeader>
 
-        <div className="space-y-4 p-4">
+        <div className="space-y-3 overflow-y-auto px-4 py-2 max-h-[60vh]">
           {showUpgrade ? (
             <div className="flex flex-col items-center gap-4 py-8 text-center">
               <p className="text font-medium">{t('createWorkspace.upgradeTitle')}</p>
@@ -130,49 +126,45 @@ export function CreateWorkspaceDialog({
             </div>
           ) : (
             <>
-              <div className="flex flex-col gap-3 mb-20">
-            <form.Field name="icon" children={(field) => (
-              <IconPicker
-                icons={PROJECT_ICONS}
-                value={field.value ?? "folder-kanban"}
-                onChange={(v) => field.handleChange(v)}
-              />
-            )} />
-          </div>
+              <div className="flex gap-2">
+                <form.Field name="icon" children={(field) => (
+                  <LucideIconPicker
+                    value={field.value}
+                    onChange={(v) => field.handleChange(v)}
+                    modal
+                  />
+                )} />
+                <form.Field name="name" children={(field) => (
+                  <Input
+                    value={field.value ?? ""}
+                    onChange={(e) => field.handleChange(e.target.value)}
+                    onBlur={field.handleBlur}
+                    placeholder={t('createWorkspace.namePlaceholder')}
+                    maxLength={100}
+                    className="h-10 flex-1"
+                  />
+                )} />
+              </div>
 
-          <div className="flex flex-col gap-3">
-            <label className="text-sm font-medium ml-2">{t('createWorkspace.nameLabel')}</label>
-            <form.Field name="name" children={(field) => (
-              <Input
-                value={field.value ?? ""}
-                onChange={(e) => field.handleChange(e.target.value)}
-                onBlur={field.handleBlur}
-                placeholder={t('createWorkspace.namePlaceholder')}
-                maxLength={100}
-              />
-            )} />
-          </div>
+              <form.Field name="description" children={(field) => (
+                <div className="notion-full-width min-h-50 max-h-150 flex flex-col overflow-y-auto border rounded-md border-border">
+                  <textarea
+                    value={field.value ?? ""}
+                    onChange={(e) => field.handleChange(e.target.value)}
+                    onBlur={field.handleBlur}
+                    placeholder={t('createWorkspace.descriptionPlaceholder')}
+                    maxLength={500}
+                    className="flex-1 min-h-0 resize-none bg-transparent px-3 py-2 text-sm outline-none placeholder:text-muted-foreground"
+                  />
+                </div>
+              )} />
 
-          <div className="space-y-2">
-            <label className="text-sm font-medium ml-2">{t('createWorkspace.descriptionLabel')}</label>
-            <form.Field name="description" children={(field) => (
-              <Textarea
-                value={field.value ?? ""}
-                onChange={(e) => field.handleChange(e.target.value)}
-                onBlur={field.handleBlur}
-                placeholder={t('createWorkspace.descriptionPlaceholder')}
-                maxLength={500}
-                rows={3}
-              />
-            )} />
-          </div>
-
-          {error && <p className="text-sm text-destructive break-words">{error}</p>}
+              {error && <p className="text-sm text-destructive break-words">{error}</p>}
             </>
           )}
         </div>
 
-        <DialogFooter>
+        <DialogFooter className="items-center gap-3">
           <Button variant="outline" onClick={() => handleOpenChange(false)}>
             {t('createWorkspace.cancel')}
           </Button>
@@ -183,4 +175,4 @@ export function CreateWorkspaceDialog({
       </DialogContent>
     </Dialog>
   );
-}
+}

package/src/lib/__tests__/project-display-id.test.ts

@@ -22,8 +22,14 @@ describe('extractDisplayId', () => {
   it('提取纯字母数字并转大写', () => {
     expect(extractDisplayId('HelloWorld')).toBe('HELLOWORLD')
   })
-  it('混合中英文取字母部分', () => {
-    expect(extractDisplayId('Hello世界')).toBe('HELLO')
+  it('混合中英文：汉字转拼音首字母', () => {
+    expect(extractDisplayId('Hello世界')).toBe('HELLOSJ')
+  })
+  it('纯中文转拼音首字母', () => {
+    expect(extractDisplayId('我的项目')).toBe('WDXM')
+  })
+  it('中英混合完整示例', () => {
+    expect(extractDisplayId('产品需求PRD')).toBe('CPXQPRD')
   })
   it('截断到10位', () => {
     expect(extractDisplayId('HelloWorld12345')).toBe('HELLOWORLD')
@@ -31,9 +37,6 @@ describe('extractDisplayId', () => {
   it('包含数字', () => {
     expect(extractDisplayId('Project 2024')).toBe('PROJECT202')
   })
-  it('纯中文返回空字符串', () => {
-    expect(extractDisplayId('我的项目')).toBe('')
-  })
   it('空字符串', () => {
     expect(extractDisplayId('')).toBe('')
   })

package/src/lib/changelog/sdk-versions.ts

@@ -10,7 +10,7 @@ export const SDK_GROUPS: SdkGroup[] = [
         "name": "@tanstack/react-start",
         "displayName": "TanStack Start",
         "version": "v1.168.49",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/start/latest"
       },
@@ -18,7 +18,7 @@ export const SDK_GROUPS: SdkGroup[] = [
         "name": "@tanstack/react-router",
         "displayName": "TanStack Router",
         "version": "v1.170.32",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/router/latest"
       },
@@ -26,7 +26,7 @@ export const SDK_GROUPS: SdkGroup[] = [
         "name": "@tanstack/react-query",
         "displayName": "TanStack Query",
         "version": "v5.102.8",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/query/latest"
       },
@@ -34,7 +34,7 @@ export const SDK_GROUPS: SdkGroup[] = [
         "name": "@tanstack/ai",
         "displayName": "TanStack AI",
         "version": "v0.52.0",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/ai/latest"
       },
@@ -42,7 +42,7 @@ export const SDK_GROUPS: SdkGroup[] = [
         "name": "@tanstack/react-table",
         "displayName": "TanStack Table",
         "version": "v9.2.3",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/table/latest"
       },
@@ -50,7 +50,7 @@ export const SDK_GROUPS: SdkGroup[] = [
         "name": "@tanstack/react-form",
         "displayName": "TanStack Form",
         "version": "v2.0.0-alpha.2",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/form/latest"
       },
@@ -58,7 +58,7 @@ export const SDK_GROUPS: SdkGroup[] = [
         "name": "@tanstack/charts",
         "displayName": "TanStack Charts",
         "version": "v0.16.0",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": "apps/admin/package.json#dependencies",
         "docsUrl": "https://tanstack.com/charts/latest"
       },
@@ -66,7 +66,7 @@ export const SDK_GROUPS: SdkGroup[] = [
         "name": "@tanstack/react-pacer",
         "displayName": "TanStack Pacer",
         "version": "v0.23.0",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/pacer/latest"
       },
@@ -74,7 +74,7 @@ export const SDK_GROUPS: SdkGroup[] = [
         "name": "@tanstack/react-hotkeys",
         "displayName": "TanStack Hotkeys",
         "version": "v0.10.0",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://tanstack.com/hotkeys/latest"
       },
@@ -82,7 +82,7 @@ export const SDK_GROUPS: SdkGroup[] = [
         "name": "@tanstack/react-virtual",
         "displayName": "TanStack Virtual",
         "version": "v3.14.10",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": "apps/admin/package.json#dependencies",
         "docsUrl": "https://tanstack.com/virtual/latest"
       }
@@ -95,15 +95,15 @@ export const SDK_GROUPS: SdkGroup[] = [
     "items": [
       {
         "name": "@allbluecn/web-app",
-        "version": "v0.5.0",
-        "lastUpdate": "Aug 31, 2026",
+        "version": "v0.6.0",
+        "lastUpdate": "Sep 3, 2026",
         "source": "apps/web/package.json",
         "docsUrl": "https://github.com/allbluecn/allblue"
       },
       {
         "name": "@allbluecn/kernel",
         "version": "v0.3.1",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": "packages/kernel/package.json",
         "docsUrl": "https://github.com/allbluecn/allblue"
       }
@@ -117,42 +117,42 @@ export const SDK_GROUPS: SdkGroup[] = [
       {
         "name": "Vite",
         "version": "v8.1.5",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": "apps/web/package.json#devDependencies",
         "docsUrl": "https://vite.dev/"
       },
       {
         "name": "Node.js",
         "version": "v24.19.0",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": ".nvmrc",
         "docsUrl": "https://nodejs.org/"
       },
       {
         "name": "Prisma",
         "version": "v7.8.0",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": "packages/database/package.json#devDependencies",
         "docsUrl": "https://www.prisma.io/docs"
       },
       {
         "name": "shadcn UI",
         "version": "v1.2.4",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": "apps/web/package.json#dependencies",
         "docsUrl": "https://ui.shadcn.com/"
       },
       {
         "name": "TipTap",
         "version": "v3.27.4",
-        "lastUpdate": "Aug 31, 2026",
+        "lastUpdate": "Sep 3, 2026",
         "source": "packages/shared/package.json#devDependencies",
         "docsUrl": "https://tiptap.dev/"
       },
       {
         "name": "Lucide React",
-        "version": "v1.24.0",
-        "lastUpdate": "Aug 31, 2026",
+        "version": "v1.27.0",
+        "lastUpdate": "Sep 3, 2026",
         "source": "packages/ui/package.json#dependencies",
         "docsUrl": "https://lucide.dev/"
       }

package/src/lib/iteration/__tests__/status.test.ts

@@ -0,0 +1,41 @@
+import { describe, it, expect } from "vitest";
+import { deriveIterationStatus, isDateRangeOverlapping, ITERATION_STATUSES } from "../status";
+
+describe("deriveIterationStatus", () => {
+  it("今天早于开始日期 → upcoming", () => {
+    expect(deriveIterationStatus("2026-09-10", "2026-09-23", new Date("2026-09-01T22:00:00Z"))).toBe("upcoming");
+  });
+  it("startDate 当天 → active（含当天）", () => {
+    expect(deriveIterationStatus("2026-09-01", "2026-09-14", new Date("2026-09-01T15:00:00Z"))).toBe("active");
+  });
+  it("endDate 当天 → 仍 active（当天不判完成）", () => {
+    expect(deriveIterationStatus("2026-08-19", "2026-09-01", new Date("2026-09-01T23:59:59Z"))).toBe("active");
+  });
+  it("endDate 次日 → completed", () => {
+    expect(deriveIterationStatus("2026-08-19", "2026-09-01", new Date("2026-09-02T00:00:00Z"))).toBe("completed");
+  });
+  it("Date 对象入参（序列化后的 ISO 字符串）同样生效", () => {
+    expect(deriveIterationStatus(new Date("2026-09-01T00:00:00Z").toISOString(), "2026-09-14", new Date("2026-09-02T00:00:00Z"))).toBe("active");
+  });
+});
+
+describe("isDateRangeOverlapping", () => {
+  it("相交", () => {
+    expect(isDateRangeOverlapping({ startDate: "2026-09-01", endDate: "2026-09-14" }, { startDate: "2026-09-10", endDate: "2026-09-23" })).toBe(true);
+  });
+  it("包含", () => {
+    expect(isDateRangeOverlapping({ startDate: "2026-09-01", endDate: "2026-09-30" }, { startDate: "2026-09-10", endDate: "2026-09-14" })).toBe(true);
+  });
+  it("首尾相接不算重叠（endDate == startDate）", () => {
+    expect(isDateRangeOverlapping({ startDate: "2026-09-01", endDate: "2026-09-14" }, { startDate: "2026-09-14", endDate: "2026-09-27" })).toBe(false);
+  });
+  it("相离", () => {
+    expect(isDateRangeOverlapping({ startDate: "2026-09-01", endDate: "2026-09-14" }, { startDate: "2026-09-15", endDate: "2026-09-28" })).toBe(false);
+  });
+});
+
+describe("ITERATION_STATUSES", () => {
+  it("三种状态", () => {
+    expect(ITERATION_STATUSES).toEqual(["upcoming", "active", "completed"]);
+  });
+});

package/src/lib/iteration/status.ts

@@ -0,0 +1,28 @@
+export type IterationStatus = "upcoming" | "active" | "completed";
+
+export const ITERATION_STATUSES: IterationStatus[] = ["upcoming", "active", "completed"];
+
+/** 取日期部分（yyyy-MM-dd），丢弃时分秒，兼容 Date / ISO 字符串 */
+export function toDatePart(d: Date | string): string {
+  return (typeof d === "string" ? d : d.toISOString()).slice(0, 10);
+}
+
+/** 迭代状态由日期动态推导（规格 §3.1：endDate 当天仍 active，次日起 completed） */
+export function deriveIterationStatus(
+  startDate: string | Date,
+  endDate: string | Date,
+  now: Date = new Date(),
+): IterationStatus {
+  const today = toDatePart(now);
+  if (today < toDatePart(startDate)) return "upcoming";
+  if (today > toDatePart(endDate)) return "completed";
+  return "active";
+}
+
+/** 日期区间重叠判断（首尾相接不算重叠 → 用严格不等号） */
+export function isDateRangeOverlapping(
+  a: { startDate: string | Date; endDate: string | Date },
+  b: { startDate: string | Date; endDate: string | Date },
+): boolean {
+  return toDatePart(a.startDate) < toDatePart(b.endDate) && toDatePart(b.startDate) < toDatePart(a.endDate);
+}