@xyd-js/uniform 0.1.0-xyd.10

package/dist/markdown.js

@@ -0,0 +1,257 @@
+// src/markdown/index.ts
+import { remark } from "remark";
+import remarkStringify from "remark-stringify";
+
+// src/markdown/utils.ts
+import { fromMarkdown } from "mdast-util-from-markdown";
+import { u } from "unist-builder";
+var START_DEPTH_LEVEL = 2;
+function root(ast) {
+  return u("root", ast);
+}
+function heading(title, canonical, description, refCategory, refType, refContext) {
+  const uTitle = u(
+    "heading",
+    { depth: START_DEPTH_LEVEL },
+    [u("text", `!!references ${title}`)]
+  );
+  const uCanonical = u(
+    "heading",
+    { depth: uTitle.depth + 1 },
+    [u("text", `!canonical ${canonical}`)]
+  );
+  let uDesc = [
+    u(
+      "heading",
+      { depth: uTitle.depth + 1 },
+      [u("text", `!description`)]
+    ),
+    u("paragraph", [u("text", description)])
+  ];
+  let uRefCategory;
+  if (refCategory) {
+    uRefCategory = u(
+      "heading",
+      { depth: uTitle.depth + 1 },
+      [u("text", `!category ${refCategory}`)]
+    );
+  }
+  let uRefType;
+  if (refType) {
+    uRefType = u(
+      "heading",
+      { depth: uTitle.depth + 1 },
+      [u("text", `!type ${refType}`)]
+    );
+  }
+  let uContext = [];
+  if (refContext && Object.keys(refContext)) {
+    uContext.push(u(
+      "heading",
+      { depth: uTitle.depth + 1 },
+      [
+        u("text", `!context`)
+      ]
+    ));
+    for (const [key, value] of Object.entries(refContext)) {
+      uContext.push(
+        u(
+          "heading",
+          { depth: uContext[0].depth + 1 },
+          [u("text", `!${key} ${value}`)]
+        )
+      );
+    }
+  }
+  return {
+    title: uTitle,
+    canonical: uCanonical,
+    description: uDesc,
+    category: uRefCategory || null,
+    type: uRefType || null,
+    context: uContext || null
+  };
+}
+function examples(examples2) {
+  const md = [];
+  const uExampleRoot = u(
+    "heading",
+    { depth: START_DEPTH_LEVEL + 1 },
+    [u("text", `!examples`)]
+  );
+  md.push(uExampleRoot);
+  examples2.groups.forEach((group) => {
+    const uExampleGroups = u(
+      "heading",
+      { depth: uExampleRoot.depth + 1 },
+      [u("text", `!!groups`)]
+    );
+    md.push(uExampleGroups);
+    const uGroupDescription = u(
+      "heading",
+      { depth: uExampleGroups.depth + 1 },
+      [u("text", `!description ${group.description}`)]
+    );
+    md.push(uGroupDescription);
+    group.examples.forEach((example) => {
+      const uExamples = u(
+        "heading",
+        { depth: uExampleGroups.depth + 1 },
+        [u("text", `!!examples`)]
+      );
+      md.push(uExamples);
+      const codeBlock = u(
+        "heading",
+        { depth: uExamples.depth + 1 },
+        [u("text", `!codeblock`)]
+      );
+      md.push(codeBlock);
+      const codeBlockTitle = u(
+        "heading",
+        { depth: codeBlock.depth + 1 },
+        [u("text", `!title ${example.codeblock.title}`)]
+      );
+      md.push(codeBlockTitle);
+      const tabs = u(
+        "heading",
+        { depth: codeBlock.depth + 1 },
+        [u("text", `!!tabs`)]
+      );
+      md.push(tabs);
+      example.codeblock.tabs.forEach((tab) => {
+        const code = u("code", {
+          lang: tab.language,
+          meta: `!code ${tab.title}`
+        }, tab.code);
+        md.push(code);
+      });
+    });
+  });
+  return md;
+}
+function definitions(definitions2) {
+  const md = [];
+  definitions2.forEach((definition) => {
+    const uDefinition = u(
+      "heading",
+      { depth: START_DEPTH_LEVEL + 1 },
+      [u("text", `!!definitions`)]
+    );
+    md.push(uDefinition);
+    md.push(u(
+      "heading",
+      { depth: uDefinition.depth + 1 },
+      [u("text", `!title ${definition.title}`)]
+    ));
+    definition.properties.forEach((prop) => {
+      properties(
+        uDefinition.depth + 1,
+        {
+          name: prop.name,
+          type: prop.type,
+          description: prop.description,
+          context: prop.context,
+          properties: prop.properties
+          // TODO: fix ts
+        },
+        md
+      );
+    });
+  });
+  return md;
+}
+function properties(depth, props, output = []) {
+  const paramName = props.name;
+  const propTitle = `!!properties ${paramName}`;
+  const uPropTitle = u("heading", { depth }, [u("text", propTitle)]);
+  const uPropName = u("paragraph", { depth }, [u("text", `!name ${paramName}`)]);
+  const uPropType = u("paragraph", { depth }, [u("text", `!type ${props.type}`)]);
+  const markdownAst = fromMarkdown(props.description || "");
+  const uPropDesc = u("paragraph", { depth }, markdownAst.children);
+  const uContext = [];
+  if (props.context && Object.keys(props.context)) {
+    uContext.push(u(
+      "heading",
+      { depth: depth + 1 },
+      [
+        u("text", `!context`)
+      ]
+    ));
+    for (const [key, value] of Object.entries(props.context)) {
+      uContext.push(
+        u(
+          "heading",
+          { depth: uContext[0].depth + 1 },
+          [u("text", `!${key} ${value}`)]
+        )
+      );
+    }
+  }
+  output.push(
+    uPropTitle,
+    uPropName,
+    uPropType,
+    uPropDesc,
+    ...uContext
+  );
+  if (props.properties) {
+    const deepDepth = depth + 1;
+    for (const prop of props.properties) {
+      properties(deepDepth, prop, output);
+    }
+  }
+}
+
+// src/markdown/index.ts
+function compile(ast) {
+  return remark().use(remarkStringify, {
+    bullet: "-",
+    fences: true,
+    listItemIndent: "one",
+    incrementListMarker: false,
+    handlers: {
+      heading(node) {
+        return `${"#".repeat(node.depth)} ${node.children[0].value}`;
+      }
+    }
+  }).stringify(root(ast));
+}
+function referenceAST(ref) {
+  var _a, _b;
+  const md = [];
+  const mdHeading = heading(
+    ref.title,
+    ref.canonical,
+    ref.description,
+    ref.category,
+    ref.type,
+    ref.context
+  );
+  md.push(
+    mdHeading.title
+  );
+  if ((_a = mdHeading == null ? void 0 : mdHeading.description) == null ? void 0 : _a.length) {
+    md.push(...mdHeading.description);
+  }
+  md.push(
+    mdHeading.canonical
+  );
+  if (mdHeading.category) {
+    md.push(mdHeading.category);
+  }
+  if (mdHeading.type) {
+    md.push(mdHeading.type);
+  }
+  if ((_b = mdHeading == null ? void 0 : mdHeading.context) == null ? void 0 : _b.length) {
+    md.push(...mdHeading.context);
+  }
+  const mdExamples = examples(ref.examples);
+  const mdDefinitions = definitions(ref.definitions);
+  md.push(...mdExamples, ...mdDefinitions);
+  return md;
+}
+export {
+  compile,
+  referenceAST
+};
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/markdown/index.ts","../src/markdown/utils.ts"],"sourcesContent":["import {remark} from \"remark\";\nimport remarkStringify from \"remark-stringify\";\n\nimport {Reference} from \"../types\";\n\nimport {definitions, examples, heading, root} from \"./utils\";\n\n// TODO: any\nexport function compile(ast: any) {\n    return remark()\n        // .use(unlimitedHeadings)\n        .use(remarkStringify, {\n            bullet: '-',\n            fences: true,\n            listItemIndent: 'one',\n            incrementListMarker: false,\n            handlers: {\n                heading(node) {\n                    return `${\"#\".repeat(node.depth)} ${node.children[0].value}`;\n                },\n            },\n        })\n        .stringify(root(ast));\n}\n\nexport function referenceAST(ref: Reference) {\n    const md = []\n\n    const mdHeading = heading(\n        ref.title,\n        ref.canonical,\n        ref.description,\n        ref.category,\n        ref.type,\n        ref.context\n    )\n\n    md.push(\n        mdHeading.title,\n    )\n\n    if (mdHeading?.description?.length) {\n        md.push(...mdHeading.description)\n    }\n\n    md.push(\n        mdHeading.canonical,\n    )\n\n    if (mdHeading.category) {\n        md.push(mdHeading.category)\n    }\n\n    if (mdHeading.type) {\n        md.push(mdHeading.type)\n    }\n\n    if (mdHeading?.context?.length) {\n        md.push(...mdHeading.context)\n    }\n\n    const mdExamples = examples(ref.examples)\n    const mdDefinitions = definitions(ref.definitions)\n    md.push(...mdExamples, ...mdDefinitions)\n\n    return md;\n}\n","import { fromMarkdown } from \"mdast-util-from-markdown\";\nimport {u} from \"unist-builder\";\n\nimport {\n    ExampleRoot,\n    Definition,\n    ReferenceCategory,\n    ReferenceContext,\n    ReferenceType,\n    DefinitionProperty\n} from \"../types\";\n\n// START_DEPTH_LEVEL is the start depth level for the markdown AST\n// starts from 2 because 1 is reserved for the title\nconst START_DEPTH_LEVEL = 2\n\n// TODO: fix any\nexport function root(ast: any) {\n    return u('root', ast);\n}\n\nexport function heading(\n    title: string,\n    canonical: string,\n    description: string,\n    refCategory?: ReferenceCategory,\n    refType?: ReferenceType,\n    refContext?: ReferenceContext\n) {\n    const uTitle = u(\n        'heading',\n        {depth: START_DEPTH_LEVEL},\n        [u('text', `!!references ${title}`)]\n    )\n\n    const uCanonical = u(\n        'heading',\n        {depth: uTitle.depth + 1},\n        [u('text', `!canonical ${canonical}`)]\n    )\n\n    let uDesc = [\n        u(\n            'heading',\n            {depth: uTitle.depth + 1},\n            [u('text', `!description`),]\n        ),\n        u('paragraph', [u('text', description)])\n    ]\n\n    let uRefCategory\n    if (refCategory) {\n        uRefCategory = u(\n            'heading',\n            {depth: uTitle.depth + 1},\n            [u('text', `!category ${refCategory}`)]\n        )\n    }\n\n    let uRefType\n    if (refType) {\n        uRefType = u(\n            'heading',\n            {depth: uTitle.depth + 1},\n            [u('text', `!type ${refType}`)]\n        )\n    }\n\n    let uContext = []\n\n    if (refContext && Object.keys(refContext)) {\n        uContext.push(u(\n            'heading',\n            {depth: uTitle.depth + 1},\n            [\n                u('text', `!context`),\n            ]\n        ))\n\n\n        for (const [key, value] of Object.entries(refContext)) {\n            uContext.push(u(\n                    'heading',\n                    {depth: uContext[0].depth + 1},\n                    [u('text', `!${key} ${value}`)]\n                )\n            )\n        }\n    }\n\n    return {\n        title: uTitle,\n        canonical: uCanonical,\n        description: uDesc,\n        category: uRefCategory || null,\n        type: uRefType || null,\n        context: uContext || null\n    }\n}\n\nexport function examples(examples: ExampleRoot) {\n    const md = []\n\n    const uExampleRoot = u(\n        'heading',\n        {depth: START_DEPTH_LEVEL + 1},\n        [u('text', `!examples`)]\n    )\n    md.push(uExampleRoot)\n\n    examples.groups.forEach(group => {\n        const uExampleGroups = u(\n            'heading',\n            {depth: uExampleRoot.depth + 1},\n            [u('text', `!!groups`)]\n        )\n        md.push(uExampleGroups)\n\n        const uGroupDescription = u(\n            'heading',\n            {depth: uExampleGroups.depth + 1},\n            [u('text', `!description ${group.description}`)]\n        )\n        md.push(uGroupDescription)\n\n        group.examples.forEach(example => {\n            const uExamples = u(\n                'heading',\n                {depth: uExampleGroups.depth + 1},\n                [u('text', `!!examples`)]\n            )\n            md.push(uExamples)\n\n            const codeBlock = u(\n                'heading',\n                {depth: uExamples.depth + 1},\n                [u('text', `!codeblock`)]\n            )\n            md.push(codeBlock)\n\n            const codeBlockTitle = u(\n                'heading',\n                {depth: codeBlock.depth + 1},\n                [u('text', `!title ${example.codeblock.title}`)]\n            )\n            md.push(codeBlockTitle)\n\n            const tabs = u(\n                'heading',\n                {depth: codeBlock.depth + 1},\n                [u('text', `!!tabs`)]\n            )\n            md.push(tabs)\n\n            example.codeblock.tabs.forEach(tab => {\n                const code = u('code', {\n                    lang: tab.language,\n                    meta: `!code ${tab.title}`\n                }, tab.code);\n\n                md.push(code)\n            })\n\n        })\n    })\n\n    return md\n}\n\nexport function definitions(definitions: Definition[]) {\n    const md: any[] = []\n\n    definitions.forEach(definition => {\n        const uDefinition = u(\n            'heading',\n            {depth: START_DEPTH_LEVEL + 1},\n            [u('text', `!!definitions`)]\n        )\n        md.push(uDefinition)\n\n        md.push(u(\n            'heading',\n            {depth: uDefinition.depth + 1},\n            [u('text', `!title ${definition.title}`)]\n        ))\n\n        definition.properties.forEach(prop => {\n            properties(\n                uDefinition.depth + 1,\n                {\n                    name: prop.name,\n                    type: prop.type,\n                    description: prop.description,\n                    context: prop.context,\n                    properties: prop.properties  // TODO: fix ts\n                },\n                md,\n            )\n        })\n    })\n\n    return md\n}\n\n// TODO: any[]\nexport function properties(\n    depth: number,\n    props: DefinitionProperty,\n    output: any[] = []\n) {\n    const paramName = props.name;\n\n    const propTitle = `!!properties ${paramName}`; // TODO: check if `!!properties is enough`\n    const uPropTitle = u('heading', {depth}, [u('text', propTitle)]);\n    const uPropName = u('paragraph', {depth}, [u('text', `!name ${paramName}`)]);\n    const uPropType = u('paragraph', {depth}, [u('text', `!type ${props.type}`)]);\n    const markdownAst = fromMarkdown(props.description || '');\n    const uPropDesc = u(\"paragraph\", { depth }, markdownAst.children);\n    const uContext = []\n\n    if (props.context && Object.keys(props.context)) {\n        uContext.push(u(\n            'heading',\n            {depth: depth + 1},\n            [\n                u('text', `!context`),\n            ]\n        ))\n\n        for (const [key, value] of Object.entries(props.context)) {\n            uContext.push(u(\n                    'heading',\n                    {depth: uContext[0].depth + 1},\n                    [u('text', `!${key} ${value}`)]\n                )\n            )\n        }\n    }\n\n    output.push(\n        uPropTitle,\n        uPropName,\n        uPropType,\n        uPropDesc,\n        ...uContext\n    );\n\n    if (props.properties) {\n        const deepDepth = depth + 1\n\n        for (const prop of props.properties) {\n            properties(deepDepth, prop, output)\n        }\n    }\n}\n\n\n\n"],"mappings":"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","names":["examples","definitions"]}

