@mui/internal-code-infra 0.0.3-canary.81 → 0.0.3-canary.83

package/build/changelog/buildSections.d.mts

@@ -0,0 +1,19 @@
+/**
+ * @typedef {import('./types.ts').CategorizedCommit} CategorizedCommit
+ * @typedef {import('./types.ts').ChangelogSection} ChangelogSection
+ * @typedef {import('./types.ts').CategorizationConfig} CategorizationConfig
+ * @typedef {import('./types.ts').PlanInheritanceConfig} PlanInheritanceConfig
+ */
+/**
+ * Builds ordered changelog sections from categorized commits.
+ *
+ * @param {Map<string, CategorizedCommit[]>} categorizedCommits - Map of category key to commits
+ * @param {CategorizationConfig} categorizationConfig - Categorization configuration
+ * @param {Map<string, string>} [packageVersions] - Map of package name to version
+ * @returns {ChangelogSection[]} Ordered sections
+ */
+export function buildSections(categorizedCommits: Map<string, CategorizedCommit[]>, categorizationConfig: CategorizationConfig, packageVersions?: Map<string, string>): ChangelogSection[];
+export type CategorizedCommit = import("./types.ts").CategorizedCommit;
+export type ChangelogSection = import("./types.ts").ChangelogSection;
+export type CategorizationConfig = import("./types.ts").CategorizationConfig;
+export type PlanInheritanceConfig = import("./types.ts").PlanInheritanceConfig;

package/build/changelog/categorizeCommits.d.mts

@@ -0,0 +1,18 @@
+/**
+ * @typedef {import('./types.ts').FetchedCommitDetails} FetchedCommitDetails
+ * @typedef {import('./types.ts').CategorizedCommit} CategorizedCommit
+ * @typedef {import('./types.ts').CategorizationConfig} CategorizationConfig
+ */
+/**
+ * Categorizes commits based on the configuration strategy.
+ * A commit with multiple scope/component labels will appear in multiple sections.
+ *
+ * @param {FetchedCommitDetails[]} commits - Commits to categorize
+ * @param {CategorizationConfig} config - Categorization configuration
+ * @returns {Map<string, CategorizedCommit[]>} Map of category key to commits
+ * @throws {Error} If a required label is missing or package mapping not found
+ */
+export function categorizeCommits(commits: FetchedCommitDetails[], config: CategorizationConfig): Map<string, CategorizedCommit[]>;
+export type FetchedCommitDetails = import("./types.ts").FetchedCommitDetails;
+export type CategorizedCommit = import("./types.ts").CategorizedCommit;
+export type CategorizationConfig = import("./types.ts").CategorizationConfig;

package/build/{utils/changelog.d.mts → changelog/fetchChangelogs.d.mts}

@@ -2,16 +2,7 @@
  * @typedef {import('@octokit/rest').Octokit} OctokitType
  */
 /**
- * @typedef {'team' | 'first_timer' | 'contributor'} AuthorAssociation
- */
-/**
- * @typedef {Object} FetchedCommitDetails
- * @property {string} sha
- * @property {string} message
- * @property {string[]} labels
- * @property {number} prNumber
- * @property {string} html_url
- * @property {{login: string; association: AuthorAssociation} | null} author
+ * @typedef {import('./types').FetchedCommitDetails} FetchedCommitDetails
  */
 /**
  * @typedef {Object} FetchCommitsOptions
@@ -41,18 +32,7 @@ export function fetchCommitsBetweenRefs(opts: FetchCommitsOptions & {
     octokit?: OctokitType;
 }): Promise<FetchedCommitDetails[]>;
 export type OctokitType = import("@octokit/rest").Octokit;
-export type AuthorAssociation = "team" | "first_timer" | "contributor";
-export type FetchedCommitDetails = {
-    sha: string;
-    message: string;
-    labels: string[];
-    prNumber: number;
-    html_url: string;
-    author: {
-        login: string;
-        association: AuthorAssociation;
-    } | null;
-};
+export type FetchedCommitDetails = import("./types").FetchedCommitDetails;
 export type FetchCommitsOptions = {
     repo: string;
     lastRelease: string;

package/build/changelog/filterCommits.d.mts

@@ -0,0 +1,14 @@
+/**
+ * @typedef {import('./types.ts').FetchedCommitDetails} FetchedCommitDetails
+ * @typedef {import('./types.ts').FilterConfig} FilterConfig
+ */
+/**
+ * Filters commits based on the configuration.
+ *
+ * @param {FetchedCommitDetails[]} commits - Commits to filter
+ * @param {FilterConfig} [filterConfig] - Filter configuration
+ * @returns {FetchedCommitDetails[]} Filtered commits
+ */
+export function filterCommits(commits: FetchedCommitDetails[], filterConfig?: FilterConfig): FetchedCommitDetails[];
+export type FetchedCommitDetails = import("./types.ts").FetchedCommitDetails;
+export type FilterConfig = import("./types.ts").FilterConfig;

