@mui/internal-code-infra 0.0.4-canary.98 → 0.1.1-canary.0

package/README.md

@@ -70,3 +70,7 @@ pnpm code-infra publish-new-package --otp=123456
 7. Finally, save the changes by clicking on `Update Package Settings` button.
 
 After following these steps, the `Publish` workflow can be invoked again.
+
+## Agent skills
+
+The agent skills previously shipped with this package now live at the repository root. See [Install instructions](../../README.md#agent-skills).

package/build/babel-config.d.mts

@@ -14,7 +14,7 @@ export type ReactCompilationMode = 'annotation' | 'syntax' | 'infer' | 'all';
  * @param {string} [param0.reactCompilerReactVersion]
  * @param {ReactCompilationMode} [param0.reactCompilerMode]
  * @param {{ allowedCallees?: Record<string, string[]> }} [param0.displayName] - Options for the display name plugin.
- * @returns {import('@babel/core').TransformOptions} The base Babel configuration.
+ * @returns {import('@babel/core').InputOptions} The base Babel configuration.
  */
 export declare function getBaseConfig({ debug, optimizeClsx, removePropTypes, noResolveImports, bundle, runtimeVersion, outExtension, reactCompilerReactVersion, reactCompilerMode, displayName, }: {
     debug?: boolean;
@@ -29,7 +29,7 @@ export declare function getBaseConfig({ debug, optimizeClsx, removePropTypes, no
     displayName?: {
         allowedCallees?: Record<string, string[]>;
     };
-}): import('@babel/core').TransformOptions;
+}): import('@babel/core').InputOptions;
 export type Options = {
     bundle?: 'esm' | 'cjs';
     noResolveImports?: boolean;
@@ -43,6 +43,6 @@ export type Options = {
  */
 /**
  * @param {import('@babel/core').ConfigAPI | Options} api
- * @returns {import('@babel/core').TransformOptions}
+ * @returns {import('@babel/core').InputOptions}
  */
-export default function getBabelConfig(api: import('@babel/core').ConfigAPI | Options): import('@babel/core').TransformOptions;
+export default function getBabelConfig(api: import('@babel/core').ConfigAPI | Options): import('@babel/core').InputOptions;

package/build/babelPluginInlineEnvironmentVariables.d.mts

@@ -0,0 +1,11 @@
+/**
+ * Inlines `process.env.X` member expressions with their build-time value.
+ *
+ * Forked from `babel-plugin-transform-inline-environment-variables` (unmaintained, last
+ * published 2022) because it calls the now-removed `NodePath#toComputedKey()` under Babel 8's
+ * `@babel/traverse`. Behavior is otherwise identical to the upstream plugin.
+ *
+ * @param {import('@babel/core').PluginAPI} api
+ * @returns {import('@babel/core').PluginObject}
+ */
+export default function babelPluginInlineEnvironmentVariables({ types: t }: import('@babel/core').PluginAPI): import('@babel/core').PluginObject;

package/build/brokenLinksChecker/index.d.mts

@@ -1,40 +1,103 @@
 export type LinkStructure = Map<string, Set<string>>;
 export type SerializedLinkStructure = {
+    /**
+     * - Object mapping page URLs to arrays of target IDs
+     */
     targets: Record<string, string[]>;
 };
 export type CrawlWorkerInput = {
+    /**
+     * - The page URL to crawl
+     */
     pageUrl: string;
+    /**
+     * - Fully resolved crawl options
+     */
     options: ResolvedCrawlOptions;
 };
 export type CrawlWorkerPageData = {
+    /**
+     * - The normalized page URL
+     */
     url: string;
+    /**
+     * - HTTP status code
+     */
     status: number;
+    /**
+     * - Array of anchor targets (e.g., '#intro')
+     */
     targets: string[];
+    /**
+     * - Content-type of the page
+     */
     contentType: string;
 };
 export type CrawlWorkerOutput = {
+    /**
+     * - Serialized page data
+     */
     pageData: CrawlWorkerPageData;
+    /**
+     * - Links discovered on the page
+     */
     links: Link[];
+    /**
+     * - HTML validation results, or null if validation was skipped/passed
+     */
     htmlValidateResults: {
         pageUrl: string;
         results: import('html-validate').Result[];
     } | null;
 };
 export type PageData = {
+    /**
+     * - The normalized page URL (without trailing slash unless root)
+     */
     url: string;
+    /**
+     * - HTTP status code from the response (e.g., 200, 404, 500)
+     */
     status: number;
+    /**
+     * - Set of available anchor targets on the page, keyed by hash (e.g., '#intro')
+     */
     targets: Set<string>;
+    /**
+     * - Content-type of the page (e.g., 'text/html', 'text/markdown')
+     */
     contentType: string;
 };
 export type Link = {
+    /**
+     * - URL of the page where this link was found, or null for seed URLs
+     */
     src: string | null;
+    /**
+     * - Accessible name/text content of the link element, or null for seed URLs
+     */
     text: string | null;
+    /**
+     * - The href attribute value (may be relative or absolute, with or without hash)
+     */
     href: string;
+    /**
+     * - Content-type of the source page (e.g., 'text/html', 'text/markdown')
+     */
     contentType?: string | null;
 };
 export type IgnoreRule = {
+    /**
+     * - Pattern(s) to match source page path
+     */
     path?: (string | RegExp) | (string | RegExp)[];
+    /**
+     * - Pattern(s) to match broken link href
+     */
     href?: (string | RegExp) | (string | RegExp)[];
+    /**
+     * - Pattern(s) to match source page content-type
+     */
     contentType?: (string | RegExp) | (string | RegExp)[];
 };
 export type NormalizedIgnoreRule = {
@@ -43,22 +106,67 @@ export type NormalizedIgnoreRule = {
     contentType: (string | RegExp)[] | undefined;
 };
 export type CrawlOptions = {
+    /**
+     * - Shell command to start the dev server (e.g., 'npm run dev'). If null, assumes server is already running
+     */
     startCommand?: string | null;
+    /**
+     * - Base URL of the site to crawl (e.g., 'http://localhost:3000')
+     */
     host: string;
+    /**
+     * - File path to write discovered link targets to. If null, targets are not persisted
+     */
     outPath?: string | null;
+    /**
+     * - Array of regex patterns to exclude from crawling (e.g., [/^\/api\//] to skip /api/* routes)
+     */
     ignoredPaths?: RegExp[];
+    /**
+     * - CSS selectors for elements whose nested links should be ignored (e.g., ['.sidebar', 'footer'])
+     */
     ignoredContent?: string[];
+    /**
+     * - Set of element IDs to ignore as link targets (defaults to '__next', '__NEXT_DATA__')
+     */
     ignoredTargets?: Set<string>;
+    /**
+     * - Pre-populated map of known valid targets to skip crawling (useful for external pages)
+     */
     knownTargets?: Map<string, Set<string>>;
+    /**
+     * - URLs to fetch known targets from (fetched JSON will be merged with knownTargets)
+     */
     knownTargetsDownloadUrl?: string[];
+    /**
+     * - Number of concurrent page fetches (defaults to 4)
+     */
     concurrency?: number;
+    /**
+     * - Starting URLs for the crawl (defaults to ['/'])
+     */
     seedUrls?: string[];
+    /**
+     * - Rules to ignore broken links. Each rule can have path, href, contentType, and/or has properties. All specified properties must match (AND logic). Within a property, multiple values use OR logic.
+     */
     ignores?: IgnoreRule[];
+    /**
+     * - Enable HTML validation on crawled pages. `false` (default): disabled. `true`: validate with recommended rules. Object: use as html-validate config — `mui:recommended` is always applied as the baseline, so most callers only need to set `rules`. Array: per-path config overrides — `mui:recommended` is applied once as the baseline and every entry whose `path` matches the page URL is layered on top; later matching entries win on conflicting rule keys. If an entry omits `extends`, it behaves like a rule patch and typically only changes the rules it names. If an entry includes `extends` (for example, re-extending `mui:recommended`), it can re-introduce or reset baseline presets rather than acting as a pure patch. An entry without `path` matches every page. If no entry matches, the page is not validated.
+     */
     htmlValidate?: HtmlValidateOption;
+    /**
+     * - Log extra diagnostics during crawling (e.g. resolved html-validate config per page). Defaults to `false`.
+     */
     verbose?: boolean;
 };
 export type HtmlValidateOverride = {
+    /**
+     * - Pattern(s) to match the page URL. Strings use exact match. Omit to match every page.
+     */
     path?: (string | RegExp) | (string | RegExp)[];
+    /**
+     * - html-validate config (or `true` for `mui:recommended`).
+     */
     config: true | import('html-validate').ConfigData;
 };
 export type HtmlValidateOption = boolean | import('html-validate').ConfigData | HtmlValidateOverride[];
@@ -71,26 +179,65 @@ export type ResolvedCrawlOptions = Omit<Required<CrawlOptions>, 'ignores' | 'htm
     htmlValidate: ResolvedHtmlValidateEntry[];
 };
 export type BrokenLinkIssue = {
+    /**
+     * - Type of issue: 'broken-link' for 404 pages, 'broken-target' for missing anchors
+     */
     type: 'broken-link' | 'broken-target';
+    /**
+     * - Human-readable description of the issue (e.g., 'Target not found', 'Page returned error 404')
+     */
     message: string;
+    /**
+     * - The link object that has the issue
+     */
     link: Link;
 };
 export type HtmlValidateIssue = {
+    /**
+     * - Issue type discriminator
+     */
     type: 'html-validate';
+    /**
+     * - Human-readable description of the issue
+     */
     message: string;
+    /**
+     * - The page URL where the issue was found
+     */
     pageUrl: string;
+    /**
+     * - The html-validate rule that triggered this issue (e.g., 'no-dup-id')
+     */
     ruleId: string;
+    /**
+     * - Severity level (1 = warning, 2 = error)
+     */
     severity: number;
+    /**
+     * - Source location of the issue
+     */
     location: {
         line: number;
         column: number;
     };
+    /**
+     * - DOM selector for the element, or null
+     */
     selector: string | null;
 };
 export type Issue = BrokenLinkIssue | HtmlValidateIssue;
 export type CrawlResult = {
+    /**
+     * - All links discovered during the crawl
+     */
     links: Set<Link>;
+    /**
+     * - All pages crawled, keyed by normalized URL
+     */
     pages: Map<string, PageData>;
+    /**
+     * - All issues found (broken links, broken targets, and HTML validation issues)
+     */
     issues: Issue[];
 };
 /**

package/build/changelog/fetchChangelogs.d.mts

@@ -4,6 +4,9 @@ export type FetchCommitsOptions = {
     repo: string;
     lastRelease: string;
     release: string;
+    /**
+     * - GitHub organization name, defaults to 'mui'
+     */
     org?: string;
 };
 /**

package/build/cli/cmdArgosPush.d.mts

@@ -1,6 +1,12 @@
 #!/usr/bin/env node
 export type Args = {
+    /**
+     * - Run with verbose logging
+     */
     verbose?: boolean;
+    /**
+     * - Screenshots folder path
+     */
     folder: string;
 };
 /**

package/build/cli/cmdBuild.d.mts

@@ -1,18 +1,63 @@
 export type Args = {
+    /**
+     * - The bundles to build.
+     */
     bundle: import('../utils/build.mjs').BundleType[];
+    /**
+     * - The large files to build.
+     */
     hasLargeFiles: boolean;
+    /**
+     * - Whether to skip generating a package.json file in the /esm folder.
+     */
     skipBundlePackageJson: boolean;
+    /**
+     * - Whether to enable verbose logging.
+     */
     verbose: boolean;
+    /**
+     * - Whether to build types for the package.
+     */
     buildTypes: boolean;
+    /**
+     * - Whether to build types for the package.
+     */
     skipTsc: boolean;
+    /**
+     * - Whether to skip checking for Babel runtime dependencies in the package.
+     */
     skipBabelRuntimeCheck: boolean;
+    /**
+     * - Whether to skip generating the package.json file in the bundle output.
+     */
     skipPackageJson: boolean;
+    /**
+     * - Whether to skip checking for main field in package.json.
+     */
     skipMainCheck: boolean;
+    /**
+     * - Globs to be ignored by Babel.
+     */
     ignore: string[];
+    /**
+     * - Files/Directories to be copied. Can be a glob pattern.
+     */
     copy?: string[];
+    /**
+     * - Whether to use the React compiler.
+     */
     enableReactCompiler?: boolean;
+    /**
+     * - Whether to build types using the native TypeScript compiler.
+     */
     tsgo?: boolean;
+    /**
+     * - Deprecated no-op; flat builds are always used.
+     */
     flat?: boolean;
+    /**
+     * - Whether to enumerate glob patterns in exports/imports into concrete entries.
+     */
     expand: boolean;
 };
 declare const _default: import('yargs').CommandModule<{}, Args>;

