@prosekit/core 0.3.1 → 0.3.2

package/dist/_tsup-dts-rollup.d.ts

@@ -598,6 +598,13 @@ declare type DocChangeHandler = (view: EditorView, prevState: EditorState) => vo
 export { DocChangeHandler }
 export { DocChangeHandler as DocChangeHandler_alias_1 }
 
+/**
+ * @internal
+ */
+export declare class DOMDocumentNotFoundError extends ProseKitError {
+    constructor();
+}
+
 /**
  * @internal
  */
@@ -620,6 +627,8 @@ export { DOMEventHandler as DOMEventHandler_alias_1 }
  */
 export declare type DOMEventPayload = [event: string, handler: DOMEventHandler];
 
+export declare type DOMNode = InstanceType<typeof window.Node>;
+
 declare type DoubleClickHandler = (view: EditorView, pos: number, event: MouseEvent) => boolean | void;
 export { DoubleClickHandler }
 export { DoubleClickHandler as DoubleClickHandler_alias_1 }
@@ -726,7 +735,31 @@ export { EditorOptions as EditorOptions_alias_1 }
  *
  * @internal
  */
-export declare function elementFromHTML(html: string): HTMLElement;
+export declare function elementFromHTML(html: string, options?: {
+    document?: Document;
+}): HTMLElement;
+
+/**
+ * Parse a ProseMirror document JSON object to a HTML element.
+ *
+ * @public
+ */
+declare function elementFromJSON(json: NodeJSON, schema: Schema, options?: {
+    document?: Document;
+}): HTMLElement;
+export { elementFromJSON }
+export { elementFromJSON as elementFromJSON_alias_1 }
+
+/**
+ * Serialize a ProseMirror node to a HTML element.
+ *
+ * @public
+ */
+declare function elementFromNode(node: ProseMirrorNode, options?: {
+    document?: Document;
+}): HTMLElement;
+export { elementFromNode }
+export { elementFromNode as elementFromNode_alias_1 }
 
 declare type EmptyValue = undefined | null | EmptyObject;
 