package/dist/types-CbDJSEtC.d.cts

@@ -0,0 +1,81 @@
+declare enum ReferenceCategory {
+    COMPONENTS = "components",
+    HOOKS = "hooks",
+    REST = "rest",
+    GRAPHQL = "graphql",
+    FUNCTIONS = "functions"
+}
+declare enum ReferenceType {
+    COMPONENT = "component",
+    HOOK = "hook",
+    REST_HTTP_GET = "rest_get",
+    REST_HTTP_POST = "rest_post",
+    REST_HTTP_PUT = "rest_put",
+    REST_HTTP_PATCH = "rest_patch",
+    REST_HTTP_DELETE = "rest_delete",
+    GRAPHQL_QUERY = "graphql_query",
+    GRAPHQL_MUTATION = "graphql_mutation",
+    FUNCTION_JS = "function_js"
+}
+interface GraphQLReferenceContext {
+}
+interface OpenAPIReferenceContext {
+    method: string;
+    path: string;
+}
+type ReferenceContext = GraphQLReferenceContext | OpenAPIReferenceContext;
+interface ExampleRoot {
+    groups: ExampleGroup[];
+}
+interface ExampleGroup {
+    description?: string;
+    examples: Example[];
+}
+interface Example {
+    description?: string;
+    codeblock: CodeBlock;
+}
+interface CodeBlock {
+    title?: string;
+    tabs: CodeBlockTab[];
+}
+interface GraphQLExampleContext {
+    schema?: any;
+}
+interface OpenAPIExampleContext {
+    status?: number;
+    content?: string;
+}
+type ExampleContext = GraphQLExampleContext | OpenAPIExampleContext;
+interface CodeBlockTab {
+    title: string;
+    code: string;
+    language: string;
+    context?: ExampleContext;
+}
+interface Reference {
+    title: string;
+    description: string;
+    canonical: string;
+    definitions: Definition[];
+    examples: ExampleRoot;
+    category?: ReferenceCategory;
+    type?: ReferenceType;
+    context?: ReferenceContext;
+}
+interface Definition {
+    title: string;
+    properties: DefinitionProperty[];
+    type?: string;
+    id?: string;
+    description?: string;
+}
+interface DefinitionProperty {
+    name: string;
+    type: string;
+    description: string;
+    context?: any;
+    properties?: DefinitionProperty[];
+}
+
+export { type CodeBlock as C, type Definition as D, type ExampleRoot as E, type GraphQLReferenceContext as G, type OpenAPIReferenceContext as O, type Reference as R, ReferenceCategory as a, ReferenceType as b, type ReferenceContext as c, type ExampleGroup as d, type Example as e, type GraphQLExampleContext as f, type OpenAPIExampleContext as g, type ExampleContext as h, type CodeBlockTab as i, type DefinitionProperty as j };