package/build/cli/cmdCopyFiles.d.mts

@@ -1,7 +1,19 @@
 export type Args = {
+    /**
+     * Run in silent mode without logging
+     */
     silent?: boolean;
+    /**
+     * Exclude default files from the copy operation
+     */
     excludeDefaults?: boolean;
+    /**
+     * Glob patterns to copy
+     */
     glob?: string[];
+    /**
+     * Extra files to copy
+     */
     files?: string[];
 };
 declare const _default: import('yargs').CommandModule<{}, Args>;

package/build/cli/cmdGenerateChangelog.d.mts

@@ -1,8 +1,23 @@
 export type Args = {
+    /**
+     * Path to the changelog configuration file
+     */
     config: string;
+    /**
+     * The git reference (tag/commit) of the last release
+     */
     lastRelease: string;
+    /**
+     * The git reference (tag/commit) of the new release
+     */
     release: string;
+    /**
+     * The version number for the new release
+     */
     releaseVersion: string;
+    /**
+     * The current working directory to run the command in
+     */
     cwd: string;
 };
 /**

package/build/cli/cmdListWorkspaces.d.mts

@@ -1,15 +1,27 @@
 #!/usr/bin/env node
 export type PublicPackage = import('../utils/pnpm.mjs').PublicPackage;
 export type Args = {
+    /**
+     * - Whether to filter to only public packages
+     */
     publicOnly?: boolean;
