@mui/internal-docs-infra 0.1.0 → 0.1.1-alpha.0

package/build/loaderUtils/resolveModulePathWithFs.d.ts

@@ -0,0 +1,44 @@
+import { type DirectoryEntry, type DirectoryReader, type ResolveModulePathOptions } from "./resolveModulePath.js";
+/**
+ * Resolves a module path using Node.js filesystem APIs.
+ * This is a convenience wrapper around the generic resolveModulePath function.
+ *
+ * @param modulePath - The module path to resolve (without file extension)
+ * @param options - Configuration options
+ * @returns Promise<string> - The resolved file path, or throws if not found
+ */
+export declare function resolveModulePathWithFs(modulePath: string, options?: ResolveModulePathOptions): Promise<string>;
+/**
+ * Resolves multiple module paths using Node.js filesystem APIs.
+ * This is a convenience wrapper around the generic resolveModulePaths function.
+ *
+ * @param modulePaths - Array of module paths to resolve (without file extensions)
+ * @param options - Configuration options
+ * @returns Promise<Map<string, string>> - Map from input path to resolved file path
+ */
+export declare function resolveModulePathsWithFs(modulePaths: string[], options?: ResolveModulePathOptions): Promise<Map<string, string>>;
+/**
+ * Resolves import result by separating JavaScript modules from static assets,
+ * only resolving JavaScript modules and returning a combined map.
+ * This is a convenience wrapper around the generic resolveImportResult function
+ * that uses Node.js filesystem APIs.
+ *
+ * @param importResult - The result from resolveImports containing all imports
+ * @param options - Configuration options for module resolution
+ * @returns Promise<Map<string, string>> - Map from import path to resolved file path
+ */
+export declare function resolveImportResultWithFs(importResult: Record<string, {
+  path: string;
+  names: string[];
+}>, options?: ResolveModulePathOptions): Promise<Map<string, string>>;
+/**
+ * Resolves variant paths from a variants object mapping variant names to their file paths.
+ * This is a convenience wrapper around the generic resolveVariantPaths function
+ * that uses Node.js filesystem APIs.
+ *
+ * @param variants - Object mapping variant names to their file paths
+ * @param options - Configuration options for module resolution
+ * @returns Promise<Map<string, string>> - Map from variant name to resolved file URL
+ */
+export declare function resolveVariantPathsWithFs(variants: Record<string, string>, options?: ResolveModulePathOptions): Promise<Map<string, string>>;
+export type { DirectoryEntry, DirectoryReader, ResolveModulePathOptions };

package/build/loaderUtils/resolveModulePathWithFs.js

