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

package/createDemoData/types.d.ts

@@ -0,0 +1,28 @@
+import type { Code } from "../CodeHighlighter/types.js";
+export type CreateDemoDataMeta = {
+  name?: string;
+  slug?: string;
+  displayName?: string;
+  skipPrecompute?: boolean;
+  precompute?: Code;
+  CodeExternalsProvider?: React.ComponentType<{
+    children: React.ReactNode;
+  }>;
+};
+export type DemoData<T extends React.ComponentType<any> = React.ComponentType> = {
+  name: string;
+  slug: string;
+  displayName: string;
+  precompute: Code | undefined;
+  CodeExternalsProvider: React.ComponentType<{
+    children: React.ReactNode;
+  }> | undefined;
+  url: string;
+  components: {
+    [key: string]: T;
+  };
+};
+export type DemoGlobalProvider = React.ComponentType<{
+  children: React.ReactNode;
+}>;
+export type DemoGlobalData = DemoData<DemoGlobalProvider>;

package/createDemoData/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/createDemoData/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,qBAAqB,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,CAAC,CAAC;CAC5E,CAAC;AAEF,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,aAAa,IAAI;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,IAAI,GAAG,SAAS,CAAC;IAC7B,qBAAqB,EAAE,KAAK,CAAC,aAAa,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IACtF,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,CAAA;KAAE,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,KAAK,CAAC,aAAa,CAAC;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,CAAC,CAAC;AACpF,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,kBAAkB,CAAC,CAAC"}

package/createDemoData/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,8 +1,20 @@
 {
   "name": "@mui/internal-docs-infra",
-  "version": "0.1.1-alpha.0",
+  "version": "0.1.1-alpha.10",
   "author": "MUI Team",
   "description": "MUI Infra - internal documentation creation tools.",
+  "main": "./index.js",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": "./index.js",
+    "./*": "./*/index.js",
+    "./*/types": "./*/types.js",
+    "./*/errors": "./*/errors.js",
+    "./pipeline": "./pipeline/index.js",
+    "./pipeline/*": "./pipeline/*/index.js",
+    "./pipeline/*/types": "./pipeline/*/types.js",
+    "./pipeline/*/errors": "./pipeline/*/errors.js"
+  },
   "keywords": [
     "react",
     "react-component",
@@ -31,43 +43,17 @@
     "js-sha256": "^0.11.1",
     "jsondiffpatch": "^0.7.3",
     "kebab-case": "^2.0.2",
+    "lz-string": "^1.5.0",
     "prettier": "^3.5.3",
     "rehype-parse": "^9.0.1",
     "rehype-remark": "^10.0.1",
     "rehype-sanitize": "^6.0.0",
+    "remark-parse": "^11.0.0",
     "remark-stringify": "^11.0.0",
     "unified": "^11.0.5",
     "unist-util-visit": "^5.0.0",
     "vscode-oniguruma": "^2.0.1"
   },
-  "devDependencies": {
-    "@babel/cli": "^7.27.2",
-    "@babel/core": "^7.27.4",
-    "@babel/plugin-transform-react-constant-elements": "^7.27.1",
-    "@babel/plugin-transform-runtime": "^7.27.4",
-    "@testing-library/react": "^16.3.0",
-    "@types/babel__standalone": "^7.1.9",
-    "@types/babel__traverse": "^7.20.7",
-    "@types/hast": "^3.0.4",
-    "@types/mdast": "^4.0.4",
-    "@types/node": "^24.0.3",
-    "@types/react": "^19.1.8",
-    "babel-plugin-istanbul": "^7.0.0",
-    "babel-plugin-module-resolver": "^5.0.2",
-    "babel-plugin-optimize-clsx": "^2.6.2",
-    "babel-plugin-react-remove-properties": "^0.3.0",
-    "babel-plugin-transform-inline-environment-variables": "^0.4.4",
-    "babel-plugin-transform-react-remove-prop-types": "^0.4.24",
-    "csstype": "^3.1.3",
-    "execa": "^7.2.0",
-    "fast-glob": "^3.3.2",
-    "fs-extra": "^11.3.0",
-    "jsonc-parser": "^3.3.1",
-    "next": "^15.3.4",
-    "react": "^19.1.0",
-    "rimraf": "^6.0.1",
-    "yargs": "^17.7.2"
-  },
   "peerDependencies": {
     "@types/react": "^17.0.0 || ^18.0.0 || ^19.0.0",
     "next": "^13.5.1 || ^14 || ^15.0.0",
@@ -78,52 +64,13 @@
       "optional": true
     }
   },
