[christianhg]

Triggers of more than one character, such as /\[\[/ or /:::/, now open the picker when the character that completes them is typed: [ followed by [ opens it with an empty keyword, and typing on updates the keyword. Inserting [foo in one go after an existing [, as Android keyboards do when committing a word, opens the picker with the keyword foo. Selecting a match replaces every trigger character along with the keyword, and with a delimiter such as ], typing [[foo] auto-completes an exact match.

import {raise} from '@portabletext/editor/behaviors'
import {defineTypeaheadPicker} from '@portabletext/plugin-typeahead-picker'

const pages = ['Getting started', 'Glossary', 'Roadmap']

function searchPages(keyword: string) {
  return pages
    .filter((title) => title.toLowerCase().startsWith(keyword.toLowerCase()))
    .map((title) => ({
      title,
      type:
        title.toLowerCase() === keyword.toLowerCase()
          ? ('exact' as const)
          : ('partial' as const),
    }))
}

const wikiLinkPicker = defineTypeaheadPicker({
  trigger: /\[\[/,
  keyword: /[^\]]*/,
  delimiter: ']',
  getMatches: ({keyword}) => searchPages(keyword),
  onSelect: [
    ({event}) => [
      raise({type: 'delete', at: event.patternSelection}),
      raise({type: 'insert.text', text: event.match.title}),
    ],
  ],
})

Until now the picker opened only when the inserted text equalled the trigger match, so a multi-character trigger worked when pasted in one go and never when typed. The trigger rule now also accepts a match that ends at the caret whose text ends with what was just inserted. The partial rule had its own refusal for matches that start before the insertion, which blocked the Android case where a keyboard commits [foo after an existing [. It now lets that through when the insertion lands inside the trigger part of the match. The trigger length comes from matching the existing trigger pattern against the start of the match text, the same way the keyword is already extracted, rather than a named group that could clash with groups in the user's own patterns.

Single-character triggers are unchanged by construction: a non-empty suffix of a one-character match is the match itself, and a one-character trigger that starts before the insertion cannot end after it. Every existing test passes untouched. The new scenarios in pattern-edge-cases.test.tsx replace the test that pinned multi-character triggers as unsupported. Neither guard depends on the trigger length, and a /:::/ scenario pins a three-character trigger. A /\w+/ keyword variant pins the trigger rule change on its own, and the bulk [foo and [foo] inserts pin the partial rule change.

One limit stays and is now documented in the README: typing [[, Escape, then [ does not reopen the picker, because the input rule finds only the first non-overlapping [[ in [[[. A stale or dismissed first [ does count when the second one is typed, which follows the rule that the character just typed completes the trigger.

[vercel]

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

Project	Deployment	Actions	Updated
portable-text-editor-documentation	Ready	Preview	Oct 21, 2026 4:45pm UTC
portable-text-example-basic	Ready	Preview	Oct 21, 2026 4:45pm UTC
portable-text-playground	Ready	Preview	Oct 21, 2026 4:45pm UTC

[changeset-bot]

🦋 Changeset detected

Latest commit: 7b5bf1f

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@portabletext/plugin-typeahead-picker	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[github-actions]

Bundle Stats

✅ No significant changes.

All scenario measurements (7)

🗺️ @portabletext/editor / @portabletext/editor · @portabletext/editor / @portabletext/editor/behaviors · @portabletext/editor / @portabletext/editor/plugins · @portabletext/editor / @portabletext/editor/selectors · @portabletext/editor / @portabletext/editor/traversal · @portabletext/editor / @portabletext/editor/utils · @portabletext/markdown / @portabletext/markdown · Artifacts

Scenario	Kind	Bundle (raw / gzip)	Gzip change	Import time	Import change
⚪ @portabletext/editor / @portabletext/editor	export	1.07 MB / 136.5 KB	None	67 ms	+2 ms, +2.8%
⚪ @portabletext/editor / @portabletext/editor/behaviors	export	4.0 KB / 147 B	None	2 ms	+0 ms, +1.0%
⚪ @portabletext/editor / @portabletext/editor/plugins	export	5.1 KB / 645 B	None	7 ms	+0 ms, +1.1%
⚪ @portabletext/editor / @portabletext/editor/selectors	export	94.9 KB / 9.3 KB	None	8 ms	+0 ms, +0.9%
⚪ @portabletext/editor / @portabletext/editor/traversal	export	43.8 KB / 4.0 KB	None	5 ms	-0 ms, -3.0%
⚪ @portabletext/editor / @portabletext/editor/utils	export	33.7 KB / 4.1 KB	None	6 ms	-0 ms, -0.0%
⚪ @portabletext/markdown / @portabletext/markdown	export	407.2 KB / 64.2 KB	None	27 ms	-0 ms, -0.9%

Significant means at least 1.0 KB and 1% gzip, or at least 5 ms and 10% import time.