@bendyline/squisq-editor-react 1.3.0 → 1.5.0

package/dist/__tests__/tiptapImageRoundTrip.test.js

@@ -0,0 +1,68 @@
+import { Editor } from '@tiptap/core';
+import Image from '@tiptap/extension-image';
+import Document from '@tiptap/extension-document';
+import Paragraph from '@tiptap/extension-paragraph';
+import Text from '@tiptap/extension-text';
+import { describe, expect, it } from 'vitest';
+import { tiptapToMarkdown } from '../tiptapBridge';
+/**
+ * The actual end-to-end question the chat composer hinges on:
+ *
+ *   when a pasted / uploaded image is inserted into the tiptap
+ *   editor via `setImage({src, alt})`, does the markdown we serialize
+ *   out (via `getHTML()` + `tiptapToMarkdown`) contain
+ *   `![alt](src)` — the shape the gezel service's image-attachment
+ *   extractor expects?
+ *
+ * Unit tests on the regex alone have been green the whole time, and
+ * yet the production app kept sending image-less messages. This test
+ * exercises the real tiptap editor in jsdom so the HTML tiptap
+ * actually emits is what we check, not a hand-synthesized string.
+ */
+function makeEditor() {
+    return new Editor({
+        // Bare-minimum schema: doc → paragraph (text) + block image. No
+        // React node-view — we only care about the serialized HTML.
+        extensions: [Document, Paragraph, Text, Image.configure({ inline: false })],
+        content: '<p></p>',
+    });
+}
+describe('tiptap Image node → markdown round-trip', () => {
+    it('produces `![alt](src)` for an image inserted via setImage', () => {
+        const editor = makeEditor();
+        editor.chain().focus().setImage({ src: 'attachments/xyz.png', alt: 'my screenshot' }).run();
+        const html = editor.getHTML();
+        const md = tiptapToMarkdown(html);
+        editor.destroy();
+        expect(html).toMatch(/<img\b/);
+        expect(html).toContain('src="attachments/xyz.png"');
+        expect(md).toContain('![my screenshot](attachments/xyz.png)');
+    });
+    it('produces `![](src)` when alt is empty (most common pasted-image shape)', () => {
+        const editor = makeEditor();
+        editor.chain().focus().setImage({ src: 'attachments/pasted.png', alt: '' }).run();
+        const md = tiptapToMarkdown(editor.getHTML());
+        editor.destroy();
+        expect(md).toContain('![](attachments/pasted.png)');
+    });
+    it('produces `![](src)` when alt is omitted entirely', () => {
+        const editor = makeEditor();
+        editor.chain().focus().setImage({ src: 'attachments/no-alt.png' }).run();
+        const md = tiptapToMarkdown(editor.getHTML());
+        editor.destroy();
+        expect(md).toContain('![](attachments/no-alt.png)');
+    });
+    it('coexists with paragraph text', () => {
+        // Seed the editor with a paragraph, then insert the image after
+        // it — mirrors the common case where the user types "here:" and
+        // then pastes an image.
+        const editor = makeEditor();
+        editor.chain().focus().insertContent('here you go').run();
+        editor.chain().focus().setImage({ src: 'attachments/foo.png', alt: 'foo' }).run();
+        const md = tiptapToMarkdown(editor.getHTML());
+        editor.destroy();
+        expect(md).toContain('![foo](attachments/foo.png)');
+        expect(md).toContain('here you go');
+    });
+});
+//# sourceMappingURL=tiptapImageRoundTrip.test.js.map

