@sutrata/editor 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (152) hide show
  1. package/README.md +87 -0
  2. package/dist/ai/generated-providers.json +1 -1
  3. package/package.json +30 -3
  4. package/scripts/copy-assets.mjs +0 -16
  5. package/scripts/generate-providers.mjs +0 -127
  6. package/src/ai/OnboardingDialog.tsx +0 -390
  7. package/src/ai/VoiceConfirmDialog.tsx +0 -137
  8. package/src/ai/VoiceToolbar.tsx +0 -321
  9. package/src/ai/ai-client.ts +0 -596
  10. package/src/ai/commands.ts +0 -164
  11. package/src/ai/generated-providers.json +0 -3696
  12. package/src/ai/prompts.ts +0 -62
  13. package/src/ai/voice-service.ts +0 -96
  14. package/src/autocomplete/AutocompletePlugin.ts +0 -21
  15. package/src/autocomplete/suggestions.ts +0 -147
  16. package/src/context/DocumentContext.tsx +0 -648
  17. package/src/desktop-api.d.ts +0 -40
  18. package/src/editor/EditorView.tsx +0 -82
  19. package/src/editor/SelectionMenu.tsx +0 -152
  20. package/src/editor/attr-pencil-plugin.ts +0 -172
  21. package/src/editor/character-decoration-plugin.ts +0 -104
  22. package/src/editor/editor-bus.ts +0 -51
  23. package/src/editor/find-highlight-plugin.ts +0 -68
  24. package/src/editor/frontmatter-field-view.ts +0 -52
  25. package/src/editor/frontmatter-field.ts +0 -115
  26. package/src/editor/grapheme-cursor.ts +0 -99
  27. package/src/editor/ime-plugin.ts +0 -85
  28. package/src/editor/insert-helper.ts +0 -43
  29. package/src/editor/keymap.ts +0 -124
  30. package/src/editor/language-class-plugin.ts +0 -91
  31. package/src/editor/plugins.ts +0 -26
  32. package/src/editor/prosemirror-to-sutra.ts +0 -192
  33. package/src/editor/scene-heading-view.ts +0 -147
  34. package/src/editor/schema.ts +0 -156
  35. package/src/editor/sutra-to-prosemirror.ts +0 -156
  36. package/src/extensions/storage-adapter.ts +0 -65
  37. package/src/extensions/types.ts +0 -60
  38. package/src/file/docx-exporter.ts +0 -585
  39. package/src/file/docx-importer.ts +0 -313
  40. package/src/file/print-paginator.ts +0 -301
  41. package/src/file/templates.ts +0 -73
  42. package/src/file/workflow-reports.ts +0 -820
  43. package/src/findreplace/FindReplace.tsx +0 -242
  44. package/src/findreplace/find-engine.ts +0 -97
  45. package/src/findreplace/scroll-to-match.ts +0 -89
  46. package/src/fonts/tofu-detect.ts +0 -53
  47. package/src/i18n/LanguageContext.tsx +0 -207
  48. package/src/i18n/language-detect.ts +0 -73
  49. package/src/i18n/useTranslation.tsx +0 -74
  50. package/src/index.ts +0 -27
  51. package/src/locales/bn.json +0 -143
  52. package/src/locales/en.json +0 -143
  53. package/src/locales/gu.json +0 -143
  54. package/src/locales/hi.json +0 -143
  55. package/src/locales/kn.json +0 -143
  56. package/src/locales/ml.json +0 -143
  57. package/src/locales/mr.json +0 -143
  58. package/src/locales/or.json +0 -143
  59. package/src/locales/pa.json +0 -143
  60. package/src/locales/si.json +0 -143
  61. package/src/locales/ta.json +0 -143
  62. package/src/locales/te.json +0 -143
  63. package/src/navigator/SceneNavigator.tsx +0 -844
  64. package/src/navigator/StatisticsDialog.tsx +0 -249
  65. package/src/navigator/scene-list.ts +0 -84
  66. package/src/settings/SettingsDialog.tsx +0 -303
  67. package/src/shell/AppBar.tsx +0 -354
  68. package/src/shell/AppShell.tsx +0 -71
  69. package/src/shell/ConfirmDialog.tsx +0 -71
  70. package/src/shell/ElementToolbar.tsx +0 -175
  71. package/src/shell/LanguageStatus.tsx +0 -101
  72. package/src/shell/StatusBar.tsx +0 -135
  73. package/src/shell/SutrataLogo.tsx +0 -89
  74. package/src/shell/Toast.tsx +0 -46
  75. package/src/shell/ToolbarButton.tsx +0 -30
  76. package/src/shell/VersionHistory.tsx +0 -212
  77. package/src/shell/Watermark.tsx +0 -9
  78. package/src/shell/fonts/fonts.css +0 -1133
  79. package/src/shell/icons.tsx +0 -335
  80. package/src/shell/toolbar-actions.ts +0 -59
  81. package/src/source/SourceView.tsx +0 -111
  82. package/src/source/find-highlight-source.ts +0 -57
  83. package/src/source/sutra-lang.ts +0 -121
  84. package/src/spellcheck/dictionaries.ts +0 -21
  85. package/src/spellcheck/hunspell.ts +0 -110
  86. package/src/spellcheck/spellcheck-plugin.ts +0 -83
  87. package/src/styles/StyleDialog.tsx +0 -148
  88. package/src/styles/builtin-styles.ts +0 -139
  89. package/src/styles/css-adapter.ts +0 -76
  90. package/src/styles/docx-adapter.ts +0 -109
  91. package/src/styles/embed-fonts.ts +0 -81
  92. package/src/styles/pagination.ts +0 -27
  93. package/src/styles/print-adapter.ts +0 -288
  94. package/src/styles/registry.ts +0 -20
  95. package/src/styles/screenplay.css +0 -3006
  96. package/src/styles/script-ranges.ts +0 -17
  97. package/src/styles/types.ts +0 -104
  98. package/src/styles/validate.ts +0 -114
  99. package/src/templates/templates.ts +0 -194
  100. package/src/titlepage/ExportDialog.tsx +0 -494
  101. package/src/titlepage/TitlePageDialog.tsx +0 -312
  102. package/src/titlepage/frontmatter-form.ts +0 -280
  103. package/src/titlepage/languages.ts +0 -37
  104. package/src/types.ts +0 -7
  105. package/tests/AppBar.test.tsx +0 -35
  106. package/tests/AppShell.test.tsx +0 -22
  107. package/tests/ElementToolbar.test.tsx +0 -36
  108. package/tests/LanguageStatus.test.tsx +0 -129
  109. package/tests/SelectionMenu.test.tsx +0 -71
  110. package/tests/ToolbarButton.test.tsx +0 -24
  111. package/tests/ai-onboarding.test.ts +0 -102
  112. package/tests/ai-status.test.tsx +0 -72
  113. package/tests/ai-structured.test.ts +0 -94
  114. package/tests/autocomplete/AutocompletePlugin.test.ts +0 -20
  115. package/tests/autocomplete/suggestions.test.ts +0 -106
  116. package/tests/document-context.test.tsx +0 -565
  117. package/tests/docx-importer.test.ts +0 -160
  118. package/tests/editor/character-decoration-plugin.test.ts +0 -101
  119. package/tests/editor/character-extension.test.ts +0 -44
  120. package/tests/editor/grapheme-cursor.test.ts +0 -118
  121. package/tests/editor/ime-plugin.test.ts +0 -72
  122. package/tests/editor/inline-note-bridge.test.ts +0 -32
  123. package/tests/editor/language-class-plugin.test.ts +0 -265
  124. package/tests/editor/title-page.test.ts +0 -124
  125. package/tests/embed-fonts.test.ts +0 -17
  126. package/tests/exporters.test.ts +0 -365
  127. package/tests/findreplace/FindReplace.test.tsx +0 -391
  128. package/tests/findreplace/find-engine.test.ts +0 -86
  129. package/tests/findreplace/scroll-to-match.test.ts +0 -50
  130. package/tests/fonts/tofu-detect.test.ts +0 -122
  131. package/tests/i18n/LanguageContext.test.tsx +0 -146
  132. package/tests/i18n/language-detect.test.ts +0 -54
  133. package/tests/i18n/locale-parity.test.ts +0 -25
  134. package/tests/i18n/useTranslation.test.tsx +0 -45
  135. package/tests/keymap.test.ts +0 -18
  136. package/tests/navigator/SceneNavigator.test.tsx +0 -177
  137. package/tests/navigator/StatisticsDialog.test.tsx +0 -63
  138. package/tests/navigator/scene-list.test.ts +0 -71
  139. package/tests/print-paginator.test.ts +0 -82
  140. package/tests/shell/VersionHistory.test.tsx +0 -129
  141. package/tests/spellcheck/hunspell.test.ts +0 -82
  142. package/tests/spellcheck/spellcheck-plugin.test.ts +0 -56
  143. package/tests/styles.test.ts +0 -315
  144. package/tests/templates/templates.test.ts +0 -83
  145. package/tests/titlepage/TitlePageDialog.test.tsx +0 -90
  146. package/tests/titlepage/apply-title-page.test.ts +0 -61
  147. package/tests/titlepage/frontmatter-form.test.ts +0 -115
  148. package/tests/toolbar-actions.test.ts +0 -93
  149. package/tests/voice-commands.test.ts +0 -58
  150. package/tsconfig.json +0 -17
  151. package/vitest.config.ts +0 -11
  152. package/vitest.setup.ts +0 -65