@@ -890,6 +923,14 @@ declare interface FacetOptions<Input, Output> {
 export { FacetOptions }
 export { FacetOptions as FacetOptions_alias_1 }
 
+export declare function findBrowserDocument(options?: {
+    document?: Document;
+}): Document | undefined;
+
+export declare function findBrowserWindow(options?: {
+    document?: Document;
+}): (Window & typeof globalThis) | null | undefined;
+
 /**
  * A function that is called when the editor gains or loses focus.
  *
@@ -901,9 +942,13 @@ declare type FocusChangeHandler = (hasFocus: boolean) => void;
 export { FocusChangeHandler }
 export { FocusChangeHandler as FocusChangeHandler_alias_1 }
 
-export declare function getBrowserDocument(): Document | undefined;
+export declare function getBrowserDocument(options?: {
+    document?: Document;
+}): Document;
 
-export declare function getBrowserWindow(): (Window & typeof globalThis) | null | undefined;
+export declare function getBrowserWindow(options?: {
+    document?: Document;
+}): Window & typeof globalThis;
 
 export declare function getCustomSelection(state: EditorState, from?: number | null, to?: number | null): Selection_3;
 
@@ -938,6 +983,31 @@ export declare type GroupedEntries<T extends Record<string, any>> = {
 
 export declare function groupEntries<T extends Record<string, any>>(entries: ObjectEntries<T>[]): GroupedEntries<T>;
 
+/**
+ * @internal
+ */
+export declare function htmlFromElement(element: HTMLElement): string;
+
+/**
+ * Parse a ProseMirror document JSON object to a HTML string.
+ *
+ * @public
+ */
+declare function htmlFromJSON(json: NodeJSON, schema: Schema, options?: {
+    document?: Document;
+}): string;
+export { htmlFromJSON }
+export { htmlFromJSON as htmlFromJSON_alias_1 }
+
+/**
+ * Serialize a ProseMirror node to a HTML string
+ *
+ * @public
+ */
+declare function htmlFromNode(node: ProseMirrorNode): string;
+export { htmlFromNode }
+export { htmlFromNode as htmlFromNode_alias_1 }
+
 /**
  * Returns a command that inserts the given node at the current selection or at
  * the given position.
@@ -1032,20 +1102,20 @@ export { isTextSelection }
 export { isTextSelection as isTextSelection_alias_1 }
 
 /**
- * Parse a HTML element to a ProseMirror document JSON.
+ * Serialize a HTML element to a ProseMirror document JSON object.
  *
  * @public
  */
-declare function jsonFromElement(element: HTMLElement, schema: Schema): NodeJSON;
-export { jsonFromElement }
-export { jsonFromElement as jsonFromElement_alias_1 }
+export declare function jsonFromElement(element: DOMNode, schema: Schema): NodeJSON;
 
 /**
- * Parse a HTML string to a ProseMirror document JSON.
+ * Parse a HTML string to a ProseMirror document JSON object.
  *
  * @public
  */
-declare function jsonFromHTML(html: string, schema: Schema): NodeJSON;
+declare function jsonFromHTML(html: string, schema: Schema, options?: {
+    document?: Document;
+}): NodeJSON;
 export { jsonFromHTML }
 export { jsonFromHTML as jsonFromHTML_alias_1 }
 
@@ -1199,7 +1269,7 @@ export declare type NodeContent = ProseMirrorNode | ProseMirrorFragment | NodeCo
  *
  * @public
  */
-declare function nodeFromElement(element: HTMLElement, schema: Schema): ProseMirrorNode;
+declare function nodeFromElement(element: DOMNode, schema: Schema): ProseMirrorNode;
 export { nodeFromElement }
 export { nodeFromElement as nodeFromElement_alias_1 }
 
@@ -1208,7 +1278,9 @@ export { nodeFromElement as nodeFromElement_alias_1 }
  *
  * @public
  */
-declare function nodeFromHTML(html: string, schema: Schema): ProseMirrorNode;
+declare function nodeFromHTML(html: string, schema: Schema, options?: {
+    document?: Document;
+}): ProseMirrorNode;
 export { nodeFromHTML }
 export { nodeFromHTML as nodeFromHTML_alias_1 }
 

package/dist/prosekit-core.d.ts

@@ -99,7 +99,10 @@ export { _getId } from './_tsup-dts-rollup';
 export { getMarkType } from './_tsup-dts-rollup';
 export { getNodeType } from './_tsup-dts-rollup';
 export { isInCodeBlock } from './_tsup-dts-rollup';
-export { jsonFromElement } from './_tsup-dts-rollup';
+export { elementFromJSON } from './_tsup-dts-rollup';
+export { elementFromNode } from './_tsup-dts-rollup';
+export { htmlFromJSON } from './_tsup-dts-rollup';
+export { htmlFromNode } from './_tsup-dts-rollup';
 export { jsonFromHTML } from './_tsup-dts-rollup';
 export { jsonFromNode } from './_tsup-dts-rollup';
 export { jsonFromState } from './_tsup-dts-rollup';

package/dist/prosekit-core.js

@@ -15,6 +15,13 @@ var EditorNotFoundError = class extends ProseKitError {
     );
   }
 };