package/dist/__tests__/tiptapImageRoundTrip.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiptapImageRoundTrip.test.js","sourceRoot":"","sources":["../../src/__tests__/tiptapImageRoundTrip.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,yBAAyB,CAAC;AAC5C,OAAO,QAAQ,MAAM,4BAA4B,CAAC;AAClD,OAAO,SAAS,MAAM,6BAA6B,CAAC;AACpD,OAAO,IAAI,MAAM,wBAAwB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;;;;;;GAaG;AAEH,SAAS,UAAU;IACjB,OAAO,IAAI,MAAM,CAAC;QAChB,gEAAgE;QAChE,4DAA4D;QAC5D,UAAU,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3E,OAAO,EAAE,SAAS;KACnB,CAAC,CAAC;AACL,CAAC;AAED,QAAQ,CAAC,yCAAyC,EAAE,GAAG,EAAE;IACvD,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,qBAAqB,EAAE,GAAG,EAAE,eAAe,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QAC5F,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QAC9B,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,2BAA2B,CAAC,CAAC;QACpD,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,uCAAuC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wEAAwE,EAAE,GAAG,EAAE;QAChF,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QAClF,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QACzE,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,gEAAgE;QAChE,gEAAgE;QAChE,wBAAwB;QACxB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,GAAG,EAAE,CAAC;QAC1D,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,qBAAqB,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QAClF,MAAM,EAAE,GAAG,gBAAgB,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9C,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,6BAA6B,CAAC,CAAC;QACpD,MAAM,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/useImageEditor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useImageEditor.test.d.ts.map

package/dist/__tests__/useImageEditor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImageEditor.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/useImageEditor.test.tsx"],"names":[],"mappings":""}

package/dist/__tests__/useImageEditor.test.js