-    output?: 'json' | 'path' | 'name' | 'publish-dir';
+    /**
+     * - Output format (name, path, or json)
+     */
+    output?: 'json' | 'path' | 'name';
+    /**
+     * - Git reference to filter changes since
+     */
     sinceRef?: string;
+    /**
+     * - Same as filtering packages with --filter in pnpm. Only include packages matching the filter. See https://pnpm.io/filtering.
+     */
     filter?: string[];
 };
 /**
  * @typedef {Object} Args
  * @property {boolean} [publicOnly] - Whether to filter to only public packages
- * @property {'json'|'path'|'name'|'publish-dir'} [output] - Output format (name, path, or json)
+ * @property {'json'|'path'|'name'} [output] - Output format (name, path, or json)
  * @property {string} [sinceRef] - Git reference to filter changes since
  * @property {string[]} [filter] - Same as filtering packages with --filter in pnpm. Only include packages matching the filter. See https://pnpm.io/filtering.
  */

package/build/cli/cmdNetlifyIgnore.d.mts

@@ -1,7 +1,16 @@
 #!/usr/bin/env node
 export type Args = {
+    /**
+     * - List of workspace names to process
+     */
     workspaces: string[];
+    /**
+     * - Check mode - error if the generated content differs from current
+     */
     check?: boolean;
+    /**
+     * - Branch to compare PRs against (default: master)
+     */
     baseBranch?: string;
 };
 declare const _default: import('yargs').CommandModule<{}, Args>;

