🎉 initiate project *astro_rewrite*

node_modules/hast-util-to-estree/lib/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * 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 {Node} tree
+ *   hast tree.
+ * @param {Options | null | undefined} [options]
+ *   Configuration.
+ * @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: Node,
+  options?: Options | null | undefined
+): Program
+export type Content = import('hast').Content
+export type Root = import('hast').Root
+export type ExpressionStatement = import('estree').ExpressionStatement
+export type Program = import('estree').Program
+export type MdxJsxAttribute = import('mdast-util-mdx-jsx').MdxJsxAttribute
+export type MdxJsxAttributeValueExpression =
+  import('mdast-util-mdx-jsx').MdxJsxAttributeValueExpression
+export type MdxJsxExpressionAttribute =
+  import('mdast-util-mdx-jsx').MdxJsxExpressionAttribute
+export type MdxJsxFlowElement = import('mdast-util-mdx-jsx').MdxJsxFlowElement
+export type MdxJsxTextElement = import('mdast-util-mdx-jsx').MdxJsxTextElement
+export type MdxFlowExpression =
+  import('mdast-util-mdx-expression').MdxFlowExpression
+export type MdxTextExpression =
+  import('mdast-util-mdx-expression').MdxTextExpression
+export type Options = import('./state.js').Options
+export type Node =
+  | Root
+  | Content
+  | MdxJsxAttributeValueExpression
+  | MdxJsxAttribute
+  | MdxJsxExpressionAttribute
+  | MdxJsxFlowElement
+  | MdxJsxTextElement
+  | MdxFlowExpression
+  | MdxTextExpression