mirror of
https://github.com/Snigdha-OS/documentation.git
synced 2025-09-15 20:34:56 +02:00
56 lines
2.4 KiB
TypeScript
56 lines
2.4 KiB
TypeScript
/**
|
||
* Transform a hast tree (with embedded MDX nodes) into an estree.
|
||
*
|
||
* ##### Notes
|
||
*
|
||
* ###### Comments
|
||
*
|
||
* Comments are attached to the tree in their neighbouring nodes (`recast`,
|
||
* `babel` style) and also added as a `comments` array on the program node
|
||
* (`espree` style).
|
||
* You may have to do `program.comments = undefined` for certain compilers.
|
||
*
|
||
* ###### Frameworks
|
||
*
|
||
* There are differences between what JSX frameworks accept, such as whether they
|
||
* accept `class` or `className`, or `background-color` or `backgroundColor`.
|
||
*
|
||
* For JSX components written in MDX, the author has to be aware of this
|
||
* difference and write code accordingly.
|
||
* For hast elements transformed by this project, this will be handled through
|
||
* options.
|
||
*
|
||
* | Framework | `elementAttributeNameCase` | `stylePropertyNameCase` |
|
||
* | --------- | -------------------------- | ----------------------- |
|
||
* | Preact | `'html'` | `'dom'` |
|
||
* | React | `'react'` | `'dom'` |
|
||
* | Solid | `'html'` | `'css'` |
|
||
* | Vue | `'html'` | `'dom'` |
|
||
*
|
||
* @param {HastNodes} tree
|
||
* hast tree.
|
||
* @param {Options | null | undefined} [options]
|
||
* Configuration (optional).
|
||
* @returns {Program}
|
||
* estree program node.
|
||
*
|
||
* The program’s last child in `body` is most likely an `ExpressionStatement`,
|
||
* whose expression is a `JSXFragment` or a `JSXElement`.
|
||
*
|
||
* Typically, there is only one node in `body`, however, this utility also
|
||
* supports embedded MDX nodes in the HTML (when `mdast-util-mdx` is used
|
||
* with mdast to parse markdown before passing its nodes through to hast).
|
||
* When MDX ESM import/exports are used, those nodes are added before the
|
||
* fragment or element in body.
|
||
*
|
||
* There aren’t many great estree serializers out there that support JSX.
|
||
* To do that, you can use `estree-util-to-js`.
|
||
* Or, use `estree-util-build-jsx` to turn JSX into function calls, and then
|
||
* serialize with whatever (`astring`, `escodegen`).
|
||
*/
|
||
export function toEstree(tree: HastNodes, options?: Options | null | undefined): Program;
|
||
export type ExpressionStatement = import('estree').ExpressionStatement;
|
||
export type Program = import('estree').Program;
|
||
export type HastNodes = import('hast').Nodes;
|
||
export type Options = import('./state.js').Options;
|