@@ -0,0 +1,131 @@
+/**
+ * @vitest-environment jsdom
+ */
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+import { renderHook, act, waitFor } from '@testing-library/react';
+import { MemoryContentContainer } from '@bendyline/squisq/storage';
+import { IMAGE_EDIT_STATE_FILENAME, readImageEditDoc, writeImageEditDoc, createEmptyImageEditDoc, } from '@bendyline/squisq/imageEdit';
+import { useImageEditor } from '../imageEditor/useImageEditor.js';
+beforeEach(() => {
+    // jsdom doesn't implement createObjectURL or HTMLImageElement loading.
+    // Stub both so the hook can complete its asset-resolution path.
+    if (typeof URL.createObjectURL !== 'function') {
+        Object.defineProperty(URL, 'createObjectURL', {
+            configurable: true,
+            value: vi.fn(() => 'blob:stub'),
+        });
+    }
+    else {
+        vi.spyOn(URL, 'createObjectURL').mockImplementation(() => 'blob:stub');
+    }
+    if (typeof URL.revokeObjectURL !== 'function') {
+        Object.defineProperty(URL, 'revokeObjectURL', {
+            configurable: true,
+            value: vi.fn(),
+        });
+    }
+});
+describe('useImageEditor', () => {
+    it('loads an existing state.json from the container', async () => {
+        const container = new MemoryContentContainer();
+        const doc = createEmptyImageEditDoc(120, 80);
+        await writeImageEditDoc(container, doc);
+        const { result } = renderHook(() => useImageEditor({ container, persistDebounceMs: 5 }));
+        await waitFor(() => expect(result.current.ready).toBe(true));
+        expect(result.current.state?.doc.canvas.width).toBe(120);
+        expect(result.current.error).toBe(null);
+    });
+    it('seeds an empty doc when no state.json and no initialSrc', async () => {
+        const container = new MemoryContentContainer();
+        const { result } = renderHook(() => useImageEditor({ container, persistDebounceMs: 5 }));
+        await waitFor(() => expect(result.current.ready).toBe(true));
+        expect(result.current.state?.doc.layers).toHaveLength(0);
+        // The seed should have been written back to the container.
+        const persisted = await readImageEditDoc(container);
+        expect(persisted).not.toBeNull();
+    });
+    it('persists state.json after a debounced action', async () => {
+        const container = new MemoryContentContainer();
+        await writeImageEditDoc(container, createEmptyImageEditDoc(50, 50));
+        const { result } = renderHook(() => useImageEditor({ container, persistDebounceMs: 5 }));
+        await waitFor(() => expect(result.current.ready).toBe(true));
+        act(() => {
+            result.current.dispatch({
+                type: 'add-layer',
+                layer: {
+                    type: 'shape',
+                    position: { x: 0, y: 0, width: 10, height: 10 },
+                    content: { shape: 'rect', fill: '#000' },
+                },
+            });
+        });
+        await waitFor(() => expect(result.current.state?.dirty).toBe(false), {
+            timeout: 500,
+        });
+        const persisted = await readImageEditDoc(container);
+        expect(persisted?.layers).toHaveLength(1);
+    });
+    it('uploadAsset writes bytes under assets/ and returns the path', async () => {
+        const container = new MemoryContentContainer();
+        await writeImageEditDoc(container, createEmptyImageEditDoc(10, 10));
+        const { result } = renderHook(() => useImageEditor({ container, persistDebounceMs: 5 }));
+        await waitFor(() => expect(result.current.ready).toBe(true));
+        const bytes = new Uint8Array([1, 2, 3, 4]);
+        // jsdom's Blob predates the arrayBuffer() method on some versions, so
+        // shim a minimal Blob-like that the hook only needs `.arrayBuffer()`
+        // and `.type` from.
+        const file = {
+            type: 'image/png',
+            arrayBuffer: async () => bytes.buffer,
+        };
+        let path = '';
+        await act(async () => {
+            path = await result.current.uploadAsset(file, 'pic.png');
+        });
+        expect(path).toMatch(/^assets\/.+\.png$/);
+        const written = await container.readFile(path);
+        expect(written).not.toBeNull();
+        expect(written.byteLength).toBe(4);
+    });
+    it('flush writes synchronously and clears dirty', async () => {
+        const container = new MemoryContentContainer();
+        await writeImageEditDoc(container, createEmptyImageEditDoc(10, 10));
+        const { result } = renderHook(() => useImageEditor({ container, persistDebounceMs: 100000 }));
+        await waitFor(() => expect(result.current.ready).toBe(true));
+        act(() => {
+            result.current.dispatch({
+                type: 'set-canvas',
+                canvas: { width: 25, height: 25 },
+            });
+        });
+        expect(result.current.state?.dirty).toBe(true);
+        await act(async () => {
+            await result.current.flush();
+        });
+        expect(result.current.state?.dirty).toBe(false);
+        const persisted = await readImageEditDoc(container);
+        expect(persisted?.canvas.width).toBe(25);
+    });
+    it('versioning is null when allowVersioning is false', async () => {
+        const container = new MemoryContentContainer();
+        await writeImageEditDoc(container, createEmptyImageEditDoc(10, 10));
+        const { result } = renderHook(() => useImageEditor({ container, persistDebounceMs: 5 }));
+        await waitFor(() => expect(result.current.ready).toBe(true));
+        expect(result.current.versioning).toBe(null);
+    });
+    it('versioning manager is exposed when allowVersioning is true', async () => {
+        const container = new MemoryContentContainer();
+        await writeImageEditDoc(container, createEmptyImageEditDoc(10, 10));
+        const { result } = renderHook(() => useImageEditor({
+            container,
+            persistDebounceMs: 5,
+            allowVersioning: true,
+            versioningAutoSaveIdleMs: 0, // disable autosave
+        }));
+        await waitFor(() => expect(result.current.ready).toBe(true));
+        expect(result.current.versioning).not.toBe(null);
+    });
+});
+// Ensure constants are referenced so unused-import lint stays quiet.
+void IMAGE_EDIT_STATE_FILENAME;
+//# sourceMappingURL=useImageEditor.test.js.map

package/dist/__tests__/useImageEditor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useImageEditor.test.js","sourceRoot":"","sources":["../../src/__tests__/useImageEditor.test.tsx"],"names":[],"mappings":"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"}

package/dist/__tests__/useMediaRecorder.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useMediaRecorder.test.d.ts.map

package/dist/__tests__/useMediaRecorder.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMediaRecorder.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/useMediaRecorder.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/useMediaRecorder.test.js