@@ -0,0 +1,163 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault")["default"];
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.resolveImportResultWithFs = resolveImportResultWithFs;
+exports.resolveModulePathWithFs = resolveModulePathWithFs;
+exports.resolveModulePathsWithFs = resolveModulePathsWithFs;
+exports.resolveVariantPathsWithFs = resolveVariantPathsWithFs;
+var _regeneratorRuntime2 = _interopRequireDefault(require("@babel/runtime/helpers/regeneratorRuntime"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _promises = require("node:fs/promises");
+var _resolveModulePath = require("./resolveModulePath");
+/**
+ * Node.js filesystem-based directory reader that converts Dirent objects
+ * to the DirectoryEntry interface expected by the resolver functions.
+ */
+var nodeDirectoryReader = /*#__PURE__*/function () {
+  var _ref = (0, _asyncToGenerator2["default"])(/*#__PURE__*/(0, _regeneratorRuntime2["default"])().mark(function _callee(path) {
+    var entries;
+    return (0, _regeneratorRuntime2["default"])().wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          _context.next = 2;
+          return (0, _promises.readdir)(path, {
+            withFileTypes: true
+          });
+        case 2:
+          entries = _context.sent;
+          return _context.abrupt("return", entries.map(function (entry) {
+            return {
+              name: entry.name,
+              isFile: entry.isFile(),
+              isDirectory: entry.isDirectory()
+            };
+          }));
+        case 4:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return function nodeDirectoryReader(_x) {
+    return _ref.apply(this, arguments);
+  };
+}();
+
+/**
+ * Resolves a module path using Node.js filesystem APIs.
+ * This is a convenience wrapper around the generic resolveModulePath function.
+ *
+ * @param modulePath - The module path to resolve (without file extension)
+ * @param options - Configuration options
+ * @returns Promise<string> - The resolved file path, or throws if not found
+ */
+function resolveModulePathWithFs(_x2) {
+  return _resolveModulePathWithFs.apply(this, arguments);
+}
+/**
+ * Resolves multiple module paths using Node.js filesystem APIs.
+ * This is a convenience wrapper around the generic resolveModulePaths function.
+ *
+ * @param modulePaths - Array of module paths to resolve (without file extensions)
+ * @param options - Configuration options
+ * @returns Promise<Map<string, string>> - Map from input path to resolved file path
+ */
+function _resolveModulePathWithFs() {
+  _resolveModulePathWithFs = (0, _asyncToGenerator2["default"])(/*#__PURE__*/(0, _regeneratorRuntime2["default"])().mark(function _callee2(modulePath) {
+    var options,
+      _args2 = arguments;
+    return (0, _regeneratorRuntime2["default"])().wrap(function _callee2$(_context2) {
+      while (1) switch (_context2.prev = _context2.next) {
+        case 0:
+          options = _args2.length > 1 && _args2[1] !== undefined ? _args2[1] : {};
+          return _context2.abrupt("return", (0, _resolveModulePath.resolveModulePath)(modulePath, nodeDirectoryReader, options));
+        case 2:
+        case "end":
+          return _context2.stop();
+      }
+    }, _callee2);
+  }));
+  return _resolveModulePathWithFs.apply(this, arguments);
+}
+function resolveModulePathsWithFs(_x3) {
+  return _resolveModulePathsWithFs.apply(this, arguments);
+}
+/**
+ * Resolves import result by separating JavaScript modules from static assets,
+ * only resolving JavaScript modules and returning a combined map.
+ * This is a convenience wrapper around the generic resolveImportResult function
+ * that uses Node.js filesystem APIs.
+ *
+ * @param importResult - The result from resolveImports containing all imports
+ * @param options - Configuration options for module resolution
+ * @returns Promise<Map<string, string>> - Map from import path to resolved file path
+ */
+function _resolveModulePathsWithFs() {
+  _resolveModulePathsWithFs = (0, _asyncToGenerator2["default"])(/*#__PURE__*/(0, _regeneratorRuntime2["default"])().mark(function _callee3(modulePaths) {
+    var options,
+      _args3 = arguments;
+    return (0, _regeneratorRuntime2["default"])().wrap(function _callee3$(_context3) {
+      while (1) switch (_context3.prev = _context3.next) {
+        case 0:
+          options = _args3.length > 1 && _args3[1] !== undefined ? _args3[1] : {};
+          return _context3.abrupt("return", (0, _resolveModulePath.resolveModulePaths)(modulePaths, nodeDirectoryReader, options));
+        case 2:
+        case "end":
+          return _context3.stop();
+      }
+    }, _callee3);
+  }));
+  return _resolveModulePathsWithFs.apply(this, arguments);
+}
+function resolveImportResultWithFs(_x4) {
+  return _resolveImportResultWithFs.apply(this, arguments);
+}
+/**
+ * Resolves variant paths from a variants object mapping variant names to their file paths.
+ * This is a convenience wrapper around the generic resolveVariantPaths function
+ * that uses Node.js filesystem APIs.
+ *
+ * @param variants - Object mapping variant names to their file paths
+ * @param options - Configuration options for module resolution
+ * @returns Promise<Map<string, string>> - Map from variant name to resolved file URL
+ */
+function _resolveImportResultWithFs() {
+  _resolveImportResultWithFs = (0, _asyncToGenerator2["default"])(/*#__PURE__*/(0, _regeneratorRuntime2["default"])().mark(function _callee4(importResult) {
+    var options,
+      _args4 = arguments;
+    return (0, _regeneratorRuntime2["default"])().wrap(function _callee4$(_context4) {
+      while (1) switch (_context4.prev = _context4.next) {
+        case 0:
+          options = _args4.length > 1 && _args4[1] !== undefined ? _args4[1] : {};
+          return _context4.abrupt("return", (0, _resolveModulePath.resolveImportResult)(importResult, nodeDirectoryReader, options));
+        case 2:
+        case "end":
+          return _context4.stop();
+      }
+    }, _callee4);
+  }));
+  return _resolveImportResultWithFs.apply(this, arguments);
+}
+function resolveVariantPathsWithFs(_x5) {
+  return _resolveVariantPathsWithFs.apply(this, arguments);
+} // Re-export types for convenience
+function _resolveVariantPathsWithFs() {
+  _resolveVariantPathsWithFs = (0, _asyncToGenerator2["default"])(/*#__PURE__*/(0, _regeneratorRuntime2["default"])().mark(function _callee5(variants) {
+    var options,
+      _args5 = arguments;
+    return (0, _regeneratorRuntime2["default"])().wrap(function _callee5$(_context5) {
+      while (1) switch (_context5.prev = _context5.next) {
+        case 0:
+          options = _args5.length > 1 && _args5[1] !== undefined ? _args5[1] : {};
+          return _context5.abrupt("return", (0, _resolveModulePath.resolveVariantPaths)(variants, nodeDirectoryReader, options));
+        case 2:
+        case "end":
+          return _context5.stop();
+      }
+    }, _callee5);
+  }));
+  return _resolveVariantPathsWithFs.apply(this, arguments);
+}

package/build/loaderUtils/rewriteImports.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Rewrites relative imports in source code to assume all files are in the same directory.
+ * Converts imports like '../utils/helper' or './components/Button' to './helper' and './Button'
+ *
+ * @param source - The source code to process
+ * @param filePaths - Set of file paths that are available as dependencies
+ * @returns The source code with rewritten imports
+ */
+export declare function rewriteImportsToSameDirectory(source: string, filePaths: Set<string>): string;

package/build/loaderUtils/rewriteImports.js

@@ -0,0 +1,62 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.rewriteImportsToSameDirectory = rewriteImportsToSameDirectory;
+var _resolveModulePath = require("./resolveModulePath");
+var _getFileNameFromUrl2 = require("./getFileNameFromUrl");
+/**
+ * Rewrites relative imports in source code to assume all files are in the same directory.
+ * Converts imports like '../utils/helper' or './components/Button' to './helper' and './Button'
+ *
+ * @param source - The source code to process
+ * @param filePaths - Set of file paths that are available as dependencies
+ * @returns The source code with rewritten imports
+ */
+function rewriteImportsToSameDirectory(source, filePaths) {
+  // Create a map of original file paths to just their basenames
+  var fileBasenames = new Map();
+  Array.from(filePaths).forEach(function (path) {
+    fileBasenames.set(path, (0, _getFileNameFromUrl2.getFileNameFromUrl)(path).fileName);
+  });
+
+  // Regex to match import statements with relative paths
+  var importRegex = /import\s+((?:\w+|\*\s+as\s+\w+|{[^}]+})\s+from\s+)['"]([^'"]+)['"]/g;
+  return source.replace(importRegex, function (match, importPart, modulePath) {
+    // Only process relative imports
+    if (modulePath.startsWith('.')) {
+      // Extract the filename from the path
+      var filename = (0, _getFileNameFromUrl2.getFileNameFromUrl)(modulePath).fileName;
+
+      // For static assets (CSS, JSON, etc.), use the filename as-is
+      if (!(0, _resolveModulePath.isJavaScriptModule)(modulePath)) {
+        var matchingPath = Array.from(filePaths).find(function (path) {
+          return (0, _getFileNameFromUrl2.getFileNameFromUrl)(path).fileName === filename;
+        });
+        if (matchingPath) {
+          return "import ".concat(importPart, "'./").concat(filename, "'");
+        }
+      } else {
+        // For JS/TS modules, check against all possible extensions
+        var _matchingPath = Array.from(filePaths).find(function (path) {
+          var pathBasename = (0, _getFileNameFromUrl2.getFileNameFromUrl)(path).fileName;
+          return pathBasename === filename || _resolveModulePath.JAVASCRIPT_MODULE_EXTENSIONS.some(function (ext) {
+            var _getFileNameFromUrl = (0, _getFileNameFromUrl2.getFileNameFromUrl)(path),
+              fileName = _getFileNameFromUrl.fileName;
+            return fileName.endsWith(ext) ? fileName.slice(0, -ext.length) === filename : false;
+          });
+        });
+        if (_matchingPath) {
+          // For JS/TS modules, rewrite to same directory without extension
+          var pathBasename = (0, _getFileNameFromUrl2.getFileNameFromUrl)(_matchingPath).fileName;
+          var nameWithoutExt = _resolveModulePath.JAVASCRIPT_MODULE_EXTENSIONS.reduce(function (name, ext) {
+            return name.replace(new RegExp("\\".concat(ext, "$")), '');
+          }, pathBasename);
+          return "import ".concat(importPart, "'./").concat(nameWithoutExt, "'");
+        }
+      }
+    }
+    return match;
+  });
+}

package/build/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "@mui/internal-docs-infra",
+  "version": "0.1.0",
+  "author": "MUI Team",
+  "description": "MUI Infra - internal documentation creation tools.",
+  "keywords": [
+    "react",
+    "react-component",
+    "material-ui",
+    "material design",
+    "docs"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mui/mui-public.git",
+    "directory": "packages/mui-docs"
+  },
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/mui/mui-public/issues"
+  },
+  "homepage": "https://github.com/mui/mui-public/tree/master/packages/docs-infra",
+  "dependencies": {
+    "@babel/runtime": "^7.27.6",
+    "@babel/standalone": "^7.28.1",
+    "@wooorm/starry-night": "^3.8.0",
+    "clipboard-copy": "^4.0.1",
+    "hast-util-to-jsx-runtime": "^2.3.6",
+    "hast-util-to-mdast": "^10.1.2",
+    "hast-util-to-text": "^4.0.2",
+    "js-sha256": "^0.11.1",
+    "jsondiffpatch": "^0.7.3",
+    "kebab-case": "^2.0.2",
+    "prettier": "^3.5.3",
+    "rehype-parse": "^9.0.1",
+    "rehype-remark": "^10.0.1",
+    "rehype-sanitize": "^6.0.0",
+    "remark-stringify": "^11.0.0",
+    "unified": "^11.0.5",
+    "unist-util-visit": "^5.0.0",
+    "vscode-oniguruma": "^2.0.1"
+  },
+  "peerDependencies": {
+    "@types/react": "^17.0.0 || ^18.0.0 || ^19.0.0",
+    "next": "^13.5.1 || ^14 || ^15.0.0",
+    "react": "^17.0.0 || ^18.0.0 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@types/react": {
+      "optional": true
+    }
+  },
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "require": {
+        "types": "./index.d.ts",
+        "default": "./index.js"
+      },
+      "import": {
+        "types": "./esm/index.d.ts",
+        "default": "./esm/index.js"
+      }
+    },
+    "./*": {
+      "import": "./build/esm/*/index.js",
+      "require": "./build/*/index.js",
+      "types": "./build/*/index.d.ts"
+    },
+    "./*/types": {
+      "import": "./build/esm/*/types.js",
+      "require": "./build/*/types.js",
+      "types": "./build/*/types.d.ts"
+    },
+    "./*/errors": {
+      "import": "./build/esm/*/errors.js",
+      "require": "./build/*/errors.js",
+      "types": "./build/*/errors.d.ts"
+    },
+    "./transformRelativeMarkdownPaths/esm": {
+      "import": "./build/esm/transformRelativeMarkdownPaths/index.js",
+      "require": "./build/esm/transformRelativeMarkdownPaths/index.js",
+      "types": "./build/esm/transformRelativeMarkdownPaths/index.d.ts"
+    },
+    "./loadPrecomputedCodeHighlighter/esm": {
+      "import": "./build/esm/loadPrecomputedCodeHighlighter/index.js",
+      "require": "./build/esm/loadPrecomputedCodeHighlighter/index.js",
+      "types": "./build/esm/loadPrecomputedCodeHighlighter/index.d.ts"
+    }
+  },
+  "files": [
+    "build/**/*"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "private": false
+}

package/build/parseSource/grammars.d.ts

@@ -0,0 +1,2 @@
+export declare const grammars: import("@wooorm/starry-night").Grammar[];
+export declare const extensionMap: Record<string, string>;

package/build/parseSource/grammars.js

@@ -0,0 +1,34 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault")["default"];
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.grammars = exports.extensionMap = void 0;
+var _source = _interopRequireDefault(require("@wooorm/starry-night/source.js"));
+var _source2 = _interopRequireDefault(require("@wooorm/starry-night/source.ts"));
+var _source3 = _interopRequireDefault(require("@wooorm/starry-night/source.tsx"));
+var _source4 = _interopRequireDefault(require("@wooorm/starry-night/source.json"));
+var _text = _interopRequireDefault(require("@wooorm/starry-night/text.md"));
+var _source5 = _interopRequireDefault(require("@wooorm/starry-night/source.mdx"));
+var _textHtml = _interopRequireDefault(require("@wooorm/starry-night/text.html.basic"));
+var _source6 = _interopRequireDefault(require("@wooorm/starry-night/source.css"));
+var _source7 = _interopRequireDefault(require("@wooorm/starry-night/source.shell"));
+var _source8 = _interopRequireDefault(require("@wooorm/starry-night/source.yaml"));
+var grammars = exports.grammars = [_source["default"], _source2["default"], _source3["default"], _source4["default"], _text["default"], _source5["default"],
+// needs sourceTsx
+_textHtml["default"], _source6["default"], _source7["default"], _source8["default"]];
+var extensionMap = exports.extensionMap = {
+  '.js': 'source.js',
+  '.ts': 'source.ts',
+  '.jsx': 'source.tsx',
+  // TODO: is there a JSX grammar?
+  '.tsx': 'source.tsx',
+  '.json': 'source.json',
+  '.md': 'text.md',
+  '.mdx': 'source.mdx',
+  '.html': 'text.html.basic',
+  '.css': 'source.css',
+  '.sh': 'source.shell',
+  '.yaml': 'source.yaml'
+};

package/build/parseSource/index.d.ts

@@ -0,0 +1 @@
+export * from "./parseSource.js";

package/build/parseSource/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _parseSource = require("./parseSource");
+Object.keys(_parseSource).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _parseSource[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _parseSource[key];
+    }
+  });
+});

