[code-infra] Migrate error code extraction to code-infra

.markdownlint-cli2.mjs

@@ -0,0 +1,11 @@
+import { createBaseConfig } from '@mui/internal-code-infra/markdownlint';
+
+const baseConfig = createBaseConfig();
+
+export default {
+  ...baseConfig,
+  config: {
+    ...baseConfig.config,
+    MD038: false, // false poisitives in MDX
+  },
+};

babel.config.mjs

@@ -1,20 +1,22 @@
 import getBaseConfig from '@mui/internal-code-infra/babel-config';
+import * as path from 'node:path';
+import { fileURLToPath } from 'node:url';
 
-const errorCodesPath = new URL(import.meta.resolve('./docs/public/static/error-codes.json'))
-  .pathname;
-const missingError = process.env.MUI_EXTRACT_ERROR_CODES === 'true' ? 'write' : 'annotate';
+const dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const errorCodesPath = path.join(dirname, 'docs/src/error-codes.json');
 
 export default function getBabelConfig(api) {
   const baseConfig = getBaseConfig(api);
 
   const plugins = [
     [
-      'babel-plugin-macros',
+      '@mui/internal-babel-plugin-minify-errors',
       {
-        muiError: {
-          errorCodesPath,
-          missingError,
-        },
+        missingError: 'annotate',
+        runtimeModule: '#formatErrorMessage',
+        detection: 'opt-out',
+        errorCodesPath,
       },
     ],
   ];

docs/src/error-codes.json

@@ -0,0 +1,74 @@
+{
+  "1": "Unsupported number of selectors",
+  "2": "Unsupported number of arguments",
+  "3": "Base UI: CheckboxGroupContext is missing. CheckboxGroup parts must be placed within <CheckboxGroup>.",
+  "4": "Base UI: DirectionContext is missing.",
+  "5": "Base UI: MenubarContext is missing. Menubar parts must be placed within <Menubar>.",
+  "6": "Base UI: useToast must be used within <Toast.Provider>.",
+  "7": "Base UI: ToggleGroupContext is missing. ToggleGroup parts must be placed within <ToggleGroup>.",
+  "8": "Base UI: Render element or function are not defined.",
+  "9": "Base UI: AccordionItemContext is missing. Accordion parts must be placed within <Accordion.Item>.",
+  "10": "Base UI: AccordionRootContext is missing. Accordion parts must be placed within <Accordion.Root>.",
+  "11": "Base UI: <AlertDialog.Portal> is missing.",
+  "12": "Base UI: AlertDialogRootContext is missing. AlertDialog parts must be placed within <AlertDialog.Root>.",
+  "13": "Base UI: AvatarRootContext is missing. Avatar parts must be placed within <Avatar.Root>.",
+  "14": "Base UI: CheckboxRootContext is missing. Checkbox parts must be placed within <Checkbox.Root>.",
+  "15": "Base UI: CollapsibleRootContext is missing. Collapsible parts must be placed within <Collapsible.Root>.",
+  "16": "Base UI: CompositeRootContext is missing. Composite parts must be placed within <Composite.Root>.",
+  "17": "useComboboxChipContext must be used within a ComboboxChip",
+  "18": "Base UI: ComboboxGroupContext is missing. ComboboxGroup parts must be placed within <Combobox.Group>.",
+  "19": "Base UI: ComboboxItemContext is missing. ComboboxItem parts must be placed within <Combobox.Item>.",
+  "20": "Base UI: <Combobox.Portal> is missing.",
+  "21": "Base UI: <Combobox.Popup> and <Combobox.Arrow> must be used within the <Combobox.Positioner> component",
+  "22": "Base UI: ComboboxRootContext is missing. Combobox parts must be placed within <Combobox.Root>.",
+  "23": "Base UI: ComboboxFloatingContext is missing. Combobox parts must be placed within <Combobox.Root>.",
+  "24": "Base UI: ComboboxItemsContext is missing. Combobox parts must be placed within <Combobox.Root>.",
+  "25": "Base UI: ContextMenuRootContext is missing. ContextMenu parts must be placed within <ContextMenu.Root>.",
+  "26": "Base UI: <Dialog.Portal> is missing.",
+  "27": "Base UI: DialogRootContext is missing. Dialog parts must be placed within <Dialog.Root>.",
+  "28": "Base UI: FieldRootContext is missing. Field parts must be placed within <Field.Root>.",
+  "29": "[Floating UI]: Invalid grid - item width at index %s is greater than grid columns",
+  "30": "Base UI: MenuCheckboxItemContext is missing. MenuCheckboxItem parts must be placed within <Menu.CheckboxItem>.",
+  "31": "Base UI: MenuGroupRootContext is missing. Menu group parts must be used within <Menu.Group>.",
+  "32": "Base UI: <Menu.Portal> is missing.",
+  "33": "Base UI: MenuPositionerContext is missing. MenuPositioner parts must be placed within <Menu.Positioner>.",
+  "34": "Base UI: MenuRadioGroupContext is missing. MenuRadioGroup parts must be placed within <Menu.RadioGroup>.",
+  "35": "Base UI: MenuRadioItemContext is missing. MenuRadioItem parts must be placed within <Menu.RadioItem>.",
+  "36": "Base UI: MenuRootContext is missing. Menu parts must be placed within <Menu.Root>.",
+  "37": "Base UI: <Menu.SubmenuTrigger> must be placed in <Menu.SubmenuRoot>.",
+  "38": "Base UI: MeterRootContext is missing. Meter parts must be placed within <Meter.Root>.",
+  "39": "Base UI: NavigationMenuItem parts must be used within a <NavigationMenu.Item>.",
+  "40": "Base UI: <NavigationMenu.Portal> is missing.",
+  "41": "Base UI: NavigationMenuRootContext is missing. Navigation Menu parts must be placed within <NavigationMenu.Root>.",
+  "42": "Base UI: NavigationMenuPositionerContext is missing. NavigationMenuPositioner parts must be placed within <NavigationMenu.Positioner>.",
+  "43": "Base UI: NumberFieldRootContext is missing. NumberField parts must be placed within <NumberField.Root>.",
+  "44": "Base UI: NumberFieldScrubAreaContext is missing. NumberFieldScrubArea parts must be placed within <NumberField.ScrubArea>.",
+  "45": "Base UI: <Popover.Portal> is missing.",
+  "46": "Base UI: PopoverPositionerContext is missing. PopoverPositioner parts must be placed within <Popover.Positioner>.",
+  "47": "Base UI: PopoverRootContext is missing. Popover parts must be placed within <Popover.Root>.",
+  "48": "Base UI: <PreviewCard.Portal> is missing.",
+  "49": "Base UI: <PreviewCard.Popup> and <PreviewCard.Arrow> must be used within the <PreviewCard.Positioner> component",
+  "50": "Base UI: PreviewCardRootContext is missing. PreviewCard parts must be placed within <PreviewCard.Root>.",
+  "51": "Base UI: ProgressRootContext is missing. Progress parts must be placed within <Progress.Root>.",
+  "52": "Base UI: RadioRootContext is missing. Radio parts must be placed within <Radio.Root>.",
+  "53": "Base UI: ScrollAreaRootContext is missing. ScrollArea parts must be placed within <ScrollArea.Root>.",
+  "54": "Base UI: ScrollAreaScrollbarContext is missing. ScrollAreaScrollbar parts must be placed within <ScrollArea.Scrollbar>.",
+  "55": "Base UI: ScrollAreaViewportContext missing. ScrollAreaViewport parts must be placed within <ScrollArea.Viewport>.",
+  "56": "Base UI: SelectGroupContext is missing. SelectGroup parts must be placed within <Select.Group>.",
+  "57": "Base UI: SelectItemContext is missing. SelectItem parts must be placed within <Select.Item>.",
+  "58": "Base UI: <Select.Portal> is missing.",
+  "59": "Base UI: SelectPositionerContext is missing. SelectPositioner parts must be placed within <Select.Positioner>.",
+  "60": "Base UI: SelectRootContext is missing. Select parts must be placed within <Select.Root>.",
+  "61": "Base UI: SelectFloatingContext is missing. Select parts must be placed within <Select.Root>.",
+  "62": "Base UI: SliderRootContext is missing. Slider parts must be placed within <Slider.Root>.",
+  "63": "Base UI: SwitchRootContext is missing. Switch parts must be placed within <Switch.Root>.",
+  "64": "Base UI: TabsRootContext is missing. Tabs parts must be placed within <Tabs.Root>.",
+  "65": "Base UI: TabsListContext is missing. TabsList parts must be placed within <Tabs.List>.",
+  "66": "Base UI: ToastRootContext is missing. Toast parts must be used within <Toast.Root>.",
+  "67": "Base UI: ToastViewportContext is missing. Toast parts must be placed within <Toast.Viewport>.",
+  "68": "Base UI: ToolbarGroupContext is missing. ToolbarGroup parts must be placed within <Toolbar.Group>.",
+  "69": "Base UI: ToolbarRootContext is missing. Toolbar parts must be placed within <Toolbar.Root>.",
+  "70": "Base UI: <Tooltip.Portal> is missing.",
+  "71": "Base UI: TooltipPositionerContext is missing. TooltipPositioner parts must be placed within <Tooltip.Positioner>.",
+  "72": "Base UI: TooltipRootContext is missing. Tooltip parts must be placed within <Tooltip.Root>."
+}

package.json

@@ -20,7 +20,7 @@
     "docs:start": "pnpm --filter docs serve",
     "docs:link-check": "pnpm --filter docs link-check",
     "docs:generate-llms": "pnpm --filter docs run generate-llms",
-    "extract-error-codes": "cross-env MUI_EXTRACT_ERROR_CODES=true lerna run --concurrency 1 build:stable",
+    "extract-error-codes": "code-infra extract-error-codes --errorCodesPath docs/src/error-codes.json --detection opt-out",
     "jsonlint": "code-infra jsonlint",
     "eslint": "eslint . --cache --report-unused-disable-directives --ext .js,.ts,.tsx,.mts --max-warnings 0 && pnpm -r lint",
     "eslint:ci": "eslint . --report-unused-disable-directives --ext .js,.ts,.tsx,.mts --max-warnings 0 && pnpm -r lint",
@@ -65,6 +65,7 @@
     "@babel/node": "^7.28.0",
     "@babel/plugin-transform-react-constant-elements": "^7.27.1",
     "@base-ui-components/monorepo-tests": "workspace:*",
+    "@mui/internal-babel-plugin-minify-errors": "^2.0.8-canary.10",
     "@mui/internal-code-infra": "^0.0.3-canary.5",
     "@mui/internal-docs-utils": "^2.0.1",
     "@mui/internal-markdown": "^2.0.7",

packages/react/package.json

@@ -69,7 +69,8 @@
     "./use-render": "./src/use-render/index.ts"
   },
   "imports": {
-    "#test-utils": "./test/index.ts"
+    "#test-utils": "./test/index.ts",
+    "#formatErrorMessage": "@base-ui-components/utils/formatErrorMessage"
   },
   "type": "commonjs",
   "scripts": {

packages/utils/package.json

@@ -12,6 +12,9 @@
     "./store": "./src/store/index.ts",
     "./*": "./src/*.ts"
   },
