@atlaskit/editor-core 187.23.2 → 187.24.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @atlaskit/editor-core
 
+## 187.24.0
+
+### Minor Changes
+
+- [`24fc3925d73`](https://bitbucket.org/atlassian/atlassian-frontend/commits/24fc3925d73) - Add a new hook called `usePreset` accesed via `@atlaskit/editor-core/use-preset`. This hook can be used to safely access state and commands from outside the editor using `EditorContext`.
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 187.23.2
 
 ### Patch Changes

package/dist/cjs/create-editor/ReactEditorViewInternal.js

@@ -87,7 +87,7 @@ var ReactEditorView = /*#__PURE__*/function (_React$Component) {
   (0, _inherits2.default)(ReactEditorView, _React$Component);
   var _super = _createSuper(ReactEditorView);
   function ReactEditorView(props, context) {
-    var _props$editorProps, _props$editorProps$pe, _props$editorProps$pe2;
+    var _props$setEditorApi, _props$editorProps, _props$editorProps$pe, _props$editorProps$pe2;
     var _this;
     (0, _classCallCheck2.default)(this, ReactEditorView);
     _this = _super.call(this, props, context);
@@ -536,6 +536,7 @@ var ReactEditorView = /*#__PURE__*/function (_React$Component) {
       getEditorState: _this.getEditorState,
       getEditorView: _this.getEditorView
     });
+    (_props$setEditorApi = props.setEditorApi) === null || _props$setEditorApi === void 0 ? void 0 : _props$setEditorApi.call(props, _this.pluginInjectionAPI.api());
     _this.eventDispatcher = new _eventDispatcher.EventDispatcher();
     _this.dispatch = (0, _eventDispatcher.createDispatch)(_this.eventDispatcher);
     _this.errorReporter = (0, _createEditor.createErrorReporter)(props.editorProps.errorReporterHandler);

package/dist/cjs/editor-next/editor-internal.js

@@ -18,6 +18,7 @@ var _featureFlagsFromProps = require("../create-editor/feature-flags-from-props"
 var _ReactEditorViewNext = _interopRequireDefault(require("../create-editor/ReactEditorViewNext"));
 var _contextAdapter = require("../nodeviews/context-adapter");
 var _EditorContext = _interopRequireDefault(require("../ui/EditorContext"));
+var _context = require("../presets/context");
 var _RenderTracking = require("../utils/performance/components/RenderTracking");
 var _useMeasureEditorMountTime = _interopRequireDefault(require("./hooks/useMeasureEditorMountTime"));
 var _useProviderFactory = _interopRequireDefault(require("./hooks/useProviderFactory"));
@@ -57,6 +58,7 @@ function EditorInternalWithoutHooks(_ref) {
     onEditorDestroyed = _ref.onEditorDestroyed,
     preset = _ref.preset;
   var Component = (0, _createEditor.getUiComponent)(props.appearance);
+  var setEditorApi = (0, _context.useSetPresetContext)();
   var overriddenEditorProps = _objectSpread(_objectSpread({}, props), {}, {
     onSave: props.onSave ? handleSave : undefined,
     // noop all analytic events, even if a handler is still passed.
@@ -101,6 +103,7 @@ function EditorInternalWithoutHooks(_ref) {
         onEditorDestroyed: onEditorDestroyed,
         disabled: props.disabled,
         preset: preset,
+        setEditorApi: setEditorApi,
         render: function render(_ref2) {
           var _props$featureFlags, _props$featureFlags2;
           var editor = _ref2.editor,

package/dist/cjs/plugins/text-color/commands/toggle-color.js

@@ -27,7 +27,7 @@ var toggleColor = function toggleColor(color) {
         color: color
       });
       state.tr.scrollIntoView();
-      (0, _preset.pluginCommandToPMCommand)((0, _mark.toggleMark)(textColor, {
+      (0, _preset.editorCommandToPMCommand)((0, _mark.toggleMark)(textColor, {
         color: color
       }))(state, dispatch);
     }

package/dist/cjs/presets/context.js

@@ -0,0 +1,40 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault");
+var _typeof = require("@babel/runtime/helpers/typeof");
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useSetPresetContext = exports.usePresetContext = exports.PresetContextProvider = exports.EditorAPIContext = void 0;
+var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
+var _react = _interopRequireWildcard(require("react"));
+function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
+function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+var EditorAPIContext = /*#__PURE__*/_react.default.createContext({});
+exports.EditorAPIContext = EditorAPIContext;
+var PresetContextProvider = function PresetContextProvider(_ref) {
+  var children = _ref.children;
+  var _useState = (0, _react.useState)(),
+    _useState2 = (0, _slicedToArray2.default)(_useState, 2),
+    editorApi = _useState2[0],
+    setEditorApi = _useState2[1];
+  return /*#__PURE__*/_react.default.createElement(EditorAPIContext.Provider, {
+    value: {
+      editorApi: editorApi,
+      setEditorApi: setEditorApi
+    }
+  }, children);
+};
+exports.PresetContextProvider = PresetContextProvider;
+var usePresetContext = function usePresetContext() {
+  var _useContext = (0, _react.useContext)(EditorAPIContext),
+    editorApi = _useContext.editorApi;
+  return editorApi;
+};
+exports.usePresetContext = usePresetContext;
+var useSetPresetContext = function useSetPresetContext() {
+  var _useContext2 = (0, _react.useContext)(EditorAPIContext),
+    setEditorApi = _useContext2.setEditorApi;
+  return setEditorApi;
+};
+exports.useSetPresetContext = useSetPresetContext;

package/dist/cjs/ui/EditorContext/index.js

@@ -14,6 +14,7 @@ var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/de
 var _react = _interopRequireDefault(require("react"));
 var _propTypes = _interopRequireDefault(require("prop-types"));
 var _actions = _interopRequireDefault(require("../../actions"));
+var _context = require("../../presets/context");
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = (0, _getPrototypeOf2.default)(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = (0, _getPrototypeOf2.default)(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return (0, _possibleConstructorReturn2.default)(this, result); }; }
 function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
 var EditorContext = /*#__PURE__*/_react.default.createContext({});
@@ -43,7 +44,7 @@ var LegacyEditorContext = /*#__PURE__*/function (_React$Component) {
     value: function render() {
       return /*#__PURE__*/_react.default.createElement(EditorContext.Provider, {
         value: this.getChildContext()
-      }, this.props.children);
+      }, /*#__PURE__*/_react.default.createElement(_context.PresetContextProvider, null, this.props.children));
     }
   }]);
   return LegacyEditorContext;

package/dist/cjs/use-preset.js

@@ -0,0 +1,51 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.usePreset = usePreset;
+var _react = require("react");
+var _context = require("./presets/context");
+/**
+ * Creates a preset.
+ *
+ * Takes an input function that returns a preset (and memoizes it) depending
+ * on the dependency array provided.
+ *
+ * Returns a pluginInjectionApi in order to apply actions and subscribe to plugin
+ * changes outside of the editor.
+ *
+ * @param createPreset
+ * @param dependencies
+ * @returns PresetAPI ({ pluginInjectionApi, preset, actionBuilder })
+ *
+ * Example:
+ * ```ts
+ * function ExampleEditor() {
+ *   const { preset, editorApi } = usePreset(() =>
+ *     new EditorPresetBuilder().add(plugin1).add(plugin2)
+ *   , []);
+ *
+ *   // Can execute typesafe commands based on plugin1 or 2
+ *   const runCommand = () => editorApi.executeCommand(
+ *     editorApi.dependencies.plugin1.commands.doSomething()
+ *   )
+ *   return (
+ *     <>
+ *       <Editor preset={preset} />
+ *       <Button onClick={runCommand}>Run command</Button>
+ *     </>
+ *   )
+ * }
+ * ```
+ */
+function usePreset(createPreset, dependencies) {
+  var editorApi = (0, _context.usePresetContext)();
+
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  var preset = (0, _react.useMemo)(createPreset, dependencies);
+  return {
+    editorApi: editorApi,
+    preset: preset
+  };
+}

package/dist/cjs/version-wrapper.js

@@ -6,7 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.version = exports.nextMajorVersion = exports.name = void 0;
 var name = "@atlaskit/editor-core";
 exports.name = name;
-var version = "187.23.2";
+var version = "187.24.0";
 exports.version = version;
 var nextMajorVersion = function nextMajorVersion() {
   return [Number(version.split('.')[0]) + 1, 0, 0].join('.');

package/dist/cjs/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/editor-core",
-	"version": "187.23.2",
+	"version": "187.24.0",
 	"sideEffects": false
 }

package/dist/es2019/create-editor/ReactEditorViewInternal.js

@@ -86,7 +86,7 @@ export class ReactEditorView extends React.Component {
     return ((_this$props$editorPro3 = this.props.editorProps) === null || _this$props$editorPro3 === void 0 ? void 0 : (_this$props$editorPro4 = _this$props$editorPro3.performanceTracking) === null || _this$props$editorPro4 === void 0 ? void 0 : (_this$props$editorPro5 = _this$props$editorPro4.transactionTracking) === null || _this$props$editorPro5 === void 0 ? void 0 : _this$props$editorPro5.enabled) === false;
   }
   constructor(props, context) {
-    var _props$editorProps, _props$editorProps$pe, _props$editorProps$pe2;
+    var _props$setEditorApi, _props$editorProps, _props$editorProps$pe, _props$editorProps$pe2;
     super(props, context);
     _defineProperty(this, "editorRef", /*#__PURE__*/React.createRef());
     // ProseMirror is instantiated prior to the initial React render cycle,
@@ -532,6 +532,7 @@ export class ReactEditorView extends React.Component {
       getEditorState: this.getEditorState,
       getEditorView: this.getEditorView
     });
+    (_props$setEditorApi = props.setEditorApi) === null || _props$setEditorApi === void 0 ? void 0 : _props$setEditorApi.call(props, this.pluginInjectionAPI.api());
     this.eventDispatcher = new EventDispatcher();
     this.dispatch = createDispatch(this.eventDispatcher);
     this.errorReporter = createErrorReporter(props.editorProps.errorReporterHandler);

package/dist/es2019/editor-next/editor-internal.js

@@ -10,6 +10,7 @@ import { createFeatureFlagsFromProps } from '../create-editor/feature-flags-from
 import ReactEditorView from '../create-editor/ReactEditorViewNext';
 import { ContextAdapter } from '../nodeviews/context-adapter';
 import EditorContext from '../ui/EditorContext';
+import { useSetPresetContext } from '../presets/context';
 import { RenderTracking } from '../utils/performance/components/RenderTracking';
 import useMeasureEditorMountTime from './hooks/useMeasureEditorMountTime';
 import useProviderFactory from './hooks/useProviderFactory';
@@ -51,6 +52,7 @@ export function EditorInternalWithoutHooks({
 }) {
   var _props$performanceTra, _props$performanceTra2, _props$performanceTra3, _props$performanceTra4;
   const Component = getUiComponent(props.appearance);
+  const setEditorApi = useSetPresetContext();
   const overriddenEditorProps = {
     ...props,
     onSave: props.onSave ? handleSave : undefined,
@@ -95,6 +97,7 @@ export function EditorInternalWithoutHooks({
       onEditorDestroyed: onEditorDestroyed,
       disabled: props.disabled,
       preset: preset,
+      setEditorApi: setEditorApi,
       render: ({
         editor,
         view,

package/dist/es2019/plugins/text-color/commands/toggle-color.js

@@ -1,7 +1,7 @@
 import { toggleMark } from '@atlaskit/editor-common/mark';
 import { ACTIONS, pluginKey } from '../pm-plugins/main';
 import { getDisabledState } from '../utils/disabled';
-import { pluginCommandToPMCommand } from '@atlaskit/editor-common/preset';
+import { editorCommandToPMCommand } from '@atlaskit/editor-common/preset';
 export const toggleColor = color => (state, dispatch) => {
   const {
     textColor
@@ -22,7 +22,7 @@ export const toggleColor = color => (state, dispatch) => {
       color
     });
     state.tr.scrollIntoView();
-    pluginCommandToPMCommand(toggleMark(textColor, {
+    editorCommandToPMCommand(toggleMark(textColor, {
       color
     }))(state, dispatch);
   }

package/dist/es2019/presets/context.js

@@ -0,0 +1,25 @@
+import React, { useState, useContext } from 'react';
+export const EditorAPIContext = /*#__PURE__*/React.createContext({});
+export const PresetContextProvider = ({
+  children
+}) => {
+  const [editorApi, setEditorApi] = useState();
+  return /*#__PURE__*/React.createElement(EditorAPIContext.Provider, {
+    value: {
+      editorApi,
+      setEditorApi
+    }
+  }, children);
+};
+export const usePresetContext = () => {
+  const {
+    editorApi
+  } = useContext(EditorAPIContext);
+  return editorApi;
+};
+export const useSetPresetContext = () => {
+  const {
+    setEditorApi
+  } = useContext(EditorAPIContext);
+  return setEditorApi;
+};

package/dist/es2019/ui/EditorContext/index.js

@@ -2,6 +2,7 @@ import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import React from 'react';
 import PropTypes from 'prop-types';
 import EditorActions from '../../actions';
+import { PresetContextProvider } from '../../presets/context';
 const EditorContext = /*#__PURE__*/React.createContext({});
 export const useEditorContext = () => React.useContext(EditorContext);
 export default class LegacyEditorContext extends React.Component {
@@ -17,7 +18,7 @@ export default class LegacyEditorContext extends React.Component {
   render() {
     return /*#__PURE__*/React.createElement(EditorContext.Provider, {
       value: this.getChildContext()
-    }, this.props.children);
+    }, /*#__PURE__*/React.createElement(PresetContextProvider, null, this.props.children));
   }
 }
 _defineProperty(LegacyEditorContext, "childContextTypes", {

package/dist/es2019/use-preset.js

@@ -0,0 +1,45 @@
+import { useMemo } from 'react';
+import { usePresetContext } from './presets/context';
+/**
+ * Creates a preset.
+ *
+ * Takes an input function that returns a preset (and memoizes it) depending
+ * on the dependency array provided.
+ *
+ * Returns a pluginInjectionApi in order to apply actions and subscribe to plugin
+ * changes outside of the editor.
+ *
+ * @param createPreset
+ * @param dependencies
+ * @returns PresetAPI ({ pluginInjectionApi, preset, actionBuilder })
+ *
+ * Example:
+ * ```ts
+ * function ExampleEditor() {
+ *   const { preset, editorApi } = usePreset(() =>
+ *     new EditorPresetBuilder().add(plugin1).add(plugin2)
+ *   , []);
+ *
+ *   // Can execute typesafe commands based on plugin1 or 2
+ *   const runCommand = () => editorApi.executeCommand(
+ *     editorApi.dependencies.plugin1.commands.doSomething()
+ *   )
+ *   return (
+ *     <>
+ *       <Editor preset={preset} />
+ *       <Button onClick={runCommand}>Run command</Button>
+ *     </>
+ *   )
+ * }
+ * ```
+ */
+export function usePreset(createPreset, dependencies) {
+  const editorApi = usePresetContext();
+
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  const preset = useMemo(createPreset, dependencies);
+  return {
+    editorApi,
+    preset
+  };
+}

package/dist/es2019/version-wrapper.js

@@ -1,5 +1,5 @@
 export const name = "@atlaskit/editor-core";
-export const version = "187.23.2";
+export const version = "187.24.0";
 export const nextMajorVersion = () => {
   return [Number(version.split('.')[0]) + 1, 0, 0].join('.');
 };

package/dist/es2019/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/editor-core",
-	"version": "187.23.2",
+	"version": "187.24.0",
 	"sideEffects": false
 }

package/dist/esm/create-editor/ReactEditorViewInternal.js

@@ -80,7 +80,7 @@ export var ReactEditorView = /*#__PURE__*/function (_React$Component) {
   _inherits(ReactEditorView, _React$Component);
   var _super = _createSuper(ReactEditorView);
   function ReactEditorView(props, context) {
-    var _props$editorProps, _props$editorProps$pe, _props$editorProps$pe2;
+    var _props$setEditorApi, _props$editorProps, _props$editorProps$pe, _props$editorProps$pe2;
     var _this;
     _classCallCheck(this, ReactEditorView);
     _this = _super.call(this, props, context);
@@ -529,6 +529,7 @@ export var ReactEditorView = /*#__PURE__*/function (_React$Component) {
       getEditorState: _this.getEditorState,
       getEditorView: _this.getEditorView
     });
+    (_props$setEditorApi = props.setEditorApi) === null || _props$setEditorApi === void 0 ? void 0 : _props$setEditorApi.call(props, _this.pluginInjectionAPI.api());
     _this.eventDispatcher = new EventDispatcher();
     _this.dispatch = createDispatch(_this.eventDispatcher);
     _this.errorReporter = createErrorReporter(props.editorProps.errorReporterHandler);

package/dist/esm/editor-next/editor-internal.js

@@ -13,6 +13,7 @@ import { createFeatureFlagsFromProps } from '../create-editor/feature-flags-from
 import ReactEditorView from '../create-editor/ReactEditorViewNext';
 import { ContextAdapter } from '../nodeviews/context-adapter';
 import EditorContext from '../ui/EditorContext';
+import { useSetPresetContext } from '../presets/context';
 import { RenderTracking } from '../utils/performance/components/RenderTracking';
 import useMeasureEditorMountTime from './hooks/useMeasureEditorMountTime';
 import useProviderFactory from './hooks/useProviderFactory';
@@ -50,6 +51,7 @@ export function EditorInternalWithoutHooks(_ref) {
     onEditorDestroyed = _ref.onEditorDestroyed,
     preset = _ref.preset;
   var Component = getUiComponent(props.appearance);
+  var setEditorApi = useSetPresetContext();
   var overriddenEditorProps = _objectSpread(_objectSpread({}, props), {}, {
     onSave: props.onSave ? handleSave : undefined,
     // noop all analytic events, even if a handler is still passed.
@@ -94,6 +96,7 @@ export function EditorInternalWithoutHooks(_ref) {
         onEditorDestroyed: onEditorDestroyed,
         disabled: props.disabled,
         preset: preset,
+        setEditorApi: setEditorApi,
         render: function render(_ref2) {
           var _props$featureFlags, _props$featureFlags2;
           var editor = _ref2.editor,

package/dist/esm/plugins/text-color/commands/toggle-color.js

@@ -1,7 +1,7 @@
 import { toggleMark } from '@atlaskit/editor-common/mark';
 import { ACTIONS, pluginKey } from '../pm-plugins/main';
 import { getDisabledState } from '../utils/disabled';
-import { pluginCommandToPMCommand } from '@atlaskit/editor-common/preset';
+import { editorCommandToPMCommand } from '@atlaskit/editor-common/preset';
 export var toggleColor = function toggleColor(color) {
   return function (state, dispatch) {
     var textColor = state.schema.marks.textColor;
@@ -21,7 +21,7 @@ export var toggleColor = function toggleColor(color) {
         color: color
       });
       state.tr.scrollIntoView();
-      pluginCommandToPMCommand(toggleMark(textColor, {
+      editorCommandToPMCommand(toggleMark(textColor, {
         color: color
       }))(state, dispatch);
     }

package/dist/esm/presets/context.js

@@ -0,0 +1,26 @@
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import React, { useState, useContext } from 'react';
+export var EditorAPIContext = /*#__PURE__*/React.createContext({});
+export var PresetContextProvider = function PresetContextProvider(_ref) {
+  var children = _ref.children;
+  var _useState = useState(),
+    _useState2 = _slicedToArray(_useState, 2),
+    editorApi = _useState2[0],
+    setEditorApi = _useState2[1];
+  return /*#__PURE__*/React.createElement(EditorAPIContext.Provider, {
+    value: {
+      editorApi: editorApi,
+      setEditorApi: setEditorApi
+    }
+  }, children);
+};
+export var usePresetContext = function usePresetContext() {
+  var _useContext = useContext(EditorAPIContext),
+    editorApi = _useContext.editorApi;
+  return editorApi;
+};
+export var useSetPresetContext = function useSetPresetContext() {
+  var _useContext2 = useContext(EditorAPIContext),
+    setEditorApi = _useContext2.setEditorApi;
+  return setEditorApi;
+};

package/dist/esm/ui/EditorContext/index.js

@@ -9,6 +9,7 @@ function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Re
 import React from 'react';
 import PropTypes from 'prop-types';
 import EditorActions from '../../actions';
+import { PresetContextProvider } from '../../presets/context';
 var EditorContext = /*#__PURE__*/React.createContext({});
 export var useEditorContext = function useEditorContext() {
   return React.useContext(EditorContext);
@@ -35,7 +36,7 @@ var LegacyEditorContext = /*#__PURE__*/function (_React$Component) {
     value: function render() {
       return /*#__PURE__*/React.createElement(EditorContext.Provider, {
         value: this.getChildContext()
-      }, this.props.children);
+      }, /*#__PURE__*/React.createElement(PresetContextProvider, null, this.props.children));
     }
   }]);
   return LegacyEditorContext;

package/dist/esm/use-preset.js

@@ -0,0 +1,45 @@
+import { useMemo } from 'react';
+import { usePresetContext } from './presets/context';
+/**
+ * Creates a preset.
+ *
+ * Takes an input function that returns a preset (and memoizes it) depending
+ * on the dependency array provided.
+ *
+ * Returns a pluginInjectionApi in order to apply actions and subscribe to plugin
+ * changes outside of the editor.
+ *
+ * @param createPreset
+ * @param dependencies
+ * @returns PresetAPI ({ pluginInjectionApi, preset, actionBuilder })
+ *
+ * Example:
+ * ```ts
+ * function ExampleEditor() {
+ *   const { preset, editorApi } = usePreset(() =>
+ *     new EditorPresetBuilder().add(plugin1).add(plugin2)
+ *   , []);
+ *
+ *   // Can execute typesafe commands based on plugin1 or 2
+ *   const runCommand = () => editorApi.executeCommand(
+ *     editorApi.dependencies.plugin1.commands.doSomething()
+ *   )
+ *   return (
+ *     <>
+ *       <Editor preset={preset} />
+ *       <Button onClick={runCommand}>Run command</Button>
+ *     </>
+ *   )
+ * }
+ * ```
+ */
+export function usePreset(createPreset, dependencies) {
+  var editorApi = usePresetContext();
+
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  var preset = useMemo(createPreset, dependencies);
+  return {
+    editorApi: editorApi,
+    preset: preset
+  };
+}

package/dist/esm/version-wrapper.js

@@ -1,5 +1,5 @@
 export var name = "@atlaskit/editor-core";
-export var version = "187.23.2";
+export var version = "187.24.0";
 export var nextMajorVersion = function nextMajorVersion() {
   return [Number(version.split('.')[0]) + 1, 0, 0].join('.');
 };

package/dist/esm/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/editor-core",
-	"version": "187.23.2",
+	"version": "187.24.0",
 	"sideEffects": false
 }

package/dist/types/create-editor/ReactEditorViewInternal.d.ts

@@ -16,6 +16,7 @@ import { FULL_WIDTH_MODE } from '@atlaskit/editor-common/analytics';
 import type { EditorAppearance, EditorConfig, EditorReactContext, EditorPlugin, EditorProps } from '../types';
 import type { EditorNextProps } from '../types/editor-props';
 import type { PortalProviderAPI } from '@atlaskit/editor-common/portal-provider';
+import type { SetEditorAPI } from '../presets/context';
 import { TransactionTracker } from '../utils/performance/track-transactions';
 import type { FireAnalyticsCallback, AnalyticsEventPayload, DispatchAnalyticsEvent } from '@atlaskit/editor-common/analytics';
 import type { EditorPresetBuilder } from '@atlaskit/editor-common/preset';
@@ -26,6 +27,7 @@ export interface EditorViewProps {
     portalProviderAPI: PortalProviderAPI;
     disabled?: boolean;
     experienceStore?: ExperienceStore;
+    setEditorApi?: SetEditorAPI;
     render?: (props: {
         editor: JSX.Element;
         view?: EditorView;

package/dist/types/labs/next/presets/default.d.ts

@@ -263,13 +263,13 @@ export declare function createDefaultPreset(options: EditorPresetProps & Default
         actions: import("@atlaskit/editor-common/analytics").EditorAnalyticsAPI;
     }>>];
     commands: {
-        toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
+        toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
     };
 }> | undefined) => import("@atlaskit/editor-common/types").DefaultEditorPlugin<"textFormatting", {
     pluginConfiguration: TextFormattingOptions | undefined;
@@ -303,13 +303,13 @@ export declare function createDefaultPreset(options: EditorPresetProps & Default
         actions: import("@atlaskit/editor-common/analytics").EditorAnalyticsAPI;
     }>>];
     commands: {
-        toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
+        toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
     };
 }>, (config?: HyperlinkPluginOptions | undefined, api?: import("@atlaskit/editor-common/types").PluginInjectionAPI<"hyperlink", {
     pluginConfiguration: HyperlinkPluginOptions | undefined;
@@ -634,13 +634,13 @@ export declare function useDefaultPreset(props: EditorPresetProps & DefaultPrese
         actions: import("@atlaskit/editor-common/analytics").EditorAnalyticsAPI;
     }>>];
     commands: {
-        toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
+        toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
     };
 }> | undefined) => import("@atlaskit/editor-common/types").DefaultEditorPlugin<"textFormatting", {
     pluginConfiguration: TextFormattingOptions | undefined;
@@ -674,13 +674,13 @@ export declare function useDefaultPreset(props: EditorPresetProps & DefaultPrese
         actions: import("@atlaskit/editor-common/analytics").EditorAnalyticsAPI;
     }>>];
     commands: {
-        toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-        toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
+        toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+        toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
     };
 }>, (config?: HyperlinkPluginOptions | undefined, api?: import("@atlaskit/editor-common/types").PluginInjectionAPI<"hyperlink", {
     pluginConfiguration: HyperlinkPluginOptions | undefined;

package/dist/types/plugins/emoji/commands/insert-emoji.d.ts

@@ -1,4 +1,4 @@
 import type { EmojiId } from '@atlaskit/emoji';
-import type { PluginCommand } from '@atlaskit/editor-common/types';
+import type { EditorCommand } from '@atlaskit/editor-common/types';
 import type { INPUT_METHOD, EditorAnalyticsAPI } from '@atlaskit/editor-common/analytics';
-export declare const insertEmoji: (editorAnalyticsAPI: EditorAnalyticsAPI | undefined) => (emojiId: EmojiId, inputMethod?: INPUT_METHOD.PICKER | INPUT_METHOD.ASCII | INPUT_METHOD.TYPEAHEAD) => PluginCommand;
+export declare const insertEmoji: (editorAnalyticsAPI: EditorAnalyticsAPI | undefined) => (emojiId: EmojiId, inputMethod?: INPUT_METHOD.PICKER | INPUT_METHOD.ASCII | INPUT_METHOD.TYPEAHEAD) => EditorCommand;

package/dist/types/plugins/emoji/index.d.ts

@@ -2,7 +2,7 @@ import { SafePlugin } from '@atlaskit/editor-common/safe-plugin';
 import type { EditorState } from '@atlaskit/editor-prosemirror/state';
 import { PluginKey } from '@atlaskit/editor-prosemirror/state';
 import type { EmojiDescription, EmojiProvider, EmojiId } from '@atlaskit/emoji';
-import type { Command, NextEditorPlugin, PMPluginFactoryParams, OptionalPlugin, PluginCommand } from '@atlaskit/editor-common/types';
+import type { Command, NextEditorPlugin, PMPluginFactoryParams, OptionalPlugin, EditorCommand } from '@atlaskit/editor-common/types';
 import { INPUT_METHOD } from '@atlaskit/editor-common/analytics';
 import type { TypeAheadItem } from '../type-ahead/types';
 import type { EmojiPluginOptions, EmojiPluginState } from './types';
@@ -18,7 +18,7 @@ export type EmojiPlugin = NextEditorPlugin<'emoji', {
     dependencies: [OptionalPlugin<typeof analyticsPlugin>];
     sharedState: EmojiPluginState | undefined;
     commands: {
-        insertEmoji: (emojiId: EmojiId, inputMethod?: INPUT_METHOD.PICKER | INPUT_METHOD.ASCII | INPUT_METHOD.TYPEAHEAD) => PluginCommand;
+        insertEmoji: (emojiId: EmojiId, inputMethod?: INPUT_METHOD.PICKER | INPUT_METHOD.ASCII | INPUT_METHOD.TYPEAHEAD) => EditorCommand;
     };
 }>;
 export declare const emojiPlugin: EmojiPlugin;

package/dist/types/plugins/find-replace/index.d.ts

@@ -1,4 +1,4 @@
-import { NextEditorPlugin } from '@atlaskit/editor-common/types';
+import type { NextEditorPlugin } from '@atlaskit/editor-common/types';
 import type featureFlagsPlugin from '@atlaskit/editor-plugin-feature-flags';
 type Config = {
     takeFullWidth: boolean;

package/dist/types/presets/context.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { PublicPluginAPI } from '@atlaskit/editor-common/types';
+export type SetEditorAPI = (editorApi: PublicPluginAPI<any>) => void;
+export interface EditorAPIContextType {
+    editorApi?: PublicPluginAPI<any>;
+    setEditorApi?: SetEditorAPI;
+}
+export declare const EditorAPIContext: React.Context<EditorAPIContextType>;
+interface EditorAPIProviderProps {
+    children: React.ReactNode;
+}
+export declare const PresetContextProvider: ({ children }: EditorAPIProviderProps) => JSX.Element;
+export declare const usePresetContext: () => PublicPluginAPI<any> | undefined;
+export declare const useSetPresetContext: () => SetEditorAPI | undefined;
+export {};

package/dist/types/use-preset.d.ts

@@ -0,0 +1,48 @@
+import type { DependencyList } from 'react';
+import type { EditorPresetBuilder } from '@atlaskit/editor-common/preset';
+import type { AllEditorPresetPluginTypes, PublicPluginAPI, NextEditorPlugin } from '@atlaskit/editor-common/types';
+type ExtractNextEditorPlugins<Plugins extends AllEditorPresetPluginTypes[]> = {
+    [PluginNumber in keyof Plugins]: Plugins[PluginNumber] extends NextEditorPlugin<infer Name, infer Metadata> ? NextEditorPlugin<Name, Metadata> : Plugins[PluginNumber] extends [
+        NextEditorPlugin<infer Name, infer Metadata>,
+        any
+    ] ? NextEditorPlugin<Name, Metadata> : never;
+};
+interface PresetAPI<PluginNames extends string[] = [], StackPlugins extends AllEditorPresetPluginTypes[] = []> {
+    editorApi: PublicPluginAPI<ExtractNextEditorPlugins<StackPlugins>> | undefined;
+    preset: EditorPresetBuilder<PluginNames, StackPlugins>;
+}
+/**
+ * Creates a preset.
+ *
+ * Takes an input function that returns a preset (and memoizes it) depending
+ * on the dependency array provided.
+ *
+ * Returns a pluginInjectionApi in order to apply actions and subscribe to plugin
+ * changes outside of the editor.
+ *
+ * @param createPreset
+ * @param dependencies
+ * @returns PresetAPI ({ pluginInjectionApi, preset, actionBuilder })
+ *
+ * Example:
+ * ```ts
+ * function ExampleEditor() {
+ *   const { preset, editorApi } = usePreset(() =>
+ *     new EditorPresetBuilder().add(plugin1).add(plugin2)
+ *   , []);
+ *
+ *   // Can execute typesafe commands based on plugin1 or 2
+ *   const runCommand = () => editorApi.executeCommand(
+ *     editorApi.dependencies.plugin1.commands.doSomething()
+ *   )
+ *   return (
+ *     <>
+ *       <Editor preset={preset} />
+ *       <Button onClick={runCommand}>Run command</Button>
+ *     </>
+ *   )
+ * }
+ * ```
+ */
+export declare function usePreset<PluginNames extends string[] = [], StackPlugins extends AllEditorPresetPluginTypes[] = []>(createPreset: () => EditorPresetBuilder<PluginNames, StackPlugins>, dependencies: DependencyList): PresetAPI<PluginNames, StackPlugins>;
+export {};

package/dist/types-ts4.5/create-editor/ReactEditorViewInternal.d.ts

@@ -16,6 +16,7 @@ import { FULL_WIDTH_MODE } from '@atlaskit/editor-common/analytics';
 import type { EditorAppearance, EditorConfig, EditorReactContext, EditorPlugin, EditorProps } from '../types';
 import type { EditorNextProps } from '../types/editor-props';
 import type { PortalProviderAPI } from '@atlaskit/editor-common/portal-provider';
+import type { SetEditorAPI } from '../presets/context';
 import { TransactionTracker } from '../utils/performance/track-transactions';
 import type { FireAnalyticsCallback, AnalyticsEventPayload, DispatchAnalyticsEvent } from '@atlaskit/editor-common/analytics';
 import type { EditorPresetBuilder } from '@atlaskit/editor-common/preset';
@@ -26,6 +27,7 @@ export interface EditorViewProps {
     portalProviderAPI: PortalProviderAPI;
     disabled?: boolean;
     experienceStore?: ExperienceStore;
+    setEditorApi?: SetEditorAPI;
     render?: (props: {
         editor: JSX.Element;
         view?: EditorView;

package/dist/types-ts4.5/labs/next/presets/default.d.ts

@@ -320,13 +320,13 @@ export declare function createDefaultPreset(options: EditorPresetProps & Default
             }>>
         ];
         commands: {
-            toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
+            toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
         };
     }> | undefined) => import("@atlaskit/editor-common/types").DefaultEditorPlugin<"textFormatting", {
         pluginConfiguration: TextFormattingOptions | undefined;
@@ -366,13 +366,13 @@ export declare function createDefaultPreset(options: EditorPresetProps & Default
             }>>
         ];
         commands: {
-            toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
+            toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
         };
     }>,
     (config?: HyperlinkPluginOptions | undefined, api?: import("@atlaskit/editor-common/types").PluginInjectionAPI<"hyperlink", {
@@ -771,13 +771,13 @@ export declare function useDefaultPreset(props: EditorPresetProps & DefaultPrese
             }>>
         ];
         commands: {
-            toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
+            toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
         };
     }> | undefined) => import("@atlaskit/editor-common/types").DefaultEditorPlugin<"textFormatting", {
         pluginConfiguration: TextFormattingOptions | undefined;
@@ -817,13 +817,13 @@ export declare function useDefaultPreset(props: EditorPresetProps & DefaultPrese
             }>>
         ];
         commands: {
-            toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
-            toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkPluginCommand;
+            toggleSuperscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleSubscript: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleStrike: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleCode: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleUnderline: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleEm: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
+            toggleStrong: import("@atlaskit/editor-plugin-text-formatting").ToggleMarkEditorCommand;
         };
     }>,
     (config?: HyperlinkPluginOptions | undefined, api?: import("@atlaskit/editor-common/types").PluginInjectionAPI<"hyperlink", {

package/dist/types-ts4.5/plugins/emoji/commands/insert-emoji.d.ts

@@ -1,4 +1,4 @@
 import type { EmojiId } from '@atlaskit/emoji';
-import type { PluginCommand } from '@atlaskit/editor-common/types';
+import type { EditorCommand } from '@atlaskit/editor-common/types';
 import type { INPUT_METHOD, EditorAnalyticsAPI } from '@atlaskit/editor-common/analytics';
-export declare const insertEmoji: (editorAnalyticsAPI: EditorAnalyticsAPI | undefined) => (emojiId: EmojiId, inputMethod?: INPUT_METHOD.PICKER | INPUT_METHOD.ASCII | INPUT_METHOD.TYPEAHEAD) => PluginCommand;
+export declare const insertEmoji: (editorAnalyticsAPI: EditorAnalyticsAPI | undefined) => (emojiId: EmojiId, inputMethod?: INPUT_METHOD.PICKER | INPUT_METHOD.ASCII | INPUT_METHOD.TYPEAHEAD) => EditorCommand;

package/dist/types-ts4.5/plugins/emoji/index.d.ts

@@ -2,7 +2,7 @@ import { SafePlugin } from '@atlaskit/editor-common/safe-plugin';
 import type { EditorState } from '@atlaskit/editor-prosemirror/state';
 import { PluginKey } from '@atlaskit/editor-prosemirror/state';
 import type { EmojiDescription, EmojiProvider, EmojiId } from '@atlaskit/emoji';
-import type { Command, NextEditorPlugin, PMPluginFactoryParams, OptionalPlugin, PluginCommand } from '@atlaskit/editor-common/types';
+import type { Command, NextEditorPlugin, PMPluginFactoryParams, OptionalPlugin, EditorCommand } from '@atlaskit/editor-common/types';
 import { INPUT_METHOD } from '@atlaskit/editor-common/analytics';
 import type { TypeAheadItem } from '../type-ahead/types';
 import type { EmojiPluginOptions, EmojiPluginState } from './types';
@@ -20,7 +20,7 @@ export type EmojiPlugin = NextEditorPlugin<'emoji', {
     ];
     sharedState: EmojiPluginState | undefined;
     commands: {
-        insertEmoji: (emojiId: EmojiId, inputMethod?: INPUT_METHOD.PICKER | INPUT_METHOD.ASCII | INPUT_METHOD.TYPEAHEAD) => PluginCommand;
+        insertEmoji: (emojiId: EmojiId, inputMethod?: INPUT_METHOD.PICKER | INPUT_METHOD.ASCII | INPUT_METHOD.TYPEAHEAD) => EditorCommand;
     };
 }>;
 export declare const emojiPlugin: EmojiPlugin;

package/dist/types-ts4.5/plugins/find-replace/index.d.ts

@@ -1,4 +1,4 @@
-import { NextEditorPlugin } from '@atlaskit/editor-common/types';
+import type { NextEditorPlugin } from '@atlaskit/editor-common/types';
 import type featureFlagsPlugin from '@atlaskit/editor-plugin-feature-flags';
 type Config = {
     takeFullWidth: boolean;

package/dist/types-ts4.5/presets/context.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { PublicPluginAPI } from '@atlaskit/editor-common/types';
+export type SetEditorAPI = (editorApi: PublicPluginAPI<any>) => void;
+export interface EditorAPIContextType {
+    editorApi?: PublicPluginAPI<any>;
+    setEditorApi?: SetEditorAPI;
+}
+export declare const EditorAPIContext: React.Context<EditorAPIContextType>;
+interface EditorAPIProviderProps {
+    children: React.ReactNode;
+}
+export declare const PresetContextProvider: ({ children }: EditorAPIProviderProps) => JSX.Element;
+export declare const usePresetContext: () => PublicPluginAPI<any> | undefined;
+export declare const useSetPresetContext: () => SetEditorAPI | undefined;
+export {};

package/dist/types-ts4.5/use-preset.d.ts

@@ -0,0 +1,52 @@
+import type { DependencyList } from 'react';
+import type { EditorPresetBuilder } from '@atlaskit/editor-common/preset';
+import type { AllEditorPresetPluginTypes, PublicPluginAPI, NextEditorPlugin } from '@atlaskit/editor-common/types';
+type ExtractNextEditorPlugins<Plugins extends AllEditorPresetPluginTypes[]> = {
+    [PluginNumber in keyof Plugins]: Plugins[PluginNumber] extends NextEditorPlugin<infer Name, infer Metadata> ? NextEditorPlugin<Name, Metadata> : Plugins[PluginNumber] extends [
+        NextEditorPlugin<infer Name, infer Metadata>,
+        any
+    ] ? NextEditorPlugin<Name, Metadata> : never;
+};
+interface PresetAPI<PluginNames extends string[] = [
+], StackPlugins extends AllEditorPresetPluginTypes[] = [
+]> {
+    editorApi: PublicPluginAPI<ExtractNextEditorPlugins<StackPlugins>> | undefined;
+    preset: EditorPresetBuilder<PluginNames, StackPlugins>;
+}
+/**
+ * Creates a preset.
+ *
+ * Takes an input function that returns a preset (and memoizes it) depending
+ * on the dependency array provided.
+ *
+ * Returns a pluginInjectionApi in order to apply actions and subscribe to plugin
+ * changes outside of the editor.
+ *
+ * @param createPreset
+ * @param dependencies
+ * @returns PresetAPI ({ pluginInjectionApi, preset, actionBuilder })
+ *
+ * Example:
+ * ```ts
+ * function ExampleEditor() {
+ *   const { preset, editorApi } = usePreset(() =>
+ *     new EditorPresetBuilder().add(plugin1).add(plugin2)
+ *   , []);
+ *
+ *   // Can execute typesafe commands based on plugin1 or 2
+ *   const runCommand = () => editorApi.executeCommand(
+ *     editorApi.dependencies.plugin1.commands.doSomething()
+ *   )
+ *   return (
+ *     <>
+ *       <Editor preset={preset} />
+ *       <Button onClick={runCommand}>Run command</Button>
+ *     </>
+ *   )
+ * }
+ * ```
+ */
+export declare function usePreset<PluginNames extends string[] = [
+], StackPlugins extends AllEditorPresetPluginTypes[] = [
+]>(createPreset: () => EditorPresetBuilder<PluginNames, StackPlugins>, dependencies: DependencyList): PresetAPI<PluginNames, StackPlugins>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlaskit/editor-core",
-  "version": "187.23.2",
+  "version": "187.24.0",
   "description": "A package contains Atlassian editor core functionality",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
@@ -55,7 +55,7 @@
     "@atlaskit/code": "^14.6.0",
     "@atlaskit/date": "^0.10.0",
     "@atlaskit/datetime-picker": "^12.7.0",
-    "@atlaskit/editor-common": "^74.45.0",
+    "@atlaskit/editor-common": "^74.46.0",
     "@atlaskit/editor-json-transformer": "^8.10.0",
     "@atlaskit/editor-markdown-transformer": "^5.2.5",
     "@atlaskit/editor-palette": "1.5.1",
@@ -72,7 +72,7 @@
     "@atlaskit/editor-plugin-guideline": "^0.3.4",
     "@atlaskit/editor-plugin-hyperlink": "^0.3.0",
     "@atlaskit/editor-plugin-image-upload": "^0.1.0",
-    "@atlaskit/editor-plugin-table": "^2.8.0",
+    "@atlaskit/editor-plugin-table": "^2.9.0",
     "@atlaskit/editor-plugin-text-formatting": "^0.2.0",
     "@atlaskit/editor-plugin-width": "^0.1.0",
     "@atlaskit/editor-prosemirror": "1.1.0",
@@ -146,7 +146,7 @@
     "@atlaskit/collab-provider": "9.10.1",
     "@atlaskit/dropdown-menu": "^11.11.0",
     "@atlaskit/editor-extension-dropbox": "^0.4.0",
-    "@atlaskit/editor-plugin-table": "^2.8.0",
+    "@atlaskit/editor-plugin-table": "^2.9.0",
     "@atlaskit/editor-test-helpers": "^18.11.0",
     "@atlaskit/flag": "^15.2.0",
     "@atlaskit/icon-object": "^6.3.0",

package/report.api.md

@@ -130,6 +130,7 @@ import { PresenceResource } from '@atlaskit/mention/resource';
 import PropTypes from 'prop-types';
 import type { ProviderFactory } from '@atlaskit/editor-common/provider-factory';
 import type { Providers } from '@atlaskit/editor-common/provider-factory';
+import type { PublicPluginAPI } from '@atlaskit/editor-common/types';
 import { PureComponent } from 'react';
 import { QuickInsertActionInsert } from '@atlaskit/editor-common/provider-factory';
 import { QuickInsertItem } from '@atlaskit/editor-common/provider-factory';
@@ -974,6 +975,8 @@ interface EditorViewProps {
     dispatchAnalyticsEvent: DispatchAnalyticsEvent;
     editorRef: React_2.RefObject<HTMLDivElement>;
   }) => JSX.Element;
+  // (undocumented)
+  setEditorApi?: SetEditorAPI;
 }
 
 // @public (undocumented)
@@ -1957,6 +1960,9 @@ export function setBlockTypeWithAnalytics(
   editorAnalyticsApi: EditorAnalyticsAPI | undefined,
 ): Command_2;
 
+// @public (undocumented)
+type SetEditorAPI = (editorApi: PublicPluginAPI<any>) => void;
+
 // @public (undocumented)
 export const setIsExpanded: (isExpanded: boolean) => Command_2;
 

package/tmp/api-report-tmp.d.ts

@@ -119,6 +119,7 @@ import { PresenceResource } from '@atlaskit/mention/resource';
 import PropTypes from 'prop-types';
 import type { ProviderFactory } from '@atlaskit/editor-common/provider-factory';
 import type { Providers } from '@atlaskit/editor-common/provider-factory';
+import type { PublicPluginAPI } from '@atlaskit/editor-common/types';
 import { PureComponent } from 'react';
 import { QuickInsertActionInsert } from '@atlaskit/editor-common/provider-factory';
 import { QuickInsertItem } from '@atlaskit/editor-common/provider-factory';
@@ -898,6 +899,8 @@ interface EditorViewProps {
         dispatchAnalyticsEvent: DispatchAnalyticsEvent;
         editorRef: React_2.RefObject<HTMLDivElement>;
     }) => JSX.Element;
+    // (undocumented)
+    setEditorApi?: SetEditorAPI;
 }
 
 // @public (undocumented)
@@ -1737,6 +1740,9 @@ export function setBlockType(name: string): Command_2;
 // @public (undocumented)
 export function setBlockTypeWithAnalytics(name: string, inputMethod: BlockTypeInputMethod, editorAnalyticsApi: EditorAnalyticsAPI | undefined): Command_2;
 
+// @public (undocumented)
+type SetEditorAPI = (editorApi: PublicPluginAPI<any>) => void;
+
 // @public (undocumented)
 export const setIsExpanded: (isExpanded: boolean) => Command_2;
 

package/use-preset/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@atlaskit/editor-core/use-preset",
+  "main": "../dist/cjs/use-preset.js",
+  "module": "../dist/esm/use-preset.js",
+  "module:es2019": "../dist/es2019/use-preset.js",
+  "sideEffects": false,
+  "types": "../dist/types/use-preset.d.ts",
+  "typesVersions": {
+    ">=4.5 <4.9": {
+      "*": [
+        "../dist/types-ts4.5/use-preset.d.ts"
+      ]
+    }
+  }
+}