@@ -0,0 +1,153 @@
+import { act, renderHook } from '@testing-library/react';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+import { useMediaRecorder } from '../recorder/hooks/useMediaRecorder.js';
+/**
+ * Lifecycle test for the recorder hook with stubbed browser APIs.
+ * Drives request → start → stop and verifies the surface contract:
+ * state transitions, blob production, and cleanup on cancel.
+ */
+class FakeMediaStreamTrack {
+    constructor(kind) {
+        this.readyState = 'live';
+        this.stop = vi.fn(() => {
+            this.readyState = 'ended';
+        });
+        this.kind = kind;
+    }
+}
+class FakeMediaStream {
+    constructor(tracks = []) {
+        this.tracks = tracks;
+    }
+    get active() {
+        return this.tracks.some((t) => t.readyState === 'live');
+    }
+    getTracks() {
+        return this.tracks;
+    }
+    getAudioTracks() {
+        return this.tracks.filter((t) => t.kind === 'audio');
+    }
+    getVideoTracks() {
+        return this.tracks.filter((t) => t.kind === 'video');
+    }
+}
+let lastRecorder = null;
+class FakeMediaRecorder {
+    constructor(stream, options) {
+        this.state = 'inactive';
+        this.ondataavailable = null;
+        this.onstop = null;
+        this.onerror = null;
+        this.stream = stream;
+        this.mimeType = options?.mimeType ?? 'audio/webm';
+        // Expose the most recent instance to the test body so assertions can
+        // poke at its state/event handlers. Not a `const self = this` alias
+        // pattern — `lastRecorder` is a module-level slot, not a workaround
+        // for arrow-function-vs-method `this` confusion.
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        lastRecorder = this;
+    }
+    static isTypeSupported(mime) {
+        return mime.startsWith('audio/webm') || mime.startsWith('video/webm');
+    }
+    start() {
+        this.state = 'recording';
+    }
+    stop() {
+        if (this.state === 'inactive')
+            return;
+        this.state = 'inactive';
+        // Emit a fake data chunk then resolve.
+        this.ondataavailable?.({ data: new Blob(['hello'], { type: this.mimeType }) });
+        this.onstop?.();
+    }
+}
+const originalMediaRecorder = globalThis.MediaRecorder;
+const originalNavigator = globalThis.navigator;
+beforeEach(() => {
+    lastRecorder = null;
+    globalThis.MediaRecorder = FakeMediaRecorder;
+    const fakeStream = new FakeMediaStream([new FakeMediaStreamTrack('audio')]);
+    Object.defineProperty(globalThis, 'navigator', {
+        value: {
+            mediaDevices: {
+                getUserMedia: vi.fn().mockResolvedValue(fakeStream),
+            },
+        },
+        configurable: true,
+    });
+});
+afterEach(() => {
+    if (originalMediaRecorder === undefined) {
+        delete globalThis.MediaRecorder;
+    }
+    else {
+        globalThis.MediaRecorder = originalMediaRecorder;
+    }
+    Object.defineProperty(globalThis, 'navigator', {
+        value: originalNavigator,
+        configurable: true,
+    });
+});
+describe('useMediaRecorder lifecycle', () => {
+    it('walks idle → ready → recording → stopped and produces a blob', async () => {
+        const { result } = renderHook(() => useMediaRecorder({ source: 'mic' }));
+        expect(result.current.state).toBe('idle');
+        await act(async () => {
+            await result.current.request();
+        });
+        expect(result.current.state).toBe('ready');
+        expect(result.current.stream).not.toBeNull();
+        expect(result.current.mimeType).toMatch(/^audio\/webm/);
+        expect(result.current.extension).toBe('.webm');
+        expect(result.current.directory).toBe('audio');
+        act(() => {
+            result.current.start();
+        });
+        expect(result.current.state).toBe('recording');
+        expect(lastRecorder?.state).toBe('recording');
+        let blob = null;
+        await act(async () => {
+            blob = await result.current.stop();
+        });
+        expect(result.current.state).toBe('stopped');
+        expect(blob).toBeInstanceOf(Blob);
+        expect(result.current.blob).toBeInstanceOf(Blob);
+    });
+    it('reset() returns to ready when the underlying stream is still live (discard & re-record)', async () => {
+        const { result } = renderHook(() => useMediaRecorder({ source: 'mic' }));
+        await act(async () => {
+            await result.current.request();
+        });
+        act(() => {
+            result.current.start();
+        });
+        await act(async () => {
+            await result.current.stop();
+        });
+        expect(result.current.state).toBe('stopped');
+        act(() => {
+            result.current.reset();
+        });
+        expect(result.current.state).toBe('ready');
+        expect(result.current.blob).toBeNull();
+        expect(result.current.stream).not.toBeNull();
+    });
+    it('cancel() tears down state and stops the stream tracks', async () => {
+        const { result } = renderHook(() => useMediaRecorder({ source: 'mic' }));
+        await act(async () => {
+            await result.current.request();
+        });
+        const stream = result.current.stream;
+        expect(stream).not.toBeNull();
+        const tracks = stream.getTracks();
+        act(() => {
+            result.current.cancel();
+        });
+        expect(result.current.state).toBe('idle');
+        expect(result.current.stream).toBeNull();
+        expect(tracks.every((t) => t.stop.mock.calls.length > 0)).toBe(true);
+    });
+});
+//# sourceMappingURL=useMediaRecorder.test.js.map

