@mp-lb/mdkit 0.2.3 → 0.2.4-main.25.1

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, ".")}`
@@ -74,6 +72,8 @@ export const TiptapMarkdownSurface = (props) => {
     const collaborationDocument = collaboration?.document ?? null;
     const collaborationProvider = collaboration?.provider ?? null;
     const collaborationUserColor = collaboration?.collaborator.color ?? "";
+    const collaborationUserId = collaboration?.collaborator.id ?? "";
+    const collaborationUserImageUrl = collaboration?.collaborator.imageUrl ?? "";
     const collaborationUserName = collaboration?.collaborator.name ?? "";
     const hasCollaboration = !!collaborationDocument;
     useEffect(() => {
@@ -105,11 +105,19 @@ export const TiptapMarkdownSurface = (props) => {
                 }),
                 user: {
                     color: collaborationUserColor,
+                    id: collaborationUserId,
+                    imageUrl: collaborationUserImageUrl || undefined,
                     name: collaborationUserName,
                 },
             }),
         ]
-        : [], [collaborationProvider, collaborationUserColor, collaborationUserName]);
+        : [], [
+        collaborationProvider,
+        collaborationUserColor,
+        collaborationUserId,
+        collaborationUserImageUrl,
+        collaborationUserName,
+    ]);
     const editor = useEditor({
         content: hasCollaboration
             ? undefined
@@ -123,26 +131,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
                 ? [

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;

package/dist/transport/trpcClient.d.ts

@@ -1,11 +1,31 @@
-import { createTRPCProxyClient } from "@trpc/client";
-import type { MdKitDocumentAdapter } from "../document/documentTypes";
-import type { MdKitTrpcRouter } from "./trpcServer";
+import type { MdKitDocumentAdapter, MdKitDocumentSnapshot, MdKitDocumentVersionDetail, MdKitDocumentVersionSummary, MdKitDocumentWriteInput, MdKitDocumentWriteResult } from "../document/documentTypes.js";
 export type CreateMdKitTrpcClientAdapterOptions = {
     url: string;
 };
+type MdKitTrpcQuery<Input, Output> = {
+    query(input: Input): Promise<Output>;
+};
+type MdKitTrpcMutation<Input, Output> = {
+    mutate(input: Input): Promise<Output>;
+};
+type MdKitDocumentInput = {
+    documentId: string;
+};
+type MdKitVersionInput = {
+    documentId: string;
+    versionId: string;
+};
+export type MdKitTrpcClient = {
+    listDocumentVersions: MdKitTrpcQuery<MdKitDocumentInput, {
+        versions: MdKitDocumentVersionSummary[];
+    }>;
+    readDocument: MdKitTrpcQuery<MdKitDocumentInput, MdKitDocumentSnapshot>;
+    readDocumentVersion: MdKitTrpcQuery<MdKitVersionInput, MdKitDocumentVersionDetail | null>;
+    resyncDocument: MdKitTrpcMutation<MdKitDocumentInput, MdKitDocumentSnapshot>;
+    writeDocument: MdKitTrpcMutation<MdKitDocumentWriteInput, MdKitDocumentWriteResult>;
+};
 export type CreateMdKitTrpcAdapterOptions = {
-    client: ReturnType<typeof createTRPCProxyClient<MdKitTrpcRouter>>;
+    client: MdKitTrpcClient;
 };
 export declare const createMdKitTrpcAdapter: ({ client, }: CreateMdKitTrpcAdapterOptions) => MdKitDocumentAdapter;
 export declare const createMdKitTrpcClient: ({ url, }: CreateMdKitTrpcClientAdapterOptions) => import("@trpc/client").TRPCClient<import("@trpc/server").TRPCBuiltRouter<{
@@ -19,7 +39,7 @@ export declare const createMdKitTrpcClient: ({ url, }: CreateMdKitTrpcClientAdap
             documentId: string;
         };
         output: {
-            versions: import("..").MdKitDocumentVersionSummary[];
+            versions: MdKitDocumentVersionSummary[];
         };
         meta: object;
     }>;
@@ -27,7 +47,7 @@ export declare const createMdKitTrpcClient: ({ url, }: CreateMdKitTrpcClientAdap
         input: {
             documentId: string;
         };
-        output: import("..").MdKitDocumentSnapshot;
+        output: MdKitDocumentSnapshot;
         meta: object;
     }>;
     readDocumentVersion: import("@trpc/server").TRPCQueryProcedure<{
@@ -35,14 +55,14 @@ export declare const createMdKitTrpcClient: ({ url, }: CreateMdKitTrpcClientAdap
             documentId: string;
             versionId: string;
         };
-        output: import("..").MdKitDocumentVersionDetail | null;
+        output: MdKitDocumentVersionDetail | null;
         meta: object;
     }>;
     resyncDocument: import("@trpc/server").TRPCMutationProcedure<{
         input: {
             documentId: string;
         };
-        output: import("..").MdKitDocumentSnapshot;
+        output: MdKitDocumentSnapshot;
         meta: object;
     }>;
     restoreDocumentVersion: import("@trpc/server").TRPCMutationProcedure<{
@@ -79,3 +99,4 @@ export declare const createMdKitTrpcClient: ({ url, }: CreateMdKitTrpcClientAdap
     }>;
 }>>>;
 export declare const createMdKitTrpcClientAdapter: ({ url, }: CreateMdKitTrpcClientAdapterOptions) => MdKitDocumentAdapter;
+export {};

package/dist/transport/trpcServer.d.ts

@@ -1,4 +1,4 @@
-import type { MdKitTransportStore } from "./store";
+import type { MdKitTransportStore } from "./store.js";
 export declare const createMdKitTrpcRouter: (store: MdKitTransportStore) => import("@trpc/server").TRPCBuiltRouter<{
     ctx: object;
     meta: object;

package/dist/trpc/client.d.ts

@@ -1,3 +1,3 @@
-export { createMdKitTrpcAdapter, createMdKitTrpcClient, createMdKitTrpcClientAdapter, } from "../transport/trpcClient";
-export type { CreateMdKitTrpcAdapterOptions, CreateMdKitTrpcClientAdapterOptions, } from "../transport/trpcClient";
-export type { MdKitTrpcRouter } from "../transport/trpcServer";
+export { createMdKitTrpcAdapter, createMdKitTrpcClient, createMdKitTrpcClientAdapter, } from "../transport/trpcClient.js";
+export type { CreateMdKitTrpcAdapterOptions, CreateMdKitTrpcClientAdapterOptions, MdKitTrpcClient, } from "../transport/trpcClient.js";
+export type { MdKitTrpcRouter } from "../transport/trpcServer.js";

package/dist/trpc/client.js

@@ -1 +1 @@
-export { createMdKitTrpcAdapter, createMdKitTrpcClient, createMdKitTrpcClientAdapter, } from "../transport/trpcClient";
+export { createMdKitTrpcAdapter, createMdKitTrpcClient, createMdKitTrpcClientAdapter, } from "../transport/trpcClient.js";

package/dist/trpc/server.d.ts

@@ -1,3 +1,5 @@
-export { createMdKitTrpcRouter } from "../transport/trpcServer";
-export type { MdKitTrpcRouter } from "../transport/trpcServer";
-export type { MdKitRestoreDocumentVersionInput, MdKitTransportStore, } from "../transport/store";
+export { createMdKitBackend } from "../transport/backend.js";
+export { createMdKitTrpcRouter } from "../transport/trpcServer.js";
+export type { CreateMdKitBackendOptions, MdKitBackendStore, MdKitCreateCheckpointInput, } from "../transport/backend.js";
+export type { MdKitTrpcRouter } from "../transport/trpcServer.js";
+export type { MdKitRestoreDocumentVersionInput, MdKitTransportStore, } from "../transport/store.js";

package/dist/trpc/server.js

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

package/dist/trpc.d.ts

@@ -1,3 +1,3 @@
-export { createMdKitTrpcAdapter, createMdKitTrpcClient, createMdKitTrpcClientAdapter, } from "./transport/trpcClient";
-export type { CreateMdKitTrpcAdapterOptions, CreateMdKitTrpcClientAdapterOptions, } from "./transport/trpcClient";
-export type { MdKitTrpcRouter } from "./transport/trpcServer";
+export { createMdKitTrpcAdapter, createMdKitTrpcClient, createMdKitTrpcClientAdapter, } from "./transport/trpcClient.js";
+export type { CreateMdKitTrpcAdapterOptions, CreateMdKitTrpcClientAdapterOptions, MdKitTrpcClient, } from "./transport/trpcClient.js";
+export type { MdKitTrpcRouter } from "./transport/trpcServer.js";

package/dist/trpc.js

@@ -1 +1 @@
-export { createMdKitTrpcAdapter, createMdKitTrpcClient, createMdKitTrpcClientAdapter, } from "./transport/trpcClient";
+export { createMdKitTrpcAdapter, createMdKitTrpcClient, createMdKitTrpcClientAdapter, } from "./transport/trpcClient.js";

package/dist/versioning/VersionHistoryPanel.d.ts

@@ -1,5 +1,5 @@
-import type { MdKitDocumentVersionDetail } from "../document/documentTypes";
-import type { MdKitDocumentVersionsController } from "./useMdKitDocumentVersions";
+import type { MdKitDocumentVersionDetail } from "../document/documentTypes.js";
+import type { MdKitDocumentVersionsController } from "./useMdKitDocumentVersions.js";
 export type VersionHistoryPanelProps = {
     className?: string;
     controller: MdKitDocumentVersionsController;

package/dist/versioning/VersionHistoryPanel.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useState } from "react";
-import { joinClassNames } from "../ui/joinClassNames";
+import { joinClassNames } from "../ui/joinClassNames.js";
 const getVersionLabel = (version) => {
     if (version.label) {
         return version.label;

package/dist/versioning/useMdKitDocumentVersions.d.ts

@@ -1,7 +1,8 @@
-import type { MdKitDocumentAdapter, MdKitDocumentVersionDetail, MdKitDocumentVersionSummary } from "../document/documentTypes";
+import type { MdKitDocumentAdapter, MdKitDocumentVersionDetail, MdKitDocumentVersionSummary } from "../document/documentTypes.js";
 export type UseMdKitDocumentVersionsOptions = {
     adapter: Pick<MdKitDocumentAdapter, "listDocumentVersions" | "readDocumentVersion">;
     documentId: string | null;
+    enabled?: boolean;
 };
 export type MdKitDocumentVersionsController = {
     error: string | null;

package/dist/versioning/useMdKitDocumentVersions.js

@@ -1,14 +1,14 @@
 import { useCallback, useEffect, useMemo, useState } from "react";
 export const useMdKitDocumentVersions = (options) => {
-    const { adapter, documentId } = options;
+    const { adapter, documentId, enabled = true } = options;
     const [versions, setVersions] = useState([]);
     const [selectedVersionId, setSelectedVersionId] = useState(null);
     const [selectedVersion, setSelectedVersion] = useState(null);
     const [isLoading, setIsLoading] = useState(false);
     const [error, setError] = useState(null);
-    const hasVersioning = !!adapter.listDocumentVersions && !!adapter.readDocumentVersion;
+    const hasVersioning = enabled && !!adapter.listDocumentVersions && !!adapter.readDocumentVersion;
     const refresh = useCallback(async () => {
-        if (!documentId || !adapter.listDocumentVersions) {
+        if (!hasVersioning || !documentId || !adapter.listDocumentVersions) {
             setVersions([]);
             setSelectedVersionId(null);
             setSelectedVersion(null);
@@ -34,9 +34,9 @@ export const useMdKitDocumentVersions = (options) => {
         finally {
             setIsLoading(false);
         }
-    }, [adapter, documentId]);
+    }, [adapter, documentId, hasVersioning]);
     const openVersion = useCallback(async (versionId) => {
-        if (!documentId || !adapter.readDocumentVersion) {
+        if (!hasVersioning || !documentId || !adapter.readDocumentVersion) {
             return;
         }
         setSelectedVersionId(versionId);
@@ -60,7 +60,7 @@ export const useMdKitDocumentVersions = (options) => {
         finally {
             setIsLoading(false);
         }
-    }, [adapter, documentId]);
+    }, [adapter, documentId, hasVersioning]);
     useEffect(() => {
         setSelectedVersionId(null);
         setSelectedVersion(null);

package/dist/yjs/MdKitMarkdownYjs.d.ts

@@ -0,0 +1,12 @@
+import * as Y from "yjs";
+export type MdKitMarkdownYjsOptions = {
+    fragmentName?: string;
+};
+export declare const replaceMdKitYjsMarkdown: (ydoc: Y.Doc, markdown: string, options?: MdKitMarkdownYjsOptions) => Uint8Array;
+export declare const markdownToMdKitYjs: (markdown: string, options?: MdKitMarkdownYjsOptions) => Uint8Array;
+export declare const mdKitYjsToMarkdown: (yjsState: Uint8Array, options?: MdKitMarkdownYjsOptions) => string;
+export declare const yjs: {
+    markdownToMdKitYjs: (markdown: string, options?: MdKitMarkdownYjsOptions) => Uint8Array;
+    mdKitYjsToMarkdown: (yjsState: Uint8Array, options?: MdKitMarkdownYjsOptions) => string;
+    replaceMdKitYjsMarkdown: (ydoc: Y.Doc, markdown: string, options?: MdKitMarkdownYjsOptions) => Uint8Array;
+};