@portabletext/editor 1.49.2 → 1.49.4

package/lib/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../src/utils/util.is-equal-selections.ts","../../src/utils/util.split-text-block.ts"],"sourcesContent":["import type {EditorSelection} from '../types/editor'\nimport {isEqualSelectionPoints} from './util.is-equal-selection-points'\n\n/**\n * @public\n */\nexport function isEqualSelections(a: EditorSelection, b: EditorSelection) {\n  if (!a && !b) {\n    return true\n  }\n\n  if (!a || !b) {\n    return false\n  }\n\n  return (\n    isEqualSelectionPoints(a.anchor, b.anchor) &&\n    isEqualSelectionPoints(a.focus, b.focus)\n  )\n}\n","import type {PortableTextTextBlock} from '@sanity/types'\nimport type {EditorSelectionPoint} from '..'\nimport type {EditorContext} from '../editor/editor-snapshot'\nimport {isSpan} from './util.is-span'\nimport {isTextBlock} from './util.is-text-block'\nimport {sliceBlocks} from './util.slice-blocks'\n\n/**\n * @beta\n */\nexport function splitTextBlock({\n  context,\n  block,\n  point,\n}: {\n  context: Pick<EditorContext, 'schema'>\n  block: PortableTextTextBlock\n  point: EditorSelectionPoint\n}): {before: PortableTextTextBlock; after: PortableTextTextBlock} | undefined {\n  const firstChild = block.children.at(0)\n  const lastChild = block.children.at(block.children.length - 1)\n\n  if (!firstChild || !lastChild) {\n    return undefined\n  }\n\n  const before = sliceBlocks({\n    context: {\n      schema: context.schema,\n      selection: {\n        anchor: {\n          path: [{_key: block._key}, 'children', {_key: firstChild._key}],\n          offset: 0,\n        },\n        focus: point,\n      },\n    },\n    blocks: [block],\n  }).at(0)\n  const after = sliceBlocks({\n    context: {\n      schema: context.schema,\n      selection: {\n        anchor: point,\n        focus: {\n          path: [{_key: block._key}, 'children', {_key: lastChild._key}],\n          offset: isSpan(context, lastChild) ? lastChild.text.length : 0,\n        },\n      },\n    },\n    blocks: [block],\n  }).at(0)\n\n  if (!before || !after) {\n    return undefined\n  }\n\n  if (!isTextBlock(context, before) || !isTextBlock(context, after)) {\n    return undefined\n  }\n\n  return {before, after}\n}\n"],"names":["isEqualSelections","a","b","isEqualSelectionPoints","anchor","focus","splitTextBlock","context","block","point","firstChild","children","at","lastChild","length","before","sliceBlocks","schema","selection","path","_key","offset","blocks","after","isSpan","text","isTextBlock"],"mappings":";;;;;;AAMgBA,SAAAA,kBAAkBC,GAAoBC,GAAoB;AACpE,SAAA,CAACD,KAAK,CAACC,IACF,KAGL,CAACD,KAAK,CAACC,IACF,KAIPC,uBAAuBF,EAAEG,QAAQF,EAAEE,MAAM,KACzCD,uBAAuBF,EAAEI,OAAOH,EAAEG,KAAK;AAE3C;ACTO,SAASC,eAAe;AAAA,EAC7BC;AAAAA,EACAC;AAAAA,EACAC;AAKF,GAA8E;AAC5E,QAAMC,aAAaF,MAAMG,SAASC,GAAG,CAAC,GAChCC,YAAYL,MAAMG,SAASC,GAAGJ,MAAMG,SAASG,SAAS,CAAC;AAEzD,MAAA,CAACJ,cAAc,CAACG;AAClB;AAGF,QAAME,SAASC,YAAY;AAAA,IACzBT,SAAS;AAAA,MACPU,QAAQV,QAAQU;AAAAA,MAChBC,WAAW;AAAA,QACTd,QAAQ;AAAA,UACNe,MAAM,CAAC;AAAA,YAACC,MAAMZ,MAAMY;AAAAA,aAAO,YAAY;AAAA,YAACA,MAAMV,WAAWU;AAAAA,UAAAA,CAAK;AAAA,UAC9DC,QAAQ;AAAA,QACV;AAAA,QACAhB,OAAOI;AAAAA,MAAAA;AAAAA,IAEX;AAAA,IACAa,QAAQ,CAACd,KAAK;AAAA,EACf,CAAA,EAAEI,GAAG,CAAC,GACDW,QAAQP,YAAY;AAAA,IACxBT,SAAS;AAAA,MACPU,QAAQV,QAAQU;AAAAA,MAChBC,WAAW;AAAA,QACTd,QAAQK;AAAAA,QACRJ,OAAO;AAAA,UACLc,MAAM,CAAC;AAAA,YAACC,MAAMZ,MAAMY;AAAAA,aAAO,YAAY;AAAA,YAACA,MAAMP,UAAUO;AAAAA,UAAAA,CAAK;AAAA,UAC7DC,QAAQG,OAAOjB,SAASM,SAAS,IAAIA,UAAUY,KAAKX,SAAS;AAAA,QAAA;AAAA,MAC/D;AAAA,IAEJ;AAAA,IACAQ,QAAQ,CAACd,KAAK;AAAA,EAAA,CACf,EAAEI,GAAG,CAAC;AAEP,MAAI,EAACG,CAAAA,UAAU,CAACQ,UAIZ,EAACG,CAAAA,YAAYnB,SAASQ,MAAM,KAAK,CAACW,YAAYnB,SAASgB,KAAK;AAIzD,WAAA;AAAA,MAACR;AAAAA,MAAQQ;AAAAA,IAAK;AACvB;"}
+{"version":3,"file":"index.js","sources":["../../src/utils/util.is-equal-selections.ts","../../src/utils/util.split-text-block.ts"],"sourcesContent":["import type {EditorSelection} from '../types/editor'\nimport {isEqualSelectionPoints} from './util.is-equal-selection-points'\n\n/**\n * @public\n */\nexport function isEqualSelections(a: EditorSelection, b: EditorSelection) {\n  if (!a && !b) {\n    return true\n  }\n\n  if (!a || !b) {\n    return false\n  }\n\n  return (\n    isEqualSelectionPoints(a.anchor, b.anchor) &&\n    isEqualSelectionPoints(a.focus, b.focus)\n  )\n}\n","import type {PortableTextTextBlock} from '@sanity/types'\nimport type {EditorSelectionPoint} from '..'\nimport type {EditorContext} from '../editor/editor-snapshot'\nimport {isSpan} from './util.is-span'\nimport {isTextBlock} from './util.is-text-block'\nimport {sliceBlocks} from './util.slice-blocks'\n\n/**\n * @beta\n */\nexport function splitTextBlock({\n  context,\n  block,\n  point,\n}: {\n  context: Pick<EditorContext, 'schema'>\n  block: PortableTextTextBlock\n  point: EditorSelectionPoint\n}): {before: PortableTextTextBlock; after: PortableTextTextBlock} | undefined {\n  const firstChild = block.children.at(0)\n  const lastChild = block.children.at(block.children.length - 1)\n\n  if (!firstChild || !lastChild) {\n    return undefined\n  }\n\n  const before = sliceBlocks({\n    context: {\n      schema: context.schema,\n      selection: {\n        anchor: {\n          path: [{_key: block._key}, 'children', {_key: firstChild._key}],\n          offset: 0,\n        },\n        focus: point,\n      },\n    },\n    blocks: [block],\n  }).at(0)\n  const after = sliceBlocks({\n    context: {\n      schema: context.schema,\n      selection: {\n        anchor: point,\n        focus: {\n          path: [{_key: block._key}, 'children', {_key: lastChild._key}],\n          offset: isSpan(context, lastChild) ? lastChild.text.length : 0,\n        },\n      },\n    },\n    blocks: [block],\n  }).at(0)\n\n  if (!before || !after) {\n    return undefined\n  }\n\n  if (!isTextBlock(context, before) || !isTextBlock(context, after)) {\n    return undefined\n  }\n\n  return {before, after}\n}\n"],"names":["isEqualSelections","a","b","isEqualSelectionPoints","anchor","focus","splitTextBlock","context","block","point","firstChild","children","at","lastChild","length","before","sliceBlocks","schema","selection","path","_key","offset","blocks","after","isSpan","text","isTextBlock"],"mappings":";;;;;;;;AAMgBA,SAAAA,kBAAkBC,GAAoBC,GAAoB;AACpE,SAAA,CAACD,KAAK,CAACC,IACF,KAGL,CAACD,KAAK,CAACC,IACF,KAIPC,uBAAuBF,EAAEG,QAAQF,EAAEE,MAAM,KACzCD,uBAAuBF,EAAEI,OAAOH,EAAEG,KAAK;AAE3C;ACTO,SAASC,eAAe;AAAA,EAC7BC;AAAAA,EACAC;AAAAA,EACAC;AAKF,GAA8E;AAC5E,QAAMC,aAAaF,MAAMG,SAASC,GAAG,CAAC,GAChCC,YAAYL,MAAMG,SAASC,GAAGJ,MAAMG,SAASG,SAAS,CAAC;AAEzD,MAAA,CAACJ,cAAc,CAACG;AAClB;AAGF,QAAME,SAASC,YAAY;AAAA,IACzBT,SAAS;AAAA,MACPU,QAAQV,QAAQU;AAAAA,MAChBC,WAAW;AAAA,QACTd,QAAQ;AAAA,UACNe,MAAM,CAAC;AAAA,YAACC,MAAMZ,MAAMY;AAAAA,aAAO,YAAY;AAAA,YAACA,MAAMV,WAAWU;AAAAA,UAAAA,CAAK;AAAA,UAC9DC,QAAQ;AAAA,QACV;AAAA,QACAhB,OAAOI;AAAAA,MAAAA;AAAAA,IAEX;AAAA,IACAa,QAAQ,CAACd,KAAK;AAAA,EACf,CAAA,EAAEI,GAAG,CAAC,GACDW,QAAQP,YAAY;AAAA,IACxBT,SAAS;AAAA,MACPU,QAAQV,QAAQU;AAAAA,MAChBC,WAAW;AAAA,QACTd,QAAQK;AAAAA,QACRJ,OAAO;AAAA,UACLc,MAAM,CAAC;AAAA,YAACC,MAAMZ,MAAMY;AAAAA,aAAO,YAAY;AAAA,YAACA,MAAMP,UAAUO;AAAAA,UAAAA,CAAK;AAAA,UAC7DC,QAAQG,OAAOjB,SAASM,SAAS,IAAIA,UAAUY,KAAKX,SAAS;AAAA,QAAA;AAAA,MAC/D;AAAA,IAEJ;AAAA,IACAQ,QAAQ,CAACd,KAAK;AAAA,EAAA,CACf,EAAEI,GAAG,CAAC;AAEP,MAAI,EAACG,CAAAA,UAAU,CAACQ,UAIZ,EAACG,CAAAA,YAAYnB,SAASQ,MAAM,KAAK,CAACW,YAAYnB,SAASgB,KAAK;AAIzD,WAAA;AAAA,MAACR;AAAAA,MAAQQ;AAAAA,IAAK;AACvB;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@portabletext/editor",
-  "version": "1.49.2",
+  "version": "1.49.4",
   "description": "Portable Text Editor made in React",
   "keywords": [
     "sanity",
@@ -79,43 +79,43 @@
     "slate-react": "0.114.2",
     "use-effect-event": "^1.0.2",
     "xstate": "^5.19.2",
-    "@portabletext/block-tools": "1.1.24",
+    "@portabletext/block-tools": "1.1.25",
     "@portabletext/patches": "1.1.3"
   },
   "devDependencies": {
     "@portabletext/toolkit": "^2.0.17",
     "@sanity/diff-match-patch": "^3.2.0",
     "@sanity/pkg-utils": "^7.2.2",
-    "@sanity/schema": "^3.88.0",
-    "@sanity/types": "^3.88.0",
+    "@sanity/schema": "^3.88.2",
+    "@sanity/types": "^3.88.2",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.3.0",
     "@types/debug": "^4.1.12",
     "@types/lodash": "^4.17.16",
     "@types/lodash.startcase": "^4.4.9",
-    "@types/react": "^19.1.2",
+    "@types/react": "^19.1.3",
     "@types/react-dom": "^19.1.3",
-    "@typescript-eslint/eslint-plugin": "^8.29.0",
-    "@typescript-eslint/parser": "^8.29.0",
+    "@typescript-eslint/eslint-plugin": "^8.32.0",
+    "@typescript-eslint/parser": "^8.32.0",
     "@vitejs/plugin-react": "^4.4.1",
-    "@vitest/browser": "^3.1.2",
-    "@vitest/coverage-istanbul": "^3.1.2",
+    "@vitest/browser": "^3.1.3",
+    "@vitest/coverage-istanbul": "^3.1.3",
     "babel-plugin-react-compiler": "19.1.0-rc.1",
     "eslint": "8.57.1",
-    "eslint-plugin-react-hooks": "0.0.0-experimental-0038c501-20250429",
+    "eslint-plugin-react-hooks": "0.0.0-experimental-7a2c7045-20250506",
     "jsdom": "^26.0.0",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
     "rxjs": "^7.8.2",
     "typescript": "5.8.3",
     "vite": "^6.2.5",
-    "vitest": "^3.1.2",
+    "vitest": "^3.1.3",
     "vitest-browser-react": "^0.1.1",
     "racejar": "1.2.4"
   },
   "peerDependencies": {
-    "@sanity/schema": "^3.88.0",
-    "@sanity/types": "^3.88.0",
+    "@sanity/schema": "^3.88.2",
+    "@sanity/types": "^3.88.2",
     "react": "^16.9 || ^17 || ^18 || ^19",
     "rxjs": "^7.8.2"
   },

package/src/editor/create-editor.ts

@@ -1,76 +1,20 @@
-import type {
-  ArrayDefinition,
-  ArraySchemaType,
-  PortableTextBlock,
-} from '@sanity/types'
-import type {ActorRef, EventObject, Snapshot} from 'xstate'
-import type {Behavior} from '../behaviors/behavior.types.behavior'
-import type {ExternalBehaviorEvent} from '../behaviors/behavior.types.event'
 import {createCoreConverters} from '../converters/converters.core'
+import type {Editor, EditorConfig} from '../editor'
 import {compileType} from '../internal-utils/schema'
 import {corePriority} from '../priority/priority.core'
 import {createEditorPriority} from '../priority/priority.types'
 import type {EditableAPI} from '../types/editor'
 import {createSlateEditor, type SlateEditor} from './create-slate-editor'
-import type {
-  EditorActor,
-  EditorEmittedEvent,
-  ExternalEditorEvent,
-} from './editor-machine'
+import type {EditorActor} from './editor-machine'
 import {
   compileSchemaDefinitionToLegacySchema,
   legacySchemaToEditorSchema,
-  type SchemaDefinition,
 } from './editor-schema'
 import {getEditorSnapshot} from './editor-selector'
-import type {EditorSnapshot} from './editor-snapshot'
 import {defaultKeyGenerator} from './key-generator'
 import {createLegacySchema} from './legacy-schema'
 import {createEditableAPI} from './plugins/createWithEditableAPI'
 
-/**
- * @public
- */
-export type EditorConfig = {
-  /**
-   * @beta
-   */
-  keyGenerator?: () => string
-  /**
-   * @deprecated Will be removed in the next major version
-   */
-  maxBlocks?: number
-  readOnly?: boolean
-  initialValue?: Array<PortableTextBlock>
-} & (
-  | {
-      schemaDefinition: SchemaDefinition
-      schema?: undefined
-    }
-  | {
-      schemaDefinition?: undefined
-      schema: ArraySchemaType<PortableTextBlock> | ArrayDefinition
-    }
-)
-
-/**
- * @public
- */
-export type EditorEvent = ExternalEditorEvent | ExternalBehaviorEvent
-
-/**
- * @public
- */
-export type Editor = {
-  getSnapshot: () => EditorSnapshot
-  /**
-   * @beta
-   */
-  registerBehavior: (config: {behavior: Behavior}) => () => void
-  send: (event: EditorEvent) => void
-  on: ActorRef<Snapshot<unknown>, EventObject, EditorEmittedEvent>['on']
-}
-
 export type InternalEditor = Editor & {
   _internal: {
     editable: EditableAPI

package/src/editor/editor-context.tsx

@@ -1,5 +1,5 @@
+import type {Editor} from '../editor'
 import {createGloballyScopedContext} from '../internal-utils/globally-scoped-context'
-import type {Editor} from './create-editor'
 
 export const EditorContext = createGloballyScopedContext<Editor | null>(
   '@portabletext/editor/context/editor',

package/src/editor/editor-provider.tsx

@@ -1,12 +1,10 @@
 import {useActorRef} from '@xstate/react'
-import React, {useMemo} from 'react'
+import type React from 'react'
+import {useMemo} from 'react'
 import {Slate} from 'slate-react'
+import type {EditorConfig} from '../editor'
 import {Synchronizer} from './components/Synchronizer'
-import {
-  createInternalEditor,
-  editorConfigToMachineInput,
-  type EditorConfig,
-} from './create-editor'
+import {createInternalEditor, editorConfigToMachineInput} from './create-editor'
 import {EditorActorContext} from './editor-actor-context'
 import {EditorContext} from './editor-context'
 import {editorMachine} from './editor-machine'
@@ -87,28 +85,3 @@ export function EditorProvider(props: EditorProviderProps) {
     </EditorContext.Provider>
   )
 }
-
-/**
- * @public
- * Get the current editor context from the `EditorProvider`.
- * Must be used inside the `EditorProvider` component.
- * @returns The current editor object.
- * @example
- * ```tsx
- * import { useEditor } from '@portabletext/editor'
- *
- * function MyComponent() {
- *  const editor = useEditor()
- * }
- * ```
- * @group Hooks
- */
-export function useEditor() {
-  const editor = React.useContext(EditorContext)
-
-  if (!editor) {
-    throw new Error('No Editor set. Use EditorProvider to set one.')
-  }
-
-  return editor
-}

package/src/editor/editor-selector.ts

@@ -1,7 +1,8 @@
 import {useSelector} from '@xstate/react'
+import type {Editor} from '../editor'
 import {slateChildrenToBlocks} from '../internal-utils/slate-children-to-blocks'
 import type {PortableTextSlateEditor} from '../types/editor'
-import type {Editor, InternalEditor} from './create-editor'
+import type {InternalEditor} from './create-editor'
 import type {EditorActor} from './editor-machine'
 import type {EditorSnapshot} from './editor-snapshot'
 import {getActiveDecorators} from './get-active-decorators'

package/src/editor/sync-machine.ts

@@ -444,48 +444,69 @@ async function updateValue({
       schemaTypes: context.schema,
     })
 
-    await new Promise<void>((resolve) => {
-      Editor.withoutNormalizing(slateEditor, () => {
-        withRemoteChanges(slateEditor, () => {
-          withoutPatching(slateEditor, async () => {
-            const childrenLength = slateEditor.children.length
+    if (streamBlocks) {
+      await new Promise<void>((resolve) => {
+        Editor.withoutNormalizing(slateEditor, () => {
+          withRemoteChanges(slateEditor, () => {
+            withoutPatching(slateEditor, async () => {
+              isChanged = removeExtraBlocks({
+                slateEditor,
+                slateValueFromProps,
+              })
 
-            // Remove blocks that have become superfluous
-            if (slateValueFromProps.length < childrenLength) {
-              for (
-                let i = childrenLength - 1;
-                i > slateValueFromProps.length - 1;
-                i--
-              ) {
-                Transforms.removeNodes(slateEditor, {
-                  at: [i],
+              for await (const [
+                currentBlock,
+                currentBlockIndex,
+              ] of getStreamedBlocks({
+                slateValue: slateValueFromProps,
+              })) {
+                const {blockChanged, blockValid} = syncBlock({
+                  context,
+                  sendBack,
+                  block: currentBlock,
+                  index: currentBlockIndex,
+                  slateEditor,
+                  value,
                 })
+
+                isChanged = blockChanged || isChanged
+                isValid = isValid && blockValid
               }
-              isChanged = true
-            }
 
-            for await (const [currentBlock, currentBlockIndex] of getBlocks({
-              slateValue: slateValueFromProps,
-              streamBlocks,
-            })) {
-              // Go through all of the blocks and see if they need to be updated
+              resolve()
+            })
+          })
+        })
+      })
+    } else {
+      Editor.withoutNormalizing(slateEditor, () => {
+        withRemoteChanges(slateEditor, () => {
+          withoutPatching(slateEditor, () => {
+            isChanged = removeExtraBlocks({
+              slateEditor,
+              slateValueFromProps,
+            })
+
+            let index = 0
+
+            for (const currentBlock of slateValueFromProps) {
               const {blockChanged, blockValid} = syncBlock({
                 context,
                 sendBack,
                 block: currentBlock,
-                index: currentBlockIndex,
+                index,
                 slateEditor,
                 value,
               })
+
               isChanged = blockChanged || isChanged
               isValid = isValid && blockValid
+              index++
             }
-
-            resolve()
           })
         })
       })
-    })
+    }
   }
 
   if (!isValid) {
@@ -523,16 +544,36 @@ async function updateValue({
   sendBack({type: 'done syncing', value})
 }
 
-async function* getBlocks({
+function removeExtraBlocks({
+  slateEditor,
+  slateValueFromProps,
+}: {
+  slateEditor: PortableTextSlateEditor
+  slateValueFromProps: Array<Descendant>
+}) {
+  let isChanged = false
+  const childrenLength = slateEditor.children.length
+
+  // Remove blocks that have become superfluous
+  if (slateValueFromProps.length < childrenLength) {
+    for (let i = childrenLength - 1; i > slateValueFromProps.length - 1; i--) {
+      Transforms.removeNodes(slateEditor, {
+        at: [i],
+      })
+    }
+    isChanged = true
+  }
+  return isChanged
+}
+
+async function* getStreamedBlocks({
   slateValue,
-  streamBlocks,
 }: {
   slateValue: Array<Descendant>
-  streamBlocks: boolean
 }) {
   let index = 0
   for await (const block of slateValue) {
-    if (streamBlocks && index % 10 === 0) {
+    if (index % 10 === 0) {
       await new Promise<void>((resolve) => setTimeout(resolve, 0))
     }
     yield [block, index] as const

package/src/editor/use-editor.ts

@@ -0,0 +1,27 @@
+import React from 'react'
+import {EditorContext} from './editor-context'
+
+/**
+ * @public
+ * Get the current editor context from the `EditorProvider`.
+ * Must be used inside the `EditorProvider` component.
+ * @returns The current editor object.
+ * @example
+ * ```tsx
+ * import { useEditor } from '@portabletext/editor'
+ *
+ * function MyComponent() {
+ *  const editor = useEditor()
+ * }
+ * ```
+ * @group Hooks
+ */
+export function useEditor() {
+  const editor = React.useContext(EditorContext)
+
+  if (!editor) {
+    throw new Error('No Editor set. Use EditorProvider to set one.')
+  }
+
+  return editor
+}

package/src/editor-event-listener.tsx

@@ -1,7 +1,7 @@
 import {useEffect} from 'react'
 import {useEffectEvent} from 'use-effect-event'
 import type {EditorEmittedEvent} from './editor/editor-machine'
-import {useEditor} from './editor/editor-provider'
+import {useEditor} from './editor/use-editor'
 
 /**
  * @public

package/src/editor.ts

@@ -0,0 +1,57 @@
+import type {
+  ArrayDefinition,
+  ArraySchemaType,
+  PortableTextBlock,
+} from '@sanity/types'
+import type {ActorRef, EventObject, Snapshot} from 'xstate'
+import type {Behavior} from './behaviors/behavior.types.behavior'
+import type {ExternalBehaviorEvent} from './behaviors/behavior.types.event'
+import type {
+  EditorEmittedEvent,
+  ExternalEditorEvent,
+} from './editor/editor-machine'
+import type {SchemaDefinition} from './editor/editor-schema'
+import type {EditorSnapshot} from './editor/editor-snapshot'
+
+/**
+ * @public
+ */
+export type EditorConfig = {
+  /**
+   * @beta
+   */
+  keyGenerator?: () => string
+  /**
+   * @deprecated Will be removed in the next major version
+   */
+  maxBlocks?: number
+  readOnly?: boolean
+  initialValue?: Array<PortableTextBlock>
+} & (
+  | {
+      schemaDefinition: SchemaDefinition
+      schema?: undefined
+    }
+  | {
+      schemaDefinition?: undefined
+      schema: ArraySchemaType<PortableTextBlock> | ArrayDefinition
+    }
+)
+
+/**
+ * @public
+ */
+export type EditorEvent = ExternalEditorEvent | ExternalBehaviorEvent
+
+/**
+ * @public
+ */
+export type Editor = {
+  getSnapshot: () => EditorSnapshot
+  /**
+   * @beta
+   */
+  registerBehavior: (config: {behavior: Behavior}) => () => void
+  send: (event: EditorEvent) => void
+  on: ActorRef<Snapshot<unknown>, EventObject, EditorEmittedEvent>['on']
+}

package/src/index.ts

@@ -4,15 +4,8 @@ export type {
   PortableTextChild,
   PortableTextSpan,
 } from '@sanity/types'
-export type {AddedAnnotationPaths} from './operations/behavior.operation.annotation.add'
 export {EditorEventListener} from './editor-event-listener'
-export type {Editor, EditorConfig, EditorEvent} from './editor/create-editor'
-export {
-  defineSchema,
-  type BaseDefinition,
-  type SchemaDefinition,
-} from './editor/editor-schema'
-export type {EditorSchema} from './editor/editor-schema'
+export type {Editor, EditorConfig, EditorEvent} from './editor'
 export {PortableTextEditable} from './editor/Editable'
 export type {PortableTextEditableProps} from './editor/Editable'
 export type {
@@ -22,9 +15,14 @@ export type {
 } from './editor/editor-machine'
 export {
   EditorProvider,
-  useEditor,
   type EditorProviderProps,
 } from './editor/editor-provider'
+export {
+  defineSchema,
+  type BaseDefinition,
+  type SchemaDefinition,
+} from './editor/editor-schema'
+export type {EditorSchema} from './editor/editor-schema'
 export {useEditorSelector, type EditorSelector} from './editor/editor-selector'
 export type {EditorContext, EditorSnapshot} from './editor/editor-snapshot'
 export {usePortableTextEditor} from './editor/hooks/usePortableTextEditor'
@@ -32,6 +30,8 @@ export {usePortableTextEditorSelection} from './editor/hooks/usePortableTextEdit
 export {defaultKeyGenerator as keyGenerator} from './editor/key-generator'
 export {PortableTextEditor} from './editor/PortableTextEditor'
 export type {PortableTextEditorProps} from './editor/PortableTextEditor'
+export {useEditor} from './editor/use-editor'
+export type {AddedAnnotationPaths} from './operations/behavior.operation.annotation.add'
 export type {BlockOffset} from './types/block-offset'
 export type {
   BlockAnnotationRenderProps,

package/src/internal-utils/text-selection.test.ts

@@ -6,6 +6,17 @@ import {
 } from './text-selection'
 
 test(getTextSelection.name, () => {
+  const simpleBlock = {
+    _key: 'b1',
+    _type: 'block',
+    children: [{_key: 's1', _type: 'span', text: 'foo'}],
+  }
+
+  expect(getTextSelection([simpleBlock], 'foo')).toEqual({
+    anchor: {path: [{_key: 'b1'}, 'children', {_key: 's1'}], offset: 0},
+    focus: {path: [{_key: 'b1'}, 'children', {_key: 's1'}], offset: 3},
+  })
+
   const joinedBlock = {
     _key: 'b1',
     _type: 'block',

package/src/plugins/plugin.behavior.tsx

@@ -1,6 +1,6 @@
 import {useEffect} from 'react'
 import type {Behavior} from '../behaviors'
-import {useEditor} from '../editor/editor-provider'
+import {useEditor} from '../editor/use-editor'
 
 /**
  * @beta

package/src/plugins/plugin.decorator-shortcut.ts

@@ -10,9 +10,9 @@ import {
 import {createDecoratorPairBehavior} from '../behaviors/behavior.decorator-pair'
 import {effect, execute, forward} from '../behaviors/behavior.types.action'
 import {defineBehavior} from '../behaviors/behavior.types.behavior'
-import type {Editor} from '../editor/create-editor'
-import {useEditor} from '../editor/editor-provider'
+import type {Editor} from '../editor'
 import type {EditorSchema} from '../editor/editor-schema'
+import {useEditor} from '../editor/use-editor'
 import type {BlockOffset} from '../types/block-offset'
 import * as utils from '../utils'
 

package/src/plugins/plugin.editor-ref.tsx

@@ -1,6 +1,6 @@
 import React from 'react'
-import type {Editor} from '../editor/create-editor'
-import {useEditor} from '../editor/editor-provider'
+import type {Editor} from '../editor'
+import {useEditor} from '../editor/use-editor'
 
 /**
  * @beta

package/src/plugins/plugin.event-listener.tsx

@@ -1,7 +1,7 @@
 import {useEffect} from 'react'
 import {useEffectEvent} from 'use-effect-event'
 import type {EditorEmittedEvent} from '../editor/editor-machine'
-import {useEditor} from '../editor/editor-provider'
+import {useEditor} from '../editor/use-editor'
 
 /**
  * @public

package/src/plugins/plugin.markdown.tsx

@@ -3,8 +3,8 @@ import {
   createMarkdownBehaviors,
   type MarkdownBehaviorsConfig,
 } from '../behaviors/behavior.markdown'
-import {useEditor} from '../editor/editor-provider'
 import type {EditorSchema} from '../editor/editor-schema'
+import {useEditor} from '../editor/use-editor'
 import {DecoratorShortcutPlugin} from './plugin.decorator-shortcut'
 
 /**