UNPKG

7.47 kBTypeScriptView Raw
1import { IRenderMime } from '@jupyterlab/rendermime-interfaces';
2import { ITranslator } from '@jupyterlab/translation';
3import { Message } from '@lumino/messaging';
4import { Widget } from '@lumino/widgets';
5/**
6 * A common base class for mime renderers.
7 */
8export declare abstract class RenderedCommon extends Widget implements IRenderMime.IRenderer {
9 /**
10 * Construct a new rendered common widget.
11 *
12 * @param options - The options for initializing the widget.
13 */
14 constructor(options: IRenderMime.IRendererOptions);
15 /**
16 * The mimetype being rendered.
17 */
18 readonly mimeType: string;
19 /**
20 * The sanitizer used to sanitize untrusted html inputs.
21 */
22 readonly sanitizer: IRenderMime.ISanitizer;
23 /**
24 * The resolver object.
25 */
26 readonly resolver: IRenderMime.IResolver | null;
27 /**
28 * The link handler.
29 */
30 readonly linkHandler: IRenderMime.ILinkHandler | null;
31 /**
32 * The latexTypesetter.
33 */
34 readonly latexTypesetter: IRenderMime.ILatexTypesetter | null;
35 /**
36 * The markdownParser.
37 */
38 readonly markdownParser: IRenderMime.IMarkdownParser | null;
39 /**
40 * The translator.
41 */
42 readonly translator: ITranslator;
43 /**
44 * Render a mime model.
45 *
46 * @param model - The mime model to render.
47 *
48 * @param keepExisting - Whether to keep the existing rendering.
49 *
50 * @returns A promise which resolves when rendering is complete.
51 *
52 * #### Notes
53 * By default, if the DOM node for this widget already has content, it
54 * is emptied before rendering. Subclasses that do not want this behavior
55 * (if, for instance, they are using DOM diffing), should override this
56 * method or call `super.renderModel(model, true)`.
57 */
58 renderModel(model: IRenderMime.IMimeModel, keepExisting?: boolean): Promise<void>;
59 /**
60 * Render the mime model.
61 *
62 * @param model - The mime model to render.
63 *
64 * @returns A promise which resolves when rendering is complete.
65 */
66 abstract render(model: IRenderMime.IMimeModel): Promise<void>;
67 /**
68 * Set the URI fragment identifier.
69 *
70 * @param fragment - The URI fragment identifier.
71 */
72 protected setFragment(fragment: string): void;
73}
74/**
75 * A common base class for HTML mime renderers.
76 */
77export declare abstract class RenderedHTMLCommon extends RenderedCommon {
78 /**
79 * Construct a new rendered HTML common widget.
80 *
81 * @param options - The options for initializing the widget.
82 */
83 constructor(options: IRenderMime.IRendererOptions);
84 setFragment(fragment: string): void;
85}
86/**
87 * A mime renderer for displaying HTML and math.
88 */
89export declare class RenderedHTML extends RenderedHTMLCommon {
90 /**
91 * Construct a new rendered HTML widget.
92 *
93 * @param options - The options for initializing the widget.
94 */
95 constructor(options: IRenderMime.IRendererOptions);
96 /**
97 * Render a mime model.
98 *
99 * @param model - The mime model to render.
100 *
101 * @returns A promise which resolves when rendering is complete.
102 */
103 render(model: IRenderMime.IMimeModel): Promise<void>;
104 /**
105 * A message handler invoked on an `'after-attach'` message.
106 */
107 onAfterAttach(msg: Message): void;
108 private _rendered;
109}
110/**
111 * A mime renderer for displaying LaTeX output.
112 */
113export declare class RenderedLatex extends RenderedCommon {
114 /**
115 * Construct a new rendered LaTeX widget.
116 *
117 * @param options - The options for initializing the widget.
118 */
119 constructor(options: IRenderMime.IRendererOptions);
120 /**
121 * Render a mime model.
122 *
123 * @param model - The mime model to render.
124 *
125 * @returns A promise which resolves when rendering is complete.
126 */
127 render(model: IRenderMime.IMimeModel): Promise<void>;
128 /**
129 * A message handler invoked on an `'after-attach'` message.
130 */
131 onAfterAttach(msg: Message): void;
132 private _rendered;
133}
134/**
135 * A mime renderer for displaying images.
136 */
137export declare class RenderedImage extends RenderedCommon {
138 /**
139 * Construct a new rendered image widget.
140 *
141 * @param options - The options for initializing the widget.
142 */
143 constructor(options: IRenderMime.IRendererOptions);
144 /**
145 * Render a mime model.
146 *
147 * @param model - The mime model to render.
148 *
149 * @returns A promise which resolves when rendering is complete.
150 */
151 render(model: IRenderMime.IMimeModel): Promise<void>;
152}
153/**
154 * A mime renderer for displaying Markdown with embedded latex.
155 */
156export declare class RenderedMarkdown extends RenderedHTMLCommon {
157 /**
158 * Construct a new rendered markdown widget.
159 *
160 * @param options - The options for initializing the widget.
161 */
162 constructor(options: IRenderMime.IRendererOptions);
163 /**
164 * Render a mime model.
165 *
166 * @param model - The mime model to render.
167 *
168 * @returns A promise which resolves when rendering is complete.
169 */
170 render(model: IRenderMime.IMimeModel): Promise<void>;
171 /**
172 * Render a mime model.
173 *
174 * @param model - The mime model to render.
175 *
176 * @returns A promise which resolves when rendering is complete.
177 */
178 renderModel(model: IRenderMime.IMimeModel): Promise<void>;
179 /**
180 * A message handler invoked on an `'after-attach'` message.
181 */
182 onAfterAttach(msg: Message): void;
183 private _rendered;
184}
185/**
186 * A widget for displaying SVG content.
187 */
188export declare class RenderedSVG extends RenderedCommon {
189 /**
190 * Construct a new rendered SVG widget.
191 *
192 * @param options - The options for initializing the widget.
193 */
194 constructor(options: IRenderMime.IRendererOptions);
195 /**
196 * Render a mime model.
197 *
198 * @param model - The mime model to render.
199 *
200 * @returns A promise which resolves when rendering is complete.
201 */
202 render(model: IRenderMime.IMimeModel): Promise<void>;
203 /**
204 * A message handler invoked on an `'after-attach'` message.
205 */
206 onAfterAttach(msg: Message): void;
207 private _rendered;
208}
209/**
210 * A widget for displaying plain text and console text.
211 */
212export declare class RenderedText extends RenderedCommon {
213 /**
214 * Construct a new rendered text widget.
215 *
216 * @param options - The options for initializing the widget.
217 */
218 constructor(options: IRenderMime.IRendererOptions);
219 /**
220 * Render a mime model.
221 *
222 * @param model - The mime model to render.
223 *
224 * @returns A promise which resolves when rendering is complete.
225 */
226 render(model: IRenderMime.IMimeModel): Promise<void>;
227}
228export declare class RenderedError extends RenderedCommon {
229 constructor(options: IRenderMime.IRendererOptions);
230 render(model: IRenderMime.IMimeModel): Promise<void>;
231}
232/**
233 * A widget for displaying JavaScript output.
234 */
235export declare class RenderedJavaScript extends RenderedCommon {
236 /**
237 * Construct a new rendered text widget.
238 *
239 * @param options - The options for initializing the widget.
240 */
241 constructor(options: IRenderMime.IRendererOptions);
242 /**
243 * Render a mime model.
244 *
245 * @param model - The mime model to render.
246 *
247 * @returns A promise which resolves when rendering is complete.
248 */
249 render(model: IRenderMime.IMimeModel): Promise<void>;
250}