package/build/changelog/generateChangelog.d.mts

@@ -0,0 +1,15 @@
+/**
+ * @typedef {import('./types.ts').GenerateChangelogOptions} GenerateChangelogOptions
+ * @typedef {import('./types.ts').GenerateChangelogResult} GenerateChangelogResult
+ * @typedef {import('./types.ts').ChangelogConfig} ChangelogConfig
+ */
+/**
+ * Generates a changelog for a release.
+ *
+ * @param {GenerateChangelogOptions} options - Options for generating the changelog
+ * @returns {Promise<GenerateChangelogResult>} Changelog result with markdown and sections
+ */
+export function generateChangelog(options: GenerateChangelogOptions): Promise<GenerateChangelogResult>;
+export type GenerateChangelogOptions = import("./types.ts").GenerateChangelogOptions;
+export type GenerateChangelogResult = import("./types.ts").GenerateChangelogResult;
+export type ChangelogConfig = import("./types.ts").ChangelogConfig;

package/build/changelog/index.d.mts

@@ -0,0 +1,3 @@
+export { generateChangelog } from "./generateChangelog.mjs";
+export * from "./loadChangelogConfig.mjs";
+export * from "./fetchChangelogs.mjs";

package/build/changelog/loadChangelogConfig.d.mts

@@ -0,0 +1,13 @@
+/**
+ * @typedef {import('./types.ts').ChangelogConfig} ChangelogConfig
+ */
+/**
+ * Loads changelog configuration from a file.
+ *
+ * @param {string} configPath - Path to config file (relative or absolute)
+ * @param {string} [cwd] - Current working directory
+ * @returns {Promise<ChangelogConfig>} Loaded configuration
+ * @throws {Error} If config file doesn't exist or is invalid
+ */
+export function loadChangelogConfig(configPath: string, cwd?: string): Promise<ChangelogConfig>;
+export type ChangelogConfig = import("./types.ts").ChangelogConfig;

package/build/changelog/parseCommitLabels.d.mts

@@ -0,0 +1,13 @@
+/**
+ * Parses labels from a commit and extracts scopes, components, plan, category overrides, and flags.
+ * Supports multiple scope and component labels - the commit will appear in all matching sections.
+ * Mutates the commit's labels to include any extracted from the title.
+ *
+ * @param {FetchedCommitDetails} commit - The commit to parse labels from
+ * @param {LabelConfig} labelConfig - Configuration for label parsing
+ * @returns {ParsedLabels} Parsed label information
+ */
+export function parseCommitLabels(commit: FetchedCommitDetails, labelConfig: LabelConfig): ParsedLabels;
+export type FetchedCommitDetails = import("./types.ts").FetchedCommitDetails;
+export type ParsedLabels = import("./types.ts").ParsedLabels;
+export type LabelConfig = import("./types.ts").LabelConfig;

package/build/changelog/renderChangelog.d.mts