package/build/cli/cmdPublish.d.mts

@@ -3,11 +3,29 @@ export type PublicPackage = import('../utils/pnpm.mjs').PublicPackage;
 export type PublishOptions = import('../utils/pnpm.mjs').PublishOptions;
 export type PublishSummaryEntry = import('../utils/pnpm.mjs').PublishSummaryEntry;
 export type Args = {
-    dry-run: boolean;
-    github-release: boolean;
+    /**
+     * Run in dry-run mode without publishing
+     */
+    "dry-run": boolean;
+    /**
+     * Create a GitHub draft release after publishing
+     */
+    "github-release": boolean;
+    /**
+     * NPM dist tag to publish to
+     */
     tag: string;
+    /**
+     * Runs in CI environment
+     */
     ci: boolean;
+    /**
+     * Git SHA to use for the GitHub release workflow (local only)
+     */
     sha?: string;
+    /**
+     * Same as filtering packages with --filter in pnpm. Only publish packages matching the filter. See https://pnpm.io/filtering.
+     */
     filter?: string[];
 };
 declare const _default: import('yargs').CommandModule<{}, Args>;

package/build/cli/cmdPublishCanary.d.mts

@@ -3,13 +3,31 @@ export type PublicPackage = import('../utils/pnpm.mjs').PublicPackage;
 export type VersionInfo = import('../utils/pnpm.mjs').VersionInfo;
 export type PublishOptions = import('../utils/pnpm.mjs').PublishOptions;
 export type Args = {
+    /**
+     * - Whether to run in dry-run mode
+     */
     dryRun?: boolean;
+    /**
+     * - Whether to create GitHub releases for canary packages
+     */
     githubRelease?: boolean;
+    /**
+     * - Same as filtering packages with --filter in pnpm. Only publish packages matching the filter. See https://pnpm.io/filtering.
+     */
     filter?: string[];
 };
 export type Commit = {
+    /**
+     * - Commit SHA
+     */
     sha: string;
+    /**
+     * - Commit message
+     */
     message: string;
+    /**
+     * - Commit author
+     */
     author: string;
 };
 declare const _default: import('yargs').CommandModule<{}, Args>;

package/build/cli/cmdPublishNewPackage.d.mts

