@mp-lb/mdkit 0.3.1 → 0.3.3

package/dist/theme/MdKitThemeEditor.js

@@ -1,4 +1,8 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Optional controls for editing an {@link MdKitEditorTheme}. Intended for theme
+ * builders, docs, and debug tools rather than production editing surfaces.
+ */
 export const MdKitThemeEditor = ({ className, onChange, onReset, theme, }) => {
     const updateTheme = (patch) => {
         onChange({

package/dist/theme/editorTheme.d.ts

@@ -18,3 +18,4 @@ export type MdKitEditorThemeStyle = CSSProperties & Record<`--mp-lb-mdkit-${stri
 export declare const defaultMdKitEditorTheme: MdKitEditorTheme;
 export declare const darkMdKitEditorTheme: MdKitEditorTheme;
 export declare const createMdKitEditorThemeStyle: (theme: MdKitEditorTheme) => MdKitEditorThemeStyle;
+//# sourceMappingURL=editorTheme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"editorTheme.d.ts","sourceRoot":"","sources":["../../src/theme/editorTheme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,aAAa,GAC/C,MAAM,CAAC,iBAAiB,MAAM,EAAE,EAAE,MAAM,CAAC,CAAC;AAE5C,eAAO,MAAM,uBAAuB,EAAE,gBAcrC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,gBAclC,CAAC;AAEF,eAAO,MAAM,2BAA2B,GACtC,OAAO,gBAAgB,KACtB,qBAgBD,CAAC"}

package/dist/theme/editorTheme.js

@@ -1,32 +1,32 @@
 export const defaultMdKitEditorTheme = {
     background: "#ffffff",
-    blockGap: "0.72em",
+    blockGap: "1px",
     border: "#d8dee8",
     codeBackground: "#eef1f4",
-    codeRadius: "0.35rem",
+    codeRadius: "0.375rem",
     fontFamily: "inherit",
     fontSize: "16px",
     foreground: "#18212f",
-    lineHeight: "1.55",
+    lineHeight: "1.5",
     link: "#4f46e5",
     muted: "#eef1f4",
     mutedForeground: "#5b6472",
-    surfacePadding: "1rem",
+    surfacePadding: "32px",
 };
 export const darkMdKitEditorTheme = {
     background: "#0b1220",
-    blockGap: "0.72em",
+    blockGap: "1px",
     border: "#314158",
     codeBackground: "#111827",
-    codeRadius: "0.35rem",
+    codeRadius: "0.375rem",
     fontFamily: "inherit",
     fontSize: "16px",
     foreground: "#e5edf7",
-    lineHeight: "1.55",
+    lineHeight: "1.5",
     link: "#38bdf8",
     muted: "#172033",
     mutedForeground: "#94a3b8",
-    surfacePadding: "1rem",
+    surfacePadding: "32px",
 };
 export const createMdKitEditorThemeStyle = (theme) => ({
     "--mp-lb-mdkit-background": theme.background,

package/dist/transport/backend.d.ts

@@ -7,6 +7,12 @@ export type MdKitCreateCheckpointInput = {
     metadata?: unknown;
     sourceRevision: MdKitDocumentVersionToken;
 };
+/**
+ * Application-owned persistence contract consumed by {@link createMdKitBackend}.
+ * Implement it with your database; mdkit calls `createCheckpoint` when the
+ * configured {@link CheckpointPolicy} triggers — the store never interprets the
+ * policy itself.
+ */
 export type MdKitBackendStore = {
     createCheckpoint?(input: MdKitCreateCheckpointInput): Promise<MdKitDocumentVersionSummary> | MdKitDocumentVersionSummary;
     getLatestCheckpoint?(documentId: string): Promise<MdKitDocumentVersionDetail | null> | MdKitDocumentVersionDetail | null;
@@ -26,4 +32,11 @@ export type CreateMdKitBackendOptions = {
     checkpointPolicy?: MdKitCheckpointPolicy;
     store: MdKitBackendStore;
 };
+/**
+ * Wraps an application {@link MdKitBackendStore} with checkpoint-policy
+ * orchestration, producing the transport-ready surface the Fastify and tRPC
+ * helpers mount. The store owns persistence, auth, and metadata; this owns
+ * checkpoint timing and restore ordering.
+ */
 export declare const createMdKitBackend: ({ checkpointPolicy, store, }: CreateMdKitBackendOptions) => MdKitTransportStore;
+//# sourceMappingURL=backend.d.ts.map

package/dist/transport/backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../src/transport/backend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,gCAAgC,EAChC,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,yBAAyB,CAAC;CAC3C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gBAAgB,CAAC,CACf,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,2BAA2B,CAAC,GAAG,2BAA2B,CAAC;IACtE,mBAAmB,CAAC,CAClB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,GAAG,0BAA0B,GAAG,IAAI,CAAC;IAClF,oBAAoB,CAAC,CACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,2BAA2B,EAAE,CAAC,GAAG,2BAA2B,EAAE,CAAC;IAC1E,sBAAsB,CAAC,CACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,UAAU,GAAG,IAAI,CAAC;IAClD,YAAY,CACV,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,CAAC;IAC1D,mBAAmB,CAAC,CAAC,KAAK,EAAE;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,GACG,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,GAC1C,0BAA0B,GAC1B,IAAI,CAAC;IACT,cAAc,CAAC,CACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,CAAC;IAC1D,sBAAsB,CAAC,CACrB,KAAK,EAAE,gCAAgC,GACtC,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAAC;IAChE,uBAAuB,CAAC,CACtB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxB,aAAa,CACX,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAAC;CACjE,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,gBAAgB,CAAC,EAAE,qBAAqB,CAAC;IACzC,KAAK,EAAE,iBAAiB,CAAC;CAC1B,CAAC;AAyHF;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,8BAGhC,yBAAyB,KAAG,mBAiB7B,CAAC"}

package/dist/transport/backend.js

@@ -77,6 +77,12 @@ const restoreWithStorePrimitives = async (store, input) => {
         force: true,
     });
 };
+/**
+ * Wraps an application {@link MdKitBackendStore} with checkpoint-policy
+ * orchestration, producing the transport-ready surface the Fastify and tRPC
+ * helpers mount. The store owns persistence, auth, and metadata; this owns
+ * checkpoint timing and restore ordering.
+ */
 export const createMdKitBackend = ({ checkpointPolicy = CheckpointPolicy.never(), store, }) => ({
     listDocumentVersions: (documentId) => store.listDocumentVersions?.(documentId) ?? [],
     readCollaborationState: (documentName) => store.readCollaborationState?.(documentName) ?? null,

package/dist/transport/fastify.d.ts

@@ -4,4 +4,9 @@ export type RegisterMdKitFastifyOptions = {
     prefix?: string;
     store: MdKitTransportStore;
 };
+/**
+ * Registers the mdkit REST endpoints on a Fastify app under `prefix`, backed by
+ * a transport store (typically from `createMdKitBackend`).
+ */
 export declare const registerMdKitFastify: (app: FastifyInstance, { prefix, store }: RegisterMdKitFastifyOptions) => Promise<void>;
+//# sourceMappingURL=fastify.d.ts.map

package/dist/transport/fastify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fastify.d.ts","sourceRoot":"","sources":["../../src/transport/fastify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAgC,MAAM,SAAS,CAAC;AAE7E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,MAAM,MAAM,2BAA2B,GAAG;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,mBAAmB,CAAC;CAC5B,CAAC;AAgBF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAC/B,KAAK,eAAe,EACpB,mBAAwB,2BAA2B,kBA2BpD,CAAC"}

package/dist/transport/fastify.js

@@ -8,6 +8,10 @@ const toRequest = (request) => ({
     params: request.params,
     query: request.query,
 });
+/**
+ * Registers the mdkit REST endpoints on a Fastify app under `prefix`, backed by
+ * a transport store (typically from `createMdKitBackend`).
+ */
 export const registerMdKitFastify = async (app, { prefix = "", store }) => {
     const handlers = createMdKitHttpHandlers(store);
     app.get(`${prefix}/documents`, (request, reply) => send(reply, handlers.readDocument(toRequest(request))));

package/dist/transport/http.d.ts

@@ -41,3 +41,4 @@ export declare const createMdKitHttpHandlers: (store: MdKitTransportStore) => {
         status: number;
     }>;
 };
+//# sourceMappingURL=http.d.ts.map

package/dist/transport/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,iBAAiB,CAAC,CAAC,GAAG,OAAO,IAAI;IAC3C,IAAI,EAAE,CAAC,CAAC;IACR,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAqD3E,eAAO,MAAM,uBAAuB,GAAI,OAAO,mBAAmB;4BAClC,gBAAgB;;;;6BAIf,gBAAgB;;;;8BAQf,gBAAgB;;;;oCAMV,gBAAgB;;;;;;mCAQjB,gBAAgB;eAhCQ,MAAM;;;;;sCA0C3B,gBAAgB;eA1CK,MAAM;;;;;CAyDnE,CAAC"}

package/dist/transport/index.d.ts

@@ -3,3 +3,4 @@ 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";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transport/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AAChD,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,6BAA6B,EAAE,MAAM,QAAQ,CAAC;AAC5D,YAAY,EACV,gCAAgC,EAChC,mBAAmB,GACpB,MAAM,SAAS,CAAC"}

package/dist/transport/rest.d.ts

@@ -3,4 +3,10 @@ export type CreateMdKitRestAdapterOptions = {
     baseUrl: string;
     fetch?: typeof fetch;
 };
+/**
+ * Builds an {@link MdKitDocumentAdapter} that talks to the mdkit REST endpoint
+ * shape. Restore is not part of the adapter contract, so REST restore needs a
+ * separate call from application code.
+ */
 export declare const createMdKitRestAdapter: ({ baseUrl, fetch: fetchImpl, }: CreateMdKitRestAdapterOptions) => MdKitDocumentAdapter;
+//# sourceMappingURL=rest.d.ts.map

package/dist/transport/rest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rest.d.ts","sourceRoot":"","sources":["../../src/transport/rest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EAErB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,6BAA6B,GAAG;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB,CAAC;AAiBF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,gCAGpC,6BAA6B,KAAG,oBA8ClC,CAAC"}

package/dist/transport/rest.js

@@ -7,6 +7,11 @@ const readJson = async (response) => {
     }
     return body;
 };
+/**
+ * Builds an {@link MdKitDocumentAdapter} that talks to the mdkit REST endpoint
+ * shape. Restore is not part of the adapter contract, so REST restore needs a
+ * separate call from application code.
+ */
 export const createMdKitRestAdapter = ({ baseUrl, fetch: fetchImpl = fetch, }) => {
     const url = trimTrailingSlash(baseUrl);
     return {

package/dist/transport/store.d.ts

@@ -19,3 +19,4 @@ export type MdKitRestoreDocumentVersionInput = {
     documentId: string;
     versionId: string;
 };
+//# sourceMappingURL=store.d.ts.map

package/dist/transport/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/transport/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,CACV,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,CAAC;IAC1D,aAAa,CACX,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAAC;IAChE,cAAc,CAAC,CACb,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,CAAC;IAC1D,oBAAoB,CAAC,CACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,2BAA2B,EAAE,CAAC,GAAG,2BAA2B,EAAE,CAAC;IAC1E,mBAAmB,CAAC,CAAC,KAAK,EAAE;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,GACG,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,GAC1C,0BAA0B,GAC1B,IAAI,CAAC;IACT,sBAAsB,CAAC,CAAC,KAAK,EAAE;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,wBAAwB,CAAC,GAAG,wBAAwB,CAAC;IACjE,sBAAsB,CAAC,CACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,UAAU,GAAG,IAAI,CAAC;IAClD,uBAAuB,CAAC,CACtB,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC"}

package/dist/transport/trpcClient.d.ts

@@ -27,7 +27,14 @@ export type MdKitTrpcClient = {
 export type CreateMdKitTrpcAdapterOptions = {
     client: MdKitTrpcClient;
 };
+/**
+ * Turns an mdkit tRPC client (standalone or a nested sub-client of your app
+ * router) into an {@link MdKitDocumentAdapter} for the document hooks.
+ */
 export declare const createMdKitTrpcAdapter: ({ client, }: CreateMdKitTrpcAdapterOptions) => MdKitDocumentAdapter;
+/**
+ * Creates a typed tRPC proxy client for the mdkit router at `url`.
+ */
 export declare const createMdKitTrpcClient: ({ url, }: CreateMdKitTrpcClientAdapterOptions) => import("@trpc/client").TRPCClient<import("@trpc/server").TRPCBuiltRouter<{
     ctx: object;
     meta: object;
@@ -100,3 +107,4 @@ export declare const createMdKitTrpcClient: ({ url, }: CreateMdKitTrpcClientAdap
 }>>>;
 export declare const createMdKitTrpcClientAdapter: ({ url, }: CreateMdKitTrpcClientAdapterOptions) => MdKitDocumentAdapter;
 export {};
+//# sourceMappingURL=trpcClient.d.ts.map

package/dist/transport/trpcClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trpcClient.d.ts","sourceRoot":"","sources":["../../src/transport/trpcClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,qBAAqB,EACrB,0BAA0B,EAC1B,2BAA2B,EAC3B,uBAAuB,EACvB,wBAAwB,EACzB,MAAM,2BAA2B,CAAC;AAGnC,MAAM,MAAM,mCAAmC,GAAG;IAChD,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,KAAK,cAAc,CAAC,KAAK,EAAE,MAAM,IAAI;IACnC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACtC,CAAC;AAEF,KAAK,iBAAiB,CAAC,KAAK,EAAE,MAAM,IAAI;IACtC,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACvC,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,oBAAoB,EAAE,cAAc,CAClC,kBAAkB,EAClB;QAAE,QAAQ,EAAE,2BAA2B,EAAE,CAAA;KAAE,CAC5C,CAAC;IACF,YAAY,EAAE,cAAc,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;IACxE,mBAAmB,EAAE,cAAc,CACjC,iBAAiB,EACjB,0BAA0B,GAAG,IAAI,CAClC,CAAC;IACF,cAAc,EAAE,iBAAiB,CAAC,kBAAkB,EAAE,qBAAqB,CAAC,CAAC;IAC7E,aAAa,EAAE,iBAAiB,CAC9B,uBAAuB,EACvB,wBAAwB,CACzB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG;IAC1C,MAAM,EAAE,eAAe,CAAC;CACzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,aAEpC,6BAA6B,KAAG,oBASjC,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAEnC,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAOlC,CAAC;AAEL,eAAO,MAAM,4BAA4B,GAAI,UAE1C,mCAAmC,yBAGlC,CAAC"}

package/dist/transport/trpcClient.js

@@ -1,4 +1,8 @@
 import { createTRPCProxyClient, httpBatchLink } from "@trpc/client";
+/**
+ * Turns an mdkit tRPC client (standalone or a nested sub-client of your app
+ * router) into an {@link MdKitDocumentAdapter} for the document hooks.
+ */
 export const createMdKitTrpcAdapter = ({ client, }) => ({
     listDocumentVersions: async (documentId) => {
         const body = await client.listDocumentVersions.query({ documentId });
@@ -9,6 +13,9 @@ export const createMdKitTrpcAdapter = ({ client, }) => ({
     resyncDocument: (documentId) => client.resyncDocument.mutate({ documentId }),
     writeDocument: (input) => client.writeDocument.mutate(input),
 });
+/**
+ * Creates a typed tRPC proxy client for the mdkit router at `url`.
+ */
 export const createMdKitTrpcClient = ({ url, }) => createTRPCProxyClient({
     links: [
         httpBatchLink({

package/dist/transport/trpcServer.d.ts

@@ -1,4 +1,9 @@
 import type { MdKitTransportStore } from "./store.js";
+/**
+ * Builds a tRPC router exposing document read/write/resync, checkpoint
+ * list/read, and restore over a transport store (typically from
+ * `createMdKitBackend`). Mount it standalone or nested in an app router.
+ */
 export declare const createMdKitTrpcRouter: (store: MdKitTransportStore) => import("@trpc/server").TRPCBuiltRouter<{
     ctx: object;
     meta: object;
@@ -70,3 +75,4 @@ export declare const createMdKitTrpcRouter: (store: MdKitTransportStore) => impo
     }>;
 }>>;
 export type MdKitTrpcRouter = ReturnType<typeof createMdKitTrpcRouter>;
+//# sourceMappingURL=trpcServer.d.ts.map

package/dist/transport/trpcServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trpcServer.d.ts","sourceRoot":"","sources":["../../src/transport/trpcServer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAsBnD;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkC5D,CAAC;AAEL,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/dist/transport/trpcServer.js

@@ -15,6 +15,11 @@ const writeInput = z.object({
     documentId: z.string(),
     force: z.boolean().optional(),
 });
+/**
+ * Builds a tRPC router exposing document read/write/resync, checkpoint
+ * list/read, and restore over a transport store (typically from
+ * `createMdKitBackend`). Mount it standalone or nested in an app router.
+ */
 export const createMdKitTrpcRouter = (store) => t.router({
     listDocumentVersions: t.procedure
         .input(documentInput)

package/dist/trpc/client.d.ts

@@ -1,3 +1,4 @@
 export { createMdKitTrpcAdapter, createMdKitTrpcClient, createMdKitTrpcClientAdapter, } from "../transport/trpcClient.js";
 export type { CreateMdKitTrpcAdapterOptions, CreateMdKitTrpcClientAdapterOptions, MdKitTrpcClient, } from "../transport/trpcClient.js";
 export type { MdKitTrpcRouter } from "../transport/trpcServer.js";
+//# sourceMappingURL=client.d.ts.map

package/dist/trpc/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/trpc/client.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,6BAA6B,EAC7B,mCAAmC,EACnC,eAAe,GAChB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/trpc/server.d.ts

@@ -3,3 +3,4 @@ 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";
+//# sourceMappingURL=server.d.ts.map

package/dist/trpc/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/trpc/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EACV,yBAAyB,EACzB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,YAAY,EACV,gCAAgC,EAChC,mBAAmB,GACpB,MAAM,oBAAoB,CAAC"}

package/dist/trpc.d.ts

@@ -1,3 +1,4 @@
 export { createMdKitTrpcAdapter, createMdKitTrpcClient, createMdKitTrpcClientAdapter, } from "./transport/trpcClient.js";
 export type { CreateMdKitTrpcAdapterOptions, CreateMdKitTrpcClientAdapterOptions, MdKitTrpcClient, } from "./transport/trpcClient.js";
 export type { MdKitTrpcRouter } from "./transport/trpcServer.js";
+//# sourceMappingURL=trpc.d.ts.map

package/dist/trpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trpc.d.ts","sourceRoot":"","sources":["../src/trpc.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,6BAA6B,EAC7B,mCAAmC,EACnC,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/ui/joinClassNames.d.ts

@@ -1 +1,2 @@
 export declare const joinClassNames: (...values: Array<string | false | null | undefined>) => string;
+//# sourceMappingURL=joinClassNames.d.ts.map

package/dist/ui/joinClassNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"joinClassNames.d.ts","sourceRoot":"","sources":["../../src/ui/joinClassNames.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,GACzB,GAAG,QAAQ,KAAK,CAAC,MAAM,GAAG,KAAK,GAAG,IAAI,GAAG,SAAS,CAAC,WAChB,CAAC"}

package/dist/versioning/VersionHistoryPanel.d.ts

@@ -6,4 +6,9 @@ export type VersionHistoryPanelProps = {
     onRestoreVersion?: (version: MdKitDocumentVersionDetail) => Promise<void> | void;
     title?: string;
 };
+/**
+ * Renders checkpoint history from {@link useMdKitDocumentVersions} and invokes
+ * the host's restore handler for a chosen checkpoint.
+ */
 export declare const VersionHistoryPanel: ({ className, controller, onRestoreVersion, title, }: VersionHistoryPanelProps) => import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=VersionHistoryPanel.d.ts.map

package/dist/versioning/VersionHistoryPanel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionHistoryPanel.d.ts","sourceRoot":"","sources":["../../src/versioning/VersionHistoryPanel.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,2BAA2B,CAAC;AAC5E,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAGlF,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,+BAA+B,CAAC;IAC5C,gBAAgB,CAAC,EAAE,CACjB,OAAO,EAAE,0BAA0B,KAChC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAgBF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,qDAKjC,wBAAwB,4CA4G1B,CAAC"}

package/dist/versioning/VersionHistoryPanel.js

@@ -10,6 +10,10 @@ const getVersionLabel = (version) => {
     }
     return version.id.slice(0, 8);
 };
+/**
+ * Renders checkpoint history from {@link useMdKitDocumentVersions} and invokes
+ * the host's restore handler for a chosen checkpoint.
+ */
 export const VersionHistoryPanel = ({ className, controller, onRestoreVersion, title = "Version history", }) => {
     const [isRestoring, setIsRestoring] = useState(false);
     const restoreSelectedVersion = async () => {

package/dist/versioning/useMdKitDocumentVersions.d.ts

@@ -14,4 +14,9 @@ export type MdKitDocumentVersionsController = {
     selectedVersionId: string | null;
     versions: MdKitDocumentVersionSummary[];
 };
+/**
+ * Lists a document's checkpoints and lazily reads checkpoint detail, tracking
+ * loading state for checkpoint-history UI.
+ */
 export declare const useMdKitDocumentVersions: (options: UseMdKitDocumentVersionsOptions) => MdKitDocumentVersionsController;
+//# sourceMappingURL=useMdKitDocumentVersions.d.ts.map

package/dist/versioning/useMdKitDocumentVersions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useMdKitDocumentVersions.d.ts","sourceRoot":"","sources":["../../src/versioning/useMdKitDocumentVersions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC5B,MAAM,2BAA2B,CAAC;AAEnC,MAAM,MAAM,+BAA+B,GAAG;IAC5C,OAAO,EAAE,IAAI,CACX,oBAAoB,EACpB,sBAAsB,GAAG,qBAAqB,CAC/C,CAAC;IACF,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,+BAA+B,GAAG;IAC5C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,eAAe,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACnD,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,2BAA2B,EAAE,CAAC;CACzC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,GACnC,SAAS,+BAA+B,KACvC,+BAgHF,CAAC"}

package/dist/versioning/useMdKitDocumentVersions.js

@@ -1,4 +1,8 @@
 import { useCallback, useEffect, useMemo, useState } from "react";
+/**
+ * Lists a document's checkpoints and lazily reads checkpoint detail, tracking
+ * loading state for checkpoint-history UI.
+ */
 export const useMdKitDocumentVersions = (options) => {
     const { adapter, documentId, enabled = true } = options;
     const [versions, setVersions] = useState([]);

package/dist/yjs/MdKitMarkdownYjs.d.ts

@@ -11,3 +11,4 @@ export declare const yjs: {
     mdKitYjsToMarkdown: (yjsState: Uint8Array, options?: MdKitMarkdownYjsOptions) => string;
     replaceMdKitYjsMarkdown: (ydoc: Y.Doc, markdown: string, options?: MdKitMarkdownYjsOptions) => Uint8Array;
 };
+//# sourceMappingURL=MdKitMarkdownYjs.d.ts.map

package/dist/yjs/MdKitMarkdownYjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MdKitMarkdownYjs.d.ts","sourceRoot":"","sources":["../../src/yjs/MdKitMarkdownYjs.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AASzB,MAAM,MAAM,uBAAuB,GAAG;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC,CAAC;AA+BF,eAAO,MAAM,uBAAuB,GAClC,MAAM,CAAC,CAAC,GAAG,EACX,UAAU,MAAM,EAChB,UAAU,uBAAuB,KAChC,UAoBF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,UAAU,MAAM,EAChB,UAAU,uBAAuB,KAChC,UAIF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAC7B,UAAU,UAAU,EACpB,UAAU,uBAAuB,KAChC,MAiBF,CAAC;AAEF,eAAO,MAAM,GAAG;mCA9BJ,MAAM,YACN,uBAAuB,KAChC,UAAU;mCAOD,UAAU,YACV,uBAAuB,KAChC,MAAM;oCArCD,CAAC,CAAC,GAAG,YACD,MAAM,YACN,uBAAuB,KAChC,UAAU;CAyDZ,CAAC"}

package/dist/yjs/index.d.ts

@@ -1,2 +1,3 @@
 export { markdownToMdKitYjs, mdKitYjsToMarkdown, replaceMdKitYjsMarkdown, yjs, } from "./MdKitMarkdownYjs.js";
 export type { MdKitMarkdownYjsOptions } from "./MdKitMarkdownYjs.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/yjs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,uBAAuB,EACvB,GAAG,GACJ,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC"}

package/package.json

@@ -1,18 +1,16 @@
 {
   "name": "@mp-lb/mdkit",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "files": [
     "dist",
-    "docs",
-    "src/styles.css",
-    "!dist/**/*.test.d.ts",
-    "!dist/**/*.test.js",
+    "src",
+    "!dist/**/*.test.*",
     "!dist/test",
-    "!docs/.vitepress/cache",
-    "!docs/.vitepress/dist"
+    "!src/**/*.test.*",
+    "!src/test"
   ],
   "exports": {
     ".": {
@@ -109,17 +107,17 @@
     "dotenv-expand": "^13.0.0",
     "fastify": "^5.1.0",
     "jsdom": "29.1.1",
+    "typedoc": "0.28.19",
+    "typedoc-plugin-markdown": "4.11.0",
     "vite": "7.2.4",
-    "vitepress": "^1.6.4",
     "vitest": "4.1.5"
   },
   "scripts": {
     "dev": "tsc --watch --project tsconfig.json",
     "build": "tsc --project tsconfig.json && node scripts/add-js-extensions.mjs",
-    "docs:build": "vitepress build docs",
-    "docs:dev": "node scripts/load-docs-env.mjs dev",
-    "docs:preview": "node scripts/load-docs-env.mjs preview",
-    "release:check": "pnpm typecheck && pnpm test && pnpm build && pnpm docs:build",
+    "docs:gen": "node scripts/docs-gen.mjs",
+    "docs:check": "node scripts/docs-check.mjs",
+    "release:check": "pnpm typecheck && pnpm test && pnpm build",
     "test": "vitest run",
     "typecheck": "tsc --noEmit --project tsconfig.json"
   }