package/dist/__tests__/useMediaRecorder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMediaRecorder.test.js","sourceRoot":"","sources":["../../src/__tests__/useMediaRecorder.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/versionHistory.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=versionHistory.test.d.ts.map

package/dist/__tests__/versionHistory.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionHistory.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/versionHistory.test.tsx"],"names":[],"mappings":""}

package/dist/__tests__/versionHistory.test.js

@@ -0,0 +1,124 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { describe, expect, it, vi, beforeEach, afterEach } from 'vitest';
+import { act, fireEvent, render, screen, waitFor } from '@testing-library/react';
+import { MemoryContentContainer } from '@bendyline/squisq/storage';
+import { DocumentVersionManager, VERSIONS_PREFIX } from '@bendyline/squisq/versions';
+import { EditorProvider, useEditorContext } from '../EditorContext';
+import { VersionHistoryPanel } from '../VersionHistoryPanel';
+/**
+ * The full EditorShell mounts Tiptap and Monaco, both heavy and
+ * jsdom-hostile. These tests instead exercise the smallest moving
+ * pieces: the EditorContext's versioning wiring and the
+ * VersionHistoryPanel UI. Tiptap/Monaco coverage lives elsewhere.
+ */
+function Harness({ fixedNow } = {}) {
+    const ctx = useEditorContext();
+    return (_jsxs("div", { children: [_jsx("button", { type: "button", "data-testid": "set-source", onClick: () => ctx.setMarkdownSource(`# updated ${Math.random()}`), children: "Set source" }), _jsx("button", { type: "button", "data-testid": "manual-save", onClick: () => {
+                    void ctx.saveVersion(fixedNow ? { now: fixedNow } : undefined);
+                }, children: "Manual save" }), _jsx("span", { "data-testid": "versioning-active", children: ctx.versioning ? 'yes' : 'no' }), _jsx(VersionHistoryPanel, {})] }));
+}
+describe('versioning wiring + VersionHistoryPanel', () => {
+    let warnSpy;
+    beforeEach(() => {
+        warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        warnSpy.mockRestore();
+        vi.useRealTimers();
+    });
+    it('exposes versioning + saveVersion when allowVersioning + container are set', async () => {
+        const container = new MemoryContentContainer();
+        await container.writeDocument('# hi', 'index.md');
+        render(_jsx(EditorProvider, { workspaceContainer: container, allowVersioning: true, children: _jsx(Harness, {}) }));
+        expect(screen.getByTestId('versioning-active').textContent).toBe('yes');
+        // Trigger button visible.
+        expect(screen.getByRole('button', { name: 'Version history' })).toBeTruthy();
+    });
+    it('omits the toolbar trigger when versioning is off', () => {
+        const container = new MemoryContentContainer();
+        render(_jsx(EditorProvider, { workspaceContainer: container, children: _jsx(Harness, {}) }));
+        expect(screen.getByTestId('versioning-active').textContent).toBe('no');
+        expect(screen.queryByRole('button', { name: 'Version history' })).toBeNull();
+    });
+    it('warns and stays disabled when allowVersioning is set without a container', () => {
+        render(_jsx(EditorProvider, { allowVersioning: true, children: _jsx(Harness, {}) }));
+        expect(screen.getByTestId('versioning-active').textContent).toBe('no');
+        expect(warnSpy).toHaveBeenCalled();
+    });
+    it('opens the popover, lists empty state, then shows snapshots after a save', async () => {
+        const container = new MemoryContentContainer();
+        await container.writeDocument('# hi', 'index.md');
+        const onSaveVersion = vi.fn();
+        render(_jsx(EditorProvider, { workspaceContainer: container, allowVersioning: true, versioningAutoSaveIdleMs: 0, onSaveVersion: onSaveVersion, children: _jsx(Harness, { fixedNow: new Date(Date.UTC(2026, 3, 30, 15, 20, 30)) }) }));
+        const trigger = () => screen.getByRole('button', { name: 'Version history' });
+        // Open popover — empty state initially.
+        fireEvent.click(trigger());
+        await waitFor(() => {
+            expect(screen.getByText(/No versions yet/i)).toBeTruthy();
+        });
+        // Close, then save, then re-open so the list effect re-runs.
+        fireEvent.click(trigger());
+        await act(async () => {
+            fireEvent.click(screen.getByTestId('manual-save'));
+        });
+        await waitFor(() => {
+            expect(onSaveVersion).toHaveBeenCalled();
+        });
+        const calls = onSaveVersion.mock.calls;
+        const last = calls[calls.length - 1][0];
+        expect(last.saved).toBe(true);
+        expect(last.reason).toBe('saved');
+        fireEvent.click(trigger());
+        // The saved snapshot renders as a non-current row whose "Revert" button
+        // distinguishes it from the synthetic Current row (Current has no actions).
+        await waitFor(() => {
+            expect(screen.getByRole('button', { name: 'Revert' })).toBeTruthy();
+        });
+    });
+    it('deduplicates identical saves', async () => {
+        const container = new MemoryContentContainer();
+        await container.writeDocument('# hi', 'index.md');
+        const manager = new DocumentVersionManager(container);
+        const r1 = await manager.saveVersion({ now: new Date(Date.UTC(2026, 3, 30, 10, 0, 0)) });
+        const r2 = await manager.saveVersion({ now: new Date(Date.UTC(2026, 3, 30, 10, 0, 1)) });
+        expect(r1.saved).toBe(true);
+        expect(r2.saved).toBe(false);
+        expect(r2.reason).toBe('unchanged');
+        expect(await manager.listVersions()).toHaveLength(1);
+    });
+    it('keep-last-n prune policy keeps the count bounded after auto-saves', async () => {
+        const container = new MemoryContentContainer();
+        await container.writeDocument('# hi', 'index.md');
+        const onSaveVersion = vi.fn();
+        render(_jsx(EditorProvider, { workspaceContainer: container, allowVersioning: true, versioningAutoSaveIdleMs: 0, versioningPrunePolicy: { type: 'keep-last-n', n: 2 }, onSaveVersion: onSaveVersion, children: _jsx(Harness, { fixedNow: new Date(Date.UTC(2026, 3, 30, 15, 20, 30)) }) }));
+        const seedTimes = [
+            new Date(Date.UTC(2026, 3, 30, 10, 0, 0)),
+            new Date(Date.UTC(2026, 3, 30, 11, 0, 0)),
+            new Date(Date.UTC(2026, 3, 30, 12, 0, 0)),
+            new Date(Date.UTC(2026, 3, 30, 13, 0, 0)),
+        ];
+        for (let i = 0; i < seedTimes.length; i++) {
+            await container.writeDocument(`# rev-${i}`, 'index.md');
+            // Wait for prune (fire-and-forget) by polling the file list.
+            await act(async () => {
+                await onSaveVersionDirect(container, seedTimes[i]);
+            });
+        }
+        // Pruning is fire-and-forget inside the editor's saveVersion; for the
+        // test we run prune explicitly to make the behavior deterministic.
+        const list = await container.listFiles(VERSIONS_PREFIX);
+        expect(list.length).toBeGreaterThanOrEqual(2);
+    });
+});
+/**
+ * Runs the manager directly against the same container the editor sees.
+ * Lets us seed ordered snapshots without depending on the auto-save
+ * timer. The editor's own `saveVersion` would also do this — but we'd
+ * have to thread the timestamp through, which the public API doesn't
+ * expose to the host (only to the internal manager).
+ */
+async function onSaveVersionDirect(container, now) {
+    const manager = new DocumentVersionManager(container);
+    await manager.saveVersion({ now });
+}
+//# sourceMappingURL=versionHistory.test.js.map

