@portabletext/editor 3.0.0 → 3.0.1

package/src/utils/parse-blocks.test.ts

@@ -1,7 +1,7 @@
 import {compileSchema, defineSchema} from '@portabletext/schema'
 import {createTestKeyGenerator} from '@portabletext/test'
 import {describe, expect, test} from 'vitest'
-import {parseBlock, parseSpan} from './parse-blocks'
+import {parseBlock, parseInlineObject, parseSpan} from './parse-blocks'
 
 describe(parseBlock.name, () => {
   test('null', () => {
@@ -12,7 +12,11 @@ describe(parseBlock.name, () => {
           keyGenerator: createTestKeyGenerator(),
           schema: compileSchema(defineSchema({})),
         },
-        options: {removeUnusedMarkDefs: true, validateFields: true},
+        options: {
+          normalize: false,
+          removeUnusedMarkDefs: true,
+          validateFields: true,
+        },
       }),
     ).toBe(undefined)
   })
@@ -25,7 +29,11 @@ describe(parseBlock.name, () => {
           keyGenerator: createTestKeyGenerator(),
           schema: compileSchema(defineSchema({})),
         },
-        options: {removeUnusedMarkDefs: true, validateFields: true},
+        options: {
+          normalize: false,
+          removeUnusedMarkDefs: true,
+          validateFields: true,
+        },
       }),
     ).toBe(undefined)
   })
@@ -39,7 +47,11 @@ describe(parseBlock.name, () => {
             keyGenerator: createTestKeyGenerator(),
             schema: compileSchema(defineSchema({})),
           },
-          options: {removeUnusedMarkDefs: true, validateFields: true},
+          options: {
+            normalize: false,
+            removeUnusedMarkDefs: true,
+            validateFields: true,
+          },
         }),
       ).toBe(undefined)
     })
@@ -54,7 +66,11 @@ describe(parseBlock.name, () => {
               defineSchema({blockObjects: [{name: 'image'}]}),
             ),
           },
-          options: {removeUnusedMarkDefs: true, validateFields: true},
+          options: {
+            normalize: false,
+            removeUnusedMarkDefs: true,
+            validateFields: true,
+          },
         }),
       ).toBe(undefined)
     })
@@ -69,7 +85,11 @@ describe(parseBlock.name, () => {
               defineSchema({blockObjects: [{name: 'image'}]}),
             ),
           },
-          options: {removeUnusedMarkDefs: true, validateFields: true},
+          options: {
+            normalize: false,
+            removeUnusedMarkDefs: true,
+            validateFields: true,
+          },
         }),
       ).toEqual({
         _key: 'k0',
@@ -87,7 +107,11 @@ describe(parseBlock.name, () => {
             keyGenerator: createTestKeyGenerator(),
             schema: compileSchema(defineSchema({})),
           },
-          options: {removeUnusedMarkDefs: true, validateFields: true},
+          options: {
+            normalize: false,
+            removeUnusedMarkDefs: true,
+            validateFields: true,
+          },
         }),
       ).toEqual({
         _key: 'k0',
@@ -114,7 +138,11 @@ describe(parseBlock.name, () => {
             keyGenerator: createTestKeyGenerator(),
             schema: {...schema, block: {...schema.block, name: 'text'}},
           },
-          options: {removeUnusedMarkDefs: true, validateFields: true},
+          options: {
+            normalize: false,
+            removeUnusedMarkDefs: true,
+            validateFields: true,
+          },
         }),
       ).toEqual({
         _key: 'k0',
@@ -149,7 +177,11 @@ describe(parseBlock.name, () => {
             keyGenerator: createTestKeyGenerator(),
             schema: compileSchema(defineSchema({})),
           },
-          options: {removeUnusedMarkDefs: true, validateFields: true},
+          options: {
+            normalize: false,
+            removeUnusedMarkDefs: true,
+            validateFields: true,
+          },
         }),
       ).toBe(undefined)
     })
