feat: Add dangerouslyLowLevelInstance (#204)

Author: Jungwoo-An

README.md

@@ -177,6 +177,29 @@ const handleSave = React.useCallback(async () => {
 <ReactEditorJS onInitialize={handleInitialize} defaultValue={blocks} />
 ```
 
+If you want to access low-level instance, you can use `dangerouslyLowLevelInstance`
+
+⚠️ dangerouslyLowLevelInstance depends on the execution environment.
+
+| Environment | Instnace Type |
+| - | - |
+| Browser | EditorJS instance|
+| NodeJS | null |
+
+```tsx
+const editorCore = React.useRef(null)
+
+const handleInitialize = React.useCallback((instance) => {
+  editorCore.current = instance
+}, [])
+
+const handleSave = React.useCallback(async () => {
+  const savedData = await editorCore.current.dangerouslyLowLevelInstance?.save();
+}, [])
+
+<ReactEditorJS onInitialize={handleInitialize} defaultValue={blocks} />
+```
+
 ### Haven't received data from server (when use Link)
 
 You should set linkTool [config](https://github.com/editor-js/link#usage). 💪🏻

packages/@react-editor-js/client/src/client-editor-core.ts

@@ -21,6 +21,10 @@ export class ClientEditorCore implements EditorCore {
     })
   }
 
+  public get dangerouslyLowLevelInstance() {
+    return this._editorJS
+  }
+
   public async clear() {
     await this._editorJS.clear()
   }

packages/@react-editor-js/core/src/editor-core.ts

@@ -8,4 +8,6 @@ export interface EditorCore {
   save(): Promise<OutputData>
 
   render(data: OutputData): Promise<void>
+
+  get dangerouslyLowLevelInstance(): any | null
 }

packages/@react-editor-js/core/tests/TestEditorCore.ts

@@ -11,6 +11,10 @@ export class TestEditorCore implements EditorCore {
     return this._data
   }
 
+  public get dangerouslyLowLevelInstance() {
+    return null
+  }
+
   public async clear() {}
 
   public async save() {

packages/@react-editor-js/server/src/server-editor-core.ts

@@ -10,6 +10,10 @@ export class ServerEditorCore implements EditorCore {
     }
   }
 
+  public get dangerouslyLowLevelInstance() {
+    return null
+  }
+
   public async clear() {}
 
   public async save() {