@@ -0,0 +1,32 @@
+/**
+ * Formats changelog sections into markdown.
+ *
+ * @param {ChangelogSection[]} sections - Changelog sections
+ * @param {ChangelogConfig} config - Changelog configuration
+ * @param {import('./types.js').GenerateChangelogOptions} options - Generate changelog options
+ * @param {{team: string[], community: string[], all: string[]}} contributors - Contributors
+ * @returns {string} Formatted changelog markdown
+ */
+export function renderChangelog(sections: ChangelogSection[], config: ChangelogConfig, options: import("./types.js").GenerateChangelogOptions, contributors: {
+    team: string[];
+    community: string[];
+    all: string[];
+}): string;
+/**
+ * Extracts contributors from all commits, excluding only those matching excludeAuthors.
+ * This is used to credit all contributors, even if their commits were filtered out
+ * for other reasons (like missing labels or being in excludeLabels).
+ *
+ * @param {import('./types.js').FetchedCommitDetails[]} allCommits - All fetched commits
+ * @param {(string|RegExp)[]} [excludeAuthors] - Author patterns to exclude (e.g., ['[bot]'])
+ * @returns {{team: string[], community: string[]; all: string[]}} Contributors grouped by type
+ */
+export function extractContributorsFromAllCommits(allCommits: import("./types.js").FetchedCommitDetails[], excludeAuthors?: (string | RegExp)[]): {
+    team: string[];
+    community: string[];
+    all: string[];
+};
+export type ChangelogSection = import("./types.js").ChangelogSection;
+export type CategorizedCommit = import("./types.js").CategorizedCommit;
+export type ChangelogConfig = import("./types.js").ChangelogConfig;
+export type GenerateChangelogResult = import("./types.js").GenerateChangelogResult;

package/build/changelog/sortSections.d.mts

@@ -0,0 +1,16 @@
+/**
+ * @typedef {import('./types.ts').ChangelogSection} ChangelogSection
+ * @typedef {import('./types.ts').CategorizationConfig} CategorizationConfig
+ */
+/**
+ * Sorts changelog sections based on configured order priority.
+ * Sections with lower order index appear first.
+ * When two sections have the same order index, they are sorted alphabetically by title.
+ *
+ * @param {ChangelogSection[]} sections - Sections to sort
+ * @param {CategorizationConfig} config - Categorization configuration containing order
+ * @returns {ChangelogSection[]} Sorted sections
+ */
+export function sortSections(sections: ChangelogSection[], config: CategorizationConfig): ChangelogSection[];
+export type ChangelogSection = import("./types.ts").ChangelogSection;
+export type CategorizationConfig = import("./types.ts").CategorizationConfig;

package/build/changelog/types.d.ts