package/dist/types-CbDJSEtC.d.ts

@@ -0,0 +1,81 @@
+declare enum ReferenceCategory {
+    COMPONENTS = "components",
+    HOOKS = "hooks",
+    REST = "rest",
+    GRAPHQL = "graphql",
+    FUNCTIONS = "functions"
+}
+declare enum ReferenceType {
+    COMPONENT = "component",
+    HOOK = "hook",
+    REST_HTTP_GET = "rest_get",
+    REST_HTTP_POST = "rest_post",
+    REST_HTTP_PUT = "rest_put",
+    REST_HTTP_PATCH = "rest_patch",
+    REST_HTTP_DELETE = "rest_delete",
+    GRAPHQL_QUERY = "graphql_query",
+    GRAPHQL_MUTATION = "graphql_mutation",
+    FUNCTION_JS = "function_js"
+}
+interface GraphQLReferenceContext {
+}
+interface OpenAPIReferenceContext {
+    method: string;
+    path: string;
+}
+type ReferenceContext = GraphQLReferenceContext | OpenAPIReferenceContext;
+interface ExampleRoot {
+    groups: ExampleGroup[];
+}
+interface ExampleGroup {
+    description?: string;
+    examples: Example[];
+}
+interface Example {
+    description?: string;
+    codeblock: CodeBlock;
+}
+interface CodeBlock {
+    title?: string;
+    tabs: CodeBlockTab[];
+}
+interface GraphQLExampleContext {
+    schema?: any;
+}
+interface OpenAPIExampleContext {
+    status?: number;
+    content?: string;
+}
+type ExampleContext = GraphQLExampleContext | OpenAPIExampleContext;
+interface CodeBlockTab {
+    title: string;
+    code: string;
+    language: string;
+    context?: ExampleContext;
+}
+interface Reference {
+    title: string;
+    description: string;
+    canonical: string;
+    definitions: Definition[];
+    examples: ExampleRoot;
+    category?: ReferenceCategory;
+    type?: ReferenceType;
+    context?: ReferenceContext;
+}
+interface Definition {
+    title: string;
+    properties: DefinitionProperty[];
+    type?: string;
+    id?: string;
+    description?: string;
+}
+interface DefinitionProperty {
+    name: string;
+    type: string;
+    description: string;
+    context?: any;
+    properties?: DefinitionProperty[];
+}
+
+export { type CodeBlock as C, type Definition as D, type ExampleRoot as E, type GraphQLReferenceContext as G, type OpenAPIReferenceContext as O, type Reference as R, ReferenceCategory as a, ReferenceType as b, type ReferenceContext as c, type ExampleGroup as d, type Example as e, type GraphQLExampleContext as f, type OpenAPIExampleContext as g, type ExampleContext as h, type CodeBlockTab as i, type DefinitionProperty as j };

