@orgajs/orgx to js

Author: xiaoxinghu

packages/orgx/.gitignore

@@ -0,0 +1 @@
+*.d.ts

packages/orgx/index.js

@@ -0,0 +1,14 @@
+/**
+ * @typedef {import('./lib/core.js').ProcessorOptions} ProcessorOptions
+ * @typedef {import('./lib/compile.js').CompileOptions} CompileOptions
+ * @typedef {import('./lib/evaluate.js').EvaluateOptions} EvaluateOptions
+ * @typedef {import('./lib/types.js').OrgComponents} OrgComponents
+ * @typedef {import('./lib/types.js').OrgContent} OrgContent
+ * @typedef {import('./lib/types.js').OrgModule} OrgModule
+ * @typedef {import('./lib/types.js').OrgProps} OrgProps
+ */
+
+export { createProcessor } from './lib/core.js'
+export { compile, compileSync } from './lib/compile.js'
+export { evaluate, evaluateSync } from './lib/evaluate.js'
+export { run, runSync } from './lib/run.js'

packages/orgx/lib/compile.js

@@ -0,0 +1,54 @@
+/**
+ * @typedef {import('vfile').VFile} VFile
+ * @typedef {import('vfile').VFileCompatible} VFileCompatible
+ * @typedef {import('./core.js').PluginOptions} PluginOptions
+ * @typedef {import('./core.js').BaseProcessorOptions} BaseProcessorOptions
+ */
+
+/**
+ * @typedef {Omit<BaseProcessorOptions, 'format'>} CoreProcessorOptions
+ *   Core configuration.
+ *
+ * @typedef ExtraOptions
+ *   Extra configuration.
+ * @property {'detect' | 'mdx' | 'md' | null | undefined} [format='detect']
+ *   Format of `file`.
+ *
+ * @typedef {CoreProcessorOptions & PluginOptions & ExtraOptions} CompileOptions
+ *   Configuration.
+ */
+
+import {createProcessor} from './core.js'
+import {resolveFileAndOptions} from './util/resolve-file-and-options.js'
+
+/**
+ * Compile MDX to JS.
+ *
+ * @param {VFileCompatible} vfileCompatible
+ *   MDX document to parse (`string`, `Buffer`, `vfile`, anything that can be
+ *   given to `vfile`).
+ * @param {CompileOptions | null | undefined} [compileOptions]
+ *   Compile configuration.
+ * @return {Promise<VFile>}
+ *   File.
+ */
+export function compile(vfileCompatible, compileOptions) {
+  const {file, options} = resolveFileAndOptions(vfileCompatible, compileOptions)
+  return createProcessor(options).process(file)
+}
+
+/**
+ * Synchronously compile MDX to JS.
+ *
+ * @param {VFileCompatible} vfileCompatible
+ *   MDX document to parse (`string`, `Buffer`, `vfile`, anything that can be
+ *   given to `vfile`).
+ * @param {CompileOptions | null | undefined} [compileOptions]
+ *   Compile configuration.
+ * @return {VFile}
+ *   File.
+ */
+export function compileSync(vfileCompatible, compileOptions) {
+  const {file, options} = resolveFileAndOptions(vfileCompatible, compileOptions)
+  return createProcessor(options).processSync(file)
+}

packages/orgx/src/condition.browser.ts packages/orgx/lib/condition.browser.jspackages/orgx/src/condition.browser.ts renamed to packages/orgx/lib/condition.browser.js

