@gravity-ui/markdown-editor 15.34.5 → 15.35.0
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/build/cjs/bundle/MarkupEditorView.js +1 -1
- package/build/cjs/bundle/MarkupEditorView.js.map +1 -1
- package/build/cjs/bundle/ToolbarView.d.ts +1 -2
- package/build/cjs/bundle/ToolbarView.js +22 -10
- package/build/cjs/bundle/ToolbarView.js.map +1 -1
- package/build/cjs/bundle/WysiwygEditorView.d.ts +1 -1
- package/build/cjs/bundle/WysiwygEditorView.js +4 -4
- package/build/cjs/bundle/WysiwygEditorView.js.map +1 -1
- package/build/cjs/bundle/config/markup.js +1 -0
- package/build/cjs/bundle/config/markup.js.map +1 -1
- package/build/cjs/bundle/config/wysiwyg.js +2 -0
- package/build/cjs/bundle/config/wysiwyg.js.map +1 -1
- package/build/cjs/bundle/emoji.js +3 -0
- package/build/cjs/bundle/emoji.js.map +1 -1
- package/build/cjs/bundle/toolbar/wysiwyg/WToolbarColors.js +36 -2
- package/build/cjs/bundle/toolbar/wysiwyg/WToolbarColors.js.map +1 -1
- package/build/cjs/extensions/markdown/Lists/commands.d.ts +1 -0
- package/build/cjs/extensions/markdown/Lists/commands.js +14 -0
- package/build/cjs/extensions/markdown/Lists/commands.js.map +1 -1
- package/build/cjs/extensions/markdown/Lists/index.js +1 -0
- package/build/cjs/extensions/markdown/Lists/index.js.map +1 -1
- package/build/cjs/extensions/yfm/YfmTable/plugins/YfmTableControls/dnd/dnd-auto-scroll.d.ts +27 -0
- package/build/cjs/extensions/yfm/YfmTable/plugins/YfmTableControls/dnd/dnd-auto-scroll.js +81 -0
- package/build/cjs/extensions/yfm/YfmTable/plugins/YfmTableControls/dnd/dnd-auto-scroll.js.map +1 -0
- package/build/cjs/extensions/yfm/YfmTable/plugins/YfmTableControls/dnd/dnd.js +33 -0
- package/build/cjs/extensions/yfm/YfmTable/plugins/YfmTableControls/dnd/dnd.js.map +1 -1
- package/build/cjs/modules/toolbars/items.js +2 -0
- package/build/cjs/modules/toolbars/items.js.map +1 -1
- package/build/cjs/modules/toolbars/types.d.ts +1 -0
- package/build/cjs/modules/toolbars/types.js.map +1 -1
- package/build/cjs/react-utils/memo.d.ts +1 -0
- package/build/cjs/react-utils/memo.js +8 -0
- package/build/cjs/react-utils/memo.js.map +1 -0
- package/build/cjs/styles/markdown.css +1 -1
- package/build/cjs/styles/styles.css +5 -0
- package/build/cjs/styles/yfm-overrides.css +1 -1
- package/build/cjs/toolbar/Toolbar.d.ts +4 -0
- package/build/cjs/toolbar/Toolbar.js +9 -4
- package/build/cjs/toolbar/Toolbar.js.map +1 -1
- package/build/cjs/toolbar/ToolbarButton.js +3 -3
- package/build/cjs/toolbar/ToolbarButton.js.map +1 -1
- package/build/cjs/toolbar/ToolbarButtonPopup.js +3 -3
- package/build/cjs/toolbar/ToolbarButtonPopup.js.map +1 -1
- package/build/cjs/toolbar/ToolbarGroup.js +5 -4
- package/build/cjs/toolbar/ToolbarGroup.js.map +1 -1
- package/build/cjs/toolbar/ToolbarListButton.js +9 -6
- package/build/cjs/toolbar/ToolbarListButton.js.map +1 -1
- package/build/cjs/toolbar/ToolbarRerender.d.ts +3 -0
- package/build/cjs/toolbar/ToolbarRerender.js +48 -0
- package/build/cjs/toolbar/ToolbarRerender.js.map +1 -0
- package/build/cjs/toolbar/context.d.ts +10 -0
- package/build/cjs/toolbar/context.js +12 -0
- package/build/cjs/toolbar/context.js.map +1 -0
- package/build/cjs/toolbar/hooks.d.ts +8 -0
- package/build/cjs/toolbar/hooks.js +68 -0
- package/build/cjs/toolbar/hooks.js.map +1 -0
- package/build/cjs/toolbar/index.d.ts +1 -0
- package/build/cjs/toolbar/index.js +4 -0
- package/build/cjs/toolbar/index.js.map +1 -1
- package/build/cjs/toolbar/types.d.ts +1 -0
- package/build/cjs/toolbar/types.js.map +1 -1
- package/build/cjs/version.js +1 -1
- package/build/cjs/version.js.map +1 -1
- package/build/cjs/view/hocs/withMermaid/index.js +6 -1
- package/build/cjs/view/hocs/withMermaid/index.js.map +1 -1
- package/build/esm/bundle/MarkupEditorView.js +1 -1
- package/build/esm/bundle/MarkupEditorView.js.map +1 -1
- package/build/esm/bundle/ToolbarView.d.ts +1 -2
- package/build/esm/bundle/ToolbarView.js +24 -12
- package/build/esm/bundle/ToolbarView.js.map +1 -1
- package/build/esm/bundle/WysiwygEditorView.d.ts +1 -1
- package/build/esm/bundle/WysiwygEditorView.js +3 -4
- package/build/esm/bundle/WysiwygEditorView.js.map +1 -1
- package/build/esm/bundle/config/markup.js +1 -0
- package/build/esm/bundle/config/markup.js.map +1 -1
- package/build/esm/bundle/config/wysiwyg.js +2 -0
- package/build/esm/bundle/config/wysiwyg.js.map +1 -1
- package/build/esm/bundle/emoji.js +3 -0
- package/build/esm/bundle/emoji.js.map +1 -1
- package/build/esm/bundle/toolbar/wysiwyg/WToolbarColors.js +36 -2
- package/build/esm/bundle/toolbar/wysiwyg/WToolbarColors.js.map +1 -1
- package/build/esm/extensions/markdown/Lists/commands.d.ts +1 -0
- package/build/esm/extensions/markdown/Lists/commands.js +13 -0
- package/build/esm/extensions/markdown/Lists/commands.js.map +1 -1
- package/build/esm/extensions/markdown/Lists/index.js +2 -1
- package/build/esm/extensions/markdown/Lists/index.js.map +1 -1
- package/build/esm/extensions/yfm/YfmTable/plugins/YfmTableControls/dnd/dnd-auto-scroll.d.ts +27 -0
- package/build/esm/extensions/yfm/YfmTable/plugins/YfmTableControls/dnd/dnd-auto-scroll.js +77 -0
- package/build/esm/extensions/yfm/YfmTable/plugins/YfmTableControls/dnd/dnd-auto-scroll.js.map +1 -0
- package/build/esm/extensions/yfm/YfmTable/plugins/YfmTableControls/dnd/dnd.js +33 -0
- package/build/esm/extensions/yfm/YfmTable/plugins/YfmTableControls/dnd/dnd.js.map +1 -1
- package/build/esm/modules/toolbars/items.js +2 -0
- package/build/esm/modules/toolbars/items.js.map +1 -1
- package/build/esm/modules/toolbars/types.d.ts +1 -0
- package/build/esm/modules/toolbars/types.js.map +1 -1
- package/build/esm/react-utils/memo.d.ts +1 -0
- package/build/esm/react-utils/memo.js +5 -0
- package/build/esm/react-utils/memo.js.map +1 -0
- package/build/esm/styles/markdown.css +1 -1
- package/build/esm/styles/styles.css +5 -0
- package/build/esm/styles/yfm-overrides.css +1 -1
- package/build/esm/toolbar/Toolbar.d.ts +4 -0
- package/build/esm/toolbar/Toolbar.js +9 -4
- package/build/esm/toolbar/Toolbar.js.map +1 -1
- package/build/esm/toolbar/ToolbarButton.js +3 -3
- package/build/esm/toolbar/ToolbarButton.js.map +1 -1
- package/build/esm/toolbar/ToolbarButtonPopup.js +3 -3
- package/build/esm/toolbar/ToolbarButtonPopup.js.map +1 -1
- package/build/esm/toolbar/ToolbarGroup.js +5 -4
- package/build/esm/toolbar/ToolbarGroup.js.map +1 -1
- package/build/esm/toolbar/ToolbarListButton.js +9 -6
- package/build/esm/toolbar/ToolbarListButton.js.map +1 -1
- package/build/esm/toolbar/ToolbarRerender.d.ts +3 -0
- package/build/esm/toolbar/ToolbarRerender.js +44 -0
- package/build/esm/toolbar/ToolbarRerender.js.map +1 -0
- package/build/esm/toolbar/context.d.ts +10 -0
- package/build/esm/toolbar/context.js +8 -0
- package/build/esm/toolbar/context.js.map +1 -0
- package/build/esm/toolbar/hooks.d.ts +8 -0
- package/build/esm/toolbar/hooks.js +64 -0
- package/build/esm/toolbar/hooks.js.map +1 -0
- package/build/esm/toolbar/index.d.ts +1 -0
- package/build/esm/toolbar/index.js +1 -0
- package/build/esm/toolbar/index.js.map +1 -1
- package/build/esm/toolbar/types.d.ts +1 -0
- package/build/esm/toolbar/types.js.map +1 -1
- package/build/esm/version.js +1 -1
- package/build/esm/version.js.map +1 -1
- package/build/esm/view/hocs/withMermaid/index.js +6 -1
- package/build/esm/view/hocs/withMermaid/index.js.map +1 -1
- package/build/styles.css +7 -2
- package/package.json +17 -79
- package/README.md +0 -89
package/README.md
DELETED
|
@@ -1,89 +0,0 @@
|
|
|
1
|
-