package/index.ts

@@ -0,0 +1,8 @@
+export {default} from "./src/index"
+
+export {
+    pluginNavigation
+} from "./src/utils"
+
+export * from "./src/types"
+

package/markdown.ts

@@ -0,0 +1 @@
+export * from "./src/markdown/index";

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@xyd-js/uniform",
+  "version": "0.1.0-xyd.10",
+  "description": "",
+  "main": "./dist/index.js",
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": "./dist/index.js",
+    "./markdown": "./dist/markdown.js",
+    "./content": "./dist/content.js"
+  },
+  "dependencies": {
+    "codehike": "^1.0.3",
+    "gray-matter": "^4.0.3",
+    "mdast-util-from-markdown": "^2.0.2",
+    "mdast-util-to-markdown": "^2.1.2",
+    "remark": "^15.0.1",
+    "remark-stringify": "^11.0.0",
+    "unist-builder": "^4.0.0",
+    "unist-util-visit": "^5.0.0",
+    "@xyd-js/core": "0.1.0-xyd.8"
+  },
+  "peerDependencies": {
+    "@mdx-js/mdx": "^3.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.5",
+    "rimraf": "^3.0.2",
+    "tsup": "^8.3.0",
+    "typescript": "^4.5.5"
+  },
+  "scripts": {
+    "clean": "rimraf build",
+    "prebuild": "pnpm clean",
+    "build": "tsup"
+  }
+}

