@mp-lb/mdkit 0.3.1 → 0.3.3

package/README.md

@@ -8,6 +8,9 @@ Frontend primitives for document editing flows:
 - `useMdKitDocumentVersions` and `VersionHistoryPanel` for version browsing and restore flows
 - `useMdKitCollaboration` for wiring the same editor into a Hocuspocus/Yjs session
 
+📖 **Full documentation: [mdkit.mp-lb.dev](https://mdkit.mp-lb.dev/)** — guide,
+recipes, and the generated [API reference](https://mdkit.mp-lb.dev/docs/reference).
+
 ## Install
 
 ```bash
@@ -129,5 +132,8 @@ package in unconnected and connected modes.
 
 ## Package Docs
 
-Published library docs live in [`docs/index.md`](./docs/index.md). Internal
-project notes live in the repository under [`../../docs/mdkit`](../../docs/mdkit).
+Published library docs live under [`docs/public/`](./docs/public) — the
+hand-written guide plus the TypeDoc-generated [`reference/`](./docs/public/reference)
+(never hand-edited; run `pnpm docs:gen` to regenerate). They are rendered as a
+site at [mdkit.mp-lb.dev](https://mdkit.mp-lb.dev/). Internal project notes live
+in the repository under [`../../docs/mdkit`](../../docs/mdkit).

package/dist/collaboration/useMdKitCollaboration.d.ts

@@ -7,4 +7,9 @@ export type UseMdKitCollaborationOptions = {
     getToken?: () => Promise<string | null>;
     resolveRoomName?: (documentId: string) => string;
 };
+/**
+ * Creates a Hocuspocus/Yjs collaboration session for {@link MdKitEditor},
+ * managing the provider connection, local participant, and presence.
+ */
 export declare const useMdKitCollaboration: (options: UseMdKitCollaborationOptions) => MdKitCollaborationSession | null;
+//# sourceMappingURL=useMdKitCollaboration.d.ts.map

package/dist/collaboration/useMdKitCollaboration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMdKitCollaboration.d.ts","sourceRoot":"","sources":["../../src/collaboration/useMdKitCollaboration.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,6BAA6B,EAE7B,yBAAyB,EAE1B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,4BAA4B,GAAG;IACzC,YAAY,EAAE,6BAA6B,CAAC;IAC5C,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,eAAe,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;CAClD,CAAC;AA6KF;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAChC,SAAS,4BAA4B,KACpC,yBAAyB,GAAG,IA2U9B,CAAC"}

package/dist/collaboration/useMdKitCollaboration.js

@@ -117,6 +117,10 @@ const setProviderUser = (provider, collaborator) => {
         name: collaborator.name,
     });
 };
+/**
+ * Creates a Hocuspocus/Yjs collaboration session for {@link MdKitEditor},
+ * managing the provider connection, local participant, and presence.
+ */
 export const useMdKitCollaboration = (options) => {
     const { collaborator, documentId, enabled = true, endpoint, getToken, resolveRoomName, } = options;
     const [status, setStatus] = useState("disconnected");

package/dist/core/checkpointPolicy.d.ts

@@ -17,9 +17,19 @@ export type MdKitSmartCheckpointPolicyOptions = {
     minIntervalMs?: number;
 };
 export declare const measureMdKitEditDistance: (left: string, right: string) => number;
+/**
+ * Factories for the policy that decides when a saved document becomes a
+ * checkpoint. Pass the result to `createMdKitBackend`, not to your store.
+ *
+ * @remarks
+ * `smart()` applies the default autosave-friendly heuristic; `function()`
+ * receives mdkit's computed edit distance alongside the raw content so you can
+ * build a custom rule.
+ */
 export declare const CheckpointPolicy: {
     readonly always: () => MdKitCheckpointPolicy;
     readonly function: (shouldCheckpoint: MdKitCheckpointPolicy["shouldCheckpoint"]) => MdKitCheckpointPolicy;
     readonly never: () => MdKitCheckpointPolicy;
     readonly smart: (options?: MdKitSmartCheckpointPolicyOptions) => MdKitCheckpointPolicy;
 };
+//# sourceMappingURL=checkpointPolicy.d.ts.map

package/dist/core/checkpointPolicy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkpointPolicy.d.ts","sourceRoot":"","sources":["../../src/core/checkpointPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,0BAA0B,GAAG;IACvC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACtD,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,UAAU,EAAE,uBAAuB,CAAC;IACpC,WAAW,EAAE,wBAAwB,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,gBAAgB,CACd,KAAK,EAAE,0BAA0B,GAChC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAKF,eAAO,MAAM,wBAAwB,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,WAiCnE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB;2BACf,qBAAqB;0CAIb,qBAAqB,CAAC,kBAAkB,CAAC,KAC1D,qBAAqB;0BAGb,qBAAqB;+BAIrB,iCAAiC,KACzC,qBAAqB;CAiBhB,CAAC"}

package/dist/core/checkpointPolicy.js

@@ -22,6 +22,15 @@ export const measureMdKitEditDistance = (left, right) => {
     }
     return previous[right.length] ?? 0;
 };
+/**
+ * Factories for the policy that decides when a saved document becomes a
+ * checkpoint. Pass the result to `createMdKitBackend`, not to your store.
+ *
+ * @remarks
+ * `smart()` applies the default autosave-friendly heuristic; `function()`
+ * receives mdkit's computed edit distance alongside the raw content so you can
+ * build a custom rule.
+ */
 export const CheckpointPolicy = {
     always: () => ({
         shouldCheckpoint: () => true,

package/dist/core/documentEngine.d.ts

@@ -36,3 +36,4 @@ export declare const detectMdKitDocumentConflict: (input: {
 export declare const createMdKitDocumentRecord: (input?: CreateMdKitDocumentRecordInput) => MdKitDocumentRecord;
 export declare const writeMdKitDocumentRecord: (record: MdKitDocumentRecord, input: WriteMdKitDocumentRecordInput) => WriteMdKitDocumentRecordResult;
 export declare const restoreMdKitDocumentVersion: (record: MdKitDocumentRecord, input: RestoreMdKitDocumentVersionInput) => RestoreMdKitDocumentVersionResult;
+//# sourceMappingURL=documentEngine.d.ts.map

package/dist/core/documentEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"documentEngine.d.ts","sourceRoot":"","sources":["../../src/core/documentEngine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACzB,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,QAAQ,EAAE,0BAA0B,EAAE,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,WAAW,EAAE,yBAAyB,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,wBAAwB,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,iCAAiC,GAAG;IAC9C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,eAAe,EAAE,0BAA0B,CAAC;IAC5C,MAAM,EAAE,wBAAwB,CAAC;CAClC,CAAC;AAMF,eAAO,MAAM,0BAA0B,GACrC,SAAS,yBAAyB,GAAG,SAAS,kBACD,CAAC;AAEhD,eAAO,MAAM,2BAA2B,GAAI,OAAO;IACjD,WAAW,EAAE,yBAAyB,CAAC;IACvC,cAAc,EAAE,yBAAyB,CAAC;CAC3C,YAEiD,CAAC;AAsBnD,eAAO,MAAM,yBAAyB,GACpC,QAAO,8BAAmC,KACzC,mBAoBF,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,QAAQ,mBAAmB,EAC3B,OAAO,6BAA6B,KACnC,8BA4CF,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,QAAQ,mBAAmB,EAC3B,OAAO,gCAAgC,KACtC,iCAqBF,CAAC"}

package/dist/core/index.d.ts

@@ -3,3 +3,4 @@ export { CheckpointPolicy, measureMdKitEditDistance, } from "./checkpointPolicy.
 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";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EACV,8BAA8B,EAC9B,mBAAmB,EACnB,gCAAgC,EAChC,iCAAiC,EACjC,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,8BAA8B,CAAC"}

package/dist/document/MdKitConflictPanel.d.ts

@@ -4,4 +4,9 @@ export type MdKitConflictPanelProps = {
     document: MdKitDocumentController;
     title?: string;
 };
+/**
+ * Base panel for resolving a save conflict. Previews remote and local content
+ * and keeps one side. Renders `null` when the document has no conflict.
+ */
 export declare const MdKitConflictPanel: ({ className, document, title, }: MdKitConflictPanelProps) => import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=MdKitConflictPanel.d.ts.map

package/dist/document/MdKitConflictPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdKitConflictPanel.d.ts","sourceRoot":"","sources":["../../src/document/MdKitConflictPanel.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAGlE,MAAM,MAAM,uBAAuB,GAAG;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,uBAAuB,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,iCAIhC,uBAAuB,mDA8GzB,CAAC"}

package/dist/document/MdKitConflictPanel.js

@@ -1,6 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { useState } from "react";
 import { joinClassNames } from "../ui/joinClassNames.js";
+/**
+ * Base panel for resolving a save conflict. Previews remote and local content
+ * and keeps one side. Renders `null` when the document has no conflict.
+ */
 export const MdKitConflictPanel = ({ className, document, title = "Document conflict", }) => {
     const [pendingAction, setPendingAction] = useState(null);
     const [activePreview, setActivePreview] = useState("remote");

package/dist/document/MdKitDocumentToolbar.d.ts

@@ -10,4 +10,10 @@ export type MdKitDocumentToolbarProps = {
     showConflictActions?: boolean;
     versions?: MdKitDocumentVersionsController | null;
 };
+/**
+ * Unstyled workflow controls for a connected document: save/collaboration
+ * status plus entry points for version history and conflict resolution. Starter
+ * UI — drop it for your own controls when it doesn't fit.
+ */
 export declare const MdKitDocumentToolbar: ({ className, collaboration, document, onOpenConflict, onOpenVersionHistory, showConflictActions, versions, }: MdKitDocumentToolbarProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=MdKitDocumentToolbar.d.ts.map

package/dist/document/MdKitDocumentToolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdKitDocumentToolbar.d.ts","sourceRoot":"","sources":["../../src/document/MdKitDocumentToolbar.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,wCAAwC,CAAC;AAG9F,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACjD,QAAQ,EAAE,uBAAuB,CAAC;IAClC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC5C,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAClD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,+BAA+B,GAAG,IAAI,CAAC;CACnD,CAAC;AAUF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAAI,8GAQlC,yBAAyB,4CAuG3B,CAAC"}

package/dist/document/MdKitDocumentToolbar.js

@@ -7,6 +7,11 @@ const formatUpdatedAt = (updatedAt) => {
     }
     return `Saved ${new Date(updatedAt).toLocaleTimeString()}`;
 };
+/**
+ * Unstyled workflow controls for a connected document: save/collaboration
+ * status plus entry points for version history and conflict resolution. Starter
+ * UI — drop it for your own controls when it doesn't fit.
+ */
 export const MdKitDocumentToolbar = ({ className, collaboration, document, onOpenConflict, onOpenVersionHistory, showConflictActions = false, versions, }) => {
     const [pendingAction, setPendingAction] = useState(null);
     const otherCollaboratorCount = collaboration?.otherParticipants.length ?? 0;

package/dist/document/documentTypes.d.ts

@@ -31,6 +31,11 @@ export type MdKitDocumentVersionSummary = {
 export type MdKitDocumentVersionDetail = MdKitDocumentVersionSummary & {
     content: string;
 };
+/**
+ * Storage contract the document hooks talk to. Implement it over tRPC, REST, or
+ * anything else; only `readDocument`/`writeDocument` are required, the
+ * checkpoint methods are optional and enable version-history UI.
+ */
 export interface MdKitDocumentAdapter {
     readDocument(documentId: string): Promise<MdKitDocumentSnapshot>;
     writeDocument(input: MdKitDocumentWriteInput): Promise<MdKitDocumentWriteResult>;
@@ -62,3 +67,4 @@ export type MdKitCollaborationSession = {
     roomName: string;
     status: MdKitCollaborationStatus;
 };
+//# sourceMappingURL=documentTypes.d.ts.map

package/dist/document/documentTypes.d.ts.map

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

package/dist/document/useMdKitDocument.d.ts

@@ -30,4 +30,9 @@ export type MdKitDocumentController = {
     value: string;
     version: MdKitDocumentVersionToken;
 };
+/**
+ * Connects an editor to a storage adapter: loads the document, debounces
+ * autosave, tracks dirty/save status, and surfaces conflicts for resolution.
+ */
 export declare const useMdKitDocument: (options: UseMdKitDocumentOptions) => MdKitDocumentController;
+//# sourceMappingURL=useMdKitDocument.d.ts.map

package/dist/document/useMdKitDocument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMdKitDocument.d.ts","sourceRoot":"","sources":["../../src/document/useMdKitDocument.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,iBAAiB,CAAC;AAEzB,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,IAAI,CACX,oBAAoB,EACpB,cAAc,GAAG,eAAe,GAAG,gBAAgB,CACpD,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IACzC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,yBAAyB,CAAC;CAC1C,CAAC;AAEF,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACrD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;IACpD,SAAS,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IACvC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,yBAAyB,CAAC;CACpC,CAAC;AAQF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,uBAAuB,KAC/B,uBAueF,CAAC"}

package/dist/document/useMdKitDocument.js

@@ -4,6 +4,10 @@ const emptyDocumentState = {
     updatedAt: null,
     version: null,
 };
+/**
+ * Connects an editor to a storage adapter: loads the document, debounces
+ * autosave, tracks dirty/save status, and surfaces conflicts for resolution.
+ */
 export const useMdKitDocument = (options) => {
     const { adapter, debounceMs = 1000, documentId, pollMs = 2000 } = options;
     const [local, setLocal] = useState("");

package/dist/fastify.d.ts

@@ -1,3 +1,4 @@
 export { registerMdKitFastify } from "./transport/fastify.js";
 export type { RegisterMdKitFastifyOptions } from "./transport/fastify.js";
 export type { MdKitRestoreDocumentVersionInput, MdKitTransportStore, } from "./transport/store.js";
+//# sourceMappingURL=fastify.d.ts.map

package/dist/fastify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.d.ts","sourceRoot":"","sources":["../src/fastify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AACvE,YAAY,EACV,gCAAgC,EAChC,mBAAmB,GACpB,MAAM,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -15,7 +15,9 @@ export { useMdKitDocumentVersions } from "./versioning/useMdKitDocumentVersions.
 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 { UseMdKitCollaborationOptions } from "./collaboration/useMdKitCollaboration.js";
+export type { UseMdKitDocumentOptions } from "./document/useMdKitDocument.js";
+export type { MdKitCollaborationParticipant, MdKitCollaborationPresence, 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";
@@ -29,3 +31,4 @@ export type { MdKitEditorTheme, MdKitEditorThemeStyle, } from "./theme/editorThe
 export type { MdKitDocumentVersionsController, UseMdKitDocumentVersionsOptions, } from "./versioning/useMdKitDocumentVersions.js";
 export type { VersionHistoryPanelProps } from "./versioning/VersionHistoryPanel.js";
 export type { MdKitMarkdownYjsOptions } from "./yjs/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EACL,gBAAgB,EAChB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,yBAAyB,EACzB,2BAA2B,EAC3B,0BAA0B,EAC1B,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EACL,2BAA2B,EAC3B,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AACvE,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAElC,YAAY,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,iCAAiC,GAClC,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,8BAA8B,EAC9B,mBAAmB,EACnB,gCAAgC,EAChC,iCAAiC,EACjC,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,4BAA4B,EAAE,MAAM,uCAAuC,CAAC;AAC1F,YAAY,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC3E,YAAY,EACV,6BAA6B,EAC7B,0BAA0B,EAC1B,yBAAyB,EACzB,wBAAwB,EACxB,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,0BAA0B,CAAC;AAElC,YAAY,EACV,4BAA4B,EAC5B,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AACrC,YAAY,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAC7E,YAAY,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AACjF,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpE,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,YAAY,EACV,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AACpC,YAAY,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACtE,YAAY,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EACV,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,+BAA+B,EAC/B,+BAA+B,GAChC,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,YAAY,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/markdown/MarkdownBubbleMenu.d.ts

@@ -7,3 +7,4 @@ type BubbleMenuShouldShowProps = Parameters<NonNullable<BubbleMenuProps["shouldS
 export declare const shouldShowMarkdownBubbleMenu: ({ editor, element, from, state, to, view, }: BubbleMenuShouldShowProps) => boolean;
 export declare const MarkdownBubbleMenu: ({ editor }: MarkdownBubbleMenuProps) => import("react/jsx-runtime").JSX.Element;
 export {};
+//# sourceMappingURL=MarkdownBubbleMenu.d.ts.map

package/dist/markdown/MarkdownBubbleMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownBubbleMenu.d.ts","sourceRoot":"","sources":["../../src/markdown/MarkdownBubbleMenu.tsx"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAgBvE,KAAK,uBAAuB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,yBAAyB,GAAG,UAAU,CACzC,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAC3C,CAAC,CAAC,CAAC,CAAC;AA0DL,eAAO,MAAM,4BAA4B,GAAI,6CAO1C,yBAAyB,YAY3B,CAAC;AAqEF,eAAO,MAAM,kBAAkB,GAAI,YAAY,uBAAuB,4CAoGrE,CAAC"}

package/dist/markdown/MarkdownPasteExtension.d.ts

@@ -1,3 +1,4 @@
 import { Extension } from "@tiptap/core";
 export declare const shouldPastePlainTextAsMarkdown: (text: string) => boolean;
 export declare const MarkdownPasteExtension: Extension<any, any>;
+//# sourceMappingURL=MarkdownPasteExtension.d.ts.map

package/dist/markdown/MarkdownPasteExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownPasteExtension.d.ts","sourceRoot":"","sources":["../../src/markdown/MarkdownPasteExtension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAgCzC,eAAO,MAAM,8BAA8B,GAAI,MAAM,MAAM,YAU1D,CAAC;AAEF,eAAO,MAAM,sBAAsB,qBAoCjC,CAAC"}

package/dist/markdown/MarkdownSearchExtension.d.ts

@@ -7,3 +7,4 @@ export type MarkdownSearchMatch = {
 };
 export declare const markdownSearchPluginKey: PluginKey<DecorationSet>;
 export declare const MarkdownSearchExtension: Extension<any, any>;
+//# sourceMappingURL=MarkdownSearchExtension.d.ts.map

package/dist/markdown/MarkdownSearchExtension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownSearchExtension.d.ts","sourceRoot":"","sources":["../../src/markdown/MarkdownSearchExtension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAU,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAc,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE5D,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAOF,eAAO,MAAM,uBAAuB,0BAEnC,CAAC;AAkBF,eAAO,MAAM,uBAAuB,qBAyClC,CAAC"}

package/dist/markdown/MarkdownSearchPanel.d.ts

@@ -11,3 +11,4 @@ type MarkdownSearchPanelProps = {
 };
 export declare const MarkdownSearchPanel: ({ activeMatchNumber, inputRef, matchCount, onClose, onPrevious, onNext, onQueryChange, query, }: MarkdownSearchPanelProps) => import("react/jsx-runtime").JSX.Element;
 export {};
+//# sourceMappingURL=MarkdownSearchPanel.d.ts.map

package/dist/markdown/MarkdownSearchPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownSearchPanel.d.ts","sourceRoot":"","sources":["../../src/markdown/MarkdownSearchPanel.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA4B,SAAS,EAAE,MAAM,OAAO,CAAC;AAEjE,KAAK,wBAAwB,GAAG;IAC9B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,iGASjC,wBAAwB,4CA0E1B,CAAC"}

package/dist/markdown/MdKitEditor.d.ts

@@ -3,7 +3,9 @@ import type { MdKitCollaborationSession } from "../document/documentTypes.js";
 import type { MdKitEditorDebugEvent } from "./editorDebug.js";
 type MdKitEditorBaseProps = {
     className?: string;
+    documentMargins?: boolean;
     fillHeight?: boolean;
+    fixedWidth?: boolean;
     ignoreYamlFrontMatter?: boolean;
     instanceKey?: string | number;
     onDebugEvent?: (event: MdKitEditorDebugEvent) => void;
@@ -23,5 +25,14 @@ type CollaborativeMdKitEditorProps = MdKitEditorBaseProps & {
     value?: string;
 };
 export type MdKitEditorProps = CollaborativeMdKitEditorProps | LocalMdKitEditorProps;
+/**
+ * Markdown-first rich text editor. Behaves like a controlled textarea in local
+ * mode and switches to a Yjs-backed engine when given a collaboration session.
+ *
+ * @remarks
+ * In collaborative mode the Yjs document is the content source; external
+ * `value` changes are not applied into the shared document.
+ */
 export declare const MdKitEditor: (props: MdKitEditorProps) => import("react/jsx-runtime").JSX.Element;
 export {};
+//# sourceMappingURL=MdKitEditor.d.ts.map

package/dist/markdown/MdKitEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdKitEditor.d.ts","sourceRoot":"","sources":["../../src/markdown/MdKitEditor.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAG3D,KAAK,oBAAoB,GAAG;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACtD,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,KAAK,qBAAqB,GAAG,oBAAoB,GAAG;IAClD,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,6BAA6B,GAAG,oBAAoB,GAAG;IAC1D,aAAa,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GACxB,6BAA6B,GAC7B,qBAAqB,CAAC;AAE1B;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,gBAAgB,4CA8BlD,CAAC"}

package/dist/markdown/MdKitEditor.js

@@ -1,7 +1,15 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { joinClassNames } from "../ui/joinClassNames.js";
 import { TiptapMarkdownSurface } from "./TiptapMarkdownSurface.js";
+/**
+ * Markdown-first rich text editor. Behaves like a controlled textarea in local
+ * mode and switches to a Yjs-backed engine when given a collaboration session.
+ *
+ * @remarks
+ * In collaborative mode the Yjs document is the content source; external
+ * `value` changes are not applied into the shared document.
+ */
 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) }));
+    const { className, documentMargins = false, fillHeight = false, fixedWidth = false, readOnly = false, style, ...surfaceProps } = props;
+    return (_jsx("div", { className: joinClassNames("mp-lb-mdkit-markdown-editor", documentMargins && "mp-lb-mdkit-markdown-editor-document-margins", fillHeight && "mp-lb-mdkit-markdown-editor-fill-height", fixedWidth && "mp-lb-mdkit-markdown-editor-fixed-width", className), "data-read-only": readOnly ? "true" : undefined, style: style, children: _jsx(TiptapMarkdownSurface, { readOnly: readOnly, ...surfaceProps }, props.instanceKey) }));
 };

package/dist/markdown/MdKitView.d.ts

@@ -1,10 +1,18 @@
 import type { CSSProperties } from "react";
 export type MdKitViewProps = {
     className?: string;
+    documentMargins?: boolean;
     fillHeight?: boolean;
+    fixedWidth?: boolean;
     ignoreYamlFrontMatter?: boolean;
     placeholder?: string;
     style?: CSSProperties;
     value: string;
 };
-export declare const MdKitView: ({ className, fillHeight, ignoreYamlFrontMatter, placeholder, style, value, }: MdKitViewProps) => import("react/jsx-runtime").JSX.Element;
+/**
+ * Read-only markdown surface that mirrors {@link MdKitEditor}'s styling and
+ * sizing contract without mounting the editor runtime. Use it for previews and
+ * restored checkpoints.
+ */
+export declare const MdKitView: ({ className, documentMargins, fillHeight, fixedWidth, ignoreYamlFrontMatter, placeholder, style, value, }: MdKitViewProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=MdKitView.d.ts.map

package/dist/markdown/MdKitView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdKitView.d.ts","sourceRoot":"","sources":["../../src/markdown/MdKitView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAM3C,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,SAAS,GAAI,2GASvB,cAAc,4CAgDhB,CAAC"}

package/dist/markdown/MdKitView.js

@@ -3,12 +3,17 @@ import ReactMarkdown from "react-markdown";
 import remarkGfm from "remark-gfm";
 import { joinClassNames } from "../ui/joinClassNames.js";
 import { removeYamlFrontMatter } from "./yamlFrontMatter.js";
-export const MdKitView = ({ className, fillHeight = false, ignoreYamlFrontMatter = false, placeholder, style, value, }) => {
+/**
+ * Read-only markdown surface that mirrors {@link MdKitEditor}'s styling and
+ * sizing contract without mounting the editor runtime. Use it for previews and
+ * restored checkpoints.
+ */
+export const MdKitView = ({ className, documentMargins = false, fillHeight = false, fixedWidth = false, ignoreYamlFrontMatter = false, placeholder, style, value, }) => {
     const markdownValue = ignoreYamlFrontMatter
         ? removeYamlFrontMatter(value)
         : value;
     const renderedValue = markdownValue.trim().length > 0 ? markdownValue : (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: {
+    return (_jsx("div", { className: joinClassNames("mp-lb-mdkit-markdown-editor", "mp-lb-mdkit-markdown-view", documentMargins && "mp-lb-mdkit-markdown-editor-document-margins", fillHeight && "mp-lb-mdkit-markdown-editor-fill-height", fixedWidth && "mp-lb-mdkit-markdown-editor-fixed-width", 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: {
                             a: ({ children, ...linkProps }) => (_jsx("a", { ...linkProps, rel: "noopener noreferrer", target: "_blank", children: children })),
                         }, remarkPlugins: [remarkGfm], children: renderedValue }) })) : (_jsx("div", { className: "mp-lb-mdkit-editor-empty" })) }) }) }));
 };

package/dist/markdown/TiptapMarkdownSurface.d.ts

@@ -25,3 +25,4 @@ type CollaborativeTiptapMarkdownSurfaceProps = {
 type TiptapMarkdownSurfaceProps = CollaborativeTiptapMarkdownSurfaceProps | LocalTiptapMarkdownSurfaceProps;
 export declare const TiptapMarkdownSurface: (props: TiptapMarkdownSurfaceProps) => import("react/jsx-runtime").JSX.Element;
 export {};
+//# sourceMappingURL=TiptapMarkdownSurface.d.ts.map

package/dist/markdown/TiptapMarkdownSurface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TiptapMarkdownSurface.d.ts","sourceRoot":"","sources":["../../src/markdown/TiptapMarkdownSurface.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAe3D,KAAK,+BAA+B,GAAG;IACrC,aAAa,CAAC,EAAE,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACtD,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,uCAAuC,GAAG;IAC7C,aAAa,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACtC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,CAAC;IACtD,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC3C,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,KAAK,0BAA0B,GAC3B,uCAAuC,GACvC,+BAA+B,CAAC;AAyEpC,eAAO,MAAM,qBAAqB,GAAI,OAAO,0BAA0B,4CA2xBtE,CAAC"}

package/dist/markdown/TiptapMarkdownSurface.js

@@ -18,6 +18,7 @@ const describeElement = (element) => {
 };
 const describeEventTarget = (target) => target instanceof Element ? describeElement(target) : String(target);
 const isInteractiveElement = (target) => !!target.closest("a,button,input,select,textarea,[contenteditable='false']");
+const isNativeFocusTarget = (target) => !!target.closest("a[href],button,input,select,textarea,[contenteditable='true'],[tabindex]:not([tabindex='-1'])");
 const createEditorDebugSnapshot = (editor, phase) => {
     const activeElement = typeof document === "undefined" || !document.activeElement
         ? null
@@ -75,7 +76,6 @@ export const TiptapMarkdownSurface = (props) => {
     const isApplyingExternalValueRef = useRef(false);
     const pendingControlledEchoesRef = useRef(new Set());
     const pendingContentFocusRef = useRef(null);
-    const shouldFocusAfterPointerRef = useRef(false);
     const [searchOpen, setSearchOpen] = useState(false);
     const [searchQuery, setSearchQuery] = useState("");
     const [activeSearchMatchIndex, setActiveSearchMatchIndex] = useState(0);
@@ -340,10 +340,13 @@ export const TiptapMarkdownSurface = (props) => {
         if (!editor) {
             return;
         }
-        const blurEditorOnExternalPointerDown = (event) => {
+        const blurEditorOnExternalClick = (event) => {
             if (editor.isDestroyed) {
                 return;
             }
+            if (!editor.isFocused && !editor.view.hasFocus()) {
+                return;
+            }
             const target = event.target;
             if (!(target instanceof Element)) {
                 return;
@@ -352,15 +355,14 @@ export const TiptapMarkdownSurface = (props) => {
                 target.closest(".mp-lb-mdkit-toolbar")) {
                 return;
             }
+            if (isNativeFocusTarget(target)) {
+                return;
+            }
             editor.commands.blur();
         };
-        document.addEventListener("pointerdown", blurEditorOnExternalPointerDown, {
-            capture: true,
-        });
+        document.addEventListener("click", blurEditorOnExternalClick);
         return () => {
-            document.removeEventListener("pointerdown", blurEditorOnExternalPointerDown, {
-                capture: true,
-            });
+            document.removeEventListener("click", blurEditorOnExternalClick);
         };
     }, [editor]);
     useEffect(() => {
@@ -483,7 +485,6 @@ export const TiptapMarkdownSurface = (props) => {
     };
     const queueEditorFocusAtPosition = (position) => {
         emitDebugEvent("focus-queued", {
-            pendingFromPointer: shouldFocusAfterPointerRef.current,
             requestedPosition: position,
         });
         window.setTimeout(() => {
@@ -569,7 +570,6 @@ export const TiptapMarkdownSurface = (props) => {
         }
         const requestedPosition = getEditorPositionAtClientPoint(event.clientX, event.clientY, event.target);
         event.preventDefault();
-        shouldFocusAfterPointerRef.current = false;
         emitDebugEvent("hitbox-pointer-down", {
             defaultPrevented: event.defaultPrevented,
             pointerType: event.pointerType,
@@ -582,7 +582,6 @@ export const TiptapMarkdownSurface = (props) => {
         const pendingContentFocus = pendingContentFocusRef.current;
         if (readOnly) {
             pendingContentFocusRef.current = null;
-            shouldFocusAfterPointerRef.current = false;
             return;
         }
         if (pendingContentFocus &&
@@ -598,17 +597,6 @@ export const TiptapMarkdownSurface = (props) => {
             }
             return;
         }
-        if (!shouldFocusAfterPointerRef.current) {
-            return;
-        }
-        event.preventDefault();
-        shouldFocusAfterPointerRef.current = false;
-        emitDebugEvent("hitbox-pointer-up", {
-            defaultPrevented: event.defaultPrevented,
-            pointerType: event.pointerType,
-            target: describeEventTarget(event.target),
-        });
-        queueEditorFocusAtPosition(getEditorPositionAtClientPoint(event.clientX, event.clientY, event.target));
     };
     return (_jsx("div", { className: "mp-lb-mdkit-editor-shell", children: _jsxs("div", { ref: editorSurfaceRef, className: "mp-lb-mdkit-editor-surface", onPointerDownCapture: focusEditorBackgroundOnPointerDown, onPointerUpCapture: focusEditorBackgroundOnPointerUp, children: [search && searchOpen ? (_jsx(MarkdownSearchPanel, { activeMatchNumber: activeSearchMatchNumber, inputRef: searchInputRef, matchCount: searchMatches.length, onClose: closeSearch, onNext: selectNextSearchMatch, onPrevious: selectPreviousSearchMatch, onQueryChange: setSearchQuery, query: searchQuery })) : null, _jsx(MarkdownBubbleMenu, { editor: editor }), _jsx(EditorContent, { editor: editor })] }) }));
 };

package/dist/markdown/createMdKitTiptapExtensions.d.ts

@@ -6,3 +6,4 @@ type CreateMdKitTiptapExtensionsOptions = {
 export declare const defaultMdKitMarkdownPlaceholder = "Start writing...";
 export declare const createMdKitTiptapExtensions: ({ placeholder, undoRedo, }?: CreateMdKitTiptapExtensionsOptions) => Extensions;
 export {};
+//# sourceMappingURL=createMdKitTiptapExtensions.d.ts.map

package/dist/markdown/createMdKitTiptapExtensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createMdKitTiptapExtensions.d.ts","sourceRoot":"","sources":["../../src/markdown/createMdKitTiptapExtensions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAO/C,KAAK,kCAAkC,GAAG;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,eAAO,MAAM,+BAA+B,qBAAqB,CAAC;AAElE,eAAO,MAAM,2BAA2B,GAAI,6BAGzC,kCAAuC,KAAG,UAwB5C,CAAC"}

package/dist/markdown/editorDebug.d.ts

@@ -3,3 +3,4 @@ export type MdKitEditorDebugEvent = {
     timestamp: number;
     type: string;
 };
+//# sourceMappingURL=editorDebug.d.ts.map

package/dist/markdown/editorDebug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorDebug.d.ts","sourceRoot":"","sources":["../../src/markdown/editorDebug.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}

package/dist/markdown/markdownFenceRanges.d.ts

@@ -4,3 +4,4 @@ export type MarkdownFenceRange = {
 };
 export declare const getMarkdownFenceRanges: (markdown: string) => MarkdownFenceRange[];
 export declare const isInsideMarkdownFence: (index: number, ranges: MarkdownFenceRange[]) => boolean;
+//# sourceMappingURL=markdownFenceRanges.d.ts.map

package/dist/markdown/markdownFenceRanges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownFenceRanges.d.ts","sourceRoot":"","sources":["../../src/markdown/markdownFenceRanges.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAIF,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,KACf,kBAAkB,EAqDpB,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,OAAO,MAAM,EACb,QAAQ,kBAAkB,EAAE,YAC4C,CAAC"}

package/dist/markdown/normalizeMarkdownSerialization.d.ts

@@ -1 +1,2 @@
 export declare const normalizeMarkdownSerialization: (markdown: string) => string;
+//# sourceMappingURL=normalizeMarkdownSerialization.d.ts.map

package/dist/markdown/normalizeMarkdownSerialization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizeMarkdownSerialization.d.ts","sourceRoot":"","sources":["../../src/markdown/normalizeMarkdownSerialization.ts"],"names":[],"mappings":"AAgDA,eAAO,MAAM,8BAA8B,GAAI,UAAU,MAAM,WAM5D,CAAC"}

package/dist/markdown/prepareMarkdownForEditorHydration.d.ts

@@ -1 +1,2 @@
 export declare const prepareMarkdownForEditorHydration: (markdown: string) => string;
+//# sourceMappingURL=prepareMarkdownForEditorHydration.d.ts.map

package/dist/markdown/prepareMarkdownForEditorHydration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepareMarkdownForEditorHydration.d.ts","sourceRoot":"","sources":["../../src/markdown/prepareMarkdownForEditorHydration.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,iCAAiC,GAAI,UAAU,MAAM,WAejE,CAAC"}

package/dist/markdown/preserveMarkdownWhitespace.d.ts

@@ -1 +1,2 @@
 export declare const preserveMarkdownWhitespace: (previousRawMarkdown: string, nextSerializedMarkdown: string) => string;
+//# sourceMappingURL=preserveMarkdownWhitespace.d.ts.map

package/dist/markdown/preserveMarkdownWhitespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preserveMarkdownWhitespace.d.ts","sourceRoot":"","sources":["../../src/markdown/preserveMarkdownWhitespace.ts"],"names":[],"mappings":"AAgFA,eAAO,MAAM,0BAA0B,GACrC,qBAAqB,MAAM,EAC3B,wBAAwB,MAAM,WA4D/B,CAAC"}

package/dist/markdown/yamlFrontMatter.d.ts

@@ -14,3 +14,4 @@ export declare const extractYamlFrontMatter: (markdown: string) => MdKitYamlFron
 export declare const hasYamlFrontMatter: (markdown: string) => boolean;
 export declare const removeYamlFrontMatter: (markdown: string) => string;
 export declare const prependYamlFrontMatter: (frontMatter: MdKitYamlFrontMatter | string | null, body: string) => string;
+//# sourceMappingURL=yamlFrontMatter.d.ts.map

package/dist/markdown/yamlFrontMatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yamlFrontMatter.d.ts","sourceRoot":"","sources":["../../src/markdown/yamlFrontMatter.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC1C,CAAC;AA4CF,eAAO,MAAM,oBAAoB,GAAI,MAAM,MAAM,KAAG,OAQnD,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,UAAU,MAAM,KACf,8BA8CF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,UAAU,MAAM,YACI,CAAC;AAExD,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,WACf,CAAC;AAExC,eAAO,MAAM,sBAAsB,GACjC,aAAa,oBAAoB,GAAG,MAAM,GAAG,IAAI,EACjD,MAAM,MAAM,WASb,CAAC"}

package/dist/server.d.ts

@@ -1,2 +1,3 @@
 export { createMdKitBackend } from "./transport/backend.js";
 export type { CreateMdKitBackendOptions, MdKitBackendStore, MdKitCreateCheckpointInput, } from "./transport/backend.js";
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,YAAY,EACV,yBAAyB,EACzB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC"}

package/dist/theme/MdKitThemeEditor.d.ts

@@ -5,4 +5,9 @@ export type MdKitThemeEditorProps = {
     onReset?: () => void;
     theme: MdKitEditorTheme;
 };
+/**
+ * Optional controls for editing an {@link MdKitEditorTheme}. Intended for theme
+ * builders, docs, and debug tools rather than production editing surfaces.
+ */
 export declare const MdKitThemeEditor: ({ className, onChange, onReset, theme, }: MdKitThemeEditorProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=MdKitThemeEditor.d.ts.map

package/dist/theme/MdKitThemeEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdKitThemeEditor.d.ts","sourceRoot":"","sources":["../../src/theme/MdKitThemeEditor.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC5C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,KAAK,EAAE,gBAAgB,CAAC;CACzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,0CAK9B,qBAAqB,4CAmHvB,CAAC"}