Files
HiveGrid-Wireframes/03 Quellen und Referenzen/hivegrid-cloud/packages/view-models/src/onboarding/first-steps-checklist.vm.test.ts
T

58 lines
2.7 KiB
TypeScript

import { describe, expect, it } from "vitest";
import { toFirstStepsChecklistVM } from "./first-steps-checklist.vm.js";
const items = [
{ id: "step_1", block: "profile", titleKey: "onboarding.firstSteps.profile", href: "settings/profile", completed: true },
{ id: "step_2", block: "contacts", titleKey: "onboarding.firstSteps.contacts", href: "contacts", completed: false },
] as const;
describe("toFirstStepsChecklistVM", () => {
it("derives progress and per-item actions from the checklist rows", () => {
const vm = toFirstStepsChecklistVM({ id: "session_1", status: "active", dismissed: false, items });
expect(vm.status).toBe("ready");
expect(vm.data).toMatchObject({ completedCount: 1, totalCount: 2, percentComplete: 50, isComplete: false, status: "active" });
expect(vm.data?.items[0]).toMatchObject({ state: "completed", canComplete: false });
expect(vm.data?.items[1]).toMatchObject({ state: "pending", canComplete: true });
});
it("marks a fully completed checklist as complete", () => {
const vm = toFirstStepsChecklistVM({
id: "session_1",
status: "active",
dismissed: false,
items: items.map((item) => ({ ...item, completed: true })),
});
expect(vm.data).toMatchObject({ status: "completed", isComplete: true, percentComplete: 100 });
expect(vm.data?.progressLabelKey).toBe("onboarding.firstSteps.dashboardComplete");
});
it("disables item actions after the checklist is dismissed", () => {
const vm = toFirstStepsChecklistVM({ id: "session_1", status: "dismissed", dismissed: true, items });
expect(vm.data).toMatchObject({ status: "dismissed", dismissed: true });
expect(vm.data?.items.every((item) => item.hidden && !item.canComplete)).toBe(true);
});
it("keeps automatically detected steps read-only until their condition is met", () => {
const vm = toFirstStepsChecklistVM({
id: "session_1",
status: "active",
dismissed: false,
items: [...items, { id: "team", block: "team", titleKey: "onboarding.firstSteps.team", href: "settings/team/members/new", completed: false, canComplete: false }],
});
expect(vm.data?.items.find((item) => item.id === "team")).toMatchObject({ completed: false, canComplete: false });
});
it("uses explicit empty and error states", () => {
expect(toFirstStepsChecklistVM({ id: "session_1", status: "active", dismissed: false, items: [] })).toEqual({ status: "empty" });
expect(toFirstStepsChecklistVM({ id: "session_1", status: "active", dismissed: false, items, errorKey: "onboarding.firstSteps.error.body" })).toEqual({
status: "error",
error: { messageKey: "onboarding.firstSteps.error.body" },
});
});
});