package/src/content/index.ts

@@ -0,0 +1,124 @@
+import path from "path";
+import {promises as fs} from "fs";
+
+import React from "react";
+import {parse} from "codehike";
+import {visit} from "unist-util-visit";
+import {recmaCodeHike, remarkCodeHike} from "codehike/mdx";
+import {compile as mdxCompile} from "@mdx-js/mdx";
+
+const codeHikeOptions = {
+    lineNumbers: true,
+    showCopyButton: true,
+    autoImport: true,
+    components: {code: "Code"},
+    // syntaxHighlighting: { // TODO: !!! FROM SETTINGS !!! wait for rr7 rsc ??
+    //     theme: "github-dark",
+    // },
+};
+//
+// // since unist does not support heading level > 6, we need to normalize them
+function normalizeCustomHeadings() {
+    return (tree: any) => {
+        visit(tree, 'paragraph', (node, index, parent) => {
+            const match = node.children[0] && node.children[0].value.match(/^(#+)\s+(.*)/);
+            if (match) {
+                const level = match[1].length;
+                const text = match[2];
+                if (level > 6) {
+                    // Create a new heading node with depth 6
+                    const headingNode = {
+                        type: 'heading',
+                        depth: level,
+                        children: [{type: 'text', value: text}]
+                    };
+                    // Replace the paragraph node with the new heading node
+                    //@ts-ignore
+                    parent.children[index] = headingNode;
+                }
+            }
+        });
+    };
+}
+
+//
+async function compile(content: string): Promise<string> {
+    const compiled = await mdxCompile(content, {
+        remarkPlugins: [normalizeCustomHeadings, [remarkCodeHike, codeHikeOptions]],
+        recmaPlugins: [
+            [recmaCodeHike, codeHikeOptions]
+        ],
+        outputFormat: 'function-body',
+        development: false,
+    });
+
+    return String(compiled)
+}
+
+async function compileBySlug(slug: string) {
+    // TODO: cwd ?
+    const filePath = path.join(process.cwd(), `${slug}.md`)
+
+    try {
+        await fs.access(filePath)
+    } catch (e) {
+        console.error(e)
+        return ""
+    }
+
+    const content = await fs.readFile(filePath, "utf-8");
+
+    return await compile(content)
+}
+
+function getMDXComponent(code: string) {
+    const mdxExport = getMDXExport(code)
+    return mdxExport.default
+}
+
+function getMDXExport(code: string) {
+    const scope = {
+        Fragment: React.Fragment,
+        jsxs: React.createElement,
+        jsx: React.createElement,
+        jsxDEV: React.createElement,
+    }
+    const fn = new Function(...Object.keys(scope), code)
+    return fn(scope)
+}
+
+//
+// function MDXContent(code: string) {
+//     return React.useMemo(
+//         () => code ? getMDXComponent(code) : null,
+//         [code]
+//     )
+// }
+
+// TODO: mod ts
+async function lazyReferences(mod: any) {
+    const references: any[] = []
+
+    if (Array.isArray(mod.default)) {
+        for (const chunk of mod.default) {
+            try {
+                const code = await compile(chunk) // TODO: do we need real path?
+                const Content = getMDXComponent(code)
+                const content = Content ? parse(Content) : null
+
+                references.push(...content.references as [])
+            } catch (e) {
+                console.error(e)
+            }
+        }
+    } else {
+        console.warn(`mod.default is not an array, current type is: ${typeof mod.default}`)
+    }
+
+    return references
+}
+
+export {
+    compileBySlug,
+    lazyReferences
+}