@@ -166,7 +198,7 @@ describe(parseBlock.name, () => {
               42,
               {foo: 'bar'},
               {
-                _key: 'k1',
+                _key: 'some key',
                 text: 'foo',
                 marks: [],
               },
@@ -177,6 +209,7 @@ describe(parseBlock.name, () => {
               {_type: 'span', text: 'foo'},
               {_type: 'span', marks: ['strong']},
               {_type: 'span', marks: ['em']},
+              {_type: 'image', text: 'inline object or span?'},
             ],
           },
           context: {
@@ -188,12 +221,22 @@ describe(parseBlock.name, () => {
               }),
             ),
           },
-          options: {removeUnusedMarkDefs: true, validateFields: true},
+          options: {
+            normalize: false,
+            removeUnusedMarkDefs: true,
+            validateFields: true,
+          },
         }),
       ).toEqual({
         _key: 'k0',
         _type: 'block',
         children: [
+          {
+            _key: 'some key',
+            _type: 'span',
+            text: 'foo',
+            marks: [],
+          },
           {
             _key: 'k1',
             _type: 'stock-ticker',
@@ -222,6 +265,12 @@ describe(parseBlock.name, () => {
             text: '',
             marks: ['em'],
           },
+          {
+            _key: 'k6',
+            _type: 'span',
+            text: 'inline object or span?',
+            marks: [],
+          },
         ],
         markDefs: [],
         style: 'normal',
@@ -236,7 +285,11 @@ describe(parseBlock.name, () => {
             keyGenerator: createTestKeyGenerator(),
             schema: compileSchema(defineSchema({lists: [{name: 'bullet'}]})),
           },
-          options: {removeUnusedMarkDefs: true, validateFields: true},
+          options: {
+            normalize: false,
+            removeUnusedMarkDefs: true,
+            validateFields: true,
+          },
         }),
       ).toEqual({
         _key: 'k0',
@@ -263,7 +316,11 @@ describe(parseBlock.name, () => {
             keyGenerator: createTestKeyGenerator(),
             schema: compileSchema(defineSchema({lists: [{name: 'bullet'}]})),
           },
-          options: {removeUnusedMarkDefs: true, validateFields: true},
+          options: {
+            normalize: false,
+            removeUnusedMarkDefs: true,
+            validateFields: true,
+          },
         }),
       ).toEqual({
         _key: 'k0',
@@ -290,7 +347,11 @@ describe(parseBlock.name, () => {
               keyGenerator: createTestKeyGenerator(),
               schema: compileSchema(defineSchema({})),
             },
-            options: {removeUnusedMarkDefs: true, validateFields: true},
+            options: {
+              normalize: false,
+              removeUnusedMarkDefs: true,
+              validateFields: true,
+            },
           }),
         ).toEqual({
           _type: 'block',
@@ -320,7 +381,11 @@ describe(parseBlock.name, () => {
                 }),
               ),
             },
-            options: {removeUnusedMarkDefs: true, validateFields: true},
+            options: {
+              normalize: false,
+              removeUnusedMarkDefs: true,
+              validateFields: true,
+            },
           }),
         ).toEqual({
           _type: 'block',
@@ -351,7 +416,11 @@ describe(parseBlock.name, () => {
                 }),
               ),
             },
-            options: {removeUnusedMarkDefs: true, validateFields: true},
+            options: {
+              normalize: false,
+              removeUnusedMarkDefs: true,
+              validateFields: true,
+            },
           }),
         ).toEqual({
           _type: 'block',
@@ -533,3 +602,214 @@ describe(parseSpan.name, () => {
     })
   })
 })
