@mintlify/cli 4.0.1339 → 4.0.1340

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mintlify/cli",
-  "version": "4.0.1339",
+  "version": "4.0.1340",
   "description": "The Mintlify CLI",
   "engines": {
     "node": ">=18.0.0"
@@ -33,7 +33,7 @@
   "scripts": {
     "dev": "yarn build && NODE_NO_WARNINGS=1 node bin/index.js",
     "prepare": "npm run build",
-    "build": "tsc --project tsconfig.build.json",
+    "build": "tsc --project tsconfig.build.json && node scripts/bundle-converter.mjs",
     "clean:build": "rimraf bin",
     "clean:all": "rimraf node_modules .eslintcache && yarn clean:build",
     "watch": "tsc --watch",
@@ -64,9 +64,18 @@
     "open": "8.4.2",
     "openid-client": "6.8.2",
     "posthog-node": "5.17.2",
+    "prosemirror-model": "^1.25.0",
     "react": "19.2.3",
+    "remark": "^15.0.1",
+    "remark-frontmatter": "^5.0.0",
+    "remark-gfm": "^4.0.1",
+    "remark-math": "^6.0.0",
+    "remark-mdx": "^3.1.1",
+    "remark-stringify": "^11.0.0",
     "semver": "7.7.2",
+    "unified": "^11.0.5",
     "unist-util-visit": "5.0.0",
+    "yaml": "^2.8.3",
     "yargs": "17.7.1",
     "zod": "4.3.6"
   },
@@ -74,6 +83,7 @@
     "keytar": "7.9.0"
   },
   "devDependencies": {
+    "@mintlify/editor": "0.0.248",
     "@mintlify/ts-config": "2.0.2",
     "@tsconfig/recommended": "1.0.2",
     "@types/adm-zip": "0.5.7",
@@ -82,6 +92,7 @@
     "@types/mdast": "4.0.4",
     "@types/node": "18.15.0",
     "@types/yargs": "17.0.22",
+    "esbuild": "0.25.12",
     "openapi-types": "12.1.3",
     "oxfmt": "^0.51.0",
     "oxlint": "1.66.0",
@@ -92,5 +103,5 @@
     "vitest": "2.1.9",
     "vitest-mock-process": "1.0.4"
   },
-  "gitHead": "3498acefd9c006ff788a60431cca85d03053d782"
+  "gitHead": "a35c4acbb224d6bfb0155931033e6c0c51896dc7"
 }

package/scripts/bundle-converter.mjs

@@ -0,0 +1,24 @@
+import { build } from 'esbuild';
+import { createRequire } from 'node:module';
+
+const require = createRequire(import.meta.url);
+const entry = require.resolve('@mintlify/editor/converter');
+
+await build({
+  entryPoints: [entry],
+  outfile: 'bin/vendor/converter.js',
+  bundle: true,
+  format: 'esm',
+  platform: 'node',
+  target: 'node18',
+  external: [
+    '@mintlify/common',
+    '@mintlify/validation',
+    'mdast-util-*',
+    'prosemirror-*',
+    'remark*',
+    'unified',
+    'unist-util-*',
+    'yaml',
+  ],
+});

package/src/cli.tsx

@@ -25,6 +25,7 @@ import { getConfigValue, setConfigValue, clearConfigValue } from './config.js';
 import { API_URL } from './constants.js';
 import { deslopHandler } from './deslop/index.js';
 import { resolveExplicitFiles } from './deslop/resolveFiles.js';
+import { formatHandler } from './format.js';
 import {
   CMD_EXEC_PATH,
   checkPort,
@@ -736,6 +737,15 @@ export const cli = ({ packageName = 'mint' }: { packageName?: string }) => {
             ),
         deslopHandler
       )
+      .command(
+        'format',
+        'Format MDX files in the current directory',
+        (yargs) =>
+          yargs
+            .usage('usage: mint format')
+            .example('mint format', 'format all MDX files in the current directory'),
+        formatHandler
+      )
       // Coming soon commands — visible in help, tracked via telemetry to gauge interest.
       .command(
         'ai',

package/src/format.tsx

@@ -0,0 +1,67 @@
+import { isMintIgnored, processMintIgnoreString } from '@mintlify/common';
+import { getMintIgnore } from '@mintlify/prebuild';
+import { addLog, ErrorLog, SuccessLog } from '@mintlify/previewing';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+
+import { CMD_EXEC_PATH, terminate } from './helpers.js';
+
+async function getGitIgnore(): Promise<string[]> {
+  try {
+    const content = await fs.readFile(path.join(CMD_EXEC_PATH, '.gitignore'), 'utf-8');
+    return processMintIgnoreString(content);
+  } catch {
+    return [];
+  }
+}
+
+async function* walk(dir: string, ignores: string[]): AsyncGenerator<string> {
+  const entries = await fs.readdir(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const full = path.join(dir, entry.name);
+    const relative = path.relative(CMD_EXEC_PATH, full).split(path.sep).join('/');
+    if (entry.isDirectory()) {
+      if (isMintIgnored(`${relative}/`, ignores)) continue;
+      yield* walk(full, ignores);
+    } else if (entry.name.endsWith('.mdx')) {
+      if (isMintIgnored(relative, ignores)) continue;
+      yield full;
+    }
+  }
+}
+
+export const formatHandler = async (): Promise<void> => {
+  const { mdxToPm, pmToMdx } = await import('./vendor/converter.js');
+  const ignores = [...(await getGitIgnore()), ...(await getMintIgnore(CMD_EXEC_PATH))];
+  let total = 0;
+  let changed = 0;
+  let failed = 0;
+
+  for await (const file of walk(CMD_EXEC_PATH, ignores)) {
+    total++;
+    const relative = path.relative(CMD_EXEC_PATH, file);
+    try {
+      const raw = await fs.readFile(file, 'utf-8');
+      const { doc, frontmatter } = mdxToPm(raw, { singleDollarTextMath: false });
+      const formatted = `${pmToMdx(doc, { frontmatter })}\n`;
+      if (formatted !== raw) {
+        await fs.writeFile(file, formatted);
+        changed++;
+      }
+    } catch (error) {
+      failed++;
+      addLog(
+        <ErrorLog
+          message={`${relative}: ${error instanceof Error ? error.message : 'unknown error'}`}
+        />
+      );
+    }
+  }
+
+  addLog(
+    <SuccessLog
+      message={`formatted ${changed} of ${total} mdx file${total === 1 ? '' : 's'}${failed > 0 ? ` (${failed} failed)` : ''}`}
+    />
+  );
+  await terminate(failed > 0 ? 1 : 0);
+};

package/src/vendor/converter.ts

@@ -0,0 +1 @@
+export * from '@mintlify/editor/converter';