-  "exports": {
-    "./*": {
-      "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"
-    }
+  "engines": {
+    "node": ">=22.0.0"
   },
-  "files": [
-    "build/**/*"
-  ],
+  "private": false,
+  "type": "module",
+  "module": "./index.js",
   "publishConfig": {
     "access": "public"
-  },
-  "engines": {
-    "node": ">=14.0.0"
-  },
-  "scripts": {
-    "build": "pnpm build:node && pnpm build:stable && pnpm build:types && pnpm build:copy-files",
-    "build:node": "node ./scripts/build.mjs node",
-    "build:stable": "node ./scripts/build.mjs stable",
-    "build:types": "tsx ./scripts/buildTypes.mts",
-    "build:copy-files": "node ./scripts/copyFiles.mjs",
-    "prebuild": "rimraf build",
-    "release": "pnpm build && pnpm publish --no-git-checks",
-    "test": "pnpm -w test --project @mui/internal-docs-infra",
-    "test:watch": "pnpm -w test:watch --project @mui/internal-docs-infra",
-    "typescript": "tsc -p tsconfig.json"
   }
 }

package/pipeline/hastUtils/hastUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hastUtils.d.ts","sourceRoot":"","sources":["../../../src/pipeline/hastUtils/hastUtils.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAM/C,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,KAAK,CAAC,SAAS,CAE1D;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,KAAK,CAAC,SAAS,CAa7F;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAiB9F;AAED,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EACjD,WAAW,CAAC,EAAE,OAAO,GACpB,KAAK,CAAC,SAAS,CAqBjB"}

package/{build/esm/hast/hast.js → pipeline/hastUtils/hastUtils.js}

@@ -1,3 +1,4 @@
+import _typeof from "@babel/runtime/helpers/esm/typeof";
 import { Fragment, jsx, jsxs } from 'react/jsx-runtime';
 import { toText } from 'hast-util-to-text';
 import { toJsxRuntime } from 'hast-util-to-jsx-runtime';
@@ -57,7 +58,7 @@ export function stringOrHastToJsx(source, highlighted) {
   } else {
     hast = source;
   }
-  if (highlighted) {
+  if (highlighted && _typeof(hast) === 'object') {
     return hastToJsx(hast);
   }
   return toText(hast, {

package/pipeline/hastUtils/index.d.ts

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

package/pipeline/hastUtils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pipeline/hastUtils/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/pipeline/hastUtils/index.js

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

package/pipeline/loadPrecomputedCodeHighlighter/emitExternalsProvider.d.ts

@@ -0,0 +1,54 @@
+export interface LoaderContext {
+  resourcePath: string;
+  addDependency(dependency: string): void;
+  emitFile?(name: string, content: string): void;
+}
+export interface ExternalsProviderInfo {
+  fileName: string;
+  content: string;
+  relativePath: string;
+}
+/**
+ * Creates a relative import path from source file to target file
+ */
+declare function createRelativePath(fromFile: string, toFile: string): string;
+/**
+ * Creates a structured path for generated externals files based on the source file location
+ * Example: app/components/checkbox/demos/basic/index.ts -> generated/demo-externals/app/components/checkbox/demos/basic.tsx
+ */
+declare function createGeneratedFilePath(resourcePath: string, projectRoot: string): Promise<{
+  filePath: string;
+  relativePath: string;
+}>;
+/**
+ * Determines the appropriate build directory for temporary files
+ * to avoid checking generated files into source control.
+ */
+declare function getBuildDirectory(resourcePath: string): Promise<string>;
+/**
+ * Finds the project root by looking for 'app' directory or common project markers
+ */
+declare function findProjectRoot(startPath: string): Promise<string>;
+/**
+ * Ensures that the generated demo externals directory is added to .gitignore
+ * to prevent accidentally committing these generated files.
+ */
+declare function ensureGitignoreEntry(projectRoot: string): Promise<void>;
+/**
+ * Emits an externals provider file using the best available method:
+ * 1. Use emitFile if available (webpack)
+ * 2. Fall back to structured filesystem writing to generated/demo-externals/ (turbopack/other bundlers)
+ *
+ * @param loaderContext - The loader context with emitFile capability
+ * @param externalsProviderInfo - The externals provider file information
+ * @returns The import path to use for the generated file
+ */
+export declare function emitExternalsProvider(loaderContext: LoaderContext, externalsProviderInfo: ExternalsProviderInfo): Promise<string>;
+export declare const testHelpers: {
+  createRelativePath: typeof createRelativePath;
+  createGeneratedFilePath: typeof createGeneratedFilePath;
+  getBuildDirectory: typeof getBuildDirectory;
+  findProjectRoot: typeof findProjectRoot;
+  ensureGitignoreEntry: typeof ensureGitignoreEntry;
+};
+export {};

package/pipeline/loadPrecomputedCodeHighlighter/emitExternalsProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitExternalsProvider.d.ts","sourceRoot":"","sources":["../../../src/pipeline/loadPrecomputedCodeHighlighter/emitExternalsProvider.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAChD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,iBAAS,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIpE;AAED;;;GAGG;AACH,iBAAe,uBAAuB,CACpC,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAoCrD;AAED;;;GAGG;AACH,iBAAe,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwCtE;AAED;;GAEG;AACH,iBAAe,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA+DjE;AAED;;;GAGG;AACH,iBAAe,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkFtE;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,aAAa,EAAE,aAAa,EAC5B,qBAAqB,EAAE,qBAAqB,GAC3C,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAGD,eAAO,MAAM,WAAW;;;;;;CAMvB,CAAC"}