Migrate to ParserV2

[Nowely]

🚨 Breaking Changes: Migration to ParserV2

1. Markup Format Change

- @[__label__](__value__)  // OLD - no longer supported
+ @[__value__](__meta__)   // NEW - required format

Impact: All markup patterns must be updated to use the new placeholder names.

2. Mark Component Props Change

// OLD - no longer supported
const Mark = ({label, value}) => (
  <mark title={value}>{label}</mark>
)

// NEW - required
const Mark = ({value, meta}) => (
  <mark title={meta}>{value}</mark>
)

Impact: All custom Mark components must update their prop destructuring.

3. initMark Function Signature Change

// OLD - no longer supported
{
  initMark: ({label, value}) => ({
    children: label,
    data: value
  })
}

// NEW - required
{
  initMark: ({value, meta}) => ({
    children: value,
    data: meta
  })
}

Impact: All option configurations with initMark must be updated.

4. useMark Hook Props Change

// OLD - no longer supported
const {label, value, ref} = useMark()

// NEW - required
const {value, meta, ref} = useMark()

Impact: All editable marks using the useMark hook must update prop names.

5. Removed Types & Functions

// ❌ REMOVED - these no longer exist
import {MarkStruct, MarkMatch, ParserV1Markup} from 'rc-marked-input'
import {denoteV1, annotateV1, isAnnotated} from 'rc-marked-input'

// ✅ USE INSTEAD - new API
import {MarkToken, Token, TextToken, Markup} from 'rc-marked-input'
import {denote, annotate} from 'rc-marked-input'
// For type checking: token.type === 'mark'

Impact: All imports and usage of deprecated APIs must be updated.

6. Token Structure Change

// OLD - MarkStruct array
tokens: MarkStruct[]  // {label: string, value?: string}

// NEW - Token union array  
tokens: Token[]       // TextToken | MarkToken

Impact: Internal changes, but affects any code directly accessing tokens.

📋 Migration Steps

1. Update all markup patterns: __label__ → __value__, __value__ → __meta__
2. Update Mark components: Change prop destructuring from {label, value} to {value, meta}
3. Update initMark functions: Change parameter destructuring
4. Update useMark usage: Change prop destructuring in editable marks
5. Replace deprecated imports: Use new ParserV2 types and functions
6. Update denote/annotate calls: Use new API

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
marked-input	Ready	Preview	Comment	Nov 12, 2025 9:23pm