@carlonicora/nextjs-jsonapi 6.14.1 → 6.15.0

package/dist/components/editors/server.d.mts

@@ -12,4 +12,10 @@ declare function BlockNoteServerContent({ content, size, className, }: {
     className?: string;
 }): Promise<React.JSX.Element | null>;
 
-export { BlockNoteServerContent };
+/**
+ * Renders a BlockNote blocks array to Markdown through BlockNote's own server
+ * editor (`blocksToMarkdownLossy`). Server only.
+ */
+declare function renderBlockNoteMarkdown(blocks: PartialBlock[]): Promise<string>;
+
+export { BlockNoteServerContent, renderBlockNoteMarkdown };

package/dist/components/editors/server.d.ts

@@ -12,4 +12,10 @@ declare function BlockNoteServerContent({ content, size, className, }: {
     className?: string;
 }): Promise<React.JSX.Element | null>;
 
-export { BlockNoteServerContent };
+/**
+ * Renders a BlockNote blocks array to Markdown through BlockNote's own server
+ * editor (`blocksToMarkdownLossy`). Server only.
+ */
+declare function renderBlockNoteMarkdown(blocks: PartialBlock[]): Promise<string>;
+
+export { BlockNoteServerContent, renderBlockNoteMarkdown };

package/dist/components/editors/server.js

@@ -6,18 +6,24 @@ var _chunk7QVYU63Ejs = require('../../chunk-7QVYU63E.js');
 require('@blocknote/shadcn/style.css');
 var _components = require('@carlonicora/nextjs-jsonapi/components');
 
-// src/components/editors/server/renderBlockNoteHTML.ts
+// src/components/editors/server/serverEditor.ts
 var _serverutil = require('@blocknote/server-util');
 var editor;
 var queue = Promise.resolve();
