@tiptap/static-renderer 3.0.0-next.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +18 -0
- package/dist/index.cjs +62 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +52 -0
- package/dist/index.d.ts +52 -0
- package/dist/index.js +34 -0
- package/dist/index.js.map +1 -0
- package/dist/json/html-string/index.cjs +100 -0
- package/dist/json/html-string/index.cjs.map +1 -0
- package/dist/json/html-string/index.d.cts +205 -0
- package/dist/json/html-string/index.d.ts +205 -0
- package/dist/json/html-string/index.js +72 -0
- package/dist/json/html-string/index.js.map +1 -0
- package/dist/json/react/index.cjs +2306 -0
- package/dist/json/react/index.cjs.map +1 -0
- package/dist/json/react/index.d.cts +207 -0
- package/dist/json/react/index.d.ts +207 -0
- package/dist/json/react/index.js +2291 -0
- package/dist/json/react/index.js.map +1 -0
- package/dist/json/renderer.cjs +89 -0
- package/dist/json/renderer.cjs.map +1 -0
- package/dist/json/renderer.d.cts +182 -0
- package/dist/json/renderer.d.ts +182 -0
- package/dist/json/renderer.js +64 -0
- package/dist/json/renderer.js.map +1 -0
- package/dist/pm/html-string/index.cjs +359 -0
- package/dist/pm/html-string/index.cjs.map +1 -0
- package/dist/pm/html-string/index.d.cts +192 -0
- package/dist/pm/html-string/index.d.ts +192 -0
- package/dist/pm/html-string/index.js +332 -0
- package/dist/pm/html-string/index.js.map +1 -0
- package/dist/pm/react/index.cjs +2588 -0
- package/dist/pm/react/index.cjs.map +1 -0
- package/dist/pm/react/index.d.cts +181 -0
- package/dist/pm/react/index.d.ts +181 -0
- package/dist/pm/react/index.js +2576 -0
- package/dist/pm/react/index.js.map +1 -0
- package/package.json +82 -0
- package/src/helpers.example.ts +35 -0
- package/src/helpers.ts +65 -0
- package/src/index.ts +2 -0
- package/src/json/html-string/index.ts +2 -0
- package/src/json/html-string/string.example.ts +46 -0
- package/src/json/html-string/string.ts +22 -0
- package/src/json/react/index.ts +2 -0
- package/src/json/react/react.example.ts +45 -0
- package/src/json/react/react.tsx +35 -0
- package/src/json/renderer.ts +242 -0
- package/src/pm/extensionRenderer.ts +230 -0
- package/src/pm/html-string/html-string.example.ts +225 -0
- package/src/pm/html-string/html-string.ts +121 -0
- package/src/pm/html-string/index.ts +2 -0
- package/src/pm/markdown/markdown.example.ts +296 -0
- package/src/pm/react/index.ts +2 -0
- package/src/pm/react/react.example.tsx +306 -0
- package/src/pm/react/react.tsx +133 -0
- package/src/types.ts +57 -0
|
@@ -0,0 +1,359 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
4
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
5
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
6
|
+
var __export = (target, all) => {
|
|
7
|
+
for (var name in all)
|
|
8
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
9
|
+
};
|
|
10
|
+
var __copyProps = (to, from, except, desc) => {
|
|
11
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
12
|
+
for (let key of __getOwnPropNames(from))
|
|
13
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
14
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
15
|
+
}
|
|
16
|
+
return to;
|
|
17
|
+
};
|
|
18
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
19
|
+
|
|
20
|
+
// src/pm/html-string/index.ts
|
|
21
|
+
var html_string_exports = {};
|
|
22
|
+
__export(html_string_exports, {
|
|
23
|
+
domOutputSpecToHTMLString: () => domOutputSpecToHTMLString,
|
|
24
|
+
mapMarkExtensionToReactNode: () => mapMarkExtensionToReactNode,
|
|
25
|
+
mapNodeExtensionToReactNode: () => mapNodeExtensionToReactNode,
|
|
26
|
+
renderToElement: () => renderToElement,
|
|
27
|
+
renderToHTMLString: () => renderToHTMLString,
|
|
28
|
+
serializeAttrsToHTMLString: () => serializeAttrsToHTMLString,
|
|
29
|
+
serializeChildrenToHTMLString: () => serializeChildrenToHTMLString
|
|
30
|
+
});
|
|
31
|
+
module.exports = __toCommonJS(html_string_exports);
|
|
32
|
+
|
|
33
|
+
// src/pm/extensionRenderer.ts
|
|
34
|
+
var import_core2 = require("@tiptap/core");
|
|
35
|
+
var import_model = require("@tiptap/pm/model");
|
|
36
|
+
|
|
37
|
+
// src/helpers.ts
|
|
38
|
+
var import_core = require("@tiptap/core");
|
|
39
|
+
function getAttributes(nodeOrMark, extensionAttributes, onlyRenderedAttributes) {
|
|
40
|
+
const nodeOrMarkAttributes = nodeOrMark.attrs;
|
|
41
|
+
if (!nodeOrMarkAttributes) {
|
|
42
|
+
return {};
|
|
43
|
+
}
|
|
44
|
+
return extensionAttributes.filter((item) => {
|
|
45
|
+
if (item.type !== nodeOrMark.type) {
|
|
46
|
+
return false;
|
|
47
|
+
}
|
|
48
|
+
if (onlyRenderedAttributes) {
|
|
49
|
+
return item.attribute.rendered;
|
|
50
|
+
}
|
|
51
|
+
return true;
|
|
52
|
+
}).map((item) => {
|
|
53
|
+
if (!item.attribute.renderHTML) {
|
|
54
|
+
return {
|
|
55
|
+
[item.name]: item.name in nodeOrMarkAttributes ? nodeOrMarkAttributes[item.name] : item.attribute.default
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
return item.attribute.renderHTML(nodeOrMarkAttributes) || {
|
|
59
|
+
[item.name]: item.name in nodeOrMarkAttributes ? nodeOrMarkAttributes[item.name] : item.attribute.default
|
|
60
|
+
};
|
|
61
|
+
}).reduce((attributes, attribute) => (0, import_core.mergeAttributes)(attributes, attribute), {});
|
|
62
|
+
}
|
|
63
|
+
function getHTMLAttributes(nodeOrMark, extensionAttributes) {
|
|
64
|
+
return getAttributes(nodeOrMark, extensionAttributes, true);
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
// src/pm/extensionRenderer.ts
|
|
68
|
+
function mapNodeExtensionToReactNode(domOutputSpecToElement, extension, extensionAttributes, options) {
|
|
69
|
+
const context = {
|
|
70
|
+
name: extension.name,
|
|
71
|
+
options: extension.options,
|
|
72
|
+
storage: extension.storage,
|
|
73
|
+
parent: extension.parent
|
|
74
|
+
};
|
|
75
|
+
const renderToHTML = (0, import_core2.getExtensionField)(
|
|
76
|
+
extension,
|
|
77
|
+
"renderHTML",
|
|
78
|
+
context
|
|
79
|
+
);
|
|
80
|
+
if (!renderToHTML) {
|
|
81
|
+
if (options == null ? void 0 : options.unhandledNode) {
|
|
82
|
+
return [extension.name, options.unhandledNode];
|
|
83
|
+
}
|
|
84
|
+
return [
|
|
85
|
+
extension.name,
|
|
86
|
+
() => {
|
|
87
|
+
throw new Error(
|
|
88
|
+
`[tiptap error]: Node ${extension.name} cannot be rendered, it is missing a "renderToHTML" method, please implement it or override the corresponding "nodeMapping" method to have a custom rendering`
|
|
89
|
+
);
|
|
90
|
+
}
|
|
91
|
+
];
|
|
92
|
+
}
|
|
93
|
+
return [
|
|
94
|
+
extension.name,
|
|
95
|
+
({ node, children }) => {
|
|
96
|
+
try {
|
|
97
|
+
return domOutputSpecToElement(
|
|
98
|
+
renderToHTML({
|
|
99
|
+
node,
|
|
100
|
+
HTMLAttributes: getHTMLAttributes(node, extensionAttributes)
|
|
101
|
+
})
|
|
102
|
+
)(children);
|
|
103
|
+
} catch (e) {
|
|
104
|
+
throw new Error(
|
|
105
|
+
`[tiptap error]: Node ${extension.name} cannot be rendered, it's "renderToHTML" method threw an error: ${e.message}`,
|
|
106
|
+
{ cause: e }
|
|
107
|
+
);
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
];
|
|
111
|
+
}
|
|
112
|
+
function mapMarkExtensionToReactNode(domOutputSpecToElement, extension, extensionAttributes, options) {
|
|
113
|
+
const context = {
|
|
114
|
+
name: extension.name,
|
|
115
|
+
options: extension.options,
|
|
116
|
+
storage: extension.storage,
|
|
117
|
+
parent: extension.parent
|
|
118
|
+
};
|
|
119
|
+
const renderToHTML = (0, import_core2.getExtensionField)(
|
|
120
|
+
extension,
|
|
121
|
+
"renderHTML",
|
|
122
|
+
context
|
|
123
|
+
);
|
|
124
|
+
if (!renderToHTML) {
|
|
125
|
+
if (options == null ? void 0 : options.unhandledMark) {
|
|
126
|
+
return [extension.name, options.unhandledMark];
|
|
127
|
+
}
|
|
128
|
+
return [
|
|
129
|
+
extension.name,
|
|
130
|
+
() => {
|
|
131
|
+
throw new Error(
|
|
132
|
+
`Node ${extension.name} cannot be rendered, it is missing a "renderToHTML" method`
|
|
133
|
+
);
|
|
134
|
+
}
|
|
135
|
+
];
|
|
136
|
+
}
|
|
137
|
+
return [
|
|
138
|
+
extension.name,
|
|
139
|
+
({ mark, children }) => {
|
|
140
|
+
try {
|
|
141
|
+
return domOutputSpecToElement(
|
|
142
|
+
renderToHTML({
|
|
143
|
+
mark,
|
|
144
|
+
HTMLAttributes: getHTMLAttributes(mark, extensionAttributes)
|
|
145
|
+
})
|
|
146
|
+
)(children);
|
|
147
|
+
} catch (e) {
|
|
148
|
+
throw new Error(
|
|
149
|
+
`[tiptap error]: Mark ${extension.name} cannot be rendered, it's "renderToHTML" method threw an error: ${e.message}`,
|
|
150
|
+
{ cause: e }
|
|
151
|
+
);
|
|
152
|
+
}
|
|
153
|
+
}
|
|
154
|
+
];
|
|
155
|
+
}
|
|
156
|
+
function renderToElement({
|
|
157
|
+
renderer,
|
|
158
|
+
domOutputSpecToElement,
|
|
159
|
+
mapDefinedTypes,
|
|
160
|
+
content,
|
|
161
|
+
extensions,
|
|
162
|
+
options
|
|
163
|
+
}) {
|
|
164
|
+
extensions = (0, import_core2.resolveExtensions)(extensions);
|
|
165
|
+
const extensionAttributes = (0, import_core2.getAttributesFromExtensions)(extensions);
|
|
166
|
+
const { nodeExtensions, markExtensions } = (0, import_core2.splitExtensions)(extensions);
|
|
167
|
+
if (!(content instanceof import_model.Node)) {
|
|
168
|
+
content = import_model.Node.fromJSON((0, import_core2.getSchemaByResolvedExtensions)(extensions), content);
|
|
169
|
+
}
|
|
170
|
+
return renderer({
|
|
171
|
+
...options,
|
|
172
|
+
nodeMapping: {
|
|
173
|
+
...Object.fromEntries(
|
|
174
|
+
nodeExtensions.filter((e) => {
|
|
175
|
+
if (e.name in mapDefinedTypes) {
|
|
176
|
+
return false;
|
|
177
|
+
}
|
|
178
|
+
if (options == null ? void 0 : options.nodeMapping) {
|
|
179
|
+
return !(e.name in options.nodeMapping);
|
|
180
|
+
}
|
|
181
|
+
return true;
|
|
182
|
+
}).map((nodeExtension) => mapNodeExtensionToReactNode(
|
|
183
|
+
domOutputSpecToElement,
|
|
184
|
+
nodeExtension,
|
|
185
|
+
extensionAttributes,
|
|
186
|
+
options
|
|
187
|
+
))
|
|
188
|
+
),
|
|
189
|
+
...mapDefinedTypes,
|
|
190
|
+
...options == null ? void 0 : options.nodeMapping
|
|
191
|
+
},
|
|
192
|
+
markMapping: {
|
|
193
|
+
...Object.fromEntries(
|
|
194
|
+
markExtensions.filter((e) => {
|
|
195
|
+
if (options == null ? void 0 : options.markMapping) {
|
|
196
|
+
return !(e.name in options.markMapping);
|
|
197
|
+
}
|
|
198
|
+
return true;
|
|
199
|
+
}).map((mark) => mapMarkExtensionToReactNode(
|
|
200
|
+
domOutputSpecToElement,
|
|
201
|
+
mark,
|
|
202
|
+
extensionAttributes,
|
|
203
|
+
options
|
|
204
|
+
))
|
|
205
|
+
),
|
|
206
|
+
...options == null ? void 0 : options.markMapping
|
|
207
|
+
}
|
|
208
|
+
})({ content });
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
// src/json/renderer.ts
|
|
212
|
+
function TiptapStaticRenderer(renderComponent, {
|
|
213
|
+
nodeMapping,
|
|
214
|
+
markMapping,
|
|
215
|
+
unhandledNode,
|
|
216
|
+
unhandledMark
|
|
217
|
+
}) {
|
|
218
|
+
return function renderContent({
|
|
219
|
+
content,
|
|
220
|
+
parent
|
|
221
|
+
}) {
|
|
222
|
+
var _a;
|
|
223
|
+
const nodeType = typeof content.type === "string" ? content.type : content.type.name;
|
|
224
|
+
const NodeHandler = (_a = nodeMapping[nodeType]) != null ? _a : unhandledNode;
|
|
225
|
+
if (!NodeHandler) {
|
|
226
|
+
throw new Error(`missing handler for node type ${nodeType}`);
|
|
227
|
+
}
|
|
228
|
+
const nodeContent = renderComponent({
|
|
229
|
+
component: NodeHandler,
|
|
230
|
+
props: {
|
|
231
|
+
node: content,
|
|
232
|
+
parent,
|
|
233
|
+
renderElement: renderContent,
|
|
234
|
+
// Lazily compute the children to avoid unnecessary recursion
|
|
235
|
+
get children() {
|
|
236
|
+
const children = [];
|
|
237
|
+
if (content.content) {
|
|
238
|
+
content.content.forEach((child) => {
|
|
239
|
+
children.push(
|
|
240
|
+
renderContent({
|
|
241
|
+
content: child,
|
|
242
|
+
parent: content
|
|
243
|
+
})
|
|
244
|
+
);
|
|
245
|
+
});
|
|
246
|
+
}
|
|
247
|
+
return children;
|
|
248
|
+
}
|
|
249
|
+
}
|
|
250
|
+
});
|
|
251
|
+
const markedContent = content.marks ? content.marks.reduce((acc, mark) => {
|
|
252
|
+
var _a2;
|
|
253
|
+
const markType = typeof mark.type === "string" ? mark.type : mark.type.name;
|
|
254
|
+
const MarkHandler = (_a2 = markMapping[markType]) != null ? _a2 : unhandledMark;
|
|
255
|
+
if (!MarkHandler) {
|
|
256
|
+
throw new Error(`missing handler for mark type ${markType}`);
|
|
257
|
+
}
|
|
258
|
+
return renderComponent({
|
|
259
|
+
component: MarkHandler,
|
|
260
|
+
props: {
|
|
261
|
+
mark,
|
|
262
|
+
parent,
|
|
263
|
+
node: content,
|
|
264
|
+
children: acc
|
|
265
|
+
}
|
|
266
|
+
});
|
|
267
|
+
}, nodeContent) : nodeContent;
|
|
268
|
+
return markedContent;
|
|
269
|
+
};
|
|
270
|
+
}
|
|
271
|
+
|
|
272
|
+
// src/json/html-string/string.ts
|
|
273
|
+
function renderJSONContentToString(options) {
|
|
274
|
+
return TiptapStaticRenderer((ctx) => {
|
|
275
|
+
return ctx.component(ctx.props);
|
|
276
|
+
}, options);
|
|
277
|
+
}
|
|
278
|
+
|
|
279
|
+
// src/pm/html-string/html-string.ts
|
|
280
|
+
function serializeAttrsToHTMLString(attrs) {
|
|
281
|
+
const output = Object.entries(attrs).map(([key, value]) => `${key}=${JSON.stringify(value)}`).join(" ");
|
|
282
|
+
return output ? ` ${output}` : "";
|
|
283
|
+
}
|
|
284
|
+
function serializeChildrenToHTMLString(children) {
|
|
285
|
+
return [].concat(children || "").filter(Boolean).join("");
|
|
286
|
+
}
|
|
287
|
+
function domOutputSpecToHTMLString(content) {
|
|
288
|
+
if (typeof content === "string") {
|
|
289
|
+
return () => content;
|
|
290
|
+
}
|
|
291
|
+
if (typeof content === "object" && "length" in content) {
|
|
292
|
+
const [tag, attrs, children, ...rest] = content;
|
|
293
|
+
if (attrs === void 0) {
|
|
294
|
+
return () => `<${tag}/>`;
|
|
295
|
+
}
|
|
296
|
+
if (attrs === 0) {
|
|
297
|
+
return (child) => `<${tag}>${serializeChildrenToHTMLString(child)}</${tag}>`;
|
|
298
|
+
}
|
|
299
|
+
if (typeof attrs === "object") {
|
|
300
|
+
if (Array.isArray(attrs)) {
|
|
301
|
+
if (children === void 0) {
|
|
302
|
+
return (child) => `<${tag}>${domOutputSpecToHTMLString(attrs)(child)}</${tag}>`;
|
|
303
|
+
}
|
|
304
|
+
if (children === 0) {
|
|
305
|
+
return (child) => `<${tag}>${domOutputSpecToHTMLString(attrs)(child)}</${tag}>`;
|
|
306
|
+
}
|
|
307
|
+
return (child) => `<${tag}>${domOutputSpecToHTMLString(attrs)(child)}${[children].concat(rest).map((a) => domOutputSpecToHTMLString(a)(child))}</${tag}>`;
|
|
308
|
+
}
|
|
309
|
+
if (children === void 0) {
|
|
310
|
+
return () => `<${tag}${serializeAttrsToHTMLString(attrs)}/>`;
|
|
311
|
+
}
|
|
312
|
+
if (children === 0) {
|
|
313
|
+
return (child) => `<${tag}${serializeAttrsToHTMLString(attrs)}>${serializeChildrenToHTMLString(
|
|
314
|
+
child
|
|
315
|
+
)}</${tag}>`;
|
|
316
|
+
}
|
|
317
|
+
return (child) => `<${tag}${serializeAttrsToHTMLString(attrs)}>${[children].concat(rest).map((a) => domOutputSpecToHTMLString(a)(child)).join("")}</${tag}>`;
|
|
318
|
+
}
|
|
319
|
+
}
|
|
320
|
+
throw new Error(
|
|
321
|
+
"[tiptap error]: Unsupported DomOutputSpec type, check the `renderHTML` method output",
|
|
322
|
+
{
|
|
323
|
+
cause: content
|
|
324
|
+
}
|
|
325
|
+
);
|
|
326
|
+
}
|
|
327
|
+
function renderToHTMLString({
|
|
328
|
+
content,
|
|
329
|
+
extensions,
|
|
330
|
+
options
|
|
331
|
+
}) {
|
|
332
|
+
return renderToElement({
|
|
333
|
+
renderer: renderJSONContentToString,
|
|
334
|
+
domOutputSpecToElement: domOutputSpecToHTMLString,
|
|
335
|
+
mapDefinedTypes: {
|
|
336
|
+
// Map a doc node to concatenated children
|
|
337
|
+
doc: ({ children }) => serializeChildrenToHTMLString(children),
|
|
338
|
+
// Map a text node to its text content
|
|
339
|
+
text: ({ node }) => {
|
|
340
|
+
var _a;
|
|
341
|
+
return (_a = node.text) != null ? _a : "";
|
|
342
|
+
}
|
|
343
|
+
},
|
|
344
|
+
content,
|
|
345
|
+
extensions,
|
|
346
|
+
options
|
|
347
|
+
});
|
|
348
|
+
}
|
|
349
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
350
|
+
0 && (module.exports = {
|
|
351
|
+
domOutputSpecToHTMLString,
|
|
352
|
+
mapMarkExtensionToReactNode,
|
|
353
|
+
mapNodeExtensionToReactNode,
|
|
354
|
+
renderToElement,
|
|
355
|
+
renderToHTMLString,
|
|
356
|
+
serializeAttrsToHTMLString,
|
|
357
|
+
serializeChildrenToHTMLString
|
|
358
|
+
});
|
|
359
|
+
//# sourceMappingURL=index.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../../../src/pm/html-string/index.ts","../../../src/pm/extensionRenderer.ts","../../../src/helpers.ts","../../../src/json/renderer.ts","../../../src/json/html-string/string.ts","../../../src/pm/html-string/html-string.ts"],"sourcesContent":["export * from '../extensionRenderer.js'\nexport * from './html-string.js'\n","/* eslint-disable no-plusplus */\n/* eslint-disable @typescript-eslint/no-explicit-any */\n\nimport {\n ExtensionAttribute,\n Extensions,\n getAttributesFromExtensions,\n getExtensionField,\n getSchemaByResolvedExtensions,\n JSONContent,\n Mark as MarkExtension,\n MarkConfig,\n Node as NodeExtension,\n NodeConfig,\n resolveExtensions,\n splitExtensions,\n} from '@tiptap/core'\nimport { DOMOutputSpec, Mark, Node } from '@tiptap/pm/model'\n\nimport { getHTMLAttributes } from '../helpers.js'\nimport { MarkProps, NodeProps, TiptapStaticRendererOptions } from '../json/renderer.js'\n\nexport type DomOutputSpecToElement<T> = (content: DOMOutputSpec) => (children?: T | T[]) => T;\n\n/**\n * This takes a NodeExtension and maps it to a React component\n * @param extension The node extension to map to a React component\n * @param extensionAttributes All available extension attributes\n * @returns A tuple with the name of the extension and a React component that renders the extension\n */\nexport function mapNodeExtensionToReactNode<T>(\n domOutputSpecToElement: DomOutputSpecToElement<T>,\n extension: NodeExtension,\n extensionAttributes: ExtensionAttribute[],\n options?: Partial<Pick<TiptapStaticRendererOptions<T, Mark, Node>, 'unhandledNode'>>,\n): [string, (props: NodeProps<Node, T | T[]>) => T] {\n const context = {\n name: extension.name,\n options: extension.options,\n storage: extension.storage,\n parent: extension.parent,\n }\n\n const renderToHTML = getExtensionField<NodeConfig['renderHTML']>(\n extension,\n 'renderHTML',\n context,\n )\n\n if (!renderToHTML) {\n if (options?.unhandledNode) {\n return [extension.name, options.unhandledNode]\n }\n return [\n extension.name,\n () => {\n throw new Error(\n `[tiptap error]: Node ${extension.name} cannot be rendered, it is missing a \"renderToHTML\" method, please implement it or override the corresponding \"nodeMapping\" method to have a custom rendering`,\n )\n },\n ]\n }\n\n return [\n extension.name,\n ({ node, children }) => {\n try {\n return domOutputSpecToElement(\n renderToHTML({\n node,\n HTMLAttributes: getHTMLAttributes(node, extensionAttributes),\n }),\n )(children)\n } catch (e) {\n throw new Error(\n `[tiptap error]: Node ${\n extension.name\n } cannot be rendered, it's \"renderToHTML\" method threw an error: ${(e as Error).message}`,\n { cause: e },\n )\n }\n },\n ]\n}\n\n/**\n * This takes a MarkExtension and maps it to a React component\n * @param extension The mark extension to map to a React component\n * @param extensionAttributes All available extension attributes\n * @returns A tuple with the name of the extension and a React component that renders the extension\n */\nexport function mapMarkExtensionToReactNode<T>(\n domOutputSpecToElement: DomOutputSpecToElement<T>,\n extension: MarkExtension,\n extensionAttributes: ExtensionAttribute[],\n options?: Partial<Pick<TiptapStaticRendererOptions<T, Mark, Node>, 'unhandledMark'>>,\n): [string, (props: MarkProps<Mark, T | T[]>) => T] {\n const context = {\n name: extension.name,\n options: extension.options,\n storage: extension.storage,\n parent: extension.parent,\n }\n\n const renderToHTML = getExtensionField<MarkConfig['renderHTML']>(\n extension,\n 'renderHTML',\n context,\n )\n\n if (!renderToHTML) {\n if (options?.unhandledMark) {\n return [extension.name, options.unhandledMark]\n }\n return [\n extension.name,\n () => {\n throw new Error(\n `Node ${extension.name} cannot be rendered, it is missing a \"renderToHTML\" method`,\n )\n },\n ]\n }\n\n return [\n extension.name,\n ({ mark, children }) => {\n try {\n return domOutputSpecToElement(\n renderToHTML({\n mark,\n HTMLAttributes: getHTMLAttributes(mark, extensionAttributes),\n }),\n )(children)\n } catch (e) {\n throw new Error(\n `[tiptap error]: Mark ${\n extension.name\n } cannot be rendered, it's \"renderToHTML\" method threw an error: ${(e as Error).message}`,\n { cause: e },\n )\n }\n },\n ]\n}\n\n/**\n * This function will statically render a Prosemirror Node to a target element type using the given extensions\n * @param renderer The renderer to use to render the Prosemirror Node to the target element type\n * @param domOutputSpecToElement A function that takes a Prosemirror DOMOutputSpec and returns a function that takes children and returns the target element type\n * @param mapDefinedTypes An object with functions to map the doc and text types to the target element type\n * @param content The Prosemirror Node to render\n * @param extensions The extensions to use to render the Prosemirror Node\n * @param options Additional options to pass to the renderer that can override the default behavior\n * @returns The rendered target element type\n */\nexport function renderToElement<T>({\n renderer,\n domOutputSpecToElement,\n mapDefinedTypes,\n content,\n extensions,\n options,\n}: {\n renderer: (options: TiptapStaticRendererOptions<T, Mark, Node>) => (ctx: { content: Node }) => T;\n domOutputSpecToElement: DomOutputSpecToElement<T>;\n mapDefinedTypes: {\n doc: (props: NodeProps<Node, T | T[]>) => T;\n text: (props: NodeProps<Node, T | T[]>) => T;\n };\n content: Node | JSONContent;\n extensions: Extensions;\n options?: Partial<TiptapStaticRendererOptions<T, Mark, Node>>;\n}): T {\n // get all extensions in order & split them into nodes and marks\n extensions = resolveExtensions(extensions)\n const extensionAttributes = getAttributesFromExtensions(extensions)\n const { nodeExtensions, markExtensions } = splitExtensions(extensions)\n\n if (!(content instanceof Node)) {\n content = Node.fromJSON(getSchemaByResolvedExtensions(extensions), content)\n }\n\n return renderer({\n ...options,\n nodeMapping: {\n ...Object.fromEntries(\n nodeExtensions\n .filter(e => {\n if (e.name in mapDefinedTypes) {\n // These are predefined types that we don't need to map\n return false\n }\n // No need to generate mappings for nodes that are already mapped\n if (options?.nodeMapping) {\n return !(e.name in options.nodeMapping)\n }\n return true\n })\n .map(nodeExtension => mapNodeExtensionToReactNode<T>(\n domOutputSpecToElement,\n nodeExtension,\n extensionAttributes,\n options,\n )),\n ),\n ...mapDefinedTypes,\n ...options?.nodeMapping,\n },\n markMapping: {\n ...Object.fromEntries(\n markExtensions\n .filter(e => {\n // No need to generate mappings for marks that are already mapped\n if (options?.markMapping) {\n return !(e.name in options.markMapping)\n }\n return true\n })\n .map(mark => mapMarkExtensionToReactNode<T>(\n domOutputSpecToElement,\n mark,\n extensionAttributes,\n options,\n )),\n ),\n ...options?.markMapping,\n },\n })({ content })\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { ExtensionAttribute, mergeAttributes } from '@tiptap/core'\n\nimport type { MarkType, NodeType } from './types'\n\n/**\n * This function returns the attributes of a node or mark that are defined by the given extension attributes.\n * @param nodeOrMark The node or mark to get the attributes from\n * @param extensionAttributes The extension attributes to use\n * @param onlyRenderedAttributes If true, only attributes that are rendered in the HTML are returned\n */\nexport function getAttributes(\n nodeOrMark: NodeType | MarkType,\n extensionAttributes: ExtensionAttribute[],\n onlyRenderedAttributes?: boolean,\n): Record<string, any> {\n const nodeOrMarkAttributes = nodeOrMark.attrs\n\n if (!nodeOrMarkAttributes) {\n return {}\n }\n\n return extensionAttributes\n .filter(item => {\n if (item.type !== nodeOrMark.type) {\n return false\n }\n if (onlyRenderedAttributes) {\n return item.attribute.rendered\n }\n return true\n })\n .map(item => {\n if (!item.attribute.renderHTML) {\n return {\n [item.name]:\n item.name in nodeOrMarkAttributes\n ? nodeOrMarkAttributes[item.name]\n : item.attribute.default,\n }\n }\n\n return (\n item.attribute.renderHTML(nodeOrMarkAttributes) || {\n [item.name]:\n item.name in nodeOrMarkAttributes\n ? nodeOrMarkAttributes[item.name]\n : item.attribute.default,\n }\n )\n })\n .reduce((attributes, attribute) => mergeAttributes(attributes, attribute), {})\n}\n\n/**\n * This function returns the HTML attributes of a node or mark that are defined by the given extension attributes.\n * @param nodeOrMark The node or mark to get the attributes from\n * @param extensionAttributes The extension attributes to use\n */\nexport function getHTMLAttributes(\n nodeOrMark: NodeType | MarkType,\n extensionAttributes: ExtensionAttribute[],\n) {\n return getAttributes(nodeOrMark, extensionAttributes, true)\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { MarkType, NodeType } from '../types'\n\n/**\n * Props for a node renderer\n */\nexport type NodeProps<TNodeType = any, TChildren = any> = {\n /**\n * The current node to render\n */\n node: TNodeType;\n /**\n * Unless the node is the root node, this will always be defined\n */\n parent?: TNodeType;\n /**\n * The children of the current node\n */\n children?: TChildren;\n /**\n * Render a child element\n */\n renderElement: (props: {\n /**\n * Tiptap JSON content to render\n */\n content: TNodeType;\n /**\n * The parent node of the current node\n */\n parent?: TNodeType;\n }) => TChildren;\n};\n\n/**\n * Props for a mark renderer\n */\nexport type MarkProps<TMarkType = any, TChildren = any, TNodeType = any> = {\n /**\n * The current mark to render\n */\n mark: TMarkType;\n /**\n * The children of the current mark\n */\n children?: TChildren;\n /**\n * The node the current mark is applied to\n */\n node: TNodeType;\n /**\n * The node the current mark is applied to\n */\n parent?: TNodeType;\n};\n\nexport type TiptapStaticRendererOptions<\n /**\n * The return type of the render function (e.g. React.ReactNode, string)\n */\n TReturnType,\n /**\n * A mark type is either a JSON representation of a mark or a Prosemirror mark instance\n */\n TMarkType extends { type: any } = MarkType,\n /**\n * A node type is either a JSON representation of a node or a Prosemirror node instance\n */\n TNodeType extends {\n content?: { forEach: (cb: (node: TNodeType) => void) => void };\n marks?: readonly TMarkType[];\n type: string | { name: string };\n } = NodeType,\n /**\n * A node renderer is a function that takes a node and its children and returns the rendered output\n */\n TNodeRender extends (ctx: NodeProps<TNodeType, TReturnType | TReturnType[]>) => TReturnType = (\n ctx: NodeProps<TNodeType, TReturnType | TReturnType[]>\n ) => TReturnType,\n /**\n * A mark renderer is a function that takes a mark and its children and returns the rendered output\n */\n TMarkRender extends (ctx: MarkProps<TMarkType, TReturnType | TReturnType[], TNodeType>) => TReturnType = (\n ctx: MarkProps<TMarkType, TReturnType | TReturnType[], TNodeType>\n ) => TReturnType,\n> = {\n /**\n * Mapping of node types to react components\n */\n nodeMapping: Record<string, TNodeRender>;\n /**\n * Mapping of mark types to react components\n */\n markMapping: Record<string, TMarkRender>;\n /**\n * Component to render if a node type is not handled\n */\n unhandledNode?: TNodeRender;\n /**\n * Component to render if a mark type is not handled\n */\n unhandledMark?: TMarkRender;\n};\n\n/**\n * Tiptap Static Renderer\n * ----------------------\n *\n * This function is a basis to allow for different renderers to be created.\n * Generic enough to be able to statically render Prosemirror JSON or Prosemirror Nodes.\n *\n * Using this function, you can create a renderer that takes a JSON representation of a Prosemirror document\n * and renders it using a mapping of node types to React components or even to a string.\n * This function is used as the basis to create the `reactRenderer` and `stringRenderer` functions.\n */\nexport function TiptapStaticRenderer<\n /**\n * The return type of the render function (e.g. React.ReactNode, string)\n */\n TReturnType,\n /**\n * A mark type is either a JSON representation of a mark or a Prosemirror mark instance\n */\n TMarkType extends { type: string | { name: string } } = MarkType,\n /**\n * A node type is either a JSON representation of a node or a Prosemirror node instance\n */\n TNodeType extends {\n content?: { forEach:(\ncb: (node: TNodeType) => void) => void };\n marks?: readonly TMarkType[];\n type: string | { name: string };\n } = NodeType,\n /**\n * A node renderer is a function that takes a node and its children and returns the rendered output\n */\n TNodeRender extends (ctx: NodeProps<TNodeType, TReturnType | TReturnType[]>) => TReturnType = (\n ctx: NodeProps<TNodeType, TReturnType | TReturnType[]>\n ) => TReturnType,\n /**\n * A mark renderer is a function that takes a mark and its children and returns the rendered output\n */\n TMarkRender extends (ctx: MarkProps<TMarkType, TReturnType | TReturnType[], TNodeType>) => TReturnType = (\n ctx: MarkProps<TMarkType, TReturnType | TReturnType[], TNodeType>\n ) => TReturnType,\n>(\n /**\n * The function that actually renders the component\n */\n renderComponent: (\n ctx:\n | {\n component: TNodeRender;\n props: NodeProps<TNodeType, TReturnType | TReturnType[]>;\n }\n | {\n component: TMarkRender;\n props: MarkProps<TMarkType, TReturnType | TReturnType[], TNodeType>;\n }\n ) => TReturnType,\n {\n nodeMapping,\n markMapping,\n unhandledNode,\n unhandledMark,\n }: TiptapStaticRendererOptions<TReturnType, TMarkType, TNodeType, TNodeRender, TMarkRender>,\n) {\n /**\n * Render Tiptap JSON and all its children using the provided node and mark mappings.\n */\n return function renderContent({\n content,\n parent,\n }: {\n /**\n * Tiptap JSON content to render\n */\n content: TNodeType;\n /**\n * The parent node of the current node\n */\n parent?: TNodeType;\n }): TReturnType {\n const nodeType = typeof content.type === 'string' ? content.type : content.type.name\n const NodeHandler = nodeMapping[nodeType] ?? unhandledNode\n\n if (!NodeHandler) {\n throw new Error(`missing handler for node type ${nodeType}`)\n }\n\n const nodeContent = renderComponent({\n component: NodeHandler,\n props: {\n node: content,\n parent,\n renderElement: renderContent,\n // Lazily compute the children to avoid unnecessary recursion\n get children() {\n // recursively render child content nodes\n const children: TReturnType[] = []\n\n if (content.content) {\n content.content.forEach(child => {\n children.push(\n renderContent({\n content: child,\n parent: content,\n }),\n )\n })\n }\n\n return children\n },\n },\n })\n\n // apply marks to the content\n const markedContent = content.marks\n ? content.marks.reduce((acc, mark) => {\n const markType = typeof mark.type === 'string' ? mark.type : mark.type.name\n const MarkHandler = markMapping[markType] ?? unhandledMark\n\n if (!MarkHandler) {\n throw new Error(`missing handler for mark type ${markType}`)\n }\n\n return renderComponent({\n component: MarkHandler,\n props: {\n mark,\n parent,\n node: content,\n children: acc,\n },\n })\n }, nodeContent)\n : nodeContent\n\n return markedContent\n }\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { MarkType, NodeType } from '../../types.js'\nimport { TiptapStaticRenderer, TiptapStaticRendererOptions } from '../renderer.js'\n\nexport function renderJSONContentToString<\n/**\n * A mark type is either a JSON representation of a mark or a Prosemirror mark instance\n */\nTMarkType extends { type: any } = MarkType,\n/**\n * A node type is either a JSON representation of a node or a Prosemirror node instance\n */\nTNodeType extends {\n content?: { forEach:(cb: (node: TNodeType) => void) => void };\n marks?: readonly TMarkType[];\n type: string | { name: string };\n} = NodeType,\n>(options: TiptapStaticRendererOptions<string, TMarkType, TNodeType>) {\n return TiptapStaticRenderer(ctx => {\n return ctx.component(ctx.props as any)\n }, options)\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { Extensions, JSONContent } from '@tiptap/core'\nimport type { DOMOutputSpec, Mark, Node } from '@tiptap/pm/model'\n\nimport { renderJSONContentToString } from '../../json/html-string/string.js'\nimport { TiptapStaticRendererOptions } from '../../json/renderer.js'\nimport type { DOMOutputSpecArray } from '../../types.js'\nimport { renderToElement } from '../extensionRenderer.js'\n\n/**\n * Serialize the attributes of a node or mark to a string\n * @param attrs The attributes to serialize\n * @returns The serialized attributes as a string\n */\nexport function serializeAttrsToHTMLString(attrs: Record<string, any>): string {\n const output = Object.entries(attrs)\n .map(([key, value]) => `${key}=${JSON.stringify(value)}`)\n .join(' ')\n\n return output ? ` ${output}` : ''\n}\n\n/**\n * Serialize the children of a node or mark to a string\n * @param children The children to serialize\n * @returns The serialized children as a string\n */\nexport function serializeChildrenToHTMLString(children?: string | string[]): string {\n return ([] as string[])\n .concat(children || '')\n .filter(Boolean)\n .join('')\n}\n\n/**\n * Take a DOMOutputSpec and return a function that can render it to a string\n * @param content The DOMOutputSpec to convert to a string\n * @returns A function that can render the DOMOutputSpec to a string\n */\nexport function domOutputSpecToHTMLString(\n content: DOMOutputSpec,\n): (children?: string | string[]) => string {\n if (typeof content === 'string') {\n return () => content\n }\n if (typeof content === 'object' && 'length' in content) {\n const [tag, attrs, children, ...rest] = content as DOMOutputSpecArray\n\n if (attrs === undefined) {\n return () => `<${tag}/>`\n }\n if (attrs === 0) {\n return child => `<${tag}>${serializeChildrenToHTMLString(child)}</${tag}>`\n }\n if (typeof attrs === 'object') {\n if (Array.isArray(attrs)) {\n if (children === undefined) {\n return child => `<${tag}>${domOutputSpecToHTMLString(attrs as DOMOutputSpecArray)(child)}</${tag}>`\n }\n if (children === 0) {\n return child => `<${tag}>${domOutputSpecToHTMLString(attrs as DOMOutputSpecArray)(child)}</${tag}>`\n }\n return child => `<${tag}>${domOutputSpecToHTMLString(attrs as DOMOutputSpecArray)(child)}${[children]\n .concat(rest)\n .map(a => domOutputSpecToHTMLString(a)(child))}</${tag}>`\n }\n if (children === undefined) {\n return () => `<${tag}${serializeAttrsToHTMLString(attrs)}/>`\n }\n if (children === 0) {\n return child => `<${tag}${serializeAttrsToHTMLString(attrs)}>${serializeChildrenToHTMLString(\n child,\n )}</${tag}>`\n }\n\n return child => `<${tag}${serializeAttrsToHTMLString(attrs)}>${[children]\n .concat(rest)\n .map(a => domOutputSpecToHTMLString(a)(child))\n .join('')}</${tag}>`\n }\n }\n\n // TODO support DOM elements? How to handle them?\n throw new Error(\n '[tiptap error]: Unsupported DomOutputSpec type, check the `renderHTML` method output',\n {\n cause: content,\n },\n )\n}\n\n/**\n * This function will statically render a Prosemirror Node to HTML using the provided extensions and options\n * @param content The content to render to HTML\n * @param extensions The extensions to use for rendering\n * @param options The options to use for rendering\n * @returns The rendered HTML string\n */\nexport function renderToHTMLString({\n content,\n extensions,\n options,\n}: {\n content: Node | JSONContent;\n extensions: Extensions;\n options?: Partial<TiptapStaticRendererOptions<string, Mark, Node>>;\n}): string {\n return renderToElement<string>({\n renderer: renderJSONContentToString,\n domOutputSpecToElement: domOutputSpecToHTMLString,\n mapDefinedTypes: {\n // Map a doc node to concatenated children\n doc: ({ children }) => serializeChildrenToHTMLString(children),\n // Map a text node to its text content\n text: ({ node }) => node.text ?? '',\n },\n content,\n extensions,\n options,\n })\n}\n"],"mappings":"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","names":["import_core","_a"]}
|
|
@@ -0,0 +1,192 @@
|
|
|
1
|
+
import { Node, ExtensionAttribute, Mark as Mark$1, JSONContent, Extensions } from '@tiptap/core';
|
|
2
|
+
import { DOMOutputSpec, Mark, Node as Node$1 } from '@tiptap/pm/model';
|
|
3
|
+
|
|
4
|
+
/**
|
|
5
|
+
* A mark type is either a JSON representation of a mark or a Prosemirror mark instance
|
|
6
|
+
*/
|
|
7
|
+
type MarkType<Type extends string = any, Attributes extends undefined | Record<string, any> = any> = {
|
|
8
|
+
type: Type;
|
|
9
|
+
attrs: Attributes;
|
|
10
|
+
};
|
|
11
|
+
/**
|
|
12
|
+
* A node type is either a JSON representation of a node or a Prosemirror node instance
|
|
13
|
+
*/
|
|
14
|
+
type NodeType<Type extends string = any, Attributes extends undefined | Record<string, any> = any, NodeMarkType extends MarkType = any, Content extends NodeType[] = any> = {
|
|
15
|
+
type: Type;
|
|
16
|
+
attrs: Attributes;
|
|
17
|
+
content?: Content;
|
|
18
|
+
marks?: NodeMarkType[];
|
|
19
|
+
text?: string;
|
|
20
|
+
};
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* Props for a node renderer
|
|
24
|
+
*/
|
|
25
|
+
type NodeProps<TNodeType = any, TChildren = any> = {
|
|
26
|
+
/**
|
|
27
|
+
* The current node to render
|
|
28
|
+
*/
|
|
29
|
+
node: TNodeType;
|
|
30
|
+
/**
|
|
31
|
+
* Unless the node is the root node, this will always be defined
|
|
32
|
+
*/
|
|
33
|
+
parent?: TNodeType;
|
|
34
|
+
/**
|
|
35
|
+
* The children of the current node
|
|
36
|
+
*/
|
|
37
|
+
children?: TChildren;
|
|
38
|
+
/**
|
|
39
|
+
* Render a child element
|
|
40
|
+
*/
|
|
41
|
+
renderElement: (props: {
|
|
42
|
+
/**
|
|
43
|
+
* Tiptap JSON content to render
|
|
44
|
+
*/
|
|
45
|
+
content: TNodeType;
|
|
46
|
+
/**
|
|
47
|
+
* The parent node of the current node
|
|
48
|
+
*/
|
|
49
|
+
parent?: TNodeType;
|
|
50
|
+
}) => TChildren;
|
|
51
|
+
};
|
|
52
|
+
/**
|
|
53
|
+
* Props for a mark renderer
|
|
54
|
+
*/
|
|
55
|
+
type MarkProps<TMarkType = any, TChildren = any, TNodeType = any> = {
|
|
56
|
+
/**
|
|
57
|
+
* The current mark to render
|
|
58
|
+
*/
|
|
59
|
+
mark: TMarkType;
|
|
60
|
+
/**
|
|
61
|
+
* The children of the current mark
|
|
62
|
+
*/
|
|
63
|
+
children?: TChildren;
|
|
64
|
+
/**
|
|
65
|
+
* The node the current mark is applied to
|
|
66
|
+
*/
|
|
67
|
+
node: TNodeType;
|
|
68
|
+
/**
|
|
69
|
+
* The node the current mark is applied to
|
|
70
|
+
*/
|
|
71
|
+
parent?: TNodeType;
|
|
72
|
+
};
|
|
73
|
+
type TiptapStaticRendererOptions<
|
|
74
|
+
/**
|
|
75
|
+
* The return type of the render function (e.g. React.ReactNode, string)
|
|
76
|
+
*/
|
|
77
|
+
TReturnType,
|
|
78
|
+
/**
|
|
79
|
+
* A mark type is either a JSON representation of a mark or a Prosemirror mark instance
|
|
80
|
+
*/
|
|
81
|
+
TMarkType extends {
|
|
82
|
+
type: any;
|
|
83
|
+
} = MarkType,
|
|
84
|
+
/**
|
|
85
|
+
* A node type is either a JSON representation of a node or a Prosemirror node instance
|
|
86
|
+
*/
|
|
87
|
+
TNodeType extends {
|
|
88
|
+
content?: {
|
|
89
|
+
forEach: (cb: (node: TNodeType) => void) => void;
|
|
90
|
+
};
|
|
91
|
+
marks?: readonly TMarkType[];
|
|
92
|
+
type: string | {
|
|
93
|
+
name: string;
|
|
94
|
+
};
|
|
95
|
+
} = NodeType,
|
|
96
|
+
/**
|
|
97
|
+
* A node renderer is a function that takes a node and its children and returns the rendered output
|
|
98
|
+
*/
|
|
99
|
+
TNodeRender extends (ctx: NodeProps<TNodeType, TReturnType | TReturnType[]>) => TReturnType = (ctx: NodeProps<TNodeType, TReturnType | TReturnType[]>) => TReturnType,
|
|
100
|
+
/**
|
|
101
|
+
* A mark renderer is a function that takes a mark and its children and returns the rendered output
|
|
102
|
+
*/
|
|
103
|
+
TMarkRender extends (ctx: MarkProps<TMarkType, TReturnType | TReturnType[], TNodeType>) => TReturnType = (ctx: MarkProps<TMarkType, TReturnType | TReturnType[], TNodeType>) => TReturnType> = {
|
|
104
|
+
/**
|
|
105
|
+
* Mapping of node types to react components
|
|
106
|
+
*/
|
|
107
|
+
nodeMapping: Record<string, TNodeRender>;
|
|
108
|
+
/**
|
|
109
|
+
* Mapping of mark types to react components
|
|
110
|
+
*/
|
|
111
|
+
markMapping: Record<string, TMarkRender>;
|
|
112
|
+
/**
|
|
113
|
+
* Component to render if a node type is not handled
|
|
114
|
+
*/
|
|
115
|
+
unhandledNode?: TNodeRender;
|
|
116
|
+
/**
|
|
117
|
+
* Component to render if a mark type is not handled
|
|
118
|
+
*/
|
|
119
|
+
unhandledMark?: TMarkRender;
|
|
120
|
+
};
|
|
121
|
+
|
|
122
|
+
type DomOutputSpecToElement<T> = (content: DOMOutputSpec) => (children?: T | T[]) => T;
|
|
123
|
+
/**
|
|
124
|
+
* This takes a NodeExtension and maps it to a React component
|
|
125
|
+
* @param extension The node extension to map to a React component
|
|
126
|
+
* @param extensionAttributes All available extension attributes
|
|
127
|
+
* @returns A tuple with the name of the extension and a React component that renders the extension
|
|
128
|
+
*/
|
|
129
|
+
declare function mapNodeExtensionToReactNode<T>(domOutputSpecToElement: DomOutputSpecToElement<T>, extension: Node, extensionAttributes: ExtensionAttribute[], options?: Partial<Pick<TiptapStaticRendererOptions<T, Mark, Node$1>, 'unhandledNode'>>): [string, (props: NodeProps<Node$1, T | T[]>) => T];
|
|
130
|
+
/**
|
|
131
|
+
* This takes a MarkExtension and maps it to a React component
|
|
132
|
+
* @param extension The mark extension to map to a React component
|
|
133
|
+
* @param extensionAttributes All available extension attributes
|
|
134
|
+
* @returns A tuple with the name of the extension and a React component that renders the extension
|
|
135
|
+
*/
|
|
136
|
+
declare function mapMarkExtensionToReactNode<T>(domOutputSpecToElement: DomOutputSpecToElement<T>, extension: Mark$1, extensionAttributes: ExtensionAttribute[], options?: Partial<Pick<TiptapStaticRendererOptions<T, Mark, Node$1>, 'unhandledMark'>>): [string, (props: MarkProps<Mark, T | T[]>) => T];
|
|
137
|
+
/**
|
|
138
|
+
* This function will statically render a Prosemirror Node to a target element type using the given extensions
|
|
139
|
+
* @param renderer The renderer to use to render the Prosemirror Node to the target element type
|
|
140
|
+
* @param domOutputSpecToElement A function that takes a Prosemirror DOMOutputSpec and returns a function that takes children and returns the target element type
|
|
141
|
+
* @param mapDefinedTypes An object with functions to map the doc and text types to the target element type
|
|
142
|
+
* @param content The Prosemirror Node to render
|
|
143
|
+
* @param extensions The extensions to use to render the Prosemirror Node
|
|
144
|
+
* @param options Additional options to pass to the renderer that can override the default behavior
|
|
145
|
+
* @returns The rendered target element type
|
|
146
|
+
*/
|
|
147
|
+
declare function renderToElement<T>({ renderer, domOutputSpecToElement, mapDefinedTypes, content, extensions, options, }: {
|
|
148
|
+
renderer: (options: TiptapStaticRendererOptions<T, Mark, Node$1>) => (ctx: {
|
|
149
|
+
content: Node$1;
|
|
150
|
+
}) => T;
|
|
151
|
+
domOutputSpecToElement: DomOutputSpecToElement<T>;
|
|
152
|
+
mapDefinedTypes: {
|
|
153
|
+
doc: (props: NodeProps<Node$1, T | T[]>) => T;
|
|
154
|
+
text: (props: NodeProps<Node$1, T | T[]>) => T;
|
|
155
|
+
};
|
|
156
|
+
content: Node$1 | JSONContent;
|
|
157
|
+
extensions: Extensions;
|
|
158
|
+
options?: Partial<TiptapStaticRendererOptions<T, Mark, Node$1>>;
|
|
159
|
+
}): T;
|
|
160
|
+
|
|
161
|
+
/**
|
|
162
|
+
* Serialize the attributes of a node or mark to a string
|
|
163
|
+
* @param attrs The attributes to serialize
|
|
164
|
+
* @returns The serialized attributes as a string
|
|
165
|
+
*/
|
|
166
|
+
declare function serializeAttrsToHTMLString(attrs: Record<string, any>): string;
|
|
167
|
+
/**
|
|
168
|
+
* Serialize the children of a node or mark to a string
|
|
169
|
+
* @param children The children to serialize
|
|
170
|
+
* @returns The serialized children as a string
|
|
171
|
+
*/
|
|
172
|
+
declare function serializeChildrenToHTMLString(children?: string | string[]): string;
|
|
173
|
+
/**
|
|
174
|
+
* Take a DOMOutputSpec and return a function that can render it to a string
|
|
175
|
+
* @param content The DOMOutputSpec to convert to a string
|
|
176
|
+
* @returns A function that can render the DOMOutputSpec to a string
|
|
177
|
+
*/
|
|
178
|
+
declare function domOutputSpecToHTMLString(content: DOMOutputSpec): (children?: string | string[]) => string;
|
|
179
|
+
/**
|
|
180
|
+
* This function will statically render a Prosemirror Node to HTML using the provided extensions and options
|
|
181
|
+
* @param content The content to render to HTML
|
|
182
|
+
* @param extensions The extensions to use for rendering
|
|
183
|
+
* @param options The options to use for rendering
|
|
184
|
+
* @returns The rendered HTML string
|
|
185
|
+
*/
|
|
186
|
+
declare function renderToHTMLString({ content, extensions, options, }: {
|
|
187
|
+
content: Node$1 | JSONContent;
|
|
188
|
+
extensions: Extensions;
|
|
189
|
+
options?: Partial<TiptapStaticRendererOptions<string, Mark, Node$1>>;
|
|
190
|
+
}): string;
|
|
191
|
+
|
|
192
|
+
export { type DomOutputSpecToElement, domOutputSpecToHTMLString, mapMarkExtensionToReactNode, mapNodeExtensionToReactNode, renderToElement, renderToHTMLString, serializeAttrsToHTMLString, serializeChildrenToHTMLString };
|