@portabletext/editor 1.49.1 → 1.49.3

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.1",
+  "version": "1.49.3",
   "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/patches": "1.1.3",
-    "@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/behaviors/behavior.abstract.split.ts

@@ -49,7 +49,7 @@ export const abstractSplitBehaviors = [
             blocks: [focusTextBlock.node],
           }).at(0),
           context: snapshot.context,
-          options: {refreshKeys: true},
+          options: {refreshKeys: true, validateFields: true},
         })
 
         if (!newTextBlock || !isTextBlock(snapshot.context, newTextBlock)) {
@@ -84,7 +84,7 @@ export const abstractSplitBehaviors = [
             children: [],
           },
           context: snapshot.context,
-          options: {refreshKeys: true},
+          options: {refreshKeys: true, validateFields: true},
         })
 
         if (!newTextBlock) {

package/src/converters/converter.portable-text.ts

@@ -62,6 +62,7 @@ export const converterPortableText = defineConverter({
            * dropped portable text as is.
            */
           refreshKeys: !snapshot.beta.hasTag?.('dragging internally'),
+          validateFields: false,
         },
       })
       return parsedBlock ? [parsedBlock] : []

package/src/converters/converter.text-html.ts

@@ -70,6 +70,7 @@ export function createConverterTextHtml(
           block,
           options: {
             refreshKeys: false,
+            validateFields: true,
           },
         })
         return parsedBlock ? [parsedBlock] : []

package/src/converters/converter.text-plain.ts

@@ -93,6 +93,7 @@ export function createConverterTextPlain(
           block,
           options: {
             refreshKeys: false,
+            validateFields: true,
           },
         })
         return parsedBlock ? [parsedBlock] : []

package/src/editor/Editable.tsx

@@ -480,6 +480,7 @@ export const PortableTextEditable = forwardRef<
                     blocks: result.insert,
                     options: {
                       refreshKeys: true,
+                      validateFields: true,
                     },
                   }),
                   placement: 'auto',

package/src/editor/components/render-element.tsx

@@ -40,7 +40,7 @@ export function RenderElement(props: {
         keyGenerator: () => '',
         schema,
       },
-      options: {refreshKeys: false},
+      options: {refreshKeys: false, validateFields: false},
       inlineObject: {
         _key: props.element._key,
         _type: props.element._type,
@@ -79,7 +79,7 @@ export function RenderElement(props: {
       keyGenerator: () => '',
       schema,
     },
-    options: {refreshKeys: false},
+    options: {refreshKeys: false, validateFields: false},
     block: props.element,
   })
 
@@ -105,7 +105,7 @@ export function RenderElement(props: {
       keyGenerator: () => '',
       schema,
     },
-    options: {refreshKeys: false},
+    options: {refreshKeys: false, validateFields: false},
     blockObject: {
       _key: props.element._key,
       _type: props.element._type,

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/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/parse-blocks.test.ts

@@ -12,7 +12,7 @@ describe(parseBlock.name, () => {
           keyGenerator: createTestKeyGenerator(),
           schema: compileSchemaDefinition(defineSchema({})),
         },
-        options: {refreshKeys: false},
+        options: {refreshKeys: false, validateFields: true},
       }),
     ).toBe(undefined)
   })
@@ -25,7 +25,7 @@ describe(parseBlock.name, () => {
           keyGenerator: createTestKeyGenerator(),
           schema: compileSchemaDefinition(defineSchema({})),
         },
-        options: {refreshKeys: false},
+        options: {refreshKeys: false, validateFields: true},
       }),
     ).toBe(undefined)
   })
@@ -39,7 +39,7 @@ describe(parseBlock.name, () => {
             keyGenerator: createTestKeyGenerator(),
             schema: compileSchemaDefinition(defineSchema({})),
           },
-          options: {refreshKeys: false},
+          options: {refreshKeys: false, validateFields: true},
         }),
       ).toBe(undefined)
     })
@@ -54,7 +54,7 @@ describe(parseBlock.name, () => {
               defineSchema({blockObjects: [{name: 'image'}]}),
             ),
           },
-          options: {refreshKeys: false},
+          options: {refreshKeys: false, validateFields: true},
         }),
       ).toBe(undefined)
     })
@@ -69,7 +69,7 @@ describe(parseBlock.name, () => {
               defineSchema({blockObjects: [{name: 'image'}]}),
             ),
           },
