last update before handover

sample_interface/node_modules/mdast-util-mdxjs-esm/lib/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Create an extension for `mdast-util-from-markdown` to enable MDX.js ESM in
+ * markdown.
+ *
+ * When using the micromark syntax extension with `addResult`, nodes will have
+ * a `data.estree` field set to an ESTree [`Program`][program] node.
+ *
+ * @returns {FromMarkdownExtension}
+ *   Extension for `mdast-util-from-markdown` to enable MDX.js ESM.
+ */
+export function mdxjsEsmFromMarkdown(): FromMarkdownExtension;
+/**
+ * Create an extension for `mdast-util-to-markdown` to enable MDX.js ESM in
+ * markdown.
+ *
+ * @returns {ToMarkdownExtension}
+ *   Extension for `mdast-util-to-markdown` to enable MDX.js ESM.
+ */
+export function mdxjsEsmToMarkdown(): ToMarkdownExtension;
+export type CompileContext = import('mdast-util-from-markdown').CompileContext;
+export type FromMarkdownExtension = import('mdast-util-from-markdown').Extension;
+export type FromMarkdownHandle = import('mdast-util-from-markdown').Handle;
+export type ToMarkdownHandle = import('mdast-util-to-markdown').Handle;
+export type ToMarkdownExtension = import('mdast-util-to-markdown').Options;
+export type MdxjsEsm = import('../index.js').MdxjsEsm;

sample_interface/node_modules/mdast-util-mdxjs-esm/lib/index.js

@@ -0,0 +1,87 @@
+/**
+ * @typedef {import('mdast-util-from-markdown').CompileContext} CompileContext
+ * @typedef {import('mdast-util-from-markdown').Extension} FromMarkdownExtension
+ * @typedef {import('mdast-util-from-markdown').Handle} FromMarkdownHandle
+ *
+ * @typedef {import('mdast-util-to-markdown').Handle} ToMarkdownHandle
+ * @typedef {import('mdast-util-to-markdown').Options} ToMarkdownExtension
+ *
+ * @typedef {import('../index.js').MdxjsEsm} MdxjsEsm
+ */
+
+// To do: next major: expose functions.
+import {ok as assert} from 'devlop'
+
+/**
+ * Create an extension for `mdast-util-from-markdown` to enable MDX.js ESM in
+ * markdown.
+ *
+ * When using the micromark syntax extension with `addResult`, nodes will have
+ * a `data.estree` field set to an ESTree [`Program`][program] node.
+ *
+ * @returns {FromMarkdownExtension}
+ *   Extension for `mdast-util-from-markdown` to enable MDX.js ESM.
+ */
+export function mdxjsEsmFromMarkdown() {
+  return {
+    enter: {mdxjsEsm: enterMdxjsEsm},
+    exit: {mdxjsEsm: exitMdxjsEsm, mdxjsEsmData: exitMdxjsEsmData}
+  }
+}
+
+/**
+ * Create an extension for `mdast-util-to-markdown` to enable MDX.js ESM in
+ * markdown.
+ *
+ * @returns {ToMarkdownExtension}
+ *   Extension for `mdast-util-to-markdown` to enable MDX.js ESM.
+ */
+export function mdxjsEsmToMarkdown() {
+  return {handlers: {mdxjsEsm: handleMdxjsEsm}}
+}
+
+/**
+ * @this {CompileContext}
+ * @type {FromMarkdownHandle}
+ */
+function enterMdxjsEsm(token) {
+  this.enter({type: 'mdxjsEsm', value: ''}, token)
+  this.buffer() // Capture EOLs
+}
+
+/**
+ * @this {CompileContext}
+ * @type {FromMarkdownHandle}
+ */
+function exitMdxjsEsm(token) {
+  const value = this.resume()
+  const node = this.stack[this.stack.length - 1]
+  assert(node.type === 'mdxjsEsm')
+
+  this.exit(token)
+
+  const estree = token.estree
+
+  node.value = value
+
+  if (estree) {
+    node.data = {estree}
+  }
+}
+
+/**
+ * @this {CompileContext}
+ * @type {FromMarkdownHandle}
+ */
+function exitMdxjsEsmData(token) {
+  this.config.enter.data.call(this, token)
+  this.config.exit.data.call(this, token)
+}
+
+/**
+ * @type {ToMarkdownHandle}
+ * @param {MdxjsEsm} node
+ */
+function handleMdxjsEsm(node) {
+  return node.value || ''
+}