@@ -1,565 +0,0 @@
1
- import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest'
2
- import { render, screen, fireEvent, act, waitFor } from '@testing-library/react'
3
- import { DocumentProvider, useDocument } from '../src/context/DocumentContext'
4
- import type { StorageAdapter } from '../src/extensions/storage-adapter'
5
-
6
- // Must match RECOVERY_POINTER_KEY in ../src/context/DocumentContext.tsx.
7
- const RECOVERY_POINTER_KEY = 'sutrata:recovery-pointer'
8
-
9
- function makeMockStorageAdapter(overrides: Partial<StorageAdapter> = {}): StorageAdapter {
10
- return {
11
- saveDocument: vi.fn().mockResolvedValue(undefined),
12
- loadDocument: vi.fn().mockResolvedValue(null),
13
- listVersions: vi.fn().mockResolvedValue([]),
14
- openFile: vi.fn().mockResolvedValue(null),
15
- openDocx: vi.fn().mockResolvedValue(null),
16
- openStyleJson: vi.fn().mockResolvedValue(null),
17
- saveFile: vi.fn().mockResolvedValue(null),
18
- saveStyle: vi.fn().mockResolvedValue(undefined),
19
- loadAllStyles: vi.fn().mockResolvedValue([]),
20
- deleteStyle: vi.fn().mockResolvedValue(undefined),
21
- ...overrides,
22
- }
23
- }
24
-
25
- const mockStorageAdapter = makeMockStorageAdapter()
26
-
27
- function Probe() {
28
- const { ribbonVisible, setRibbonVisible, navVisible } = useDocument()
29
- return (
30
- <div>
31
- <span data-testid="ribbon">{String(ribbonVisible)}</span>
32
- <span data-testid="nav">{String(navVisible)}</span>
33
- <button onClick={() => setRibbonVisible(!ribbonVisible)}>toggle</button>
34
- </div>
35
- )
36
- }
37
-
38
- describe('DocumentContext visibility flags', () => {
39
- it('defaults ribbon visible and nav visible on desktop (jsdom innerWidth=1024)', () => {
40
- render(<DocumentProvider storageAdapter={mockStorageAdapter}><Probe /></DocumentProvider>)
41
- expect(screen.getByTestId('ribbon').textContent).toBe('true')
42
- expect(screen.getByTestId('nav').textContent).toBe('true')
43
- })
44
-
45
- it('toggles ribbon visibility', () => {
46
- render(<DocumentProvider storageAdapter={mockStorageAdapter}><Probe /></DocumentProvider>)
47
- fireEvent.click(screen.getByText('toggle'))
48
- expect(screen.getByTestId('ribbon').textContent).toBe('false')
49
- })
50
-
51
- it('Ctrl-S calls preventDefault and saves', () => {
52
- render(<DocumentProvider storageAdapter={mockStorageAdapter}><Probe /></DocumentProvider>)
53
- const ev = new KeyboardEvent('keydown', { key: 's', code: 'KeyS', ctrlKey: true, cancelable: true })
54
- const prevent = vi.spyOn(ev, 'preventDefault')
55
- act(() => { window.dispatchEvent(ev) })
56
- expect(prevent).toHaveBeenCalled()
57
- })
58
- })
59
-
60
- function FullProbe() {
61
- const {
62
- text, isDirty, filePath, lastSaveTarget, setText, newDocument, openFile, saveFile, saveFileAs, save,
63
- confirmModal, toasts, versions, restoreVersion, clearVersionHistory,
64
- } = useDocument()
65
- return (
66
- <div>
67
- <span data-testid="text">{text}</span>
68
- <span data-testid="dirty">{String(isDirty)}</span>
69
- <span data-testid="filePath">{String(filePath)}</span>
70
- <span data-testid="lastSaveTarget">{String(lastSaveTarget)}</span>
71
- <span data-testid="toasts">{toasts.map(t => t.message).join('|')}</span>
72
- <span data-testid="confirm-title">{confirmModal?.title ?? ''}</span>
73
- <span data-testid="versions">{versions.map(v => v.id).join('|')}</span>
74
- <button onClick={() => setText('## Scene 1\n\nEdited by the user.\n')}>edit</button>
75
- <button onClick={() => newDocument()}>new</button>
76
- <button onClick={() => void openFile()}>open</button>
77
- <button onClick={() => void saveFile()}>save</button>
78
- <button onClick={() => void saveFileAs()}>saveAs</button>
79
- <button onClick={() => void save()}>autosaveNow</button>
80
- <button onClick={() => confirmModal?.onConfirm()}>confirm</button>
81
- <button onClick={() => confirmModal?.onCancel?.()}>cancel</button>
82
- <button onClick={() => versions[1] && restoreVersion(versions[1])}>restoreSecond</button>
83
- <button onClick={() => void clearVersionHistory()}>clearVersions</button>
84
- </div>
85
- )
86
- }
87
-
88
- describe('DocumentContext reload recovery (Ctrl-R data loss fix)', () => {
89
- beforeEach(() => {
90
- localStorage.clear()
91
- })
92
-
93
- it('starts blank when there is no recovery pointer', () => {
94
- const adapter = makeMockStorageAdapter()
95
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
96
- expect(adapter.loadDocument).not.toHaveBeenCalled()
97
- expect(screen.getByTestId('dirty').textContent).toBe('false')
98
- })
99
-
100
- it('restores autosaved content left behind by a previous session, marks it dirty, and toasts', async () => {
101
- localStorage.setItem(RECOVERY_POINTER_KEY, JSON.stringify({ path: '__autosave__', updatedAt: Date.now() }))
102
- const adapter = makeMockStorageAdapter({
103
- loadDocument: vi.fn().mockResolvedValue('## Scene 1\n\nRECOVERED CONTENT.\n'),
104
- })
105
-
106
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
107
-
108
- await waitFor(() => {
109
- expect(screen.getByTestId('text').textContent).toContain('RECOVERED CONTENT')
110
- })
111
- expect(screen.getByTestId('dirty').textContent).toBe('true')
112
- expect(screen.getByTestId('filePath').textContent).toBe('null')
113
- expect(screen.getByTestId('toasts').textContent).toContain('Recovered unsaved changes')
114
- })
115
-
116
- it('stays marked dirty after the scheduled autosave re-backs-up a just-recovered draft (regression: reopening must not silently look saved)', async () => {
117
- vi.useFakeTimers({ shouldAdvanceTime: true })
118
- try {
119
- localStorage.setItem(RECOVERY_POINTER_KEY, JSON.stringify({ path: '__autosave__', updatedAt: Date.now() }))
120
- const adapter = makeMockStorageAdapter({
121
- loadDocument: vi.fn().mockResolvedValue('## Scene 1\n\nRECOVERED CONTENT.\n'),
122
- })
123
-
124
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
125
-
126
- await act(async () => { await vi.advanceTimersByTimeAsync(0) })
127
- expect(screen.getByTestId('text').textContent).toContain('RECOVERED CONTENT')
128
- expect(screen.getByTestId('dirty').textContent).toBe('true')
129
-
130
- // The debounce/ceiling autosave fires on its own (no further edits) and
131
- // backs the recovered draft up again — it must not clear isDirty, or the
132
- // footer would flip to "saved" for a file that was never actually written.
133
- await act(async () => { await vi.advanceTimersByTimeAsync(4000) })
134
- expect(adapter.saveDocument).toHaveBeenCalled()
135
- expect(screen.getByTestId('dirty').textContent).toBe('true')
136
- expect(screen.getByTestId('lastSaveTarget').textContent).toBe('local')
137
- } finally {
138
- vi.useRealTimers()
139
- }
140
- })
141
-
142
- it('restores under the real filePath when the pointer names one', async () => {
143
- localStorage.setItem(RECOVERY_POINTER_KEY, JSON.stringify({ path: 'myscript.sutra', updatedAt: Date.now() }))
144
- const adapter = makeMockStorageAdapter({
145
- loadDocument: vi.fn().mockResolvedValue('## Scene 1\n\nRecovered named file.\n'),
146
- })
147
-
148
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
149
-
150
- await waitFor(() => {
151
- expect(screen.getByTestId('filePath').textContent).toBe('myscript.sutra')
152
- })
153
- expect(adapter.loadDocument).toHaveBeenCalledWith('myscript.sutra')
154
- })
155
-
156
- it('openFile asks for confirmation instead of silently discarding unsaved edits', async () => {
157
- const adapter = makeMockStorageAdapter()
158
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
159
-
160
- fireEvent.click(screen.getByText('edit'))
161
- expect(screen.getByTestId('dirty').textContent).toBe('true')
162
-
163
- fireEvent.click(screen.getByText('open'))
164
- expect(screen.getByTestId('confirm-title').textContent).toBe('Discard Unsaved Changes?')
165
- expect(adapter.openFile).not.toHaveBeenCalled()
166
-
167
- await act(async () => { fireEvent.click(screen.getByText('confirm')) })
168
- expect(adapter.openFile).toHaveBeenCalled()
169
- })
170
-
171
- it('openFile proceeds without a prompt when there is nothing unsaved', () => {
172
- const adapter = makeMockStorageAdapter()
173
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
174
- fireEvent.click(screen.getByText('open'))
175
- expect(adapter.openFile).toHaveBeenCalled()
176
- expect(screen.getByTestId('confirm-title').textContent).toBe('')
177
- })
178
-
179
- it('saveFile clears the recovery pointer since content is now safely on disk', async () => {
180
- localStorage.setItem(RECOVERY_POINTER_KEY, JSON.stringify({ path: '__autosave__', updatedAt: Date.now() }))
181
- const adapter = makeMockStorageAdapter({
182
- saveFile: vi.fn().mockResolvedValue({ savedName: 'myscript.sutra', handle: null }),
183
- })
184
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
185
-
186
- await act(async () => { fireEvent.click(screen.getByText('save')) })
187
-
188
- expect(localStorage.getItem(RECOVERY_POINTER_KEY)).toBeNull()
189
- })
190
-
191
- it('autosaves at least once every 30s even during continuous, uninterrupted typing', async () => {
192
- vi.useFakeTimers({ shouldAdvanceTime: true })
193
- try {
194
- const adapter = makeMockStorageAdapter()
195
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
196
-
197
- fireEvent.click(screen.getByText('edit'))
198
-
199
- // Simulate a keystroke every second for 35s straight — under the old pure-debounce
200
- // implementation this would reset the 30s timer every time and never fire.
201
- for (let i = 0; i < 35; i++) {
202
- await act(async () => { await vi.advanceTimersByTimeAsync(1000) })
203
- fireEvent.click(screen.getByText('edit'))
204
- }
205
- await act(async () => { await vi.advanceTimersByTimeAsync(1000) })
206
-
207
- expect(adapter.saveDocument).toHaveBeenCalled()
208
- } finally {
209
- vi.useRealTimers()
210
- }
211
- })
212
- })
213
-
214
- describe('DocumentContext three-state save status (Phase 2)', () => {
215
- beforeEach(() => {
216
- localStorage.clear()
217
- })
218
-
219
- it('marks lastSaveTarget "local" after an autosave, distinct from a real file save', async () => {
220
- const adapter = makeMockStorageAdapter()
221
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
222
-
223
- fireEvent.click(screen.getByText('edit'))
224
- await act(async () => { fireEvent.click(screen.getByText('autosaveNow')) })
225
-
226
- expect(screen.getByTestId('lastSaveTarget').textContent).toBe('local')
227
- })
228
-
229
- it('VS Code-style: a local autosave backs content up but does NOT clear isDirty — only saveFile does', async () => {
230
- const adapter = makeMockStorageAdapter({
231
- saveFile: vi.fn().mockResolvedValue({ savedName: 'myscript.sutra', handle: null }),
232
- })
233
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
234
-
235
- fireEvent.click(screen.getByText('edit'))
236
- expect(screen.getByTestId('dirty').textContent).toBe('true')
237
-
238
- await act(async () => { fireEvent.click(screen.getByText('autosaveNow')) })
239
- // Backed up locally, but still "unsaved" relative to the real file.
240
- expect(adapter.saveDocument).toHaveBeenCalled()
241
- expect(screen.getByTestId('lastSaveTarget').textContent).toBe('local')
242
- expect(screen.getByTestId('dirty').textContent).toBe('true')
243
-
244
- await act(async () => { fireEvent.click(screen.getByText('save')) })
245
- expect(screen.getByTestId('dirty').textContent).toBe('false')
246
- expect(screen.getByTestId('lastSaveTarget').textContent).toBe('file')
247
- })
248
-
249
- it('marks lastSaveTarget "file" after saveFile, overriding a prior local autosave', async () => {
250
- const adapter = makeMockStorageAdapter({
251
- saveFile: vi.fn().mockResolvedValue({ savedName: 'myscript.sutra', handle: null }),
252
- })
253
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
254
-
255
- fireEvent.click(screen.getByText('edit'))
256
- await act(async () => { fireEvent.click(screen.getByText('autosaveNow')) })
257
- expect(screen.getByTestId('lastSaveTarget').textContent).toBe('local')
258
-
259
- await act(async () => { fireEvent.click(screen.getByText('save')) })
260
- expect(screen.getByTestId('lastSaveTarget').textContent).toBe('file')
261
- })
262
-
263
- it('marks lastSaveTarget "file" after opening a (non-fountain) file, with nothing unsaved yet', async () => {
264
- const adapter = makeMockStorageAdapter({
265
- openFile: vi.fn().mockResolvedValue({ name: 'myscript.sutra', content: '## Scene 1\n\nHi.\n', handle: null }),
266
- })
267
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
268
-
269
- await act(async () => { fireEvent.click(screen.getByText('open')) })
270
-
271
- expect(screen.getByTestId('lastSaveTarget').textContent).toBe('file')
272
- expect(screen.getByTestId('dirty').textContent).toBe('false')
273
- })
274
- })
275
-
276
- describe('DocumentContext file handle persistence (Phase 2)', () => {
277
- beforeEach(() => {
278
- localStorage.clear()
279
- })
280
-
281
- it('persists the handle after saveFileAs and after opening a file', async () => {
282
- const fakeHandle = { name: 'myscript.sutra' }
283
- const adapter = makeMockStorageAdapter({
284
- saveFile: vi.fn().mockResolvedValue({ savedName: 'myscript.sutra', handle: fakeHandle }),
285
- openFile: vi.fn().mockResolvedValue({ name: 'other.sutra', content: '## Scene 1\n\nHi.\n', handle: fakeHandle }),
286
- persistFileHandle: vi.fn().mockResolvedValue(undefined),
287
- })
288
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
289
-
290
- await act(async () => { fireEvent.click(screen.getByText('saveAs')) })
291
- expect(adapter.persistFileHandle).toHaveBeenCalledWith('myscript.sutra', fakeHandle)
292
-
293
- await act(async () => { fireEvent.click(screen.getByText('open')) })
294
- expect(adapter.persistFileHandle).toHaveBeenCalledWith('other.sutra', fakeHandle)
295
- })
296
-
297
- it('reattaches a still-permitted handle on boot recovery so the next save writes back in place', async () => {
298
- localStorage.setItem(RECOVERY_POINTER_KEY, JSON.stringify({ path: 'myscript.sutra', updatedAt: Date.now() }))
299
- const fakeHandle = { name: 'myscript.sutra' }
300
- const adapter = makeMockStorageAdapter({
301
- loadDocument: vi.fn().mockResolvedValue('## Scene 1\n\nRecovered.\n'),
302
- restoreFileHandle: vi.fn().mockResolvedValue(fakeHandle),
303
- saveFile: vi.fn().mockResolvedValue({ savedName: 'myscript.sutra', handle: fakeHandle }),
304
- })
305
-
306
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
307
-
308
- await waitFor(() => {
309
- expect(screen.getByTestId('filePath').textContent).toBe('myscript.sutra')
310
- })
311
- expect(adapter.restoreFileHandle).toHaveBeenCalledWith('myscript.sutra')
312
-
313
- // Confirms the reattached handle actually reaches saveFile as the existing handle
314
- // to write back in place, instead of null (which would force a Save As prompt).
315
- await act(async () => { fireEvent.click(screen.getByText('save')) })
316
- expect(adapter.saveFile).toHaveBeenCalledWith('myscript.sutra', expect.any(String), fakeHandle)
317
- })
318
-
319
- it('does not reattach a handle the adapter refuses (permission not granted)', async () => {
320
- localStorage.setItem(RECOVERY_POINTER_KEY, JSON.stringify({ path: 'myscript.sutra', updatedAt: Date.now() }))
321
- const adapter = makeMockStorageAdapter({
322
- loadDocument: vi.fn().mockResolvedValue('## Scene 1\n\nRecovered.\n'),
323
- restoreFileHandle: vi.fn().mockResolvedValue(null),
324
- saveFile: vi.fn().mockResolvedValue({ savedName: 'myscript.sutra', handle: null }),
325
- })
326
-
327
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
328
-
329
- await waitFor(() => {
330
- expect(screen.getByTestId('filePath').textContent).toBe('myscript.sutra')
331
- })
332
-
333
- await act(async () => { fireEvent.click(screen.getByText('save')) })
334
- expect(adapter.saveFile).toHaveBeenCalledWith('myscript.sutra', expect.any(String), null)
335
- })
336
- })
337
-
338
- describe('DocumentContext desktop window-close guard (Phase 3)', () => {
339
- afterEach(() => {
340
- delete (window as { desktopAPI?: unknown }).desktopAPI
341
- })
342
-
343
- it('closes immediately when there is nothing unsaved', async () => {
344
- let trigger: (() => void) | undefined
345
- const closeWindow = vi.fn().mockResolvedValue(undefined)
346
- window.desktopAPI = {
347
- readFile: vi.fn(), writeFile: vi.fn(), showOpenDialog: vi.fn(), showSaveDialog: vi.fn(),
348
- onMenuCommand: vi.fn().mockReturnValue(() => {}),
349
- onCloseRequested: (cb: () => void) => { trigger = cb; return () => {} },
350
- closeWindow,
351
- } as unknown as typeof window.desktopAPI
352
-
353
- const adapter = makeMockStorageAdapter()
354
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
355
-
356
- expect(trigger).toBeDefined()
357
- await act(async () => { trigger!() })
358
-
359
- expect(closeWindow).toHaveBeenCalled()
360
- })
361
-
362
- it('asks for confirmation, then saves and closes, when there are unsaved edits', async () => {
363
- let trigger: (() => void) | undefined
364
- const closeWindow = vi.fn().mockResolvedValue(undefined)
365
- const adapter = makeMockStorageAdapter({
366
- saveFile: vi.fn().mockResolvedValue({ savedName: 'myscript.sutra', handle: null }),
367
- })
368
- window.desktopAPI = {
369
- readFile: vi.fn(), writeFile: vi.fn(), showOpenDialog: vi.fn(), showSaveDialog: vi.fn(),
370
- onMenuCommand: vi.fn().mockReturnValue(() => {}),
371
- onCloseRequested: (cb: () => void) => { trigger = cb; return () => {} },
372
- closeWindow,
373
- } as unknown as typeof window.desktopAPI
374
-
375
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
376
-
377
- fireEvent.click(screen.getByText('edit'))
378
- act(() => { trigger!() })
379
-
380
- expect(screen.getByTestId('confirm-title').textContent).toBe('Unsaved Changes')
381
- expect(closeWindow).not.toHaveBeenCalled()
382
-
383
- fireEvent.click(screen.getByText('confirm'))
384
- // saveFile()'s internal await plus its .then() are both microtasks; a real
385
- // macrotask boundary is enough to flush them without fake timers.
386
- await act(async () => { await new Promise(r => setTimeout(r, 10)) })
387
-
388
- expect(adapter.saveFile).toHaveBeenCalled()
389
- expect(closeWindow).toHaveBeenCalled()
390
- })
391
-
392
- it('stays open if the save during close is cancelled (no handle returned)', async () => {
393
- let trigger: (() => void) | undefined
394
- const closeWindow = vi.fn().mockResolvedValue(undefined)
395
- const adapter = makeMockStorageAdapter({
396
- saveFile: vi.fn().mockResolvedValue(null), // user dismissed the Save As picker
397
- })
398
- window.desktopAPI = {
399
- readFile: vi.fn(), writeFile: vi.fn(), showOpenDialog: vi.fn(), showSaveDialog: vi.fn(),
400
- onMenuCommand: vi.fn().mockReturnValue(() => {}),
401
- onCloseRequested: (cb: () => void) => { trigger = cb; return () => {} },
402
- closeWindow,
403
- } as unknown as typeof window.desktopAPI
404
-
405
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
406
-
407
- fireEvent.click(screen.getByText('edit'))
408
- act(() => { trigger!() })
409
- fireEvent.click(screen.getByText('confirm'))
410
- await act(async () => { await new Promise(r => setTimeout(r, 10)) })
411
-
412
- expect(adapter.saveFile).toHaveBeenCalled()
413
- expect(closeWindow).not.toHaveBeenCalled()
414
- })
415
- })
416
-
417
- describe('DocumentContext version history (power-user feature)', () => {
418
- beforeEach(() => {
419
- localStorage.clear()
420
- })
421
-
422
- it('loads versions for the file once it has a filePath', async () => {
423
- const versionList = [
424
- { id: 'v2', timestamp: 200, content: '## Scene 1\n\nSecond save.\n' },
425
- { id: 'v1', timestamp: 100, content: '## Scene 1\n\nFirst save.\n' },
426
- ]
427
- const adapter = makeMockStorageAdapter({
428
- openFile: vi.fn().mockResolvedValue({ name: 'myscript.sutra', content: '## Scene 1\n\nHi.\n', handle: null }),
429
- listVersions: vi.fn().mockResolvedValue(versionList),
430
- })
431
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
432
-
433
- expect(screen.getByTestId('versions').textContent).toBe('')
434
-
435
- await act(async () => { fireEvent.click(screen.getByText('open')) })
436
-
437
- await waitFor(() => {
438
- expect(screen.getByTestId('versions').textContent).toBe('v2|v1')
439
- })
440
- expect(adapter.listVersions).toHaveBeenCalledWith('myscript.sutra')
441
- })
442
-
443
- it('refreshes the version list after re-saving the same already-named file', async () => {
444
- const adapter = makeMockStorageAdapter({
445
- saveFile: vi.fn().mockResolvedValue({ savedName: 'myscript.sutra', handle: null }),
446
- listVersions: vi.fn()
447
- .mockResolvedValueOnce([{ id: 'v1', timestamp: 100, content: 'old' }])
448
- .mockResolvedValueOnce([
449
- { id: 'v2', timestamp: 200, content: 'new' },
450
- { id: 'v1', timestamp: 100, content: 'old' },
451
- ]),
452
- openFile: vi.fn().mockResolvedValue({ name: 'myscript.sutra', content: '## Scene 1\n\nHi.\n', handle: null }),
453
- })
454
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
455
-
456
- await act(async () => { fireEvent.click(screen.getByText('open')) })
457
- await waitFor(() => {
458
- expect(screen.getByTestId('versions').textContent).toBe('v1')
459
- })
460
-
461
- // filePath doesn't change on this save (already 'myscript.sutra'), so the
462
- // filePath-change effect alone wouldn't refetch — saveFile must do it explicitly.
463
- fireEvent.click(screen.getByText('edit'))
464
- await act(async () => { fireEvent.click(screen.getByText('save')) })
465
-
466
- await waitFor(() => {
467
- expect(screen.getByTestId('versions').textContent).toBe('v2|v1')
468
- })
469
- })
470
-
471
- it('creates no version on autosave — only explicit saveFile/saveFileAs does', async () => {
472
- const adapter = makeMockStorageAdapter({
473
- saveFile: vi.fn().mockResolvedValue({ savedName: 'myscript.sutra', handle: null }),
474
- })
475
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
476
-
477
- fireEvent.click(screen.getByText('edit'))
478
- await act(async () => { fireEvent.click(screen.getByText('autosaveNow')) })
479
-
480
- // Autosave goes through storageAdapter.saveDocument, never storageAdapter.saveFile.
481
- expect(adapter.saveDocument).toHaveBeenCalled()
482
- expect(adapter.saveFile).not.toHaveBeenCalled()
483
- })
484
-
485
- it('restoreVersion replaces the document content and marks it dirty', async () => {
486
- const versionList = [
487
- { id: 'v2', timestamp: 200, content: '## Scene 1\n\nCurrent.\n' },
488
- { id: 'v1', timestamp: 100, content: '## Scene 1\n\nOlder version.\n' },
489
- ]
490
- const adapter = makeMockStorageAdapter({
491
- openFile: vi.fn().mockResolvedValue({ name: 'myscript.sutra', content: '## Scene 1\n\nCurrent.\n', handle: null }),
492
- listVersions: vi.fn().mockResolvedValue(versionList),
493
- })
494
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
495
-
496
- await act(async () => { fireEvent.click(screen.getByText('open')) })
497
- await waitFor(() => {
498
- expect(screen.getByTestId('versions').textContent).toBe('v2|v1')
499
- })
500
-
501
- fireEvent.click(screen.getByText('restoreSecond'))
502
-
503
- expect(screen.getByTestId('text').textContent).toContain('Older version')
504
- expect(screen.getByTestId('dirty').textContent).toBe('true')
505
- })
506
-
507
- it('clearVersionHistory asks for confirmation, then calls the adapter and empties the list', async () => {
508
- const versionList = [
509
- { id: 'v1', timestamp: 100, content: '## Scene 1\n\nFirst save.\n' },
510
- ]
511
- const adapter = makeMockStorageAdapter({
512
- openFile: vi.fn().mockResolvedValue({ name: 'myscript.sutra', content: '## Scene 1\n\nHi.\n', handle: null }),
513
- listVersions: vi.fn().mockResolvedValue(versionList),
514
- deleteAllVersions: vi.fn().mockResolvedValue(undefined),
515
- })
516
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
517
-
518
- await act(async () => { fireEvent.click(screen.getByText('open')) })
519
- await waitFor(() => {
520
- expect(screen.getByTestId('versions').textContent).toBe('v1')
521
- })
522
-
523
- fireEvent.click(screen.getByText('clearVersions'))
524
- expect(screen.getByTestId('confirm-title').textContent).toBe('Delete Version History?')
525
- expect(adapter.deleteAllVersions).not.toHaveBeenCalled()
526
-
527
- await act(async () => { fireEvent.click(screen.getByText('confirm')) })
528
-
529
- expect(adapter.deleteAllVersions).toHaveBeenCalledWith('myscript.sutra')
530
- expect(screen.getByTestId('versions').textContent).toBe('')
531
- })
532
-
533
- it('newDocument resets filePath and versions so new file is not tracked under old file history', async () => {
534
- const versionList = [
535
- { id: 'v1', timestamp: 100, content: '## Scene 1\n\nFirst save.\n' },
536
- ]
537
- const adapter = makeMockStorageAdapter({
538
- openFile: vi.fn().mockResolvedValue({ name: 'myscript.sutra', content: '## Scene 1\n\nHi.\n', handle: null }),
539
- listVersions: vi.fn().mockResolvedValue(versionList),
540
- saveDocument: vi.fn().mockResolvedValue(undefined),
541
- })
542
- render(<DocumentProvider storageAdapter={adapter}><FullProbe /></DocumentProvider>)
543
-
544
- // Open existing file with versions
545
- await act(async () => { fireEvent.click(screen.getByText('open')) })
546
- await waitFor(() => {
547
- expect(screen.getByTestId('filePath').textContent).toBe('myscript.sutra')
548
- expect(screen.getByTestId('versions').textContent).toBe('v1')
549
- })
550
-
551
- // Start a new document
552
- act(() => { fireEvent.click(screen.getByText('new')) })
553
-
554
- // filePath and versions must be cleared immediately
555
- expect(screen.getByTestId('filePath').textContent).toBe('null')
556
- expect(screen.getByTestId('versions').textContent).toBe('')
557
- expect(screen.getByTestId('dirty').textContent).toBe('false')
558
-
559
- // An edit to the new document and subsequent autosave must NOT write to 'myscript.sutra'
560
- fireEvent.click(screen.getByText('edit'))
561
- await act(async () => { fireEvent.click(screen.getByText('autosaveNow')) })
562
- expect(adapter.saveDocument).toHaveBeenCalledWith('__autosave__', expect.any(String))
563
- expect(adapter.saveDocument).not.toHaveBeenCalledWith('myscript.sutra', expect.any(String))
564
- })
565
- })