@portabletext/editor 1.47.13 → 1.47.15

package/lib/behaviors/index.d.cts

@@ -151,7 +151,7 @@ declare type AbstractBehaviorEvent =
     }
   | {
       type: StrictExtract_2<SyntheticBehaviorEventType, 'insert.blocks'>
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey_2>
       placement: InsertPlacement_2
     }
   | {
@@ -2033,7 +2033,7 @@ export declare const coreBehaviors: Behavior_2<
         | 'style.toggle',
         'insert.blocks'
       >
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {
@@ -4577,7 +4577,7 @@ export declare function createCodeEditorBehaviors(
         | 'style.toggle',
         'insert.blocks'
       >
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {
@@ -7121,7 +7121,7 @@ export declare function createEmojiPickerBehaviors<TEmojiMatch>(
         | 'style.toggle',
         'insert.blocks'
       >
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {
@@ -9665,7 +9665,7 @@ export declare function createLinkBehaviors(
         | 'style.toggle',
         'insert.blocks'
       >
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {
@@ -12251,7 +12251,7 @@ export declare function createMarkdownBehaviors(
         | 'style.toggle',
         'insert.blocks'
       >
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {

package/lib/behaviors/index.d.ts

@@ -151,7 +151,7 @@ declare type AbstractBehaviorEvent =
     }
   | {
       type: StrictExtract_2<SyntheticBehaviorEventType, 'insert.blocks'>
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey_2>
       placement: InsertPlacement_2
     }
   | {
@@ -2033,7 +2033,7 @@ export declare const coreBehaviors: Behavior_2<
         | 'style.toggle',
         'insert.blocks'
       >
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {
@@ -4577,7 +4577,7 @@ export declare function createCodeEditorBehaviors(
         | 'style.toggle',
         'insert.blocks'
       >
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {
@@ -7121,7 +7121,7 @@ export declare function createEmojiPickerBehaviors<TEmojiMatch>(
         | 'style.toggle',
         'insert.blocks'
       >
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {
@@ -9665,7 +9665,7 @@ export declare function createLinkBehaviors(
         | 'style.toggle',
         'insert.blocks'
       >
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {
@@ -12251,7 +12251,7 @@ export declare function createMarkdownBehaviors(
         | 'style.toggle',
         'insert.blocks'
       >
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {

package/lib/index.d.cts

@@ -63,6 +63,7 @@ import {
 } from 'xstate'
 import type {EventObject, Snapshot} from 'xstate'
 import {GuardArgs} from 'xstate/guards'
+import {Editor as Editor_2} from './create-editor'
 
 declare type AbstractBehaviorEvent =
   | {
@@ -153,7 +154,7 @@ declare type AbstractBehaviorEvent =
     }
   | {
       type: StrictExtract<SyntheticBehaviorEventType, 'insert.blocks'>
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {
@@ -6815,7 +6816,7 @@ declare type UnsetEvent = {
  * ```
  * @group Hooks
  */
-export declare function useEditor(): Editor
+export declare function useEditor(): Editor_2
 
 /**
  * @public

package/lib/index.d.ts

@@ -63,6 +63,7 @@ import {
 } from 'xstate'
 import type {EventObject, Snapshot} from 'xstate'
 import {GuardArgs} from 'xstate/guards'
+import {Editor as Editor_2} from './create-editor'
 
 declare type AbstractBehaviorEvent =
   | {
@@ -153,7 +154,7 @@ declare type AbstractBehaviorEvent =
     }
   | {
       type: StrictExtract<SyntheticBehaviorEventType, 'insert.blocks'>
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {
@@ -6815,7 +6816,7 @@ declare type UnsetEvent = {
  * ```
  * @group Hooks
  */
-export declare function useEditor(): Editor
+export declare function useEditor(): Editor_2
 
 /**
  * @public

package/lib/plugins/index.d.cts

@@ -134,7 +134,7 @@ declare type AbstractBehaviorEvent =
     }
   | {
       type: StrictExtract<SyntheticBehaviorEventType, 'insert.blocks'>
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {

package/lib/plugins/index.d.ts

@@ -134,7 +134,7 @@ declare type AbstractBehaviorEvent =
     }
   | {
       type: StrictExtract<SyntheticBehaviorEventType, 'insert.blocks'>
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {

package/lib/selectors/index.d.cts

@@ -134,7 +134,7 @@ declare type AbstractBehaviorEvent =
     }
   | {
       type: StrictExtract<SyntheticBehaviorEventType, 'insert.blocks'>
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {

package/lib/selectors/index.d.ts

@@ -134,7 +134,7 @@ declare type AbstractBehaviorEvent =
     }
   | {
       type: StrictExtract<SyntheticBehaviorEventType, 'insert.blocks'>
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {

package/lib/utils/index.d.cts

@@ -134,7 +134,7 @@ declare type AbstractBehaviorEvent =
     }
   | {
       type: StrictExtract<SyntheticBehaviorEventType, 'insert.blocks'>
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {

package/lib/utils/index.d.ts

@@ -134,7 +134,7 @@ declare type AbstractBehaviorEvent =
     }
   | {
       type: StrictExtract<SyntheticBehaviorEventType, 'insert.blocks'>
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@portabletext/editor",
-  "version": "1.47.13",
+  "version": "1.47.15",
   "description": "Portable Text Editor made in React",
   "keywords": [
     "sanity",
@@ -79,15 +79,15 @@
     "slate-react": "0.112.1",
     "use-effect-event": "^1.0.2",
     "xstate": "^5.19.2",
-    "@portabletext/block-tools": "1.1.20",
+    "@portabletext/block-tools": "1.1.21",
     "@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.86.0",
-    "@sanity/types": "^3.86.0",
+    "@sanity/schema": "^3.86.1",
+    "@sanity/types": "^3.86.1",
     "@testing-library/jest-dom": "^6.6.3",
     "@testing-library/react": "^16.3.0",
     "@types/debug": "^4.1.12",
@@ -97,9 +97,9 @@
     "@types/react-dom": "^19.1.2",
     "@typescript-eslint/eslint-plugin": "^8.29.0",
     "@typescript-eslint/parser": "^8.29.0",
-    "@vitejs/plugin-react": "^4.3.4",
-    "@vitest/browser": "^3.1.1",
-    "@vitest/coverage-istanbul": "^3.1.1",
+    "@vitejs/plugin-react": "^4.4.1",
+    "@vitest/browser": "^3.1.2",
+    "@vitest/coverage-istanbul": "^3.1.2",
     "babel-plugin-react-compiler": "19.0.0-beta-e993439-20250328",
     "eslint": "8.57.1",
     "eslint-plugin-react-compiler": "19.0.0-beta-e993439-20250328",
@@ -110,13 +110,13 @@
     "rxjs": "^7.8.2",
     "typescript": "5.8.3",
     "vite": "^6.2.5",
-    "vitest": "^3.1.1",
+    "vitest": "^3.1.2",
     "vitest-browser-react": "^0.1.1",
     "racejar": "1.2.4"
   },
   "peerDependencies": {
-    "@sanity/schema": "^3.86.0",
-    "@sanity/types": "^3.86.0",
+    "@sanity/schema": "^3.86.1",
+    "@sanity/types": "^3.86.1",
     "react": "^16.9 || ^17 || ^18 || ^19",
     "rxjs": "^7.8.2"
   },

package/src/behaviors/behavior.perform-event.ts

@@ -22,7 +22,7 @@ function eventCategory(event: BehaviorEvent) {
   return isNativeBehaviorEvent(event)
     ? 'native'
     : isAbstractBehaviorEvent(event)
-      ? 'abstract'
+      ? 'synthetic'
       : isCustomBehaviorEvent(event)
         ? 'custom'
         : 'synthetic'
@@ -51,7 +51,10 @@ export function performEvent({
       }
     | undefined
 }) {
-  debug(`(${eventCategory(event)})`, JSON.stringify(event, null, 2))
+  debug(
+    `(${!isNativeBehaviorEvent(event) ? `${mode}:` : ''}${eventCategory(event)})`,
+    JSON.stringify(event, null, 2),
+  )
 
   const defaultAction =
     isCustomBehaviorEvent(event) ||

package/src/behaviors/behavior.types.event.ts

@@ -320,7 +320,7 @@ type AbstractBehaviorEvent =
     }
   | {
       type: StrictExtract<SyntheticBehaviorEventType, 'insert.blocks'>
-      blocks: Array<PortableTextBlock>
+      blocks: Array<BlockWithOptionalKey>
       placement: InsertPlacement
     }
   | {

package/src/editor/editor-context.tsx

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

package/src/editor/editor-provider.tsx

@@ -5,10 +5,10 @@ import {Synchronizer} from './components/Synchronizer'
 import {
   createInternalEditor,
   editorConfigToMachineInput,
-  type Editor,
   type EditorConfig,
 } from './create-editor'
 import {EditorActorContext} from './editor-actor-context'
+import {EditorContext} from './editor-context'
 import {editorMachine} from './editor-machine'
 import {PortableTextEditorContext} from './hooks/usePortableTextEditor'
 import {PortableTextEditorSelectionProvider} from './hooks/usePortableTextEditorSelection'
@@ -18,8 +18,6 @@ import {
   type PortableTextEditorProps,
 } from './PortableTextEditor'
 
-const EditorContext = React.createContext<Editor | undefined>(undefined)
-
 /**
  * @public
  */

package/src/internal-utils/global-scope.ts

@@ -0,0 +1,19 @@
+/**
+ * Gets the global scope instance in a given environment.
+ *
+ * The strategy is to return the most modern, and if not, the most common:
+ * - The `globalThis` variable is the modern approach to accessing the global scope
+ * - The `window` variable is the global scope in a web browser
+ * - The `self` variable is the global scope in workers and others
+ * - The `global` variable is the global scope in Node.js
+ */
+function getGlobalScope() {
+  if (typeof globalThis !== 'undefined') return globalThis
+  if (typeof window !== 'undefined') return window
+  if (typeof self !== 'undefined') return self
+  if (typeof global !== 'undefined') return global
+
+  throw new Error('@portabletext/editor: could not locate global scope')
+}
+
+export const globalScope = getGlobalScope() as any

package/src/internal-utils/globally-scoped-context.ts

@@ -0,0 +1,39 @@
+import {createContext, type Context} from 'react'
+import {globalScope} from './global-scope'
+
+/**
+ * As `@portabletext/editor` is declared as a dependency, and may be
+ * duplicated, sometimes across major versions it's critical that vital
+ * React Contexts are shared even when there is a duplicate.
+ *
+ * We have to support a Sanity Plugin being able to call hooks like
+ * `useEditor`, and then read the context setup by `sanity`, which calls
+ * `EditorProvider`, even if the provider and hook are different instances in
+ * memory.
+ *
+ * For this reason it's vital that all changes to globally scoped providers
+ * remain fully backwards compatible.
+ */
+export function createGloballyScopedContext<
+  ContextType,
+  const T extends ContextType = ContextType,
+>(
+  /**
+   * Enforce that all Symbol.for keys used for globally scoped contexts have a predictable prefix
+   */
+  key: `@portabletext/editor/context/${string}`,
+  defaultValue: T,
+): Context<ContextType> {
+  const symbol = Symbol.for(key)
+
+  /**
+   * Prevent errors about re-renders on React SSR on Next.js App Router
+   */
+  if (typeof document === 'undefined') {
+    return createContext<ContextType>(defaultValue)
+  }
+
+  globalScope[symbol] = globalScope[symbol] ?? createContext<T>(defaultValue)
+
+  return globalScope[symbol]
+}