+
+describe(parseInlineObject.name, () => {
+  test('undefined', () => {
+    expect(
+      parseInlineObject({
+        inlineObject: undefined,
+        context: {
+          keyGenerator: createTestKeyGenerator(),
+          schema: compileSchema(
+            defineSchema({inlineObjects: [{name: 'stock-ticker'}]}),
+          ),
+        },
+        options: {validateFields: true},
+      }),
+    ).toBe(undefined)
+  })
+
+  test('null', () => {
+    expect(
+      parseInlineObject({
+        inlineObject: null,
+        context: {
+          keyGenerator: createTestKeyGenerator(),
+          schema: compileSchema(
+            defineSchema({inlineObjects: [{name: 'stock-ticker'}]}),
+          ),
+        },
+        options: {validateFields: true},
+      }),
+    ).toBe(undefined)
+  })
+
+  test('empty object', () => {
+    expect(
+      parseInlineObject({
+        inlineObject: {},
+        context: {
+          keyGenerator: createTestKeyGenerator(),
+          schema: compileSchema(
+            defineSchema({inlineObjects: [{name: 'stock-ticker'}]}),
+          ),
+        },
+        options: {validateFields: true},
+      }),
+    ).toBe(undefined)
+  })
+
+  test('invalid _type', () => {
+    expect(
+      parseInlineObject({
+        inlineObject: {_type: 'image'},
+        context: {
+          keyGenerator: createTestKeyGenerator(),
+          schema: compileSchema(
+            defineSchema({inlineObjects: [{name: 'stock-ticker'}]}),
+          ),
+        },
+        options: {validateFields: true},
+      }),
+    ).toBe(undefined)
+  })
+
+  test('only _type', () => {
+    expect(
+      parseInlineObject({
+        inlineObject: {_type: 'stock-ticker'},
+        context: {
+          keyGenerator: createTestKeyGenerator(),
+          schema: compileSchema(
+            defineSchema({inlineObjects: [{name: 'stock-ticker'}]}),
+          ),
+        },
+        options: {validateFields: true},
+      }),
+    ).toEqual({
+      _key: 'k0',
+      _type: 'stock-ticker',
+    })
+  })
+
+  describe('looks like text node', () => {
+    test('known inline object _type', () => {
+      expect(
+        parseInlineObject({
+          inlineObject: {_type: 'stock-ticker', text: 'foo'},
+          context: {
+            keyGenerator: createTestKeyGenerator(),
+            schema: compileSchema(
+              defineSchema({inlineObjects: [{name: 'stock-ticker'}]}),
+            ),
+          },
+          options: {validateFields: true},
+        }),
+      ).toEqual({_key: 'k0', _type: 'stock-ticker'})
+    })
+
+    test('unknown inline object _type', () => {
+      expect(
+        parseInlineObject({
+          inlineObject: {_type: 'image', text: 'foo'},
+          context: {
+            keyGenerator: createTestKeyGenerator(),
+            schema: compileSchema(
+              defineSchema({inlineObjects: [{name: 'stock-ticker'}]}),
+            ),
+          },
+          options: {validateFields: true},
+        }),
+      ).toBe(undefined)
+    })
+  })
+
+  describe('custom props', () => {
+    describe('unknown prop', () => {
+      test('validateFields: true', () => {
+        expect(
+          parseInlineObject({
+            inlineObject: {_type: 'stock-ticker', foo: 'bar'},
+            context: {
+              keyGenerator: createTestKeyGenerator(),
+              schema: compileSchema(
+                defineSchema({
+                  inlineObjects: [{name: 'stock-ticker'}],
+                }),
+              ),
+            },
+            options: {validateFields: true},
+          }),
+        ).toEqual({
+          _key: 'k0',
+          _type: 'stock-ticker',
+        })
+      })
+
+      test('validateFields: false', () => {
+        expect(
+          parseInlineObject({
+            inlineObject: {_type: 'stock-ticker', foo: 'bar'},
+            context: {
+              keyGenerator: createTestKeyGenerator(),
+              schema: compileSchema(
+                defineSchema({
+                  inlineObjects: [{name: 'stock-ticker'}],
+                }),
+              ),
+            },
+            options: {validateFields: false},
+          }),
+        ).toEqual({
+          _key: 'k0',
+          _type: 'stock-ticker',
+          foo: 'bar',
+        })
+      })
+    })
+
+    describe('known prop', () => {
+      test('validateFields: true', () => {
+        expect(
+          parseInlineObject({
+            inlineObject: {_type: 'stock-ticker', foo: 'bar'},
+            context: {
+              keyGenerator: createTestKeyGenerator(),
+              schema: compileSchema(
+                defineSchema({
+                  inlineObjects: [
+                    {
+                      name: 'stock-ticker',
+                      fields: [{name: 'foo', type: 'string'}],
+                    },
+                  ],
+                }),
+              ),
+            },
+            options: {validateFields: true},
+          }),
+        ).toEqual({
+          _key: 'k0',
+          _type: 'stock-ticker',
+          foo: 'bar',
+        })
+      })
+    })
+
+    test('validateFields: false', () => {
+      expect(
+        parseInlineObject({
+          inlineObject: {_type: 'stock-ticker', foo: 'bar'},
+          context: {
+            keyGenerator: createTestKeyGenerator(),
+            schema: compileSchema(
+              defineSchema({
+                inlineObjects: [
+                  {
+                    name: 'stock-ticker',
+                    fields: [{name: 'foo', type: 'string'}],
+                  },
+                ],
+              }),
+            ),
+          },
+          options: {validateFields: false},
+        }),
+      ).toEqual({
+        _key: 'k0',
+        _type: 'stock-ticker',
+        foo: 'bar',
+      })
+    })
+  })
+})