-          options: {refreshKeys: false},
+          options: {refreshKeys: false, validateFields: true},
         }),
       ).toEqual({
         _key: 'k0',
@@ -87,7 +87,7 @@ describe(parseBlock.name, () => {
             keyGenerator: createTestKeyGenerator(),
             schema: compileSchemaDefinition(defineSchema({})),
           },
-          options: {refreshKeys: false},
+          options: {refreshKeys: false, validateFields: true},
         }),
       ).toEqual({
         _key: 'k0',
@@ -114,7 +114,7 @@ describe(parseBlock.name, () => {
             keyGenerator: createTestKeyGenerator(),
             schema: {...schema, block: {...schema.block, name: 'text'}},
           },
-          options: {refreshKeys: false},
+          options: {refreshKeys: false, validateFields: true},
         }),
       ).toEqual({
         _key: 'k0',
@@ -149,7 +149,7 @@ describe(parseBlock.name, () => {
             keyGenerator: createTestKeyGenerator(),
             schema: compileSchemaDefinition(defineSchema({})),
           },
-          options: {refreshKeys: false},
+          options: {refreshKeys: false, validateFields: true},
         }),
       ).toBe(undefined)
     })
@@ -188,7 +188,7 @@ describe(parseBlock.name, () => {
               }),
             ),
           },
-          options: {refreshKeys: false},
+          options: {refreshKeys: false, validateFields: true},
         }),
       ).toEqual({
         _key: 'k0',
@@ -238,7 +238,7 @@ describe(parseBlock.name, () => {
               defineSchema({lists: [{name: 'bullet'}]}),
             ),
           },
-          options: {refreshKeys: false},
+          options: {refreshKeys: false, validateFields: true},
         }),
       ).toEqual({
         _key: 'k0',
@@ -267,7 +267,7 @@ describe(parseBlock.name, () => {
               defineSchema({lists: [{name: 'bullet'}]}),
             ),
           },
-          options: {refreshKeys: false},
+          options: {refreshKeys: false, validateFields: true},
         }),
       ).toEqual({
         _key: 'k0',
@@ -297,7 +297,7 @@ describe(parseSpan.name, () => {
           schema: compileSchemaDefinition(defineSchema({})),
         },
         markDefKeyMap: new Map(),
-        options: {refreshKeys: false},
+        options: {refreshKeys: false, validateFields: true},
       }),
     ).toBe(undefined)
   })
@@ -311,7 +311,7 @@ describe(parseSpan.name, () => {
           schema: compileSchemaDefinition(defineSchema({})),
         },
         markDefKeyMap: new Map(),
-        options: {refreshKeys: false},
+        options: {refreshKeys: false, validateFields: true},
       }),
     ).toBe(undefined)
   })
@@ -325,7 +325,7 @@ describe(parseSpan.name, () => {
           schema: compileSchemaDefinition(defineSchema({})),
         },
         markDefKeyMap: new Map(),
-        options: {refreshKeys: false},
+        options: {refreshKeys: false, validateFields: true},
       }),
     ).toBe(undefined)
   })
@@ -339,7 +339,7 @@ describe(parseSpan.name, () => {
           schema: compileSchemaDefinition(defineSchema({})),
         },
         markDefKeyMap: new Map(),
-        options: {refreshKeys: false},
+        options: {refreshKeys: false, validateFields: true},
       }),
     ).toBe(undefined)
   })
@@ -353,7 +353,7 @@ describe(parseSpan.name, () => {
           schema: compileSchemaDefinition(defineSchema({})),
         },
         markDefKeyMap: new Map(),
-        options: {refreshKeys: false},
+        options: {refreshKeys: false, validateFields: true},
       }),
     ).toEqual({
       _key: 'k0',
@@ -372,7 +372,7 @@ describe(parseSpan.name, () => {
           schema: compileSchemaDefinition(defineSchema({})),
         },
         markDefKeyMap: new Map(),
-        options: {refreshKeys: false},
+        options: {refreshKeys: false, validateFields: true},
       }),
     ).toEqual({
       _key: 'k0',
@@ -394,7 +394,7 @@ describe(parseSpan.name, () => {
           schema: compileSchemaDefinition(defineSchema({})),
         },
         markDefKeyMap: new Map(),
-        options: {refreshKeys: false},
+        options: {refreshKeys: false, validateFields: true},
       }),
     ).toEqual({
       _key: 'k0',
@@ -418,7 +418,7 @@ describe(parseSpan.name, () => {
           ),
         },
         markDefKeyMap: new Map(),
-        options: {refreshKeys: false},
+        options: {refreshKeys: false, validateFields: true},
       }),
     ).toEqual({
       _key: 'k0',
@@ -442,7 +442,7 @@ describe(parseSpan.name, () => {
           ),
         },
         markDefKeyMap: new Map(),
-        options: {refreshKeys: false},
+        options: {refreshKeys: false, validateFields: true},
       }),
     ).toEqual({
       _key: 'k0',