+  "imports": {
+    "#formatErrorMessage": "./src/formatErrorMessage.ts"
+  },
   "type": "commonjs",
   "scripts": {
     "prebuild": "rimraf --glob build build-tests \"*.tsbuildinfo\"",

packages/utils/src/formatErrorMessage.ts

@@ -0,0 +1,14 @@
+/**
+ * WARNING: Don't import this directly. It's imported by the code generated by
+ * `@mui/interal-babel-plugin-minify-errors`. Make sure to always use string literals in `Error`
+ * constructors to ensure the plugin works as expected. Supported patterns include:
+ *   throw new Error('My message');
+ *   throw new Error(`My message: ${foo}`);
+ *   throw new Error(`My message: ${foo}` + 'another string');
+ *   ...
+ */
+export default function formatErrorMessage(code: number, ...args: string[]): string {
+  const url = new URL(`https://base-ui.com/production-error/${code}`);
+  args.forEach((arg) => url.searchParams.append('args[]', arg));
+  return `Base UI error #${code}; visit ${url} for the full message.`;
+}

packages/utils/src/store/createSelector.ts

@@ -125,7 +125,7 @@ export const createSelector = ((
   } else if (a) {
     selector = a;
   } else {
-    throw new Error('Missing arguments');
+    throw /* minify-error-disabled */ new Error('Missing arguments');
   }
 
   return selector;
@@ -206,7 +206,7 @@ export const createSelectorMemoized: CreateSelectorFunction = (...selectors: any
       case 2: return fn(state, a1, a2);
       case 3: return fn(state, a1, a2, a3);
       default:
-        throw new Error('unreachable');
+        throw /* minify-error-disabled */ new Error('unreachable');
     }
   };
 

packages/utils/src/useEventCallback.ts

@@ -46,6 +46,8 @@ function createStableCallback() {
 
 function assertNotCalled() {
   if (process.env.NODE_ENV !== 'production') {
-    throw new Error('Base UI: Cannot call an event handler while rendering.');
+    throw /* minify-error-disabled */ new Error(
+      'Base UI: Cannot call an event handler while rendering.',
+    );
   }
 }