-function renderBlockNoteHTML(blocks) {
+function runWithServerEditor(fn) {
   const run = queue.then(() => {
     editor ??= _serverutil.ServerBlockNoteEditor.create();
-    return editor.blocksToFullHTML(blocks);
+    return fn(editor);
   });
   queue = run.catch(() => void 0);
   return run;
 }
+_chunk7QVYU63Ejs.__name.call(void 0, runWithServerEditor, "runWithServerEditor");
+
+// src/components/editors/server/renderBlockNoteHTML.ts
+function renderBlockNoteHTML(blocks) {
+  return runWithServerEditor((editor2) => editor2.blocksToFullHTML(blocks));
+}
 _chunk7QVYU63Ejs.__name.call(void 0, renderBlockNoteHTML, "renderBlockNoteHTML");
 
 // src/components/editors/server/BlockNoteServerContent.tsx
@@ -33,6 +39,13 @@ async function BlockNoteServerContent({
 }
 _chunk7QVYU63Ejs.__name.call(void 0, BlockNoteServerContent, "BlockNoteServerContent");
 
+// src/components/editors/server/renderBlockNoteMarkdown.ts
+function renderBlockNoteMarkdown(blocks) {
+  return runWithServerEditor((editor2) => editor2.blocksToMarkdownLossy(blocks));
+}
+_chunk7QVYU63Ejs.__name.call(void 0, renderBlockNoteMarkdown, "renderBlockNoteMarkdown");
+
+
 
-exports.BlockNoteServerContent = BlockNoteServerContent;
+exports.BlockNoteServerContent = BlockNoteServerContent; exports.renderBlockNoteMarkdown = renderBlockNoteMarkdown;
 //# sourceMappingURL=server.js.map

package/dist/components/editors/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/components/editors/server.js","../../../src/components/editors/server/BlockNoteServerContent.tsx","../../../src/components/editors/server/renderBlockNoteHTML.ts"],"names":[],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC;AACA;ACHA,uCAAO;AAIP,oEAAsC;ADEtC;AACA;AEPA,oDAAsC;AAKtC,IAAI,MAAA;AAMJ,IAAI,MAAA,EAA0B,OAAA,CAAQ,OAAA,CAAQ,CAAA;AAMvC,SAAS,mBAAA,CAAoB,MAAA,EAAyC;AAC3E,EAAA,MAAM,IAAA,EAAM,KAAA,CAAM,IAAA,CAAK,CAAA,EAAA,GAAM;AAC3B,IAAA,OAAA,IAAW,iCAAA,CAAsB,MAAA,CAAO,CAAA;AACxC,IAAA,OAAO,MAAA,CAAO,gBAAA,CAAiB,MAAM,CAAA;AAAA,EACvC,CAAC,CAAA;AACD,EAAA,MAAA,EAAQ,GAAA,CAAI,KAAA,CAAM,CAAA,EAAA,GAAM,KAAA,CAAS,CAAA;AACjC,EAAA,OAAO,GAAA;AACT;AAPgB,qCAAA,mBAAA,EAAA,qBAAA,CAAA;AFGhB;AACA;ACIS,+CAAA;AAbT,MAAA,SAAsB,sBAAA,CAAuB;AAAA,EAC3C,OAAA;AAAA,EACA,IAAA;AAAA,EACA;AACF,CAAA,EAIG;AACD,EAAA,GAAA,CAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,OAAO,EAAA,GAAK,OAAA,CAAQ,OAAA,IAAW,CAAA,EAAG,OAAO,IAAA;AAE5D,EAAA,MAAM,KAAA,EAAO,MAAM,mBAAA,CAAoB,OAAO,CAAA;AAE9C,EAAA,uBAAO,6BAAA,iCAAC,EAAA,EAAsB,IAAA,EAAY,IAAA,EAAY,UAAA,CAAsB,CAAA;AAC9E;AAdsB,qCAAA,sBAAA,EAAA,wBAAA,CAAA;ADqBtB;AACE;AACF,wDAAC","file":"/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/components/editors/server.js","sourcesContent":[null,"import type { PartialBlock } from \"@blocknote/core\";\nimport \"@blocknote/shadcn/style.css\";\n// Imported through the package's own client subpath, like the analytics server\n// pages: the built server entry must reach the viewer through the \"use client\"\n// bundle, not inline it.\nimport { BlockNoteStaticViewer } from \"@carlonicora/nextjs-jsonapi/components\";\nimport { renderBlockNoteHTML } from \"./renderBlockNoteHTML\";\n\n/**\n * Read-only rich text rendered on the server, so the text is in the HTML that\n * crawlers read. For public read-only pages only: everywhere else, display goes\n * through BlockNoteEditorContainer.\n */\nexport async function BlockNoteServerContent({\n  content,\n  size,\n  className,\n}: {\n  content?: PartialBlock[];\n  size?: \"default\" | \"sm\";\n  className?: string;\n}) {\n  if (!Array.isArray(content) || content.length === 0) return null;\n\n  const html = await renderBlockNoteHTML(content);\n\n  return <BlockNoteStaticViewer html={html} size={size} className={className} />;\n}\n","import type { PartialBlock } from \"@blocknote/core\";\nimport { ServerBlockNoteEditor } from \"@blocknote/server-util\";\n\n// Default schema only, the same one BlockNoteViewer uses: the editor's mention\n// and diff inline specs are React specs from \"use client\" modules (next/link,\n// hover cards), so they cannot run here.\nlet editor: ServerBlockNoteEditor | undefined;\n\n// ServerBlockNoteEditor swaps globalThis.window/document for its JSDOM around\n// each call and restores them after an await. Two overlapping calls would\n// restore each other's values and could leave the JSDOM window on the server's\n// globals, so calls run one at a time.\nlet queue: Promise<unknown> = Promise.resolve();\n\n/**\n * Renders a BlockNote blocks array to the HTML the editor itself would render,\n * through BlockNote's own server editor (`blocksToFullHTML`). Server only.\n */\nexport function renderBlockNoteHTML(blocks: PartialBlock[]): Promise<string> {\n  const run = queue.then(() => {\n    editor ??= ServerBlockNoteEditor.create();\n    return editor.blocksToFullHTML(blocks);\n  });\n  queue = run.catch(() => undefined);\n  return run;\n}\n"]}
+{"version":3,"sources":["/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/components/editors/server.js","../../../src/components/editors/server/BlockNoteServerContent.tsx","../../../src/components/editors/server/serverEditor.ts","../../../src/components/editors/server/renderBlockNoteHTML.ts","../../../src/components/editors/server/renderBlockNoteMarkdown.ts"],"names":["editor"],"mappings":"AAAA;AACE;AACF,0DAAgC;AAChC;AACA;ACHA,uCAAO;AAIP,oEAAsC;ADEtC;AACA;AERA,oDAAsC;AAKtC,IAAI,MAAA;AAMJ,IAAI,MAAA,EAA0B,OAAA,CAAQ,OAAA,CAAQ,CAAA;AAMvC,SAAS,mBAAA,CAAuB,EAAA,EAAmE;AACxG,EAAA,MAAM,IAAA,EAAM,KAAA,CAAM,IAAA,CAAK,CAAA,EAAA,GAAM;AAC3B,IAAA,OAAA,IAAW,iCAAA,CAAsB,MAAA,CAAO,CAAA;AACxC,IAAA,OAAO,EAAA,CAAG,MAAM,CAAA;AAAA,EAClB,CAAC,CAAA;AACD,EAAA,MAAA,EAAQ,GAAA,CAAI,KAAA,CAAM,CAAA,EAAA,GAAM,KAAA,CAAS,CAAA;AACjC,EAAA,OAAO,GAAA;AACT;AAPgB,qCAAA,mBAAA,EAAA,qBAAA,CAAA;AFIhB;AACA;AGfO,SAAS,mBAAA,CAAoB,MAAA,EAAyC;AAC3E,EAAA,OAAO,mBAAA,CAAoB,CAACA,OAAAA,EAAAA,GAAWA,OAAAA,CAAO,gBAAA,CAAiB,MAAM,CAAC,CAAA;AACxE;AAFgB,qCAAA,mBAAA,EAAA,qBAAA,CAAA;AHoBhB;AACA;ACFS,+CAAA;AAbT,MAAA,SAAsB,sBAAA,CAAuB;AAAA,EAC3C,OAAA;AAAA,EACA,IAAA;AAAA,EACA;AACF,CAAA,EAIG;AACD,EAAA,GAAA,CAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,OAAO,EAAA,GAAK,OAAA,CAAQ,OAAA,IAAW,CAAA,EAAG,OAAO,IAAA;AAE5D,EAAA,MAAM,KAAA,EAAO,MAAM,mBAAA,CAAoB,OAAO,CAAA;AAE9C,EAAA,uBAAO,6BAAA,iCAAC,EAAA,EAAsB,IAAA,EAAY,IAAA,EAAY,UAAA,CAAsB,CAAA;AAC9E;AAdsB,qCAAA,sBAAA,EAAA,wBAAA,CAAA;AD2BtB;AACA;AIlCO,SAAS,uBAAA,CAAwB,MAAA,EAAyC;AAC/E,EAAA,OAAO,mBAAA,CAAoB,CAACA,OAAAA,EAAAA,GAAWA,OAAAA,CAAO,qBAAA,CAAsB,MAAM,CAAC,CAAA;AAC7E;AAFgB,qCAAA,uBAAA,EAAA,yBAAA,CAAA;AJuChB;AACE;AACA;AACF,mHAAC","file":"/home/runner/work/nextjs-jsonapi/nextjs-jsonapi/dist/components/editors/server.js","sourcesContent":[null,"import type { PartialBlock } from \"@blocknote/core\";\nimport \"@blocknote/shadcn/style.css\";\n// Imported through the package's own client subpath, like the analytics server\n// pages: the built server entry must reach the viewer through the \"use client\"\n// bundle, not inline it.\nimport { BlockNoteStaticViewer } from \"@carlonicora/nextjs-jsonapi/components\";\nimport { renderBlockNoteHTML } from \"./renderBlockNoteHTML\";\n\n/**\n * Read-only rich text rendered on the server, so the text is in the HTML that\n * crawlers read. For public read-only pages only: everywhere else, display goes\n * through BlockNoteEditorContainer.\n */\nexport async function BlockNoteServerContent({\n  content,\n  size,\n  className,\n}: {\n  content?: PartialBlock[];\n  size?: \"default\" | \"sm\";\n  className?: string;\n}) {\n  if (!Array.isArray(content) || content.length === 0) return null;\n\n  const html = await renderBlockNoteHTML(content);\n\n  return <BlockNoteStaticViewer html={html} size={size} className={className} />;\n}\n","import { ServerBlockNoteEditor } from \"@blocknote/server-util\";\n\n// Default schema only, the same one BlockNoteViewer uses: the editor's mention\n// and diff inline specs are React specs from \"use client\" modules (next/link,\n// hover cards), so they cannot run here.\nlet editor: ServerBlockNoteEditor | undefined;\n\n// ServerBlockNoteEditor swaps globalThis.window/document for its JSDOM around\n// each call and restores them after an await. Two overlapping calls would\n// restore each other's values and could leave the JSDOM window on the server's\n// globals, so calls run one at a time.\nlet queue: Promise<unknown> = Promise.resolve();\n\n/**\n * Runs `fn` with the shared server editor, one call at a time. Server only.\n * Internal to the library: not exported from the barrel.\n */\nexport function runWithServerEditor<T>(fn: (editor: ServerBlockNoteEditor) => T | Promise<T>): Promise<T> {\n  const run = queue.then(() => {\n    editor ??= ServerBlockNoteEditor.create();\n    return fn(editor);\n  });\n  queue = run.catch(() => undefined);\n  return run;\n}\n","import type { PartialBlock } from \"@blocknote/core\";\nimport { runWithServerEditor } from \"./serverEditor\";\n\n/**\n * Renders a BlockNote blocks array to the HTML the editor itself would render,\n * through BlockNote's own server editor (`blocksToFullHTML`). Server only.\n */\nexport function renderBlockNoteHTML(blocks: PartialBlock[]): Promise<string> {\n  return runWithServerEditor((editor) => editor.blocksToFullHTML(blocks));\n}\n","import type { PartialBlock } from \"@blocknote/core\";\nimport { runWithServerEditor } from \"./serverEditor\";\n\n/**\n * Renders a BlockNote blocks array to Markdown through BlockNote's own server\n * editor (`blocksToMarkdownLossy`). Server only.\n */\nexport function renderBlockNoteMarkdown(blocks: PartialBlock[]): Promise<string> {\n  return runWithServerEditor((editor) => editor.blocksToMarkdownLossy(blocks));\n}\n"]}

package/dist/components/editors/server.mjs

@@ -6,18 +6,24 @@ import {
 import "@blocknote/shadcn/style.css";
 import { BlockNoteStaticViewer } from "@carlonicora/nextjs-jsonapi/components";
 
-// src/components/editors/server/renderBlockNoteHTML.ts
+// src/components/editors/server/serverEditor.ts
 import { ServerBlockNoteEditor } from "@blocknote/server-util";
 var editor;
 var queue = Promise.resolve();
-function renderBlockNoteHTML(blocks) {
+function runWithServerEditor(fn) {
   const run = queue.then(() => {
     editor ??= ServerBlockNoteEditor.create();
-    return editor.blocksToFullHTML(blocks);
+    return fn(editor);
   });
   queue = run.catch(() => void 0);
   return run;
 }
+__name(runWithServerEditor, "runWithServerEditor");
+
+// src/components/editors/server/renderBlockNoteHTML.ts
+function renderBlockNoteHTML(blocks) {
+  return runWithServerEditor((editor2) => editor2.blocksToFullHTML(blocks));
+}
 __name(renderBlockNoteHTML, "renderBlockNoteHTML");
 
 // src/components/editors/server/BlockNoteServerContent.tsx
@@ -32,7 +38,14 @@ async function BlockNoteServerContent({
   return /* @__PURE__ */ jsx(BlockNoteStaticViewer, { html, size, className });
 }
 __name(BlockNoteServerContent, "BlockNoteServerContent");
+
+// src/components/editors/server/renderBlockNoteMarkdown.ts
+function renderBlockNoteMarkdown(blocks) {
+  return runWithServerEditor((editor2) => editor2.blocksToMarkdownLossy(blocks));
+}
+__name(renderBlockNoteMarkdown, "renderBlockNoteMarkdown");
 export {
-  BlockNoteServerContent
+  BlockNoteServerContent,
+  renderBlockNoteMarkdown
 };
 //# sourceMappingURL=server.mjs.map

package/dist/components/editors/server.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/components/editors/server/BlockNoteServerContent.tsx","../../../src/components/editors/server/renderBlockNoteHTML.ts"],"sourcesContent":["import type { PartialBlock } from \"@blocknote/core\";\nimport \"@blocknote/shadcn/style.css\";\n// Imported through the package's own client subpath, like the analytics server\n// pages: the built server entry must reach the viewer through the \"use client\"\n// bundle, not inline it.\nimport { BlockNoteStaticViewer } from \"@carlonicora/nextjs-jsonapi/components\";\nimport { renderBlockNoteHTML } from \"./renderBlockNoteHTML\";\n\n/**\n * Read-only rich text rendered on the server, so the text is in the HTML that\n * crawlers read. For public read-only pages only: everywhere else, display goes\n * through BlockNoteEditorContainer.\n */\nexport async function BlockNoteServerContent({\n  content,\n  size,\n  className,\n}: {\n  content?: PartialBlock[];\n  size?: \"default\" | \"sm\";\n  className?: string;\n}) {\n  if (!Array.isArray(content) || content.length === 0) return null;\n\n  const html = await renderBlockNoteHTML(content);\n\n  return <BlockNoteStaticViewer html={html} size={size} className={className} />;\n}\n","import type { PartialBlock } from \"@blocknote/core\";\nimport { ServerBlockNoteEditor } from \"@blocknote/server-util\";\n\n// Default schema only, the same one BlockNoteViewer uses: the editor's mention\n// and diff inline specs are React specs from \"use client\" modules (next/link,\n// hover cards), so they cannot run here.\nlet editor: ServerBlockNoteEditor | undefined;\n\n// ServerBlockNoteEditor swaps globalThis.window/document for its JSDOM around\n// each call and restores them after an await. Two overlapping calls would\n// restore each other's values and could leave the JSDOM window on the server's\n// globals, so calls run one at a time.\nlet queue: Promise<unknown> = Promise.resolve();\n\n/**\n * Renders a BlockNote blocks array to the HTML the editor itself would render,\n * through BlockNote's own server editor (`blocksToFullHTML`). Server only.\n */\nexport function renderBlockNoteHTML(blocks: PartialBlock[]): Promise<string> {\n  const run = queue.then(() => {\n    editor ??= ServerBlockNoteEditor.create();\n    return editor.blocksToFullHTML(blocks);\n  });\n  queue = run.catch(() => undefined);\n  return run;\n}\n"],"mappings":";;;;;AACA,OAAO;AAIP,SAAS,6BAA6B;;;ACJtC,SAAS,6BAA6B;AAKtC,IAAI;AAMJ,IAAI,QAA0B,QAAQ,QAAQ;AAMvC,SAAS,oBAAoB,QAAyC;AAC3E,QAAM,MAAM,MAAM,KAAK,MAAM;AAC3B,eAAW,sBAAsB,OAAO;AACxC,WAAO,OAAO,iBAAiB,MAAM;AAAA,EACvC,CAAC;AACD,UAAQ,IAAI,MAAM,MAAM,MAAS;AACjC,SAAO;AACT;AAPgB;;;ADQP;AAbT,eAAsB,uBAAuB;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,MAAI,CAAC,MAAM,QAAQ,OAAO,KAAK,QAAQ,WAAW,EAAG,QAAO;AAE5D,QAAM,OAAO,MAAM,oBAAoB,OAAO;AAE9C,SAAO,oBAAC,yBAAsB,MAAY,MAAY,WAAsB;AAC9E;AAdsB;","names":[]}
+{"version":3,"sources":["../../../src/components/editors/server/BlockNoteServerContent.tsx","../../../src/components/editors/server/serverEditor.ts","../../../src/components/editors/server/renderBlockNoteHTML.ts","../../../src/components/editors/server/renderBlockNoteMarkdown.ts"],"sourcesContent":["import type { PartialBlock } from \"@blocknote/core\";\nimport \"@blocknote/shadcn/style.css\";\n// Imported through the package's own client subpath, like the analytics server\n// pages: the built server entry must reach the viewer through the \"use client\"\n// bundle, not inline it.\nimport { BlockNoteStaticViewer } from \"@carlonicora/nextjs-jsonapi/components\";\nimport { renderBlockNoteHTML } from \"./renderBlockNoteHTML\";\n\n/**\n * Read-only rich text rendered on the server, so the text is in the HTML that\n * crawlers read. For public read-only pages only: everywhere else, display goes\n * through BlockNoteEditorContainer.\n */\nexport async function BlockNoteServerContent({\n  content,\n  size,\n  className,\n}: {\n  content?: PartialBlock[];\n  size?: \"default\" | \"sm\";\n  className?: string;\n}) {\n  if (!Array.isArray(content) || content.length === 0) return null;\n\n  const html = await renderBlockNoteHTML(content);\n\n  return <BlockNoteStaticViewer html={html} size={size} className={className} />;\n}\n","import { ServerBlockNoteEditor } from \"@blocknote/server-util\";\n\n// Default schema only, the same one BlockNoteViewer uses: the editor's mention\n// and diff inline specs are React specs from \"use client\" modules (next/link,\n// hover cards), so they cannot run here.\nlet editor: ServerBlockNoteEditor | undefined;\n\n// ServerBlockNoteEditor swaps globalThis.window/document for its JSDOM around\n// each call and restores them after an await. Two overlapping calls would\n// restore each other's values and could leave the JSDOM window on the server's\n// globals, so calls run one at a time.\nlet queue: Promise<unknown> = Promise.resolve();\n\n/**\n * Runs `fn` with the shared server editor, one call at a time. Server only.\n * Internal to the library: not exported from the barrel.\n */\nexport function runWithServerEditor<T>(fn: (editor: ServerBlockNoteEditor) => T | Promise<T>): Promise<T> {\n  const run = queue.then(() => {\n    editor ??= ServerBlockNoteEditor.create();\n    return fn(editor);\n  });\n  queue = run.catch(() => undefined);\n  return run;\n}\n","import type { PartialBlock } from \"@blocknote/core\";\nimport { runWithServerEditor } from \"./serverEditor\";\n\n/**\n * Renders a BlockNote blocks array to the HTML the editor itself would render,\n * through BlockNote's own server editor (`blocksToFullHTML`). Server only.\n */\nexport function renderBlockNoteHTML(blocks: PartialBlock[]): Promise<string> {\n  return runWithServerEditor((editor) => editor.blocksToFullHTML(blocks));\n}\n","import type { PartialBlock } from \"@blocknote/core\";\nimport { runWithServerEditor } from \"./serverEditor\";\n\n/**\n * Renders a BlockNote blocks array to Markdown through BlockNote's own server\n * editor (`blocksToMarkdownLossy`). Server only.\n */\nexport function renderBlockNoteMarkdown(blocks: PartialBlock[]): Promise<string> {\n  return runWithServerEditor((editor) => editor.blocksToMarkdownLossy(blocks));\n}\n"],"mappings":";;;;;AACA,OAAO;AAIP,SAAS,6BAA6B;;;ACLtC,SAAS,6BAA6B;AAKtC,IAAI;AAMJ,IAAI,QAA0B,QAAQ,QAAQ;AAMvC,SAAS,oBAAuB,IAAmE;AACxG,QAAM,MAAM,MAAM,KAAK,MAAM;AAC3B,eAAW,sBAAsB,OAAO;AACxC,WAAO,GAAG,MAAM;AAAA,EAClB,CAAC;AACD,UAAQ,IAAI,MAAM,MAAM,MAAS;AACjC,SAAO;AACT;AAPgB;;;ACVT,SAAS,oBAAoB,QAAyC;AAC3E,SAAO,oBAAoB,CAACA,YAAWA,QAAO,iBAAiB,MAAM,CAAC;AACxE;AAFgB;;;AFmBP;AAbT,eAAsB,uBAAuB;AAAA,EAC3C;AAAA,EACA;AAAA,EACA;AACF,GAIG;AACD,MAAI,CAAC,MAAM,QAAQ,OAAO,KAAK,QAAQ,WAAW,EAAG,QAAO;AAE5D,QAAM,OAAO,MAAM,oBAAoB,OAAO;AAE9C,SAAO,oBAAC,yBAAsB,MAAY,MAAY,WAAsB;AAC9E;AAdsB;;;AGNf,SAAS,wBAAwB,QAAyC;AAC/E,SAAO,oBAAoB,CAACC,YAAWA,QAAO,sBAAsB,MAAM,CAAC;AAC7E;AAFgB;","names":["editor","editor"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@carlonicora/nextjs-jsonapi",
-  "version": "6.14.1",
+  "version": "6.15.0",
   "description": "Next.js JSON:API client with server/client support and caching",
   "author": "Carlo Nicora",
   "license": "GPL-3.0-or-later",

package/src/components/editors/server/__tests__/renderBlockNoteMarkdown.spec.ts

@@ -0,0 +1,45 @@
+// @vitest-environment node
+// The server render runs in Node, where there is no window or document of our own:
+// BlockNote's ServerBlockNoteEditor brings its JSDOM.
+import type { PartialBlock } from "@blocknote/core";
+import { describe, expect, it } from "vitest";
+import { renderBlockNoteHTML } from "../renderBlockNoteHTML";
+import { renderBlockNoteMarkdown } from "../renderBlockNoteMarkdown";
+
+const blocks: PartialBlock[] = [
+  { type: "heading", props: { level: 2 }, content: "Think of the Campaign as the lid on the box" },
+  { type: "paragraph", content: "One Campaign is one story arc." },
+  { type: "bulletListItem", content: "Characters" },
+  {
+    type: "paragraph",
+    content: [{ type: "link", href: "https://wyrd.li/help", content: "help" }],
+  },
+  { type: "image", props: { url: "https://wyrd.li/marketing/og.png", caption: "Wyrdli" } },
+  { type: "image", props: { url: "https://wyrd.li/marketing/plain.png" } },
+];
+
+describe("renderBlockNoteMarkdown", () => {
+  it("renders headings, paragraphs, bullet lists and links", async () => {
+    const markdown = await renderBlockNoteMarkdown(blocks);
+
+    expect(markdown).toContain("## Think of the Campaign as the lid on the box");
+    expect(markdown).toContain("One Campaign is one story arc.");
+    expect(markdown).toMatch(/^\s*[-*+] Characters\s*$/m);
+    expect(markdown).toContain("[help](https://wyrd.li/help)");
+    // blocksToMarkdownLossy keeps a captioned image as an HTML <figure> (valid
+    // CommonMark HTML block); an image with no caption becomes ![](url).
+    expect(markdown).toMatch(/<img[^>]*src="https:\/\/wyrd\.li\/marketing\/og\.png"/);
+    expect(markdown).toContain("<figcaption>Wyrdli</figcaption>");
+    expect(markdown).toMatch(/!\[[^\]]*\]\(https:\/\/wyrd\.li\/marketing\/plain\.png\)/);
+  });
+
+  it("two overlapping calls both resolve and leave no JSDOM window on globalThis", async () => {
+    const before = typeof (globalThis as { window?: unknown }).window;
+
+    const [markdown, html] = await Promise.all([renderBlockNoteMarkdown(blocks), renderBlockNoteHTML(blocks)]);
+
+    expect(markdown).toContain("One Campaign is one story arc.");
+    expect(html).toContain("One Campaign is one story arc.");
+    expect(typeof (globalThis as { window?: unknown }).window).toBe(before);
+  });
+});

package/src/components/editors/server/renderBlockNoteHTML.ts

@@ -1,26 +1,10 @@
 import type { PartialBlock } from "@blocknote/core";
-import { ServerBlockNoteEditor } from "@blocknote/server-util";
-
-// Default schema only, the same one BlockNoteViewer uses: the editor's mention
-// and diff inline specs are React specs from "use client" modules (next/link,
-// hover cards), so they cannot run here.
-let editor: ServerBlockNoteEditor | undefined;
-
-// ServerBlockNoteEditor swaps globalThis.window/document for its JSDOM around
-// each call and restores them after an await. Two overlapping calls would
-// restore each other's values and could leave the JSDOM window on the server's
-// globals, so calls run one at a time.
-let queue: Promise<unknown> = Promise.resolve();
+import { runWithServerEditor } from "./serverEditor";
 
 /**
  * Renders a BlockNote blocks array to the HTML the editor itself would render,
  * through BlockNote's own server editor (`blocksToFullHTML`). Server only.
  */
 export function renderBlockNoteHTML(blocks: PartialBlock[]): Promise<string> {
-  const run = queue.then(() => {
-    editor ??= ServerBlockNoteEditor.create();
-    return editor.blocksToFullHTML(blocks);
-  });
-  queue = run.catch(() => undefined);
-  return run;
+  return runWithServerEditor((editor) => editor.blocksToFullHTML(blocks));
 }

package/src/components/editors/server/renderBlockNoteMarkdown.ts

@@ -0,0 +1,10 @@
+import type { PartialBlock } from "@blocknote/core";
+import { runWithServerEditor } from "./serverEditor";
+
+/**
+ * Renders a BlockNote blocks array to Markdown through BlockNote's own server
+ * editor (`blocksToMarkdownLossy`). Server only.
+ */
+export function renderBlockNoteMarkdown(blocks: PartialBlock[]): Promise<string> {
+  return runWithServerEditor((editor) => editor.blocksToMarkdownLossy(blocks));
+}

package/src/components/editors/server/serverEditor.ts

@@ -0,0 +1,25 @@
+import { ServerBlockNoteEditor } from "@blocknote/server-util";
+
+// Default schema only, the same one BlockNoteViewer uses: the editor's mention
+// and diff inline specs are React specs from "use client" modules (next/link,
+// hover cards), so they cannot run here.
+let editor: ServerBlockNoteEditor | undefined;
+
+// ServerBlockNoteEditor swaps globalThis.window/document for its JSDOM around
+// each call and restores them after an await. Two overlapping calls would
+// restore each other's values and could leave the JSDOM window on the server's
+// globals, so calls run one at a time.
+let queue: Promise<unknown> = Promise.resolve();
+
+/**
+ * Runs `fn` with the shared server editor, one call at a time. Server only.
+ * Internal to the library: not exported from the barrel.
+ */
+export function runWithServerEditor<T>(fn: (editor: ServerBlockNoteEditor) => T | Promise<T>): Promise<T> {
+  const run = queue.then(() => {
+    editor ??= ServerBlockNoteEditor.create();
+    return fn(editor);
+  });
+  queue = run.catch(() => undefined);
+  return run;
+}

package/src/components/editors/server-entry.ts

@@ -5,3 +5,4 @@
 // `serverExternalPackages` so Node loads it instead of the bundler.
 
 export { BlockNoteServerContent } from "./server/BlockNoteServerContent";
+export { renderBlockNoteMarkdown } from "./server/renderBlockNoteMarkdown";