BREAKING(front-matter): remove createExtractor()

[iuioiua]

What's changed

@std/front-matter/create-extractor has been made private. It is still used in the underlying package implementation.

Motivation

This module was removed because it exposed implementation details of @std/front-matter's extract() functions and wasn't used (correctly) according to GitHub search. Making this code private allows us to more easily make improvements in the backend without breaking user code.

Migration guide

The previously mentioned GitHub search showed there are some codebases which are mistakenly using createExtractor(), which is the primary function for @std/front-matter/create-extractor. Ensure you're using one of the extractor() methods, instead of manually creating an extractor().

- import { createExtractor } from "@std/front-matter";
- import { parse as parseYAML } from "@std/yaml";
+ import { extract } from "@std/front-matter/yaml";

- const extract = createExtractor({ yaml: parseYAML as Parser });

  // ...

  const yamlObject = extract(yamlString);

Related

Closes #5265
Towards #5016

[codecov]

Codecov Report

Attention: Patch coverage is 86.00000% with 7 lines in your changes missing coverage. Please review.

Project coverage is 95.70%. Comparing base (735609e) to head (288ae1b).

Files	Patch %	Lines
front_matter/_create_extractor.ts	84.78%	7 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #5266      +/-   ##
==========================================
- Coverage   95.70%   95.70%   -0.01%     
==========================================
  Files         459      459              
  Lines       38025    38017       -8     
  Branches     5563     5563              
==========================================
- Hits        36393    36385       -8     
  Misses       1591     1591              
  Partials       41       41              

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[kt3k]

Note: createExtractor was for supporting arbitrary combination for front-matter language, but we couldn't find any correct usage in github open source search.

LGTM