+var DOMDocumentNotFoundError = class extends ProseKitError {
+  constructor() {
+    super(
+      "Unable to find browser Document. When not in the browser environment, you need to pass a DOM Document."
+    );
+  }
+};
 
 // src/utils/get-mark-type.ts
 function getMarkType(schema, type) {
@@ -433,11 +440,11 @@ var stateFacet = Facet.defineRootFacet({
 });
 
 // src/utils/parse.ts
-import { DOMParser } from "@prosekit/pm/model";
+import { DOMParser, DOMSerializer } from "@prosekit/pm/model";
 import { EditorState } from "@prosekit/pm/state";
 
 // src/utils/get-dom-api.ts
-function getGlobalBrowserDocument() {
+function findGlobalBrowserDocument() {
   if (typeof document !== "undefined") {
     return document;
   }
@@ -445,7 +452,7 @@ function getGlobalBrowserDocument() {
     return globalThis.document;
   }
 }
-function getGlobalBrowserWindow() {
+function findGlobalBrowserWindow() {
   if (typeof window !== "undefined") {
     return window;
   }
@@ -453,49 +460,78 @@ function getGlobalBrowserWindow() {
     return globalThis.window;
   }
 }
-function getBrowserWindow() {
-  var _a;
-  const win = getGlobalBrowserWindow();
-  if (win) {
+function findBrowserDocument(options) {
+  var _a, _b, _c;
+  return (_c = (_a = options == null ? void 0 : options.document) != null ? _a : findGlobalBrowserDocument()) != null ? _c : (_b = findGlobalBrowserWindow()) == null ? void 0 : _b.document;
+}
+function findBrowserWindow(options) {
+  var _a, _b, _c, _d;
+  return (_d = (_b = (_a = options == null ? void 0 : options.document) == null ? void 0 : _a.defaultView) != null ? _b : findGlobalBrowserWindow()) != null ? _d : (_c = findBrowserDocument(options)) == null ? void 0 : _c.defaultView;
+}
+function getBrowserDocument(options) {
+  const doc = findBrowserDocument(options);
+  if (doc)
+    return doc;
+  throw new DOMDocumentNotFoundError();
+}
+function getBrowserWindow(options) {
+  const win = findBrowserWindow(options);
+  if (win)
     return win;
-  }
-  return (_a = getGlobalBrowserDocument()) == null ? void 0 : _a.defaultView;
+  throw new DOMDocumentNotFoundError();
 }
 
 // src/utils/parse.ts
-function nodeFromElement(element, schema) {
-  return DOMParser.fromSchema(schema).parse(element);
+function jsonFromState(state) {
+  return state.toJSON();
 }
-function jsonFromElement(element, schema) {
-  return jsonFromNode(nodeFromElement(element, schema));
+function stateFromJSON(json, schema) {
+  return EditorState.fromJSON({ schema }, json);
 }
-function nodeFromHTML(html, schema) {
-  return nodeFromElement(elementFromHTML(html), schema);
+function jsonFromNode(node) {
+  return node.toJSON();
 }
-function jsonFromHTML(html, schema) {
-  return jsonFromElement(elementFromHTML(html), schema);
+function nodeFromJSON(json, schema) {
+  return schema.nodeFromJSON(json);
 }
-function elementFromHTML(html) {
-  const win = getBrowserWindow();
-  if (!win) {
-    throw new ProseKitError(
-      "No Browser Document Found. You can only parse a HTML string in the browser environment."
-    );
+function nodeFromElement(element, schema) {
+  return DOMParser.fromSchema(schema).parse(element);
+}
+function elementFromNode(node, options) {
+  const schema = node.type.schema;
+  const serializer = DOMSerializer.fromSchema(schema);
+  if (schema.topNodeType !== node.type) {
+    return serializer.serializeNode(node, options);
   }
+  const doc = getBrowserDocument();
+  const div = doc.createElement("div");
+  return serializer.serializeFragment(node.content, options, div);
+}
+function elementFromHTML(html, options) {
+  const win = getBrowserWindow(options);
   const parser = new win.DOMParser();
-  return parser.parseFromString(`<body>${html}</body>`, "text/html").body;
+  return parser.parseFromString(`<body><div>${html}</div></body>`, "text/html").body.firstElementChild;
 }
-function jsonFromState(state) {
-  return state.toJSON();
+function htmlFromElement(element) {
+  return element.outerHTML;
 }
-function jsonFromNode(node) {
-  return node.toJSON();
+function nodeFromHTML(html, schema, options) {
+  return nodeFromElement(elementFromHTML(html, options), schema);
 }
-function nodeFromJSON(json, schema) {
-  return schema.nodeFromJSON(json);
+function htmlFromNode(node) {
+  return elementFromNode(node).outerHTML;
 }
-function stateFromJSON(json, schema) {
-  return EditorState.fromJSON({ schema }, json);
+function jsonFromElement(element, schema) {
+  return jsonFromNode(nodeFromElement(element, schema));
+}
+function elementFromJSON(json, schema, options) {
+  return elementFromNode(nodeFromJSON(json, schema), options);
+}
+function jsonFromHTML(html, schema, options) {
+  return jsonFromElement(elementFromHTML(html, options), schema);
+}
+function htmlFromJSON(json, schema, options) {
+  return htmlFromElement(elementFromJSON(json, schema, options));
 }
 
 // src/extensions/default-state.ts
@@ -1975,9 +2011,13 @@ export {
   defineTripleClickOnHandler,
   defineUnmountHandler,
   defineUpdateHandler,
+  elementFromJSON,
+  elementFromNode,
   expandMark,
   getMarkType,
   getNodeType,
+  htmlFromJSON,
+  htmlFromNode,
   insertNode,
   isAllSelection,
   isInCodeBlock,
@@ -1985,7 +2025,6 @@ export {
   isNodeSelection,
   isProseMirrorNode,
   isTextSelection,
-  jsonFromElement,
   jsonFromHTML,
   jsonFromNode,
   jsonFromState,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@prosekit/core",
   "type": "module",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "private": false,
   "author": {
     "name": "ocavue",