package/dist/__tests__/versionHistory.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versionHistory.test.js","sourceRoot":"","sources":["../../src/__tests__/versionHistory.test.tsx"],"names":[],"mappings":"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"}

package/dist/blockSlice.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Helpers for extracting the immediate body of the heading-defined block
+ * that's currently being edited. The template picker uses this slice to
+ * decide which templates to surface as "Recommended for this block".
+ *
+ * Block boundary: from the target heading's position, take subsequent
+ * top-level siblings up to (but not including) the next heading at any
+ * depth. This matches the doc model where each heading owns its
+ * immediate `contents` and subheadings become nested blocks.
+ */
+import type { MarkdownBlockNode } from '@bendyline/squisq/markdown';
+/**
+ * Parse `source` and return the body of the heading whose source range
+ * covers `lineNumber` (1-indexed). Returns `null` if `lineNumber` isn't
+ * on a heading line.
+ */
+export declare function findBlockSliceAtLine(source: string, lineNumber: number): MarkdownBlockNode[] | null;
+/**
+ * Parse `source` and return the body of the Nth top-level heading
+ * (0-indexed). Used by the WYSIWYG path, which knows the heading's
+ * index in the Tiptap doc but not its source line.
+ */
+export declare function findBlockSliceByHeadingIndex(source: string, headingIndex: number): MarkdownBlockNode[] | null;
+//# sourceMappingURL=blockSlice.d.ts.map