@@ -1,5 +1,11 @@
 export type Args = {
+    /**
+     * If true, will only log the commands without executing them
+     */
     dryRun?: boolean;
+    /**
+     * 6 digit auth code to forward to npm for two-factor authentication
+     */
     otp?: string;
 };
 /**

package/build/cli/cmdRenameScope.d.mts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+export type Args = {
+    /**
+     * Source and target scope
+     */
+    alias: [string, string];
+};
+/**
+ * @typedef {Object} Args
+ * @property {[string, string]} alias Source and target scope
+ */
+/**
+ * @param {string} alias
+ * @returns {[string, string]}
+ */
+export declare function parseAlias(alias: string): [string, string];
+declare const _default: import('yargs').CommandModule<{}, Args>;
+export default _default;

package/build/cli/cmdSetVersionOverrides.d.mts

@@ -1,5 +1,8 @@
 #!/usr/bin/env node
 export type Args = {
+    /**
+     * - Package version specifiers in format 'package@version'
+     */
     pkg?: string[];
 };
 declare const _default: import('yargs').CommandModule<{}, Args>;

package/build/eslint/mui/rules/no-restricted-resolved-imports.d.mts

@@ -1,5 +1,11 @@
 export type PatternConfig = {
+    /**
+     * - The pattern to match against resolved imports
+     */
     pattern: string;
+    /**
+     * - Custom message to show when the pattern matches
+     */
     message?: string;
 };
 /**

package/build/eslint/testConfig.d.mts

@@ -3,12 +3,6 @@
  */
 export declare const baseSpecRules: import('eslint').Linter.Config;
 /**
- * @param {Object} [options]
- * @param {boolean} [options.useMocha]
- * @param {boolean} [options.useVitest]
  * @returns {import('eslint').Linter.Config[]}
  */
-export declare function createTestConfig(options?: {
-    useMocha?: boolean;
-    useVitest?: boolean;
-}): import('eslint').Linter.Config[];
+export declare function createTestConfig(): import('eslint').Linter.Config[];

package/build/utils/babel.d.mts

@@ -15,7 +15,13 @@ export declare function cjsCopy({ from, to }: {
     to: string;
 }): Promise<void>;
 export type ErrorCodeMetadata = {
+    /**
+     * - The path where the error code file should be written.
+     */
     outputPath: string;
+    /**
+     * - The runtime module to replace the errors with.
+     */
     runtimeModule?: string;
 };
 /**

package/build/utils/build.d.mts

@@ -2,6 +2,9 @@ export type BundleType = 'esm' | 'cjs';
 export type BundleMeta = {
     type: BundleType;
     dir: string;
+    /**
+     * - The package.json condition this bundle maps to.
+     */
     condition: 'import' | 'require';
     outExtension: string;
     typeOutExtension: string;
@@ -104,18 +107,3 @@ export declare function markFn<F extends () => Promise<any>>(label: string, fn:
  * @param {string} label
  */
 export declare function measureFn(label: string): PerformanceMeasure;
-/**
- * A utility to map a function over an array of items in a worker pool.
- *
- * This function will create a pool of workers and distribute the items to be processed among them.
- * Each worker will process items sequentially, but multiple workers will run in parallel.
- *
- * @function
- * @template T
- * @template R
- * @param {T[]} items
- * @param {(item: T) => Promise<R>} mapper
- * @param {number} concurrency
- * @returns {Promise<(R|Error)[]>}
- */
-export declare function mapConcurrently<T, R>(items: T[], mapper: (item: T) => Promise<R>, concurrency: number): Promise<(R | Error)[]>;

package/build/utils/extractErrorCodes.d.mts

@@ -1,8 +1,24 @@
 export type Args = {
+    /**
+     * - The output path to write the extracted error codes.
+     */
     errorCodesPath: string;
+    /**
+     * - List of package names to skip. By default, all workspace packages are considered.
+     */
     skip?: string[];
+    /**
+     * - The detection strategy to use when extracting error codes.
+     */
     detection?: import('@mui/internal-babel-plugin-minify-errors').Options['detection'];
 };
+/**
+ * Extracts error codes from all files in a directory.
+ * @param {string[]} files
+ * @param {Set<string | Error>} errors
+ * @param {import('@mui/internal-babel-plugin-minify-errors').Options['detection']} [detection='opt-in']
+ */
+export declare function extractErrorCodesForFiles(files: string[], errors: Set<string | Error>, detection?: import('@mui/internal-babel-plugin-minify-errors').Options['detection']): Promise<void>;
 /**
  * Extracts error codes from all workspace packages.
  * @param {Args} args