package/src/utils/parse-blocks.ts

@@ -1,4 +1,4 @@
-import {isTextBlock} from '@portabletext/schema'
+import {isSpan, isTextBlock} from '@portabletext/schema'
 import type {
   PortableTextBlock,
   PortableTextListBlock,
@@ -9,7 +9,7 @@ import type {
 } from '@sanity/types'
 import type {EditorSchema} from '../editor/editor-schema'
 import type {EditorContext} from '../editor/editor-snapshot'
-import {isTypedObject} from './asserters'
+import {isRecord, isTypedObject} from './asserters'
 
 export function parseBlocks({
   context,
@@ -19,6 +19,7 @@ export function parseBlocks({
   context: Pick<EditorContext, 'keyGenerator' | 'schema'>
   blocks: unknown
   options: {
+    normalize: boolean
     removeUnusedMarkDefs: boolean
     validateFields: boolean
   }
@@ -42,6 +43,7 @@ export function parseBlock({
   context: Pick<EditorContext, 'keyGenerator' | 'schema'>
   block: unknown
   options: {
+    normalize: boolean
     removeUnusedMarkDefs: boolean
     validateFields: boolean
   }
@@ -102,6 +104,7 @@ export function parseTextBlock({
   block: unknown
   context: Pick<EditorContext, 'keyGenerator' | 'schema'>
   options: {
+    normalize: boolean
     removeUnusedMarkDefs: boolean
     validateFields: boolean
   }
@@ -186,29 +189,70 @@ export function parseTextBlock({
     ? block.children
     : []
 
-  const children = unparsedChildren
+  const parsedChildren = unparsedChildren
     .map(
       (child) =>
         parseSpan({span: child, context, markDefKeyMap, options}) ??
         parseInlineObject({inlineObject: child, context, options}),
     )
     .filter((child) => child !== undefined)
-  const marks = children.flatMap((child) => child.marks ?? [])
+  const marks = parsedChildren.flatMap((child) => child.marks ?? [])
+
+  const children =
+    parsedChildren.length > 0
+      ? parsedChildren
+      : [
+          {
+            _key: context.keyGenerator(),
+            _type: context.schema.span.name,
+            text: '',
+            marks: [],
+          },
+        ]
+
+  const normalizedChildren = options.normalize
+    ? // Ensure that inline objects re surrounded by spans
+      children.reduce<Array<PortableTextObject | PortableTextSpan>>(
+        (normalizedChildren, child, index) => {
+          if (isSpan(context, child)) {
+            return [...normalizedChildren, child]
+          }
+
+          const previousChild = normalizedChildren.at(-1)
+
+          if (!previousChild || !isSpan(context, previousChild)) {
+            return [
+              ...normalizedChildren,
+              {
+                _key: context.keyGenerator(),
+                _type: context.schema.span.name,
+                text: '',
+                marks: [],
+              },
+              child,
+              ...(index === children.length - 1
+                ? [
+                    {
+                      _key: context.keyGenerator(),
+                      _type: context.schema.span.name,
+                      text: '',
+                      marks: [],
+                    },
+                  ]
+                : []),
+            ]
+          }
+
+          return [...normalizedChildren, child]
+        },
+        [],
+      )
+    : children
 
   const parsedBlock: PortableTextTextBlock = {
     _type: context.schema.block.name,
     _key,
-    children:
-      children.length > 0
-        ? children
-        : [
-            {
-              _key: context.keyGenerator(),
-              _type: context.schema.span.name,
-              text: '',
-              marks: [],
-            },
-          ],
+    children: normalizedChildren,
     markDefs: options.removeUnusedMarkDefs
       ? markDefs.filter((markDef) => marks.includes(markDef._key))
       : markDefs,
@@ -255,7 +299,7 @@ export function parseSpan({
   markDefKeyMap: Map<string, string>
   options: {validateFields: boolean}
 }): PortableTextSpan | undefined {
-  if (!isTypedObject(span)) {
+  if (!isRecord(span)) {
     return undefined
   }
 
@@ -272,11 +316,6 @@ export function parseSpan({
     }
   }
 
-  // In reality, the span schema name is always 'span', but we only the check here anyway
-  if (span._type !== context.schema.span.name || span._type !== 'span') {
-    return undefined
-  }
-
   const unparsedMarks: Array<unknown> = Array.isArray(span.marks)
     ? span.marks
     : []
@@ -300,8 +339,28 @@ export function parseSpan({
     return []
   })
 
+  if (span._type !== context.schema.span.name) {
+    if (
+      !context.schema.inlineObjects.some(
+        (inlineObject) => inlineObject.name === span._type,
+      ) &&
+      typeof span.text === 'string'
+    ) {
+      return {
+        _type: context.schema.span.name as 'span',
+        _key:
+          typeof span._key === 'string' ? span._key : context.keyGenerator(),
+        text: span.text,
+        marks,
+        ...(options.validateFields ? {} : customFields),
+      }
+    }
+
+    return undefined
+  }
+
   return {
-    _type: 'span',
+    _type: context.schema.span.name as 'span',
     _key: typeof span._key === 'string' ? span._key : context.keyGenerator(),
     text: typeof span.text === 'string' ? span.text : '',
     marks,

package/src/utils/util.merge-text-blocks.ts

@@ -18,7 +18,11 @@ export function mergeTextBlocks({
   const parsedIncomingBlock = parseBlock({
     context,
     block: incomingBlock,
-    options: {removeUnusedMarkDefs: true, validateFields: false},
+    options: {
+      normalize: false,
+      removeUnusedMarkDefs: true,
+      validateFields: false,
+    },
   })
 
   if (!parsedIncomingBlock || !isTextBlock(context, parsedIncomingBlock)) {

package/src/utils/util.slice-blocks.ts

@@ -17,7 +17,9 @@ export function sliceBlocks({
   context,
   blocks,
 }: {
-  context: Pick<EditorContext, 'schema' | 'selection'>
+  context: Pick<EditorContext, 'schema' | 'selection'> & {
+    keyGenerator?: () => string
+  }
   blocks: Array<PortableTextBlock>
 }): Array<PortableTextBlock> {
   const slice: Array<PortableTextBlock> = []
@@ -167,11 +169,15 @@ export function sliceBlocks({
       middleBlocks.push(
         parseBlock({
           context: {
-            ...context,
-            keyGenerator: defaultKeyGenerator,
+            schema: context.schema,
+            keyGenerator: context.keyGenerator ?? defaultKeyGenerator,
           },
           block,
-          options: {removeUnusedMarkDefs: true, validateFields: false},
+          options: {
+            normalize: false,
+            removeUnusedMarkDefs: true,
+            validateFields: false,
+          },
         }) ?? block,
       )
     }
@@ -180,22 +186,30 @@ export function sliceBlocks({
   const parsedStartBlock = startBlock
     ? parseBlock({
         context: {
-          ...context,
-          keyGenerator: defaultKeyGenerator,
+          schema: context.schema,
+          keyGenerator: context.keyGenerator ?? defaultKeyGenerator,
         },
         block: startBlock,
-        options: {removeUnusedMarkDefs: true, validateFields: false},
+        options: {
+          normalize: false,
+          removeUnusedMarkDefs: true,
+          validateFields: false,
+        },
       })
     : undefined
 
   const parsedEndBlock = endBlock
     ? parseBlock({
         context: {
-          ...context,
-          keyGenerator: defaultKeyGenerator,
+          schema: context.schema,
+          keyGenerator: context.keyGenerator ?? defaultKeyGenerator,
         },
         block: endBlock,
-        options: {removeUnusedMarkDefs: true, validateFields: false},
+        options: {
+          normalize: false,
+          removeUnusedMarkDefs: true,
+          validateFields: false,
+        },
       })
     : undefined