Add preg_match process plugin to extract substrings using regex

Problem/Motivation

Adding a preg_match plugin for extracting substrings using regular expressions.

This is a common need during migrations; for example, extracting values enclosed in characters or matching a known pattern. Without a preg_match plugin, users must write custom callbacks or process plugins for a simple operation.

Steps to reproduce

No plugin exists to extract matching values.

Proposed resolution

Add a preg_match process plugin that uses preg_match() to extract matched content.

Configuration options:

• pattern: the regex pattern
• group_index: which capture group to return (default: 0)

Example to match first set of curly braces:

process:
  extracted_value:
    plugin: preg_match
    source: source_field
    pattern: '/\{([^}]*)\}/'
    group_index: 1

Example to extract the url attribute value:

process:
  extracted_value:
    plugin: preg_match
    source: source_field
    pattern: '/url="([^"]+)"/'
    group_index: 1

Remaining tasks

• Add plugin under Plugin/migrate/process/PregMatch.php
• Add test coverage
• Document usage

User interface changes

N/A

API changes

N/A

Data model changes

N/A