🔄 Refactor myst-parse to expose parsing options (#2243)

Author: rowanc1

.changeset/neat-knives-play.md

@@ -0,0 +1,5 @@
+---
+"myst-cli": patch
+---
+
+Refactor function to expose parsing options

packages/myst-cli/src/process/myst.ts

@@ -1,4 +1,4 @@
-import { mystParse } from 'myst-parser';
+import { mystParse, type AllOptions } from 'myst-parser';
 import { buttonRole } from 'myst-ext-button';
 import { cardDirective } from 'myst-ext-card';
 import { gridDirectives } from 'myst-ext-grid';
@@ -20,6 +20,24 @@ type Options = {
   ignoreFrontmatter?: boolean;
 };
 
+export function getMystParserOptions(session: ISession, opts?: Options): Partial<AllOptions> {
+  return {
+    markdownit: { linkify: true },
+    directives: [
+      cardDirective,
+      ...gridDirectives,
+      proofDirective,
+      ...exerciseDirectives,
+      ...tabDirectives,
+      ...(session.plugins?.directives ?? []),
+    ],
+    extensions: {
+      frontmatter: !opts?.ignoreFrontmatter,
+    },
+    roles: [buttonRole, ...(session.plugins?.roles ?? [])],
+  };
+}
+
 /**
  * Parse MyST content using the full suite of built-in directives, roles, and plugins
  *
@@ -35,22 +53,8 @@ export function parseMyst(
 ): GenericParent {
   const vfile = new VFile();
   vfile.path = file;
-  const parsed = mystParse(content, {
-    markdownit: { linkify: true },
-    directives: [
-      cardDirective,
-      ...gridDirectives,
-      proofDirective,
-      ...exerciseDirectives,
-      ...tabDirectives,
-      ...(session.plugins?.directives ?? []),
-    ],
-    extensions: {
-      frontmatter: !opts?.ignoreFrontmatter,
-    },
-    roles: [buttonRole, ...(session.plugins?.roles ?? [])],
-    vfile,
-  });
+  const parserOptions = getMystParserOptions(session, opts);
+  const parsed = mystParse(content, { ...parserOptions, vfile });
   logMessagesFromVFile(session, vfile);
   return parsed;
 }