@@ -0,0 +1,101 @@
+/**
+ * @typedef {import('unified').PluggableList} PluggableList
+ * @typedef {import('unified').Processor} Processor
+ * @typedef {import('./plugin/rehype-recma.js').Options} RehypeRecmaOptions
+ * @typedef {import('./plugin/recma-document.js').RecmaDocumentOptions} RecmaDocumentOptions
+ * @typedef {import('./plugin/recma-stringify.js').RecmaStringifyOptions} RecmaStringifyOptions
+ * @typedef {import('./plugin/recma-jsx-rewrite.js').RecmaJsxRewriteOptions} RecmaJsxRewriteOptions
+ */
+
+/**
+ * @typedef BaseProcessorOptions
+ *   Base configuration.
+ * @property {boolean | null | undefined} [jsx=false]
+ *   Whether to keep JSX.
+ *   Format of the files to be processed.
+ * @property {'function-body' | 'program'} [outputFormat='program']
+ *   Whether to compile to a whole program or a function body..
+ * @property {PluggableList | null | undefined} [recmaPlugins]
+ *   List of recma (esast, JavaScript) plugins.
+ * @property {PluggableList | null | undefined} [remarkPlugins]
+ *   List of remark (mdast, markdown) plugins.
+ * @property {PluggableList | null | undefined} [rehypePlugins]
+ *   List of rehype (hast, HTML) plugins.
+ * @property {import('@orgajs/reorg-rehype').Options | null | undefined} [reorgRehypeOptions]
+ *   Options to pass through to `reorg-rehype`.
+ *
+ * @typedef {Omit<RehypeRecmaOptions & RecmaDocumentOptions & RecmaStringifyOptions & RecmaJsxRewriteOptions, 'outputFormat'>} PluginOptions
+ *   Configuration for internal plugins.
+ *
+ * @typedef {BaseProcessorOptions & PluginOptions} ProcessorOptions
+ *   Configuration for processor.
+ */
+
+import { unified } from 'unified'
+import reorgParse from '@orgajs/reorg-parse'
+import reorgRehype from '@orgajs/reorg-rehype'
+import { recmaJsxBuild } from './plugin/recma-jsx-build.js'
+import { recmaDocument } from './plugin/recma-document.js'
+import { recmaJsxRewrite } from './plugin/recma-jsx-rewrite.js'
+import { recmaStringify } from './plugin/recma-stringify.js'
+import { rehypeRecma } from './plugin/rehype-recma.js'
+// import { remarkMarkAndUnravel } from './plugin/remark-mark-and-unravel.js'
+import { development as defaultDevelopment } from './condition.js'
+
+/**
+ * Pipeline to:
+ *
+ * 1. Parse org-mode
+ * 2. Transform through reorg (oast), rehype (hast), and recma (esast)
+ * 3. Serialize as JavaScript
+ *
+ * @param {ProcessorOptions | null | undefined} [options]
+ *   Configuration.
+ * @return {Processor}
+ *   Processor.
+ */
+export function createProcessor(options) {
+  const {
+    development,
+    jsx,
+    outputFormat,
+    providerImportSource,
+    recmaPlugins,
+    rehypePlugins,
+    remarkPlugins,
+    reorgRehypeOptions,
+    elementAttributeNameCase,
+    stylePropertyNameCase,
+    SourceMapGenerator,
+    ...rest
+  } = options || {}
+  const dev =
+    development === null || development === undefined
+      ? defaultDevelopment
+      : development
+
+  const pipeline = unified()
+    .use(reorgParse)
+    // .use(remarkMarkAndUnravel)
+    .use(remarkPlugins || [])
+    .use(reorgRehype, {
+      ...reorgRehypeOptions,
+      allowDangerousHtml: true,
+    })
+    .use(rehypePlugins || [])
+    .use(rehypeRecma, { elementAttributeNameCase, stylePropertyNameCase })
+    .use(recmaDocument, { ...rest, outputFormat })
+    .use(recmaJsxRewrite, {
+      development: dev,
+      providerImportSource,
+      outputFormat,
+    })
+
+  if (!jsx) {
+    pipeline.use(recmaJsxBuild, { development: dev, outputFormat })
+  }
+
+  pipeline.use(recmaStringify, { SourceMapGenerator }).use(recmaPlugins || [])
+
+  return pipeline
+}

packages/orgx/src/condition.ts packages/orgx/lib/condition.jspackages/orgx/src/condition.ts renamed to packages/orgx/lib/condition.js

@@ -0,0 +1,41 @@
+/**
+ * @typedef {import('./types.js').OrgModule} ExportMap
+ * @typedef {import('vfile').VFileCompatible} VFileCompatible
+ * @typedef {import('./util/resolve-evaluate-options.js').EvaluateOptions} EvaluateOptions
+ */
+
+import { compile, compileSync } from './compile.js'
+import { run, runSync } from './run.js'
+import { resolveEvaluateOptions } from './util/resolve-evaluate-options.js'
+
+/**
+ * Evaluate MDX.
+ *
+ * @param {VFileCompatible} vfileCompatible
+ *   MDX document to parse (`string`, `Buffer`, `vfile`, anything that can be
+ *   given to `vfile`).
+ * @param {EvaluateOptions} evaluateOptions
+ *   Configuration for evaluation.
+ * @return {Promise<ExportMap>}
+ *   Export map.
+ */
+export async function evaluate(vfileCompatible, evaluateOptions) {
+  const { compiletime, runtime } = resolveEvaluateOptions(evaluateOptions)
+  return run(await compile(vfileCompatible, compiletime), runtime)
+}
+
+/**
+ * Synchronously evaluate MDX.
+ *
+ * @param {VFileCompatible} vfileCompatible
+ *   MDX document to parse (`string`, `Buffer`, `vfile`, anything that can be
+ *   given to `vfile`).
+ * @param {EvaluateOptions} evaluateOptions
+ *   Configuration for evaluation.
+ * @return {ExportMap}
+ *   Export map.
+ */
+export function evaluateSync(vfileCompatible, evaluateOptions) {
+  const { compiletime, runtime } = resolveEvaluateOptions(evaluateOptions)
+  return runSync(compileSync(vfileCompatible, compiletime), runtime)
+}