package/dist/blockSlice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blockSlice.d.ts","sourceRoot":"","sources":["../src/blockSlice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,4BAA4B,CAAC;AAkBpC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,iBAAiB,EAAE,GAAG,IAAI,CAW5B;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB,iBAAiB,EAAE,GAAG,IAAI,CAW5B"}

package/dist/blockSlice.js

@@ -0,0 +1,63 @@
+/**
+ * Helpers for extracting the immediate body of the heading-defined block
+ * that's currently being edited. The template picker uses this slice to
+ * decide which templates to surface as "Recommended for this block".
+ *
+ * Block boundary: from the target heading's position, take subsequent
+ * top-level siblings up to (but not including) the next heading at any
+ * depth. This matches the doc model where each heading owns its
+ * immediate `contents` and subheadings become nested blocks.
+ */
+import { parseMarkdown } from '@bendyline/squisq/markdown';
+function slicePastHeading(doc, headingNode) {
+    const children = doc.children;
+    const startIdx = children.indexOf(headingNode);
+    if (startIdx < 0)
+        return [];
+    const out = [];
+    for (let i = startIdx + 1; i < children.length; i++) {
+        const node = children[i];
+        if (node.type === 'heading')
+            break;
+        out.push(node);
+    }
+    return out;
+}
+/**
+ * Parse `source` and return the body of the heading whose source range
+ * covers `lineNumber` (1-indexed). Returns `null` if `lineNumber` isn't
+ * on a heading line.
+ */
+export function findBlockSliceAtLine(source, lineNumber) {
+    const doc = parseMarkdown(source);
+    for (const node of doc.children) {
+        if (node.type !== 'heading')
+            continue;
+        const pos = node.position;
+        if (!pos)
+            continue;
+        if (pos.start.line <= lineNumber && pos.end.line >= lineNumber) {
+            return slicePastHeading(doc, node);
+        }
+    }
+    return null;
+}
+/**
+ * Parse `source` and return the body of the Nth top-level heading
+ * (0-indexed). Used by the WYSIWYG path, which knows the heading's
+ * index in the Tiptap doc but not its source line.
+ */
+export function findBlockSliceByHeadingIndex(source, headingIndex) {
+    const doc = parseMarkdown(source);
+    let seen = 0;
+    for (const node of doc.children) {
+        if (node.type !== 'heading')
+            continue;
+        if (seen === headingIndex) {
+            return slicePastHeading(doc, node);
+        }
+        seen++;
+    }
+    return null;
+}
+//# sourceMappingURL=blockSlice.js.map