|
| 1 | +import { EnvironmentId } from "@t3tools/contracts"; |
| 2 | +import { AsyncResult } from "effect/unstable/reactivity"; |
| 3 | +import { act, StrictMode } from "react"; |
| 4 | +import { create, type ReactTestRenderer } from "react-test-renderer"; |
| 5 | +import { afterEach, beforeEach, describe, expect, it, vi } from "vite-plus/test"; |
| 6 | + |
| 7 | +const { writeFile, confirmFile } = vi.hoisted(() => ({ |
| 8 | + writeFile: vi.fn(), |
| 9 | + confirmFile: vi.fn(), |
| 10 | +})); |
| 11 | +vi.mock("~/state/projects", () => ({ projectEnvironment: { writeFile: {} } })); |
| 12 | +vi.mock("~/state/use-atom-command", () => ({ useAtomCommand: () => writeFile })); |
| 13 | +vi.mock("./projectFilesQueryState", () => ({ confirmProjectFileQueryData: confirmFile })); |
| 14 | + |
| 15 | +import { setMarkdownTaskChecked } from "./filePreviewMode"; |
| 16 | +import { useFileSaveCoordinator } from "./useFileSaveCoordinator"; |
| 17 | + |
| 18 | +const environmentId = EnvironmentId.make("save-lifecycle-audit"); |
| 19 | +const onPendingChange = vi.fn(); |
| 20 | +const defaultProps = { |
| 21 | + environmentId, |
| 22 | + cwd: "/workspace", |
| 23 | + relativePath: "file.txt", |
| 24 | + onPendingChange, |
| 25 | +}; |
| 26 | +let renderer: ReactTestRenderer | null; |
| 27 | + |
| 28 | +function ChangeSource(_props: { onChange: (contents: string) => void }) { |
| 29 | + return null; |
| 30 | +} |
| 31 | + |
| 32 | +function FileSurface(props: Parameters<typeof useFileSaveCoordinator>[0]) { |
| 33 | + const coordinator = useFileSaveCoordinator(props); |
| 34 | + return <ChangeSource onChange={(contents) => coordinator.change(contents)} />; |
| 35 | +} |
| 36 | + |
| 37 | +function mount(props = defaultProps) { |
| 38 | + act(() => { |
| 39 | + renderer = create( |
| 40 | + <StrictMode> |
| 41 | + <FileSurface {...props} /> |
| 42 | + </StrictMode>, |
| 43 | + ); |
| 44 | + }); |
| 45 | +} |
| 46 | + |
| 47 | +function changeHandler(): (contents: string) => void { |
| 48 | + return renderer!.root.findByType(ChangeSource).props.onChange; |
| 49 | +} |
| 50 | + |
| 51 | +beforeEach(() => { |
| 52 | + renderer = null; |
| 53 | + vi.useFakeTimers(); |
| 54 | + vi.stubGlobal("IS_REACT_ACT_ENVIRONMENT", true); |
| 55 | + writeFile.mockReset().mockResolvedValue(AsyncResult.success(undefined)); |
| 56 | + confirmFile.mockReset(); |
| 57 | + onPendingChange.mockReset(); |
| 58 | +}); |
| 59 | + |
| 60 | +afterEach(async () => { |
| 61 | + await act(async () => renderer?.unmount()); |
| 62 | + vi.useRealTimers(); |
| 63 | + vi.unstubAllGlobals(); |
| 64 | +}); |
| 65 | + |
| 66 | +describe("file-save React lifecycle", () => { |
| 67 | + it("persists editor model changes after StrictMode setup replay", async () => { |
| 68 | + mount(); |
| 69 | + changeHandler()("AUDIT7907NATIVE\n"); |
| 70 | + expect(onPendingChange).toHaveBeenCalledWith("file.txt", true); |
| 71 | + await vi.advanceTimersByTimeAsync(500); |
| 72 | + expect(writeFile).toHaveBeenCalledExactlyOnceWith({ |
| 73 | + environmentId, |
| 74 | + input: { cwd: "/workspace", relativePath: "file.txt", contents: "AUDIT7907NATIVE\n" }, |
| 75 | + }); |
| 76 | + expect(confirmFile).toHaveBeenCalledExactlyOnceWith( |
| 77 | + environmentId, |
| 78 | + "/workspace", |
| 79 | + "file.txt", |
| 80 | + "AUDIT7907NATIVE\n", |
| 81 | + ); |
| 82 | + expect(onPendingChange).toHaveBeenLastCalledWith("file.txt", false); |
| 83 | + }); |
| 84 | + |
| 85 | + it("persists rendered Markdown task changes after StrictMode setup replay", async () => { |
| 86 | + mount({ ...defaultProps, relativePath: "README.md" }); |
| 87 | + const nextContents = setMarkdownTaskChecked("- [ ] task\n", 2, true); |
| 88 | + changeHandler()(nextContents); |
| 89 | + await vi.advanceTimersByTimeAsync(500); |
| 90 | + expect(writeFile).toHaveBeenCalledExactlyOnceWith({ |
| 91 | + environmentId, |
| 92 | + input: { cwd: "/workspace", relativePath: "README.md", contents: "- [x] task\n" }, |
| 93 | + }); |
| 94 | + }); |
| 95 | + |
| 96 | + it("keeps the debounce across rerenders of the same file", async () => { |
| 97 | + mount(); |
| 98 | + changeHandler()("first"); |
| 99 | + await vi.advanceTimersByTimeAsync(300); |
| 100 | + act(() => |
| 101 | + renderer!.update( |
| 102 | + <StrictMode> |
| 103 | + <FileSurface {...defaultProps} /> |
| 104 | + </StrictMode>, |
| 105 | + ), |
| 106 | + ); |
| 107 | + changeHandler()("latest"); |
| 108 | + await vi.advanceTimersByTimeAsync(499); |
| 109 | + expect(writeFile).not.toHaveBeenCalled(); |
| 110 | + await vi.advanceTimersByTimeAsync(1); |
| 111 | + expect(writeFile).toHaveBeenCalledTimes(1); |
| 112 | + expect(writeFile.mock.calls[0]![0].input.contents).toBe("latest"); |
| 113 | + }); |
| 114 | + |
| 115 | + it("flushes on unmount and ignores a retired editor callback", async () => { |
| 116 | + mount(); |
| 117 | + const retiredChange = changeHandler(); |
| 118 | + retiredChange("pending edit"); |
| 119 | + await act(async () => renderer!.unmount()); |
| 120 | + renderer = null; |
| 121 | + retiredChange("stale editor contents"); |
| 122 | + await vi.runAllTimersAsync(); |
| 123 | + expect(writeFile).toHaveBeenCalledTimes(1); |
| 124 | + expect(writeFile.mock.calls[0]![0].input.contents).toBe("pending edit"); |
| 125 | + }); |
| 126 | + |
| 127 | + it.each([ |
| 128 | + { relativePath: "other.txt" }, |
| 129 | + { cwd: "/other-workspace" }, |
| 130 | + { environmentId: EnvironmentId.make("other-environment") }, |
| 131 | + ])("retires callbacks when the file identity changes: %j", async (change) => { |
| 132 | + mount(); |
| 133 | + const retiredChange = changeHandler(); |
| 134 | + retiredChange("old file edit"); |
| 135 | + const nextProps = { ...defaultProps, ...change }; |
| 136 | + act(() => |
| 137 | + renderer!.update( |
| 138 | + <StrictMode> |
| 139 | + <FileSurface {...nextProps} /> |
| 140 | + </StrictMode>, |
| 141 | + ), |
| 142 | + ); |
| 143 | + retiredChange("stale editor contents"); |
| 144 | + changeHandler()("new file edit"); |
| 145 | + await vi.runAllTimersAsync(); |
| 146 | + expect(writeFile.mock.calls.map(([request]) => request)).toEqual([ |
| 147 | + { |
| 148 | + environmentId, |
| 149 | + input: { cwd: "/workspace", relativePath: "file.txt", contents: "old file edit" }, |
| 150 | + }, |
| 151 | + { |
| 152 | + environmentId: nextProps.environmentId, |
| 153 | + input: { |
| 154 | + cwd: nextProps.cwd, |
| 155 | + relativePath: nextProps.relativePath, |
| 156 | + contents: "new file edit", |
| 157 | + }, |
| 158 | + }, |
| 159 | + ]); |
| 160 | + }); |
| 161 | + |
| 162 | + it("does not reactivate a retired callback when the same file mounts again", async () => { |
| 163 | + mount(); |
| 164 | + const retiredChange = changeHandler(); |
| 165 | + await act(async () => renderer!.unmount()); |
| 166 | + renderer = null; |
| 167 | + mount(); |
| 168 | + retiredChange("stale contents"); |
| 169 | + changeHandler()("current contents"); |
| 170 | + await vi.runAllTimersAsync(); |
| 171 | + expect(writeFile).toHaveBeenCalledTimes(1); |
| 172 | + expect(writeFile.mock.calls[0]![0].input.contents).toBe("current contents"); |
| 173 | + }); |
| 174 | +}); |
0 commit comments