snapshot of https://github.com/ueberdosis/tiptap.git (main, 2026-09-15; blobs > 131072B omitted)

packages/html/src/generateJSON.ts

@@ -0,0 +1,39 @@
+import type { Extensions } from '@tiptap/core'
+import { getSchema } from '@tiptap/core'
+import type { ParseOptions } from '@tiptap/pm/model'
+import { DOMParser } from '@tiptap/pm/model'
+
+/**
+ * Generates a JSON object from the given HTML string and converts it into a Prosemirror node with content.
+ * @param {string} html - The HTML string to be converted into a Prosemirror node.
+ * @param {Extensions} extensions - The extensions to be used for generating the schema.
+ * @param {ParseOptions} options - The options to be supplied to the parser.
+ * @returns {Record<string, any>} - The generated JSON object.
+ * @example
+ * const html = '<p>Hello, world!</p>'
+ * const extensions = [...]
+ * const json = generateJSON(html, extensions)
+ * console.log(json) // { type: 'doc', content: [{ type: 'paragraph', content: [{ type: 'text', text: 'Hello, world!' }] }] }
+ */
+export function generateJSON(
+  html: string,
+  extensions: Extensions,
+  options?: ParseOptions,
+): Record<string, any> {
+  if (typeof window === 'undefined') {
+    throw new Error(
+      'generateJSON can only be used in a browser environment\nIf you want to use this in a Node environment, use the `@tiptap/html/server` import instead.',
+    )
+  }
+
+  const schema = getSchema(extensions)
+  const doc: Document = new window.DOMParser().parseFromString(html, 'text/html')
+
+  if (!doc) {
+    throw new Error('Failed to parse HTML string')
+  }
+
+  return DOMParser.fromSchema(schema)
+    .parse(doc.body as Node, options)
+    .toJSON()
+}