|
|
2
|
-
|
|
3
|
-
# @gravity-ui/markdown-editor · [](https://www.npmjs.com/package/@gravity-ui/markdown-editor) [](https://github.com/gravity-ui/markdown-editor/actions/workflows/ci.yml?query=branch:main) [](https://github.com/gravity-ui/markdown-editor/actions/workflows/release.yml?query=branch:main) [](https://preview.gravity-ui.com/md-editor/)
|
|
4
|
-
|
|
5
|
-
## Markdown wysiwyg and markup editor
|
|
6
|
-
|
|
7
|
-
MarkdownEditor is a powerful tool for working with Markdown, which combines WYSIWYG and Markup modes. This means that you can create and edit content in a convenient visual mode, as well as have full control over the markup.
|
|
8
|
-
|
|
9
|
-
### 🔧 Main features
|
|
10
|
-
|
|
11
|
-
- Support for the basic Markdown and [YFM](https://ydocs.tech) syntax.
|
|
12
|
-
- Extensibility through the use of ProseMirror and CodeMirror engines.
|
|
13
|
-
- The ability to work in WYSIWYG and Markup modes for maximum flexibility.
|
|
14
|
-
|
|
15
|
-
## Install
|
|
16
|
-
|
|
17
|
-
```shell
|
|
18
|
-
npm install @gravity-ui/markdown-editor
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
### Required dependencies
|
|
22
|
-
|
|
23
|
-
Please note that to start using the package, your project must also have the following installed: `@diplodoc/transform`, `react`, `react-dom`, `@gravity-ui/uikit`, `@gravity-ui/components` and some others. Check out the `peerDependencies` section of `package.json` for accurate information.
|
|
24
|
-
|
|
25
|
-
## Getting started
|
|
26
|
-
|
|
27
|
-
The markdown editor is supplied as a React hook to create an instance of editor and a component for rendering the view.\
|
|
28
|
-
To set up styling and theme see [UIKit docs](https://github.com/gravity-ui/uikit?tab=readme-ov-file#styles).
|
|
29
|
-
|
|
30
|
-
```tsx
|
|
31
|
-
import React from 'react';
|
|
32
|
-
import {useMarkdownEditor, MarkdownEditorView} from '@gravity-ui/markdown-editor';
|
|
33
|
-
|
|
34
|
-
function Editor({onSubmit}) {
|
|
35
|
-
const editor = useMarkdownEditor({allowHTML: false});
|
|
36
|
-
|
|
37
|
-
React.useEffect(() => {
|
|
38
|
-
function submitHandler() {
|
|
39
|
-
// Serialize current content to markdown markup
|
|
40
|
-
const value = editor.getValue();
|
|
41
|
-
onSubmit(value);
|
|
42
|
-
}
|
|
43
|
-
|
|
44
|
-
editor.on('submit', submitHandler);
|
|
45
|
-
return () => {
|
|
46
|
-
editor.off('submit', submitHandler);
|
|
47
|
-
};
|
|
48
|
-
}, [onSubmit]);
|
|
49
|
-
|
|
50
|
-
return <MarkdownEditorView stickyToolbar autofocus editor={editor} />;
|
|
51
|
-
}
|
|
52
|
-
```
|
|
53
|
-
Read more:
|
|
54
|
-
- [How to connect the editor in the Create React App](https://preview.gravity-ui.com/md-editor/?path=/docs/docs-getting-started-create-react-app--docs)
|
|
55
|
-
- [How to add preview for markup mode](https://preview.gravity-ui.com/md-editor/?path=/docs/docs-getting-started-preview--docs)
|
|
56
|
-
- [How to add HTML extension](https://preview.gravity-ui.com/md-editor/?path=/docs/docs-extensions-html-block--docs)
|
|
57
|
-
- [How to add Latex extension](https://preview.gravity-ui.com/md-editor/?path=/docs/docs-extensions-latex-extension--docs)
|
|
58
|
-
- [How to add Mermaid extension](https://preview.gravity-ui.com/md-editor/?path=/docs/docs-extensions-mermaid-extension--docs)
|
|
59
|
-
- [How to write extension](https://preview.gravity-ui.com/md-editor/?path=/docs/docs-develop-extension-creation--docs)
|
|
60
|
-
- [How to add GPT extension](https://preview.gravity-ui.com/md-editor/?path=/docs/docs-extensions-gpt--docs)
|
|
61
|
-
- [How to add text binding extension in markdown](https://preview.gravity-ui.com/md-editor/?path=/docs/docs-develop-extension-with-popup--docs)
|
|
62
|
-
|
|
63
|
-
### Development
|
|
64
|
-
|
|
65
|
-
1. Install Nodejs environment, version is specified in `.nvmrc` file. We recommend using [NVM](https://github.com/nvm-sh/nvm) or a similar tool.
|
|
66
|
-
2. Install [pnpm](https://pnpm.io/installation), version is specified in `package.json` in "packageManager" property.
|
|
67
|
-
|
|
68
|
-
You can use [Corepack](https://nodejs.org/api/corepack.html), or just install via npm: run `npm deps:global --force`.
|
|
69
|
-
3. Install dependencies: `pnpm i`
|
|
70
|
-
4. Run storybook dev-server: `pnpm start`
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
### i18n
|
|
74
|
-
|
|
75
|
-
To set up internationalization, you just need to use the `configure`:
|
|
76
|
-
|
|
77
|
-
```typescript
|
|
78
|
-
import {configure} from '@gravity-ui/markdown-editor';
|
|
79
|
-
|
|
80
|
-
configure({
|
|
81
|
-
lang: 'ru',
|
|
82
|
-
});
|
|
83
|
-
```
|
|
84
|
-
|
|
85
|
-
Don't forget to call `configure()` from [UIKit](https://github.com/gravity-ui/uikit?tab=readme-ov-file#i18n) and other UI libraries.
|
|
86
|
-
|
|
87
|
-
### Contributing
|
|
88
|
-
|
|
89
|
-
- [Contributor Guidelines](https://preview.gravity-ui.com/md-editor/?path=/docs/docs-contributing--docs)
|