@portabletext/editor 1.20.0 → 1.21.0

package/src/{editor/utils/utils.block-offset.ts → utils/util.block-offset.ts}

@@ -4,8 +4,13 @@ import {
   type KeyedSegment,
   type PortableTextBlock,
 } from '@sanity/types'
-import type {BlockOffset} from '../../behaviors/behavior.types'
+import type {BlockOffset} from '../behaviors/behavior.types'
+import type {EditorSelectionPoint} from '../types/editor'
+import {isKeyedSegment} from './util.is-keyed-segment'
 
+/**
+ * @public
+ */
 export function blockOffsetToSpanSelectionPoint({
   value,
   blockOffset,
@@ -55,20 +60,31 @@ export function blockOffsetToSpanSelectionPoint({
   return selectionPoint
 }
 
+/**
+ * @public
+ */
 export function spanSelectionPointToBlockOffset({
   value,
   selectionPoint,
 }: {
   value: Array<PortableTextBlock>
-  selectionPoint: {
-    path: [KeyedSegment, 'children', KeyedSegment]
-    offset: number
-  }
+  selectionPoint: EditorSelectionPoint
 }): BlockOffset | undefined {
   let offset = 0
 
+  const blockKey = isKeyedSegment(selectionPoint.path[0])
+    ? selectionPoint.path[0]._key
+    : undefined
+  const spanKey = isKeyedSegment(selectionPoint.path[2])
+    ? selectionPoint.path[2]._key
+    : undefined
+
+  if (!blockKey || !spanKey) {
+    return undefined
+  }
+
   for (const block of value) {
-    if (block._key !== selectionPoint.path[0]._key) {
+    if (block._key !== blockKey) {
       continue
     }
 
@@ -81,7 +97,7 @@ export function spanSelectionPointToBlockOffset({
         continue
       }
 
-      if (child._key === selectionPoint.path[2]._key) {
+      if (child._key === spanKey) {
         return {
           path: [{_key: block._key}],
           offset: offset + selectionPoint.offset,

package/src/{editor/utils/utils.get-start-point.ts → utils/util.get-block-start-point.ts}

@@ -3,9 +3,12 @@ import {
   type KeyedSegment,
   type PortableTextBlock,
 } from '@sanity/types'
-import type {EditorSelectionPoint} from '../../types/editor'
+import type {EditorSelectionPoint} from '../types/editor'
 
-export function getStartPoint({
+/**
+ * @public
+ */
+export function getBlockStartPoint({
   node,
   path,
 }: {

package/src/utils/util.get-text-block-text.ts

@@ -0,0 +1,8 @@
+import type {PortableTextTextBlock} from '@sanity/types'
+
+/**
+ * @public
+ */
+export function getTextBlockText(block: PortableTextTextBlock) {
+  return block.children.map((child) => child.text ?? '').join('')
+}

package/src/{editor/utils/utils.ts → utils/util.is-empty-text-block.ts}

@@ -2,9 +2,12 @@ import {
   isPortableTextSpan,
   isPortableTextTextBlock,
   type PortableTextBlock,
-  type PortableTextTextBlock,
 } from '@sanity/types'
+import {getTextBlockText} from './util.get-text-block-text'
 
+/**
+ * @public
+ */
 export function isEmptyTextBlock(block: PortableTextBlock) {
   if (!isPortableTextTextBlock(block)) {
     return false
@@ -15,7 +18,3 @@ export function isEmptyTextBlock(block: PortableTextBlock) {
 
   return onlyText && blockText === ''
 }
-
-export function getTextBlockText(block: PortableTextTextBlock) {
-  return block.children.map((child) => child.text ?? '').join('')
-}

package/src/{editor/utils/utils.is-keyed-segment.ts → utils/util.is-keyed-segment.ts}

@@ -1,5 +1,8 @@
 import type {KeyedSegment, PathSegment} from '@sanity/types'
 
+/**
+ * @public
+ */
 export function isKeyedSegment(segment: PathSegment): segment is KeyedSegment {
   return typeof segment === 'object' && segment !== null && '_key' in segment
 }

package/src/{editor/utils/utils.reverse-selection.ts → utils/util.reverse-selection.ts}

@@ -1,5 +1,8 @@
-import type {EditorSelection} from '../../types/editor'
+import type {EditorSelection} from '../types/editor'
 
+/**
+ * @public
+ */
 export function reverseSelection(
   selection: NonNullable<EditorSelection>,
 ): NonNullable<EditorSelection> {