package/build/parseSource/parseSource.d.ts

@@ -0,0 +1,3 @@
+import { ParseSource } from "../CodeHighlighter/index.js";
+export declare const parseSource: ParseSource;
+export declare const parseSourceFactory: () => Promise<ParseSource>;

package/build/parseSource/parseSource.js

@@ -0,0 +1,44 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault")["default"];
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.parseSourceFactory = exports.parseSource = void 0;
+var _regeneratorRuntime2 = _interopRequireDefault(require("@babel/runtime/helpers/regeneratorRuntime"));
+var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
+var _starryNight = require("@wooorm/starry-night");
+var _grammars = require("./grammars");
+var starryNight = null;
+var parseSource = exports.parseSource = function parseSource(source, fileName) {
+  if (!starryNight) {
+    throw new Error('Starry Night not initialized. Use parseSourceFactory to create an initialized parseSource function.');
+  }
+  var fileType = fileName.slice(fileName.lastIndexOf('.')) || 'plaintext';
+  return starryNight.highlight(source, _grammars.extensionMap[fileType] || 'plaintext');
+};
+var parseSourceFactory = exports.parseSourceFactory = /*#__PURE__*/function () {
+  var _ref = (0, _asyncToGenerator2["default"])(/*#__PURE__*/(0, _regeneratorRuntime2["default"])().mark(function _callee() {
+    return (0, _regeneratorRuntime2["default"])().wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          if (starryNight) {
+            _context.next = 4;
+            break;
+          }
+          _context.next = 3;
+          return (0, _starryNight.createStarryNight)(_grammars.grammars);
+        case 3:
+          starryNight = _context.sent;
+        case 4:
+          return _context.abrupt("return", parseSource);
+        case 5:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
+  return function parseSourceFactory() {
+    return _ref.apply(this, arguments);
+  };
+}();

package/build/transformRelativeMarkdownPaths/index.d.ts

@@ -0,0 +1,2 @@
+import { transformRelativeMarkdownPaths } from "./transformRelativeMarkdownPaths.js";
+export default transformRelativeMarkdownPaths;

package/build/transformRelativeMarkdownPaths/index.js

@@ -0,0 +1,9 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports["default"] = void 0;
+var _transformRelativeMarkdownPaths = require("./transformRelativeMarkdownPaths");
+// This is the export format expected by a remark plugin.
+var _default = exports["default"] = _transformRelativeMarkdownPaths.transformRelativeMarkdownPaths;

package/build/transformRelativeMarkdownPaths/transformRelativeMarkdownPaths.d.ts

@@ -0,0 +1,12 @@
+import type { Plugin } from 'unified';
+/**
+ * Remark plugin that strips page file extensions from URLs.
+ * Removes /page.tsx, /page.jsx, /page.js, /page.mdx, /page.md from both absolute and relative URLs.
+ * For relative URLs, converts them to absolute paths based on the current file's location.
+ *
+ * Examples:
+ * - /components/page.tsx -> /components
+ * - ./code-highlighter/page.mdx -> /components/code-highlighter (when processed from /components/page.mdx)
+ * This allows URLs to resolve when reading in VSCode and Github
+ */
+export declare const transformRelativeMarkdownPaths: Plugin;

package/build/transformRelativeMarkdownPaths/transformRelativeMarkdownPaths.js

@@ -0,0 +1,36 @@
+"use strict";
+
+var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefault")["default"];
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.transformRelativeMarkdownPaths = void 0;
+var _unistUtilVisit = require("unist-util-visit");
+var _path = _interopRequireDefault(require("path"));
+/**
+ * Remark plugin that strips page file extensions from URLs.
+ * Removes /page.tsx, /page.jsx, /page.js, /page.mdx, /page.md from both absolute and relative URLs.
+ * For relative URLs, converts them to absolute paths based on the current file's location.
+ *
+ * Examples:
+ * - /components/page.tsx -> /components
+ * - ./code-highlighter/page.mdx -> /components/code-highlighter (when processed from /components/page.mdx)
+ * This allows URLs to resolve when reading in VSCode and Github
+ */
+var transformRelativeMarkdownPaths = exports.transformRelativeMarkdownPaths = function transformRelativeMarkdownPaths() {
+  return function (tree, file) {
+    (0, _unistUtilVisit.visit)(tree, 'link', function (node) {
+      if (node.url) {
+        node.url = node.url.replace(/\/page\.(tsx|jsx|js|mdx|md)$/g, '');
+        node.url = node.url.replace(/\/page\.(tsx|jsx|js|mdx|md)(\?[^#]*)?(#.*)?$/g, '$2$3');
+        if (node.url.startsWith('./') && file.path) {
+          var currentDir = _path["default"].dirname(file.path);
+          var appIndex = currentDir.indexOf('/app/');
+          var baseDir = appIndex !== -1 ? currentDir.substring(appIndex + 4) : '/';
+          node.url = _path["default"].join('/', baseDir, node.url.replace(/^\.\//, ''));
+        }
+        node.url = node.url.replace(/\/$/, '');
+      }
+    });
+  };
+};

package/build/transformTsToJs/index.d.ts

@@ -0,0 +1 @@
+export * from "./transformTsToJs.js";

package/build/transformTsToJs/index.js

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _transformTsToJs = require("./transformTsToJs");
+Object.keys(_transformTsToJs).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (key in exports && exports[key] === _transformTsToJs[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function get() {
+      return _transformTsToJs[key];
+    }
+  });
+});

package/build/transformTsToJs/removeTypes.d.ts

@@ -0,0 +1,13 @@
+import type { Options as PrettierOptions } from 'prettier';
+/**
+ * Strips TypeScript types and decorators from code (including React in TSX),
+ * preserving blank lines and optionally formatting with Prettier.
+ *
+ * @param code - The source code string to transform.
+ * @param filename - The name of the file (e.g. "foo.ts" or "Foo.tsx").
+ *                   Determines whether TSX parsing is enabled.
+ * @param prettierConfig - `true` for default formatting, `false` to skip,
+ *                         or a Prettier options object to customize.
+ * @returns The transformed (and optionally formatted) code.
+ */
+export declare function removeTypes(code: string, filename?: string, prettierConfig?: PrettierOptions | boolean): Promise<string>;