@mp-lb/mdkit 0.2.2 → 0.2.3-main.21.1

package/dist/collaboration/useMdKitCollaboration.d.ts

@@ -1,4 +1,4 @@
-import type { MdKitCollaborationParticipant, MdKitCollaborationSession } from "../document/documentTypes";
+import type { MdKitCollaborationParticipant, MdKitCollaborationSession } from "../document/documentTypes.js";
 export type UseMdKitCollaborationOptions = {
     collaborator: MdKitCollaborationParticipant;
     documentId: string | null;

package/dist/core/checkpointPolicy.d.ts

@@ -0,0 +1,25 @@
+import type { MdKitDocumentVersionDetail, MdKitDocumentWriteInput, MdKitDocumentWriteResult } from "../document/documentTypes.js";
+export type MdKitCheckpointPolicyInput = {
+    currentContent: string;
+    documentId: string;
+    editDistance: number;
+    previousCheckpoint: MdKitDocumentVersionDetail | null;
+    previousCheckpointContent: string | null;
+    timeSinceLastCheckpointMs: number | null;
+    writeInput: MdKitDocumentWriteInput;
+    writeResult: MdKitDocumentWriteResult;
+};
+export type MdKitCheckpointPolicy = {
+    shouldCheckpoint(input: MdKitCheckpointPolicyInput): boolean | Promise<boolean>;
+};
+export type MdKitSmartCheckpointPolicyOptions = {
+    minEditDistance?: number;
+    minIntervalMs?: number;
+};
+export declare const measureMdKitEditDistance: (left: string, right: string) => number;
+export declare const CheckpointPolicy: {
+    readonly always: () => MdKitCheckpointPolicy;
+    readonly function: (shouldCheckpoint: MdKitCheckpointPolicy["shouldCheckpoint"]) => MdKitCheckpointPolicy;
+    readonly never: () => MdKitCheckpointPolicy;
+    readonly smart: (options?: MdKitSmartCheckpointPolicyOptions) => MdKitCheckpointPolicy;
+};

package/dist/core/checkpointPolicy.js

@@ -0,0 +1,45 @@
+const defaultMinEditDistance = 250;
+const defaultMinIntervalMs = 5 * 60_000;
+export const measureMdKitEditDistance = (left, right) => {
+    if (left === right) {
+        return 0;
+    }
+    if (left.length === 0) {
+        return right.length;
+    }
+    if (right.length === 0) {
+        return left.length;
+    }
+    let previous = Array.from({ length: right.length + 1 }, (_, index) => index);
+    let current = new Array(right.length + 1);
+    for (let leftIndex = 1; leftIndex <= left.length; leftIndex += 1) {
+        current[0] = leftIndex;
+        for (let rightIndex = 1; rightIndex <= right.length; rightIndex += 1) {
+            const cost = left[leftIndex - 1] === right[rightIndex - 1] ? 0 : 1;
+            current[rightIndex] = Math.min(current[rightIndex - 1] + 1, previous[rightIndex] + 1, previous[rightIndex - 1] + cost);
+        }
+        [previous, current] = [current, previous];
+    }
+    return previous[right.length] ?? 0;
+};
+export const CheckpointPolicy = {
+    always: () => ({
+        shouldCheckpoint: () => true,
+    }),
+    function: (shouldCheckpoint) => ({
+        shouldCheckpoint,
+    }),
+    never: () => ({
+        shouldCheckpoint: () => false,
+    }),
+    smart: (options = {}) => {
+        const minEditDistance = options.minEditDistance ?? defaultMinEditDistance;
+        const minIntervalMs = options.minIntervalMs ?? defaultMinIntervalMs;
+        return {
+            shouldCheckpoint: ({ editDistance, previousCheckpoint, timeSinceLastCheckpointMs, }) => !previousCheckpoint ||
+                editDistance >= minEditDistance ||
+                (timeSinceLastCheckpointMs !== null &&
+                    timeSinceLastCheckpointMs >= minIntervalMs),
+        };
+    },
+};

package/dist/core/index.d.ts

@@ -1,3 +1,5 @@
 export { createMdKitDocumentRecord, detectMdKitDocumentConflict, normalizeMdKitVersionToken, restoreMdKitDocumentVersion, writeMdKitDocumentRecord, } from "./documentEngine.js";
+export { CheckpointPolicy, measureMdKitEditDistance, } from "./checkpointPolicy.js";
 export type { CreateMdKitDocumentRecordInput, MdKitDocumentRecord, RestoreMdKitDocumentVersionInput, RestoreMdKitDocumentVersionResult, WriteMdKitDocumentRecordInput, WriteMdKitDocumentRecordResult, } from "./documentEngine.js";
+export type { MdKitCheckpointPolicy, MdKitCheckpointPolicyInput, MdKitSmartCheckpointPolicyOptions, } from "./checkpointPolicy.js";
 export type { MdKitDocumentSnapshot, MdKitDocumentVersionDetail, MdKitDocumentVersionSummary, MdKitDocumentVersionToken, MdKitDocumentWriteInput, MdKitDocumentWriteResult, } from "../document/documentTypes.js";

package/dist/core/index.js

@@ -1 +1,2 @@
 export { createMdKitDocumentRecord, detectMdKitDocumentConflict, normalizeMdKitVersionToken, restoreMdKitDocumentVersion, writeMdKitDocumentRecord, } from "./documentEngine.js";
+export { CheckpointPolicy, measureMdKitEditDistance, } from "./checkpointPolicy.js";

package/dist/document/MdKitConflictPanel.d.ts

@@ -1,4 +1,4 @@
-import type { MdKitDocumentController } from "./useMdKitDocument";
+import type { MdKitDocumentController } from "./useMdKitDocument.js";
 export type MdKitConflictPanelProps = {
     className?: string;
     document: MdKitDocumentController;

package/dist/document/MdKitConflictPanel.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState } from "react";
-import { joinClassNames } from "../ui/joinClassNames";
+import { joinClassNames } from "../ui/joinClassNames.js";
 export const MdKitConflictPanel = ({ className, document, title = "Document conflict", }) => {
     const [pendingAction, setPendingAction] = useState(null);
     const [activePreview, setActivePreview] = useState("remote");

package/dist/document/MdKitDocumentToolbar.d.ts

@@ -1,6 +1,6 @@
-import type { MdKitCollaborationSession } from "./documentTypes";
-import type { MdKitDocumentController } from "./useMdKitDocument";
-import type { MdKitDocumentVersionsController } from "../versioning/useMdKitDocumentVersions";
+import type { MdKitCollaborationSession } from "./documentTypes.js";
+import type { MdKitDocumentController } from "./useMdKitDocument.js";
+import type { MdKitDocumentVersionsController } from "../versioning/useMdKitDocumentVersions.js";
 export type MdKitDocumentToolbarProps = {
     className?: string;
     collaboration?: MdKitCollaborationSession | null;

package/dist/document/MdKitDocumentToolbar.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState } from "react";
-import { joinClassNames } from "../ui/joinClassNames";
+import { joinClassNames } from "../ui/joinClassNames.js";
 const formatUpdatedAt = (updatedAt) => {
     if (!updatedAt) {
         return "Never saved";

package/dist/document/useMdKitDocument.d.ts

@@ -1,4 +1,4 @@
-import type { MdKitDocumentAdapter, MdKitDocumentVersionToken } from "./documentTypes";
+import type { MdKitDocumentAdapter, MdKitDocumentVersionToken } from "./documentTypes.js";
 export type UseMdKitDocumentOptions = {
     adapter: Pick<MdKitDocumentAdapter, "readDocument" | "writeDocument" | "resyncDocument">;
     debounceMs?: number;

package/dist/fastify.d.ts

@@ -1,3 +1,3 @@
-export { registerMdKitFastify } from "./transport/fastify";
-export type { RegisterMdKitFastifyOptions } from "./transport/fastify";
-export type { MdKitRestoreDocumentVersionInput, MdKitTransportStore, } from "./transport/store";
+export { registerMdKitFastify } from "./transport/fastify.js";
+export type { RegisterMdKitFastifyOptions } from "./transport/fastify.js";
+export type { MdKitRestoreDocumentVersionInput, MdKitTransportStore, } from "./transport/store.js";

package/dist/fastify.js

@@ -1 +1 @@
-export { registerMdKitFastify } from "./transport/fastify";
+export { registerMdKitFastify } from "./transport/fastify.js";

package/dist/index.d.ts

@@ -1,25 +1,29 @@
-export { useMdKitCollaboration } from "./collaboration/useMdKitCollaboration";
-export { createMdKitDocumentRecord, detectMdKitDocumentConflict, normalizeMdKitVersionToken, restoreMdKitDocumentVersion, writeMdKitDocumentRecord, } from "./core/documentEngine";
-export { useMdKitDocument } from "./document/useMdKitDocument";
-export { MdKitConflictPanel } from "./document/MdKitConflictPanel";
-export { MdKitDocumentToolbar } from "./document/MdKitDocumentToolbar";
-export { MdKitEditor } from "./markdown/MdKitEditor";
-export { MdKitView } from "./markdown/MdKitView";
-export { MdKitThemeEditor } from "./theme/MdKitThemeEditor";
-export { createMdKitRestAdapter } from "./transport/rest";
-export { createMdKitEditorThemeStyle, darkMdKitEditorTheme, defaultMdKitEditorTheme, } from "./theme/editorTheme";
-export { VersionHistoryPanel } from "./versioning/VersionHistoryPanel";
-export { useMdKitDocumentVersions } from "./versioning/useMdKitDocumentVersions";
-export type { CreateMdKitDocumentRecordInput, MdKitDocumentRecord, RestoreMdKitDocumentVersionInput, RestoreMdKitDocumentVersionResult, WriteMdKitDocumentRecordInput, WriteMdKitDocumentRecordResult, } from "./core/documentEngine";
-export type { MdKitCollaborationParticipant, MdKitCollaborationSession, MdKitCollaborationStatus, MdKitDocumentAdapter, MdKitDocumentSnapshot, MdKitDocumentVersionDetail, MdKitDocumentVersionSummary, MdKitDocumentVersionToken, MdKitDocumentWriteInput, MdKitDocumentWriteResult, } from "./document/documentTypes";
-export type { MdKitDocumentConflictDetails, MdKitDocumentController, } from "./document/useMdKitDocument";
-export type { MdKitConflictPanelProps } from "./document/MdKitConflictPanel";
-export type { MdKitDocumentToolbarProps } from "./document/MdKitDocumentToolbar";
-export type { MdKitEditorProps } from "./markdown/MdKitEditor";
-export type { MdKitEditorDebugEvent } from "./markdown/editorDebug";
-export type { MdKitViewProps } from "./markdown/MdKitView";
-export type { MdKitThemeEditorProps } from "./theme/MdKitThemeEditor";
-export type { CreateMdKitRestAdapterOptions } from "./transport/rest";
-export type { MdKitEditorTheme, MdKitEditorThemeStyle, } from "./theme/editorTheme";
-export type { MdKitDocumentVersionsController, UseMdKitDocumentVersionsOptions, } from "./versioning/useMdKitDocumentVersions";
-export type { VersionHistoryPanelProps } from "./versioning/VersionHistoryPanel";
+export { useMdKitCollaboration } from "./collaboration/useMdKitCollaboration.js";
+export { CheckpointPolicy, measureMdKitEditDistance, } from "./core/checkpointPolicy.js";
+export { createMdKitDocumentRecord, detectMdKitDocumentConflict, normalizeMdKitVersionToken, restoreMdKitDocumentVersion, writeMdKitDocumentRecord, } from "./core/documentEngine.js";
+export { useMdKitDocument } from "./document/useMdKitDocument.js";
+export { MdKitConflictPanel } from "./document/MdKitConflictPanel.js";
+export { MdKitDocumentToolbar } from "./document/MdKitDocumentToolbar.js";
+export { MdKitEditor } from "./markdown/MdKitEditor.js";
+export { MdKitView } from "./markdown/MdKitView.js";
+export { MdKitThemeEditor } from "./theme/MdKitThemeEditor.js";
+export { createMdKitRestAdapter } from "./transport/rest.js";
+export { createMdKitEditorThemeStyle, darkMdKitEditorTheme, defaultMdKitEditorTheme, } from "./theme/editorTheme.js";
+export { VersionHistoryPanel } from "./versioning/VersionHistoryPanel.js";
+export { useMdKitDocumentVersions } from "./versioning/useMdKitDocumentVersions.js";
+export { yjs } from "./yjs/index.js";
+export type { MdKitCheckpointPolicy, MdKitCheckpointPolicyInput, MdKitSmartCheckpointPolicyOptions, } from "./core/checkpointPolicy.js";
+export type { CreateMdKitDocumentRecordInput, MdKitDocumentRecord, RestoreMdKitDocumentVersionInput, RestoreMdKitDocumentVersionResult, WriteMdKitDocumentRecordInput, WriteMdKitDocumentRecordResult, } from "./core/documentEngine.js";
+export type { MdKitCollaborationParticipant, MdKitCollaborationSession, MdKitCollaborationStatus, MdKitDocumentAdapter, MdKitDocumentSnapshot, MdKitDocumentVersionDetail, MdKitDocumentVersionSummary, MdKitDocumentVersionToken, MdKitDocumentWriteInput, MdKitDocumentWriteResult, } from "./document/documentTypes.js";
+export type { MdKitDocumentConflictDetails, MdKitDocumentController, } from "./document/useMdKitDocument.js";
+export type { MdKitConflictPanelProps } from "./document/MdKitConflictPanel.js";
+export type { MdKitDocumentToolbarProps } from "./document/MdKitDocumentToolbar.js";
+export type { MdKitEditorProps } from "./markdown/MdKitEditor.js";
+export type { MdKitEditorDebugEvent } from "./markdown/editorDebug.js";
+export type { MdKitViewProps } from "./markdown/MdKitView.js";
+export type { MdKitThemeEditorProps } from "./theme/MdKitThemeEditor.js";
+export type { CreateMdKitRestAdapterOptions } from "./transport/rest.js";
+export type { MdKitEditorTheme, MdKitEditorThemeStyle, } from "./theme/editorTheme.js";
+export type { MdKitDocumentVersionsController, UseMdKitDocumentVersionsOptions, } from "./versioning/useMdKitDocumentVersions.js";
+export type { VersionHistoryPanelProps } from "./versioning/VersionHistoryPanel.js";
+export type { MdKitMarkdownYjsOptions } from "./yjs/index.js";

package/dist/index.js

@@ -1,12 +1,14 @@
-export { useMdKitCollaboration } from "./collaboration/useMdKitCollaboration";
-export { createMdKitDocumentRecord, detectMdKitDocumentConflict, normalizeMdKitVersionToken, restoreMdKitDocumentVersion, writeMdKitDocumentRecord, } from "./core/documentEngine";
-export { useMdKitDocument } from "./document/useMdKitDocument";
-export { MdKitConflictPanel } from "./document/MdKitConflictPanel";
-export { MdKitDocumentToolbar } from "./document/MdKitDocumentToolbar";
-export { MdKitEditor } from "./markdown/MdKitEditor";
-export { MdKitView } from "./markdown/MdKitView";
-export { MdKitThemeEditor } from "./theme/MdKitThemeEditor";
-export { createMdKitRestAdapter } from "./transport/rest";
-export { createMdKitEditorThemeStyle, darkMdKitEditorTheme, defaultMdKitEditorTheme, } from "./theme/editorTheme";
-export { VersionHistoryPanel } from "./versioning/VersionHistoryPanel";
-export { useMdKitDocumentVersions } from "./versioning/useMdKitDocumentVersions";
+export { useMdKitCollaboration } from "./collaboration/useMdKitCollaboration.js";
+export { CheckpointPolicy, measureMdKitEditDistance, } from "./core/checkpointPolicy.js";
+export { createMdKitDocumentRecord, detectMdKitDocumentConflict, normalizeMdKitVersionToken, restoreMdKitDocumentVersion, writeMdKitDocumentRecord, } from "./core/documentEngine.js";
+export { useMdKitDocument } from "./document/useMdKitDocument.js";
+export { MdKitConflictPanel } from "./document/MdKitConflictPanel.js";
+export { MdKitDocumentToolbar } from "./document/MdKitDocumentToolbar.js";
+export { MdKitEditor } from "./markdown/MdKitEditor.js";
+export { MdKitView } from "./markdown/MdKitView.js";
+export { MdKitThemeEditor } from "./theme/MdKitThemeEditor.js";
+export { createMdKitRestAdapter } from "./transport/rest.js";
+export { createMdKitEditorThemeStyle, darkMdKitEditorTheme, defaultMdKitEditorTheme, } from "./theme/editorTheme.js";
+export { VersionHistoryPanel } from "./versioning/VersionHistoryPanel.js";
+export { useMdKitDocumentVersions } from "./versioning/useMdKitDocumentVersions.js";
+export { yjs } from "./yjs/index.js";

package/dist/markdown/MarkdownBubbleMenu.js

@@ -2,7 +2,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEditorState } from "@tiptap/react";
 import { BubbleMenu } from "@tiptap/react/menus";
 import { Bold, Code2, Heading1, Heading2, Italic, Link2, List, ListOrdered, Quote, Strikethrough, } from "lucide-react";
-import { joinClassNames } from "../ui/joinClassNames";
+import { joinClassNames } from "../ui/joinClassNames.js";
 const toolbarActiveStateIsEqual = (left, right) => {
     if (!right) {
         return false;

package/dist/markdown/MdKitEditor.d.ts

@@ -1,6 +1,6 @@
 import type { CSSProperties } from "react";
-import type { MdKitCollaborationSession } from "../document/documentTypes";
-import type { MdKitEditorDebugEvent } from "./editorDebug";
+import type { MdKitCollaborationSession } from "../document/documentTypes.js";
+import type { MdKitEditorDebugEvent } from "./editorDebug.js";
 type MdKitEditorBaseProps = {
     className?: string;
     fillHeight?: boolean;

package/dist/markdown/MdKitEditor.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { joinClassNames } from "../ui/joinClassNames";
-import { TiptapMarkdownSurface } from "./TiptapMarkdownSurface";
+import { joinClassNames } from "../ui/joinClassNames.js";
+import { TiptapMarkdownSurface } from "./TiptapMarkdownSurface.js";
 export const MdKitEditor = (props) => {
     const { className, fillHeight = false, readOnly = false, style, ...surfaceProps } = props;
     return (_jsx("div", { className: joinClassNames("mp-lb-mdkit-markdown-editor", fillHeight && "mp-lb-mdkit-markdown-editor-fill-height", className), "data-read-only": readOnly ? "true" : undefined, style: style, children: _jsx(TiptapMarkdownSurface, { readOnly: readOnly, ...surfaceProps }, props.instanceKey) }));

package/dist/markdown/MdKitView.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import ReactMarkdown from "react-markdown";
 import remarkGfm from "remark-gfm";
-import { joinClassNames } from "../ui/joinClassNames";
+import { joinClassNames } from "../ui/joinClassNames.js";
 export const MdKitView = ({ className, fillHeight = false, placeholder, style, value, }) => {
     const renderedValue = value.trim().length > 0 ? value : (placeholder ?? "");
     return (_jsx("div", { className: joinClassNames("mp-lb-mdkit-markdown-editor", "mp-lb-mdkit-markdown-view", fillHeight && "mp-lb-mdkit-markdown-editor-fill-height", className), "data-read-only": "true", style: style, children: _jsx("div", { className: "mp-lb-mdkit-editor-shell", children: _jsx("div", { className: "mp-lb-mdkit-editor-surface", children: renderedValue.length > 0 ? (_jsx("div", { className: "mp-lb-mdkit-tiptap mp-lb-mdkit-view-content", children: _jsx(ReactMarkdown, { components: {

package/dist/markdown/TiptapMarkdownSurface.d.ts

@@ -1,5 +1,5 @@
-import type { MdKitCollaborationSession } from "../document/documentTypes";
-import type { MdKitEditorDebugEvent } from "./editorDebug";
+import type { MdKitCollaborationSession } from "../document/documentTypes.js";
+import type { MdKitEditorDebugEvent } from "./editorDebug.js";
 type LocalTiptapMarkdownSurfaceProps = {
     collaboration?: null;
     onChange?: (markdown: string) => void;

package/dist/markdown/TiptapMarkdownSurface.js

@@ -2,13 +2,11 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect, useMemo, useRef } from "react";
 import Collaboration from "@tiptap/extension-collaboration";
 import CollaborationCaret from "@tiptap/extension-collaboration-caret";
-import { Markdown } from "@tiptap/markdown";
-import Placeholder from "@tiptap/extension-placeholder";
 import { EditorContent, useEditor } from "@tiptap/react";
-import StarterKit from "@tiptap/starter-kit";
-import { MarkdownBubbleMenu } from "./MarkdownBubbleMenu";
-import { normalizeMarkdownSerialization } from "./normalizeMarkdownSerialization";
-import { prepareMarkdownForEditorHydration } from "./prepareMarkdownForEditorHydration";
+import { createMdKitTiptapExtensions } from "./createMdKitTiptapExtensions.js";
+import { MarkdownBubbleMenu } from "./MarkdownBubbleMenu.js";
+import { normalizeMarkdownSerialization } from "./normalizeMarkdownSerialization.js";
+import { prepareMarkdownForEditorHydration } from "./prepareMarkdownForEditorHydration.js";
 const describeElement = (element) => {
     const classes = element instanceof HTMLElement && element.className
         ? `.${String(element.className).trim().replace(/\s+/g, ".")}`
@@ -123,26 +121,9 @@ export const TiptapMarkdownSurface = (props) => {
             },
         },
         extensions: [
-            StarterKit.configure({
-                heading: { levels: [1, 2] },
-                link: {
-                    HTMLAttributes: {
-                        rel: "noopener noreferrer",
-                        target: "_blank",
-                    },
-                    autolink: true,
-                    linkOnPaste: true,
-                    openOnClick: true,
-                },
-                undoRedo: hasCollaboration ? false : undefined,
-            }),
-            Placeholder.configure({
+            ...createMdKitTiptapExtensions({
                 placeholder,
-            }),
-            Markdown.configure({
-                markedOptions: {
-                    gfm: true,
-                },
+                undoRedo: !hasCollaboration,
             }),
             ...(collaborationDocument
                 ? [
@@ -191,6 +172,33 @@ export const TiptapMarkdownSurface = (props) => {
     useEffect(() => {
         editor?.setEditable(!readOnly);
     }, [editor, readOnly]);
+    useEffect(() => {
+        if (!editor) {
+            return;
+        }
+        const blurEditorOnExternalPointerDown = (event) => {
+            if (editor.isDestroyed) {
+                return;
+            }
+            const target = event.target;
+            if (!(target instanceof Element)) {
+                return;
+            }
+            if (editorSurfaceRef.current?.contains(target) ||
+                target.closest(".mp-lb-mdkit-toolbar")) {
+                return;
+            }
+            editor.commands.blur();
+        };
+        document.addEventListener("pointerdown", blurEditorOnExternalPointerDown, {
+            capture: true,
+        });
+        return () => {
+            document.removeEventListener("pointerdown", blurEditorOnExternalPointerDown, {
+                capture: true,
+            });
+        };
+    }, [editor]);
     useEffect(() => {
         if (!editor) {
             return;

package/dist/markdown/createMdKitTiptapExtensions.d.ts

@@ -0,0 +1,8 @@
+import type { Extensions } from "@tiptap/core";
+type CreateMdKitTiptapExtensionsOptions = {
+    placeholder?: string;
+    undoRedo?: boolean;
+};
+export declare const defaultMdKitMarkdownPlaceholder = "Start writing...";
+export declare const createMdKitTiptapExtensions: ({ placeholder, undoRedo, }?: CreateMdKitTiptapExtensionsOptions) => Extensions;
+export {};

package/dist/markdown/createMdKitTiptapExtensions.js

@@ -0,0 +1,27 @@
+import { Markdown } from "@tiptap/markdown";
+import Placeholder from "@tiptap/extension-placeholder";
+import StarterKit from "@tiptap/starter-kit";
+export const defaultMdKitMarkdownPlaceholder = "Start writing...";
+export const createMdKitTiptapExtensions = ({ placeholder = defaultMdKitMarkdownPlaceholder, undoRedo = true, } = {}) => [
+    StarterKit.configure({
+        heading: { levels: [1, 2] },
+        link: {
+            HTMLAttributes: {
+                rel: "noopener noreferrer",
+                target: "_blank",
+            },
+            autolink: true,
+            linkOnPaste: true,
+            openOnClick: true,
+        },
+        undoRedo: undoRedo ? undefined : false,
+    }),
+    Placeholder.configure({
+        placeholder,
+    }),
+    Markdown.configure({
+        markedOptions: {
+            gfm: true,
+        },
+    }),
+];

package/dist/markdown/prepareMarkdownForEditorHydration.js

@@ -1,4 +1,4 @@
-import { getMarkdownFenceRanges, isInsideMarkdownFence, } from "./markdownFenceRanges";
+import { getMarkdownFenceRanges, isInsideMarkdownFence, } from "./markdownFenceRanges.js";
 const expandedBlankLineRunPattern = /\n{3,}/g;
 export const prepareMarkdownForEditorHydration = (markdown) => {
     const fenceRanges = getMarkdownFenceRanges(markdown);

package/dist/markdown/preserveMarkdownWhitespace.js

@@ -1,4 +1,4 @@
-import { getMarkdownFenceRanges, isInsideMarkdownFence, } from "./markdownFenceRanges";
+import { getMarkdownFenceRanges, isInsideMarkdownFence, } from "./markdownFenceRanges.js";
 const tokenizeMarkdownBlocks = (markdown) => {
     const ranges = getMarkdownFenceRanges(markdown);
     const tokens = [];

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+export { createMdKitBackend } from "./transport/backend.js";
+export type { CreateMdKitBackendOptions, MdKitBackendStore, MdKitCreateCheckpointInput, } from "./transport/backend.js";

package/dist/server.js

@@ -0,0 +1 @@
+export { createMdKitBackend } from "./transport/backend.js";

package/dist/theme/MdKitThemeEditor.d.ts

@@ -1,4 +1,4 @@
-import type { MdKitEditorTheme } from "./editorTheme";
+import type { MdKitEditorTheme } from "./editorTheme.js";
 export type MdKitThemeEditorProps = {
     className?: string;
     onChange: (theme: MdKitEditorTheme) => void;

package/dist/transport/backend.d.ts

@@ -0,0 +1,29 @@
+import type { MdKitDocumentSnapshot, MdKitDocumentVersionDetail, MdKitDocumentVersionSummary, MdKitDocumentVersionToken, MdKitDocumentWriteInput, MdKitDocumentWriteResult } from "../document/documentTypes.js";
+import { type MdKitCheckpointPolicy } from "../core/checkpointPolicy.js";
+import type { MdKitRestoreDocumentVersionInput, MdKitTransportStore } from "./store.js";
+export type MdKitCreateCheckpointInput = {
+    content: string;
+    documentId: string;
+    metadata?: unknown;
+    sourceRevision: MdKitDocumentVersionToken;
+};
+export type MdKitBackendStore = {
+    createCheckpoint?(input: MdKitCreateCheckpointInput): Promise<MdKitDocumentVersionSummary> | MdKitDocumentVersionSummary;
+    getLatestCheckpoint?(documentId: string): Promise<MdKitDocumentVersionDetail | null> | MdKitDocumentVersionDetail | null;
+    listDocumentVersions?(documentId: string): Promise<MdKitDocumentVersionSummary[]> | MdKitDocumentVersionSummary[];
+    readCollaborationState?(documentName: string): Promise<Uint8Array | null> | Uint8Array | null;
+    readDocument(documentId: string): Promise<MdKitDocumentSnapshot> | MdKitDocumentSnapshot;
+    readDocumentVersion?(input: {
+        documentId: string;
+        versionId: string;
+    }): Promise<MdKitDocumentVersionDetail | null> | MdKitDocumentVersionDetail | null;
+    resyncDocument?(documentId: string): Promise<MdKitDocumentSnapshot> | MdKitDocumentSnapshot;
+    restoreDocumentVersion?(input: MdKitRestoreDocumentVersionInput): Promise<MdKitDocumentWriteResult> | MdKitDocumentWriteResult;
+    writeCollaborationState?(documentName: string, state: Uint8Array): Promise<void> | void;
+    writeDocument(input: MdKitDocumentWriteInput): Promise<MdKitDocumentWriteResult> | MdKitDocumentWriteResult;
+};
+export type CreateMdKitBackendOptions = {
+    checkpointPolicy?: MdKitCheckpointPolicy;
+    store: MdKitBackendStore;
+};
+export declare const createMdKitBackend: ({ checkpointPolicy, store, }: CreateMdKitBackendOptions) => MdKitTransportStore;

package/dist/transport/backend.js

@@ -0,0 +1,93 @@
+import { CheckpointPolicy, measureMdKitEditDistance, } from "../core/checkpointPolicy.js";
+const timestampMs = (value) => {
+    if (!value) {
+        return null;
+    }
+    const timestamp = Date.parse(value);
+    return Number.isFinite(timestamp) ? timestamp : null;
+};
+const successfulWriteRevision = (result) => "conflict" in result ? null : result.version;
+const latestCheckpointFromList = async (store, documentId) => {
+    const versions = await store.listDocumentVersions?.(documentId);
+    const latestSummary = versions?.at(-1);
+    if (!latestSummary || !store.readDocumentVersion) {
+        return null;
+    }
+    return store.readDocumentVersion({
+        documentId,
+        versionId: latestSummary.id,
+    });
+};
+const readLatestCheckpoint = async (store, documentId) => (await store.getLatestCheckpoint?.(documentId)) ??
+    (await latestCheckpointFromList(store, documentId));
+const maybeCreateCheckpoint = async (store, policy, input, result) => {
+    const sourceRevision = successfulWriteRevision(result);
+    if (!store.createCheckpoint || sourceRevision === null) {
+        return;
+    }
+    const previousCheckpoint = await readLatestCheckpoint(store, input.documentId);
+    const previousCheckpointContent = previousCheckpoint?.content ?? null;
+    const editDistance = measureMdKitEditDistance(previousCheckpointContent ?? "", input.content);
+    const checkpointTimestamp = timestampMs(previousCheckpoint?.createdAt);
+    const timeSinceLastCheckpointMs = checkpointTimestamp === null ? null : Date.now() - checkpointTimestamp;
+    const shouldCheckpoint = await policy.shouldCheckpoint({
+        currentContent: input.content,
+        documentId: input.documentId,
+        editDistance,
+        previousCheckpoint,
+        previousCheckpointContent,
+        timeSinceLastCheckpointMs,
+        writeInput: input,
+        writeResult: result,
+    });
+    if (!shouldCheckpoint) {
+        return;
+    }
+    await store.createCheckpoint({
+        content: input.content,
+        documentId: input.documentId,
+        sourceRevision,
+    });
+};
+const restoreWithStorePrimitives = async (store, input) => {
+    if (!store.readDocumentVersion) {
+        if (!store.restoreDocumentVersion) {
+            throw new Error("Version restore is not supported");
+        }
+        return store.restoreDocumentVersion(input);
+    }
+    const restoredVersion = await store.readDocumentVersion(input);
+    if (!restoredVersion) {
+        throw new Error(`Version not found: ${input.versionId}`);
+    }
+    const current = await store.readDocument(input.documentId);
+    const latestCheckpoint = await readLatestCheckpoint(store, input.documentId);
+    if (store.createCheckpoint &&
+        latestCheckpoint?.content !== current.content) {
+        await store.createCheckpoint({
+            content: current.content,
+            documentId: input.documentId,
+            sourceRevision: current.version,
+        });
+    }
+    return store.writeDocument({
+        baseVersion: current.version,
+        content: restoredVersion.content,
+        documentId: input.documentId,
+        force: true,
+    });
+};
+export const createMdKitBackend = ({ checkpointPolicy = CheckpointPolicy.never(), store, }) => ({
+    listDocumentVersions: (documentId) => store.listDocumentVersions?.(documentId) ?? [],
+    readCollaborationState: (documentName) => store.readCollaborationState?.(documentName) ?? null,
+    readDocument: (documentId) => store.readDocument(documentId),
+    readDocumentVersion: (input) => store.readDocumentVersion?.(input) ?? null,
+    resyncDocument: (documentId) => (store.resyncDocument ?? store.readDocument)(documentId),
+    restoreDocumentVersion: (input) => restoreWithStorePrimitives(store, input),
+    writeCollaborationState: (documentName, state) => store.writeCollaborationState?.(documentName, state),
+    writeDocument: async (input) => {
+        const result = await store.writeDocument(input);
+        await maybeCreateCheckpoint(store, checkpointPolicy, input, result);
+        return result;
+    },
+});

package/dist/transport/fastify.d.ts

@@ -1,5 +1,5 @@
 import type { FastifyInstance } from "fastify";
-import type { MdKitTransportStore } from "./store";
+import type { MdKitTransportStore } from "./store.js";
 export type RegisterMdKitFastifyOptions = {
     prefix?: string;
     store: MdKitTransportStore;

package/dist/transport/fastify.js

@@ -1,4 +1,4 @@
-import { createMdKitHttpHandlers } from "./http";
+import { createMdKitHttpHandlers } from "./http.js";
 const send = async (reply, response) => {
     const { body, status } = await response;
     return reply.status(status).send(body);

package/dist/transport/http.d.ts

@@ -1,4 +1,4 @@
-import type { MdKitTransportStore } from "./store";
+import type { MdKitTransportStore } from "./store.js";
 export type MdKitHttpRequest = {
     body?: unknown;
     params?: Record<string, unknown>;

package/dist/transport/index.d.ts

@@ -1,5 +1,5 @@
-export { createMdKitHttpHandlers } from "./http";
-export { createMdKitRestAdapter } from "./rest";
-export type { MdKitHttpHandlers, MdKitHttpRequest, MdKitHttpResponse, } from "./http";
-export type { CreateMdKitRestAdapterOptions } from "./rest";
-export type { MdKitRestoreDocumentVersionInput, MdKitTransportStore, } from "./store";
+export { createMdKitHttpHandlers } from "./http.js";
+export { createMdKitRestAdapter } from "./rest.js";
+export type { MdKitHttpHandlers, MdKitHttpRequest, MdKitHttpResponse, } from "./http.js";
+export type { CreateMdKitRestAdapterOptions } from "./rest.js";
+export type { MdKitRestoreDocumentVersionInput, MdKitTransportStore, } from "./store.js";

package/dist/transport/index.js

@@ -1,2 +1,2 @@
-export { createMdKitHttpHandlers } from "./http";
-export { createMdKitRestAdapter } from "./rest";
+export { createMdKitHttpHandlers } from "./http.js";
+export { createMdKitRestAdapter } from "./rest.js";

package/dist/transport/rest.d.ts

@@ -1,4 +1,4 @@
-import type { MdKitDocumentAdapter } from "../document/documentTypes";
+import type { MdKitDocumentAdapter } from "../document/documentTypes.js";
 export type CreateMdKitRestAdapterOptions = {
     baseUrl: string;
     fetch?: typeof fetch;

package/dist/transport/store.d.ts

@@ -1,4 +1,4 @@
-import type { MdKitDocumentSnapshot, MdKitDocumentVersionDetail, MdKitDocumentVersionSummary, MdKitDocumentWriteInput, MdKitDocumentWriteResult } from "../document/documentTypes";
+import type { MdKitDocumentSnapshot, MdKitDocumentVersionDetail, MdKitDocumentVersionSummary, MdKitDocumentWriteInput, MdKitDocumentWriteResult } from "../document/documentTypes.js";
 export type MdKitTransportStore = {
     readDocument(documentId: string): Promise<MdKitDocumentSnapshot> | MdKitDocumentSnapshot;
     writeDocument(input: MdKitDocumentWriteInput): Promise<MdKitDocumentWriteResult> | MdKitDocumentWriteResult;