@mintlify/cli 4.0.1196 → 4.0.1198

package/bin/cli.js

@@ -21,7 +21,7 @@ import { comingSoon } from './comingSoon.js';
 import { setTelemetryEnabled } from './config.js';
 import { getConfigValue, setConfigValue, clearConfigValue } from './config.js';
 import { API_URL } from './constants.js';
-import { CMD_EXEC_PATH, checkPort, checkNodeVersion, autoUpgradeIfNeeded, getVersions, suppressConsoleWarnings, terminate, } from './helpers.js';
+import { CMD_EXEC_PATH, checkPort, checkNodeVersion, autoUpgradeIfNeeded, getVersions, isAI, suppressConsoleWarnings, terminate, } from './helpers.js';
 import { init } from './init.js';
 import { getAccessToken } from './keyring.js';
 import { login } from './login.js';
@@ -33,8 +33,40 @@ import { scoreHandler } from './score/index.js';
 import { status, getCliSubdomains } from './status.js';
 import { trackTelemetryPreferenceChange } from './telemetry/track.js';
 import { update } from './update.js';
+import { renderWelcome } from './welcome.js';
 import { workflowsBuilder } from './workflows/index.js';
+// The branded welcome screen replaces yargs' default help, but only for an
+// interactive human at a TTY. Piped, scripted, AI, and test callers keep the
+// plain yargs help so their output stays parseable and stable.
+const shouldShowWelcome = (args) => {
+    const interactive = Boolean(process.stdout.isTTY) && !isAI() && process.env.CLI_TEST_MODE !== 'true';
+    if (!interactive)
+        return false;
+    if (args.length === 0)
+        return true;
+    const positionals = args.filter((arg) => !arg.startsWith('-'));
+    const command = positionals[0];
+    // `help` followed by a subcommand (e.g. `mint help dev`) is a subcommand
+    // lookup — let yargs handle it rather than intercepting with the welcome screen.
+    const isTopLevel = command === undefined || (command === 'help' && positionals.length === 1);
+    const helpRequested = command === 'help' || args.includes('--help') || args.includes('-h');
+    return isTopLevel && helpRequested;
+};
+const showWelcome = (packageName) => __awaiter(void 0, void 0, void 0, function* () {
+    const { cli: version } = getVersions(packageName);
+    const subdomain = getConfigValue('subdomain');
+    let signedIn = false;
+    try {
+        signedIn = Boolean(yield getAccessToken());
+    }
+    catch (_a) { }
+    process.stdout.write(renderWelcome({ packageName, version, signedIn, subdomain }));
+    yield terminate(0);
+});
 export const cli = ({ packageName = 'mint' }) => {
+    if (shouldShowWelcome(hideBin(process.argv))) {
+        return showWelcome(packageName);
+    }
     const telemetryMiddleware = createTelemetryMiddleware();
     render(_jsx(Logs, {}));
     return (yargs(hideBin(process.argv))

package/bin/logo.js

@@ -0,0 +1,28 @@
+// AUTO-GENERATED by `scripts/generate-logo.mjs` from the Mintlify icon mark.
+// Do not edit by hand — run `node scripts/generate-logo.mjs` to regenerate.
+/** Mintlify brand greens. */
+export const MINT_GREEN = '#18E299';
+export const MINT_GREEN_DEEP = '#0C8C5E';
+/**
+ * The Mintlify leaf, rendered as a solid `#` mark (chafa shape detection,
+ * normalized to a single glyph). Drawn in {@link MINT_GREEN} on the welcome
+ * screen.
+ */
+export const MINT_LOGO = [
+    '             ##############',
+    '          #################',
+    '        ###################',
+    '      #####################',
+    '    ####     ##############',
+    '  #####         ###########',
+    ' #######          #########',
+    '########           ########',
+    '########            ######',
+    '########            ####',
+    '######  ##############',
+    ' ###  ##############',
+    '    ##############',
+    '     ##########',
+];
+/** Width of the widest logo row, for laying out content beside it. */
+export const MINT_LOGO_WIDTH = MINT_LOGO.reduce((max, line) => Math.max(max, line.length), 0);