@@ -0,0 +1,390 @@
+/**
+ * Commit details fetched from GitHub including PR information and labels.
+ */
+export interface FetchedCommitDetails {
+    sha: string;
+    message: string;
+    labels: string[];
+    prNumber: number;
+    html_url: string;
+    author: {
+        login: string;
+        association: 'team' | 'first_timer' | 'contributor';
+    } | null;
+    mergedAt: string | null;
+    createdAt: string | null;
+}
+/**
+ * Parsed label information from a commit.
+ */
+export interface ParsedLabels {
+    /**
+     * Scope values from labels (e.g., from 'scope: data-grid', 'scope: charts').
+     * Multiple scopes mean the commit should appear in multiple sections.
+     */
+    scopes: string[];
+    /**
+     * Component values from labels (e.g., from 'component: checkbox', 'component: radio').
+     * Multiple components mean the commit should appear in multiple sections.
+     */
+    components: string[];
+    plan?: string;
+    flags: string[];
+    /**
+     * Category override from a label (e.g., 'all components' -> 'General changes').
+     * This overrides the normal categorization logic.
+     */
+    categoryOverride?: string;
+}
+/**
+ * A commit with parsed label information.
+ */
+export interface CategorizedCommit extends FetchedCommitDetails {
+    parsed: ParsedLabels;
+}
+/**
+ * Configuration for label parsing.
+ */
+export interface LabelConfig {
+    plan: {
+        values: string[];
+    };
+    scope?: {
+        prefix: string[];
+    };
+    component?: {
+        prefix: string[];
+    };
+    /**
+     * Category overrides - labels that override normal categorization.
+     * Maps label to section name.
+     * Example: { 'all components': 'General changes', 'docs': 'Docs' }
+     */
+    categoryOverrides?: Record<string, string>;
+    /**
+     * Explicit list of flag labels.
+     * Only labels in this list will be treated as flags.
+     * Example: ['breaking change', 'enhancement', 'bug']
+     */
+    flags?: Record<string, {
+        name: string;
+        prefix?: string;
+        suffix?: string;
+    }>;
+    extractLabelsFromTitle?: (commitMessage: string) => string[];
+}
+/**
+ * Package naming configuration for package-first strategy.
+ */
+export interface PackageNamingConfig {
+    /**
+     * Explicit mapping from scope label value to package name.
+     * Example: { 'data grid': '@mui/x-data-grid', 'charts': '@mui/x-charts' }
+     */
+    mappings: Record<string, string>;
+    /**
+     * Mappings for different plan variants.
+     * Maps plan name to a mapping of base package to plan-specific package.
+     * Example: {
+     *   'pro': { '@mui/x-charts': '@mui/x-charts-pro' },
+     *   'premium': { '@mui/x-charts': '@mui/x-charts-premium' },
+     *   'enterprise': { '@mui/x-charts': '@mui/x-charts-enterprise' }
+     * }
+     */
+    plans?: Record<string, Record<string, string>>;
+    /**
+     * Scope values that represent generic sections (not packages).
+     * These scopes won't go through package name resolution and will be used as-is for sections.
+     * Example: ['docs', 'code-infra', 'docs-infra']
+     */
+    genericScopes?: string[];
+}
+/**
+ * Configuration for categorizing commits into sections.
+ */
+export interface CategorizationConfig {
+    /**
+     * Primary categorization strategy.
+     * - 'component': Group by component name (For new repos with 1 or 2 packages)
+     * - 'package': Group by package name (For established repos with multiple packages)
+     */
+    strategy: 'component' | 'package';
+    /**
+     * Label configuration for parsing commit labels.
+     */
+    labels: LabelConfig;
+    /**
+     * Package naming configuration (required for 'package' strategy).
+     */
+    packageNaming?: PackageNamingConfig;
+    /**
+     * Section ordering and titles.
+     */
+    sections: {
+        /**
+         * Section ordering priority by title.
+         * Maps section title to order index (lower values appear first).
+         * Sections not in this map default to order index 0.
+         * When two sections have the same order index, they are sorted alphabetically by title.
+         */
+        order?: Record<string, number>;
+        /**
+         * Optional custom titles for sections.
+         * Maps section key to display title.
+         */
+        titles?: Record<string, string>;
+        /**
+         * Section name for commits that don't match any category.
+         */
+        fallbackSection: string;
+    };
+    /**
+     * Optional mapping from component label value to display name.
+     * Example: { 'pie': 'PieChart', 'bar': 'BarChart' }
+     */
+    componentNameMapping?: Record<string, string>;
+}
+/**
+ * Configuration for plan inheritance (pro/premium packages).
+ */
+export interface PlanInheritanceConfig {
+    enabled: boolean;
+    messages: {
+        same: string;
+        plus: string;
+    };
+}
+/**
+ * Configuration for version and date formatting.
+ */
+export interface FormatConfig {
+    /**
+     * Version format template.
+     * Use {{version}} placeholder, the value will be picked from workspace package.json.
+     *
+     * @default 'v{{version}}'
+     * @example `Release v{{version}}`
+     */
+    version?: string;
+    /**
+     * Date format (using common format tokens). Only the four tokens below are supported:
+     * - MMM: abbreviated month name (e.g., Jan, Feb, Mar)
+     * - MMMM: full month name (e.g., January, February)
+     * - DD: day of month (01 to 31)
+     * - YYYY: four-digit year (e.g., 2025)
+     *
+     * @default 'MMM DD, YYYY' (e.g., 'Aug 15 2025')
+     */
+    dateFormat?: string;
+    /**
+     * Format for PR and author attribution. Available placeholders:
+     * - {{message}}: Commit message (cleaned up first line)
+     * - {{rawMessage}}: Raw commit message (without cleanup and only the first line)
+     * - {{prNumber}}: Pull request number
+     * - {{prUrl}}: Pull request URL
+     * - {{author}}: Author username
+     * - {{scope}}: Scope value
+     * - {{plan}}: Plan value
+     *
+     * @example '{{message}} (#[{{prNumber}}]({{prUrl}}) by @{{author}})'
+     */
+    changelogMessage?: string | ((commit: CategorizedCommit) => string);
+    sectionTitle?: {
+        forPackage?: string;
+    };
+    planMessage?: {
+        same: string;
+        plus: string;
+    };
+    planBadge?: Record<string, string>;
+    showInternalChangesMessage?: boolean;
+}
+/**
+ * Configuration for intro section.
+ * The intro section appears after the version and date, before the changelog sections.
+ * It can include a thank you message and/or a highlights section with a placeholder for manual curation.
+ */
+export interface IntroConfig {
+    /**
+     * Thank you message to show at the start of the intro section.
+     * Supports placeholders:
+     * - {{contributorCount}}: Total number of contributors (team + community)
+     * - {{teamCount}}: Number of team members
+     * - {{communityCount}}: Number of community contributors
+     *
+     * Example: "We'd like to extend a big thank you to the {{contributorCount}} contributors who made this release possible"
+     *
+     * Set to `false` or omit to disable the thank you message.
+     */
+    thanksMessage?: string;
+    /**
+     * Optional prefix text for the highlights section.
+     * When provided, adds a highlights section with placeholder comments for manual curation.
+     *
+     * Example: "Here are some highlights ✨:"
+     */
+    highlightsPrefix?: string;
+}
+export type PluralizedMessage = string | {
+    many: string;
+    one: string;
+};
+/**
+ * Configuration for contributors section.
+ */
+export interface ContributorsConfig {
+    /**
+     * Disable the contributors section entirely.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Custom message template for the contributors section (when splitByType is false).
+     * Supports {contributors} placeholder.
+     * Example: "All contributors of this release in alphabetical order: {contributors}"
+     */
+    message?: {
+        contributors?: PluralizedMessage;
+        team?: PluralizedMessage;
+        community?: PluralizedMessage;
+    };
+    /**
+     * Add contributors list after the intro section instead of at the end.
+     * If true, contributors appear immediately after the intro (before changelog sections).
+     * If false (default), contributors appear at the end (after all changelog sections).
+     *
+     * @default false
+     */
+    addContributorsToIntro?: boolean;
+}
+/**
+ * Configuration for filtering commits.
+ */
+export interface FilterConfig {
+    /**
+     * Exclude commits where author username matches any of these patterns.
+     * Supports string matching and regular expressions.
+     * Example: ['[bot]', 'dependabot'] will exclude any author ending with [bot] or named dependabot.
+     */
+    excludeCommitByAuthors?: (RegExp | string)[];
+    /**
+     * Exclude these authors from being shown in the intro thank you message.
+     * Supports string matching and regular expressions.
+     */
+    excludeAuthorsFromContributors?: (RegExp | string)[];
+    /**
+     * Exclude commits that have any of these labels.
+     * Example: ['skip-changelog', 'internal']
+     */
+    excludeCommitWithLabels?: (RegExp | string)[];
+    /**
+     * Custom filter function for advanced filtering.
+     * Return false to exclude a commit from the changelog.
+     */
+    customFilter?: (commit: FetchedCommitDetails) => boolean;
+    /**
+     * Show "Internal changes." for packages where all commits were filtered out.
+     * When true, packages with filtered commits will appear in the changelog with "Internal changes." message.
+     * When false (default), packages with all commits filtered are omitted entirely.
+     *
+     * @default false
+     */
+    showFilteredPackages?: boolean;
+}
+/**
+ * Complete changelog configuration.
+ */
+export interface ChangelogConfig {
+    format?: FormatConfig;
+    intro?: IntroConfig;
+    contributors?: ContributorsConfig;
+    categorization: CategorizationConfig;
+    filter?: FilterConfig;
+}
+/**
+ * A section in the changelog.
+ */
+export interface ChangelogSection {
+    /**
+     * Section key (package name or component name).
+     */
+    key: string;
+    /**
+     * Package version (if applicable).
+     */
+    pkgInfo: {
+        name: string;
+        version?: string;
+        plan?: string;
+    } | null;
+    /**
+     * Heading level (2 for top-level, 3 for packages, 4 for sub-sections).
+     */
+    level: number;
+    /**
+     * Commits in this section.
+     */
+    commits: CategorizedCommit[];
+    /**
+     * Sub-sections (for package-first with pro/premium).
+     */
+    subsections?: ChangelogSection[];
+}
+/**
+ * Options for generating a changelog.
+ */
+export interface GenerateChangelogOptions {
+    /**
+     * Repository name (e.g., 'mui-x').
+     */
+    repo: string;
+    /**
+     * GitHub organization name (default: 'mui').
+     */
+    org?: string;
+    /**
+     * Last release tag or commit ref.
+     */
+    lastRelease: string;
+    /**
+     * Current release tag or commit ref.
+     */
+    release: string;
+    /**
+     * Version string for the changelog (e.g., '8.19.0').
+     */
+    version: string;
+    /**
+     * Release date (will be formatted according to config).
+     */
+    date: Date;
+    /**
+     * Changelog configuration (if not loading from file).
+     */
+    config: ChangelogConfig;
+    /**
+     * Current working directory to run commands in.
+     */
+    cwd?: string;
+}
+/**
+ * Result of changelog generation.
+ */
+export interface GenerateChangelogResult {
+    /**
+     * Formatted changelog markdown.
+     */
+    markdown: string;
+    /**
+     * Categorized sections.
+     */
+    sections: ChangelogSection[];
+    /**
+     * All contributors (for contributors section).
+     */
+    contributors: {
+        team: string[];
+        community: string[];
+        all: string[];
+    };
+}

package/build/cli/cmdGenerateChangelog.d.mts

@@ -0,0 +1,24 @@
+declare const _default: import("yargs").CommandModule<{}, Args>;
+export default _default;
+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/utils/babel.d.mts

@@ -17,7 +17,6 @@ export function cjsCopy({ from, to }: {
 /**
  * @typedef {Object} ErrorCodeMetadata
  * @property {string} outputPath - The path where the error code file should be written.
- * @property {'annotate' | 'throw' | 'write'} [missingError] - How to handle missing error codes.
  * @property {string} [runtimeModule] - The runtime module to replace the errors with.
  */
 /**
@@ -60,10 +59,6 @@ export type ErrorCodeMetadata = {
      * - The path where the error code file should be written.
      */
     outputPath: string;
-    /**
-     * - How to handle missing error codes.
-     */
-    missingError?: "throw" | "annotate" | "write" | undefined;
     /**
      * - The runtime module to replace the errors with.
      */

package/build/utils/git.d.mts

@@ -6,9 +6,10 @@
  */
 /**
  * Get current repository info from git remote
+ * @param {string} [cwd=process.cwd()]
  * @returns {Promise<RepoInfo>} Repository owner and name
  */
-export function getRepositoryInfo(): Promise<RepoInfo>;
+export function getRepositoryInfo(cwd?: string): Promise<RepoInfo>;
 /**
  * Get current git SHA
  * @returns {Promise<string>} Current git commit SHA

package/build/utils/pnpm.d.mts

@@ -235,4 +235,8 @@ export type GetWorkspacePackagesOptions = {
      * - Whether to filter to only non-published packages. It by default means public packages yet to be published.
      */
     nonPublishedOnly?: boolean | undefined;
+    /**
+     * - Current working directory to run pnpm command in
+     */
+    cwd?: string | undefined;
 };

package/build/utils/template.d.mts

@@ -0,0 +1,19 @@
+/**
+ * Simple template string replacement utility.
+ * Replaces placeholders like {{ key }} with values from an object.
+ * Handles spacing variations: {{key}}, {{ key}}, {{ key }} are all treated the same.
+ * If a value is undefined, the placeholder is removed from the output.
+ *
+ * @param {string} template - Template string with placeholders
+ * @param {Record<string, any>} values - Object with template values
+ * @returns {string} - Rendered string with placeholders replaced
+ *
+ * @example
+ * const result = templateString('Hello {{ name }}, version {{ version }}', { name: 'Alice' });
+ * // 'Hello Alice, version ' (version placeholder removed as it's undefined)
+ *
+ * @example
+ * const result = templateString('Release {{ version }}', { version: '1.0.0' });
+ * // 'Release 1.0.0'
+ */
+export function templateString(template: string, values: Record<string, any>): string;