jamdesk 1.1.175 → 1.1.177

package/dist/__tests__/unit/dev-workspace-symlinks.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dev-workspace-symlinks.test.d.ts.map

package/dist/__tests__/unit/dev-workspace-symlinks.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-workspace-symlinks.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/dev-workspace-symlinks.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/dev-workspace-symlinks.test.js

@@ -0,0 +1,112 @@
+/**
+ * @vitest-environment node
+ *
+ * Tests prepareProjectWorkspaceLinks — replaces the single
+ * <workspace>/projects/<name> -> <projectDir> symlink with per-entry
+ * symlinks that skip non-active language directories. This is what
+ * actually reduces Turbopack's filesystem scan from 403 MDX files to
+ * 135 on jamdesk-docs.
+ */
+import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
+import fs from 'fs-extra';
+import path from 'path';
+import { tmpdir } from 'os';
+import { prepareProjectWorkspaceLinks } from '../../commands/dev.js';
+import { output } from '../../lib/output.js';
+describe('prepareProjectWorkspaceLinks', () => {
+    let tmpRoot;
+    let projectDir;
+    let workspaceProjectDir;
+    beforeEach(() => {
+        tmpRoot = fs.mkdtempSync(path.join(tmpdir(), 'jam-ws-'));
+        projectDir = path.join(tmpRoot, 'project');
+        workspaceProjectDir = path.join(tmpRoot, 'ws', 'projects', 'project');
+        // Set up a project layout that mirrors a multi-language docs project:
+        //   project/
+        //     ai/intro.mdx       (en at root)
+        //     development/foo.mdx (en at root)
+        //     es/ai/intro.mdx    (spanish)
+        //     fr/ai/intro.mdx    (french)
+        //     docs.json
+        //     images/logo.png
+        fs.mkdirpSync(path.join(projectDir, 'ai'));
+        fs.writeFileSync(path.join(projectDir, 'ai', 'intro.mdx'), '# en');
+        fs.mkdirpSync(path.join(projectDir, 'development'));
+        fs.writeFileSync(path.join(projectDir, 'development', 'foo.mdx'), '# en');
+        fs.mkdirpSync(path.join(projectDir, 'es', 'ai'));
+        fs.writeFileSync(path.join(projectDir, 'es', 'ai', 'intro.mdx'), '# es');
+        fs.mkdirpSync(path.join(projectDir, 'fr', 'ai'));
+        fs.writeFileSync(path.join(projectDir, 'fr', 'ai', 'intro.mdx'), '# fr');
+        fs.writeFileSync(path.join(projectDir, 'docs.json'), '{}');
+        fs.mkdirpSync(path.join(projectDir, 'images'));
+        fs.writeFileSync(path.join(projectDir, 'images', 'logo.png'), '');
+    });
+    afterEach(() => {
+        fs.removeSync(tmpRoot);
+    });
+    it('symlinks every top-level entry when skip set is empty', async () => {
+        await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set());
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'ai', 'intro.mdx'))).toBe(true);
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'es', 'ai', 'intro.mdx'))).toBe(true);
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'fr', 'ai', 'intro.mdx'))).toBe(true);
+    });
+    it('does not symlink docs.json (caller writes a filtered copy)', async () => {
+        // docs.json must not be symlinked — the caller writes a per-language
+        // filtered copy, and fs.writeFile through a symlink would clobber the
+        // user's source docs.json.
+        await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set());
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'docs.json'))).toBe(false);
+    });
+    it('skips entries whose names are in the skip set', async () => {
+        await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set(['es', 'fr']));
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'ai', 'intro.mdx'))).toBe(true);
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'development', 'foo.mdx'))).toBe(true);
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'images', 'logo.png'))).toBe(true);
+        // Skipped:
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'es'))).toBe(false);
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'fr'))).toBe(false);
+        // docs.json not symlinked — caller writes a filtered copy.
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'docs.json'))).toBe(false);
+    });
+    it('rebuilds the workspace links from scratch on subsequent calls', async () => {
+        // First call: no skip
+        await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set());
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'es'))).toBe(true);
+        // Second call: skip es
+        await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set(['es']));
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'es'))).toBe(false);
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'fr'))).toBe(true);
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'ai', 'intro.mdx'))).toBe(true);
+    });
+    it('handles a pre-existing single symlink at workspaceProjectDir (legacy layout)', async () => {
+        // Pre-create the legacy single-symlink layout
+        fs.mkdirpSync(path.dirname(workspaceProjectDir));
+        fs.symlinkSync(projectDir, workspaceProjectDir, 'junction');
+        await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set(['es', 'fr']));
+        const lstat = fs.lstatSync(workspaceProjectDir);
+        expect(lstat.isDirectory()).toBe(true);
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'ai', 'intro.mdx'))).toBe(true);
+        expect(fs.existsSync(path.join(workspaceProjectDir, 'es'))).toBe(false);
+    });
+    it('surfaces friendly error (not raw stack trace) when fs.rm throws ENOTEMPTY', async () => {
+        // Regression: before safeRemoveCache, fs.remove raised an unfriendly stack
+        // trace when Turbopack still held open files. Now safeRemoveCache detects
+        // the race and calls process.exit(1) with a human-readable message.
+        const rmSpy = vi.spyOn(fs, 'rm');
+        const exitSpy = vi.spyOn(process, 'exit').mockImplementation(((code) => {
+            throw new Error(`process.exit:${code}`);
+        }));
+        const errorSpy = vi.spyOn(output, 'error').mockImplementation(() => undefined);
+        const enotempty = Object.assign(new Error('ENOTEMPTY'), { code: 'ENOTEMPTY' });
+        // fs.rm will be called by safeRemoveCache; make it fail with ENOTEMPTY
+        // even after the internal maxRetries — simulate persistent race condition.
+        rmSpy.mockRejectedValue(enotempty);
+        await expect(prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set())).rejects.toThrow('process.exit:1');
+        const msg = errorSpy.mock.calls[0]?.[0] ?? '';
+        expect(msg).toContain('Another `jamdesk dev` instance');
+        expect(msg).toContain('pkill -f');
+        expect(exitSpy).toHaveBeenCalledWith(1);
+        vi.restoreAllMocks();
+    });
+});
+//# sourceMappingURL=dev-workspace-symlinks.test.js.map

package/dist/__tests__/unit/dev-workspace-symlinks.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev-workspace-symlinks.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/dev-workspace-symlinks.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/unit/language-filter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=language-filter.test.d.ts.map

package/dist/__tests__/unit/language-filter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-filter.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/language-filter.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/language-filter.test.js

@@ -0,0 +1,166 @@
+/**
+ * @vitest-environment node
+ *
+ * Tests for getActiveLanguageFilter — pure helper that decides which
+ * top-level language directories to skip when symlinking project content
+ * into the dev workspace. Multi-language sites' non-default languages
+ * inflate Turbopack's filesystem scan and balloon cold compile time
+ * (jamdesk-docs: 67s with 3 langs vs. 12.5s with 1 lang).
+ */
+import { describe, it, expect } from 'vitest';
+import { getActiveLanguageFilter, isPageInSkippedLanguage, filterConfigByActiveLanguage, } from '../../lib/language-filter.js';
+const config = (langs) => ({
+    navigation: { languages: langs.map(l => ({ language: l.language, default: l.default })) },
+});
+describe('getActiveLanguageFilter', () => {
+    it('returns null filter when project has no languages array', () => {
+        const result = getActiveLanguageFilter({ navigation: {} }, undefined, false);
+        expect(result).toEqual({ active: null, skip: new Set() });
+    });
+    it('returns null filter when project has only one language', () => {
+        const result = getActiveLanguageFilter(config([{ language: 'en', default: true }]), undefined, false);
+        expect(result).toEqual({ active: 'en', skip: new Set() });
+    });
+    it('skips non-default languages when active is the default', () => {
+        const result = getActiveLanguageFilter(config([
+            { language: 'en', default: true },
+            { language: 'es' },
+            { language: 'fr' },
+        ]), undefined, false);
+        expect(result.active).toBe('en');
+        expect(result.skip).toEqual(new Set(['es', 'fr']));
+    });
+    it('falls back to first language when none is marked default', () => {
+        const result = getActiveLanguageFilter(config([{ language: 'en' }, { language: 'es' }, { language: 'fr' }]), undefined, false);
+        expect(result.active).toBe('en');
+        expect(result.skip).toEqual(new Set(['es', 'fr']));
+    });
+    it('accepts --lang matching the default language (no-op equivalence)', () => {
+        const result = getActiveLanguageFilter(config([
+            { language: 'en', default: true },
+            { language: 'es' },
+        ]), 'en', false);
+        expect(result.active).toBe('en');
+        expect(result.skip).toEqual(new Set(['es']));
+    });
+    it('throws on --lang for a non-default language (initial release scope)', () => {
+        // Non-default-language layouts mix root-level default-lang content with
+        // <lang>/ subdirs for translations; correctly stripping the default
+        // content while keeping <lang>/ takes more work and is deferred to a
+        // follow-up. For now, surface the workaround clearly.
+        expect(() => getActiveLanguageFilter(config([
+            { language: 'en', default: true },
+            { language: 'es' },
+            { language: 'fr' },
+        ]), 'es', false)).toThrow(/--lang es: previewing non-default languages.*--all-langs/i);
+    });
+    it('returns empty skip set when --all-langs is set', () => {
+        const result = getActiveLanguageFilter(config([
+            { language: 'en', default: true },
+            { language: 'es' },
+        ]), undefined, true);
+        expect(result.active).toBe('en');
+        expect(result.skip).toEqual(new Set());
+    });
+    it('throws on --lang code that does not exist in docs.json', () => {
+        expect(() => getActiveLanguageFilter(config([{ language: 'en', default: true }, { language: 'es' }]), 'de', false)).toThrow(/--lang de.*not.*docs\.json.*Available: en, es/);
+    });
+    it('handles malformed languages array (entries missing language field) by ignoring them', () => {
+        const malformed = {
+            navigation: {
+                languages: [
+                    { language: 'en', default: true },
+                    { default: false }, // missing language: ignored
+                    { language: 'es' },
+                    { language: 42 }, // wrong type: ignored
+                ],
+            },
+        };
+        const result = getActiveLanguageFilter(malformed, undefined, false);
+        expect(result.active).toBe('en');
+        expect(result.skip).toEqual(new Set(['es']));
+    });
+    it('returns null active when no valid language entries exist', () => {
+        const result = getActiveLanguageFilter({ navigation: { languages: [{ default: true }] } }, undefined, false);
+        expect(result).toEqual({ active: null, skip: new Set() });
+    });
+    it('rejects empty-string --lang as an invalid code (commander passes "" through)', () => {
+        // commander.js treats `--lang ""` as a value, not as missing — so
+        // langOption is "" (defined, but empty). Empty string is never a valid
+        // language code; surface it as a clear error rather than silently
+        // falling back to the default.
+        expect(() => getActiveLanguageFilter(config([{ language: 'en', default: true }, { language: 'es' }]), '', false)).toThrow(/--lang.*not.*docs\.json/);
+    });
+});
+describe('isPageInSkippedLanguage', () => {
+    it('returns false when skip set is empty', () => {
+        expect(isPageInSkippedLanguage('fr/introduction', new Set())).toBe(false);
+    });
+    it('returns true when first path segment is a skipped language', () => {
+        expect(isPageInSkippedLanguage('fr/introduction', new Set(['fr']))).toBe(true);
+    });
+    it('returns true for nested paths inside a skipped language', () => {
+        expect(isPageInSkippedLanguage('fr/setup/connecting-github', new Set(['fr', 'de']))).toBe(true);
+    });
+    it('returns false when first segment is the active language', () => {
+        expect(isPageInSkippedLanguage('en/introduction', new Set(['fr']))).toBe(false);
+    });
+    it('returns false for unprefixed root pages', () => {
+        expect(isPageInSkippedLanguage('introduction', new Set(['fr']))).toBe(false);
+    });
+    it('does not match when the skip code is a prefix-substring of a different segment', () => {
+        // Guard against startsWith('fr/') matching e.g. 'fr-something/foo'
+        expect(isPageInSkippedLanguage('fr-something/foo', new Set(['fr']))).toBe(false);
+    });
+    it('returns true for a path with a fragment anchor in a skipped language', () => {
+        // Broken-anchor warnings from validate-links.cjs surface as link values
+        // like `fr/introduction#missing-section` — the fragment lives past the
+        // first segment so the language check still works.
+        expect(isPageInSkippedLanguage('fr/introduction#setup', new Set(['fr']))).toBe(true);
+    });
+});
+describe('filterConfigByActiveLanguage', () => {
+    it('returns the input unchanged (same reference) when skip is empty', () => {
+        const config = { name: 'foo', navigation: { languages: [{ language: 'en' }] } };
+        const result = filterConfigByActiveLanguage(config, { active: 'en', skip: new Set() });
+        expect(result).toBe(config);
+    });
+    it('drops skipped languages from navigation.languages', () => {
+        const config = {
+            name: 'jamdesk-docs',
+            navigation: {
+                languages: [
+                    { language: 'en', default: true, tabs: [{ tab: 'Guide' }] },
+                    { language: 'fr', tabs: [{ tab: 'Guide' }] },
+                    { language: 'de', tabs: [{ tab: 'Guide' }] },
+                ],
+            },
+        };
+        const result = filterConfigByActiveLanguage(config, {
+            active: 'en',
+            skip: new Set(['fr', 'de']),
+        });
+        expect(result.navigation.languages).toEqual([
+            { language: 'en', default: true, tabs: [{ tab: 'Guide' }] },
+        ]);
+        // Top-level fields preserved.
+        expect(result.name).toBe('jamdesk-docs');
+        // Original config untouched.
+        expect(config.navigation.languages).toHaveLength(3);
+    });
+    it('preserves other navigation fields (tabs, global, anchors, etc.)', () => {
+        const config = {
+            navigation: {
+                languages: [{ language: 'en' }, { language: 'fr' }],
+                global: { anchors: [{ anchor: 'Support' }] },
+            },
+        };
+        const result = filterConfigByActiveLanguage(config, {
+            active: 'en',
+            skip: new Set(['fr']),
+        });
+        expect(result.navigation.global).toEqual({ anchors: [{ anchor: 'Support' }] });
+        expect(result.navigation.languages).toHaveLength(1);
+    });
+});
+//# sourceMappingURL=language-filter.test.js.map

package/dist/__tests__/unit/language-filter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-filter.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/language-filter.test.ts"],"names":[],"mappings":"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"}

package/dist/lib/language-filter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Picks which `<lang>/` directories under projectDir to keep as workspace
+ * symlinks and which to skip. Skipping non-active language directories
+ * shrinks Turbopack's filesystem scan and dropped cold compile from ~67s
+ * to ~12s on jamdesk-docs (commit 90d781b4).
+ *
+ * The dev server still reads content from the user's source tree via
+ * JAMDESK_PROJECTS_DIR, so the language picker keeps showing every
+ * language and clicks always 200 OK — the workspace symlinks are a
+ * Turbopack-only performance layer.
+ *
+ * Default rules:
+ *   1. Language with `default: true`
+ *   2. First language in `navigation.languages[]`
+ */
+export interface LanguageFilter {
+    active: string | null;
+    skip: Set<string>;
+}
+interface NavigationLanguageEntry {
+    language?: string;
+    default?: boolean;
+}
+interface MinimalConfig {
+    navigation?: {
+        languages?: NavigationLanguageEntry[];
+    };
+}
+export declare function getActiveLanguageFilter(config: MinimalConfig): LanguageFilter;
+export {};
+//# sourceMappingURL=language-filter.d.ts.map

package/dist/lib/language-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-filter.d.ts","sourceRoot":"","sources":["../../src/lib/language-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACnB;AAED,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,aAAa;IACrB,UAAU,CAAC,EAAE;QACX,SAAS,CAAC,EAAE,uBAAuB,EAAE,CAAC;KACvC,CAAC;CACH;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAc7E"}

package/dist/lib/language-filter.js

@@ -0,0 +1,14 @@
+export function getActiveLanguageFilter(config) {
+    const validEntries = (config.navigation?.languages ?? []).filter((l) => typeof l.language === 'string');
+    if (validEntries.length === 0) {
+        return { active: null, skip: new Set() };
+    }
+    const codes = validEntries.map((l) => l.language);
+    const active = validEntries.find((l) => l.default)?.language ?? validEntries[0].language;
+    if (codes.length === 1) {
+        return { active, skip: new Set() };
+    }
+    const skip = new Set(codes.filter((c) => c !== active));
+    return { active, skip };
+}
+//# sourceMappingURL=language-filter.js.map

package/dist/lib/language-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-filter.js","sourceRoot":"","sources":["../../src/lib/language-filter.ts"],"names":[],"mappings":"AA+BA,MAAM,UAAU,uBAAuB,CAAC,MAAqB;IAC3D,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAC9D,CAAC,CAAC,EAAgD,EAAE,CAAC,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CACpF,CAAC;IACF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,EAAU,EAAE,CAAC;IACnD,CAAC;IACD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACzF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,EAAU,EAAE,CAAC;IAC7C,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC;IACxD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.175",
+  "version": "1.1.177",
   "description": "CLI for Jamdesk — build, preview, and deploy documentation sites from MDX. Dev server with hot reload, 50+ components, OpenAPI support, AI search, and Mintlify migration",
   "keywords": [
     "jamdesk",

package/vendored/components/mdx/Prompt.tsx

@@ -132,8 +132,8 @@ const promptUtilityClassName = [
 ].join(' ');
 
 const primaryActionClassName = [
-  'inline-flex min-h-10 min-w-0 items-center gap-2 px-4 py-2 text-sm font-semibold',
-  'prompt-primary-action bg-[var(--color-text-primary)] text-[var(--color-bg-primary)] transition-opacity cursor-pointer',
+  'inline-flex min-h-8 min-w-0 items-center gap-2 px-3.5 py-1 text-sm font-semibold',
+  'prompt-primary-action bg-[var(--color-primary)] text-white transition-opacity cursor-pointer',
   'hover:opacity-90',
   contrastSafeFocusClassName,
 ].join(' ');
@@ -210,7 +210,7 @@ function PromptDialog({
     >
       <div className="flex max-h-[calc(100dvh-2rem)] min-h-0 flex-col">
         <div className="flex shrink-0 items-center justify-between gap-3 border-b border-[var(--color-border)] px-4 py-3">
-          <h2 className="m-0 min-w-0 truncate text-sm font-semibold text-[var(--color-text-primary)]">
+          <h2 className="prompt-dialog-title m-0 min-w-0 truncate text-sm font-semibold text-[var(--color-text-primary)]">
             {title ?? 'Prompt'}
           </h2>
           <button
@@ -243,11 +243,21 @@ function PromptDialog({
         </span>
       </div>
       <style jsx>{`
+        /* A fixed black scrim: the text token flips to near-white in dark
+           mode and washed the whole page out behind the dialog. */
         .prompt-dialog::backdrop {
-          background: var(--color-text-primary);
-          opacity: 0.6;
+          background: rgb(0 0 0 / 0.55);
           backdrop-filter: blur(4px);
         }
+        /* Outranks the docs themes' .prose h2 rules, which reach into the
+           dialog and would inflate this chrome heading. */
+        .prompt-dialog .prompt-dialog-title {
+          margin: 0;
+          font-size: 0.875rem;
+          line-height: 1.5;
+          font-weight: 600;
+          letter-spacing: normal;
+        }
       `}</style>
     </dialog>
   );
@@ -413,7 +423,7 @@ export function Prompt({
           ) : null}
           <div
             data-testid="prompt-actions"
-            className="flex min-w-0 max-w-full items-stretch justify-end self-end sm:ml-auto sm:self-auto"
+            className="flex min-w-0 max-w-full items-center justify-end self-end sm:ml-auto sm:self-auto"
           >
             {primary ? (
               <a
@@ -421,7 +431,7 @@ export function Prompt({
                 target="_blank"
                 rel="noopener noreferrer"
                 aria-label={primary.label}
-                className={`${primaryActionClassName} ${secondary.length > 0 ? 'rounded-l-[var(--radius-lg)]' : 'rounded-[var(--radius-lg)]'}`}
+                className={`${primaryActionClassName} ${secondary.length > 0 ? 'rounded-l-full' : 'rounded-full'}`}
               >
                 <span aria-hidden="true"><ActionIcon action={primary.action} /></span>
                 <span className="min-w-0 truncate">{primary.label}</span>
@@ -436,7 +446,7 @@ export function Prompt({
                   aria-haspopup="menu"
                   aria-expanded={menuOpen}
                   aria-controls={menuId}
-                  className={`${primaryActionClassName} min-w-10 rounded-r-[var(--radius-lg)] border-l border-[var(--color-bg-primary)] px-3`}
+                  className={`${primaryActionClassName} min-w-8 rounded-r-full border-l border-[var(--color-bg-primary)] px-2.5`}
                   onMouseDown={(event) => {
                     if (menuOpen) event.preventDefault();
                   }}
@@ -468,7 +478,7 @@ export function Prompt({
                         target="_blank"
                         rel="noopener noreferrer"
                         aria-label={action.label}
-                        className={`flex min-h-10 min-w-0 max-w-full cursor-pointer items-center gap-2 rounded-[var(--radius-lg)] px-3 py-2 text-sm text-[var(--color-text-primary)] hover:bg-[var(--color-border)] ${contrastSafeFocusClassName}`}
+                        className={`prompt-menu-item flex min-h-10 min-w-0 max-w-full cursor-pointer items-center gap-2 rounded-[var(--radius-lg)] px-3 py-2 text-sm text-[var(--color-text-primary)] hover:bg-[var(--color-border)] ${contrastSafeFocusClassName}`}
                         onClick={closeMenuAndFocusTrigger}
                       >
                         <span aria-hidden="true"><ActionIcon action={action.action} /></span>
@@ -497,7 +507,7 @@ export function Prompt({
         >
           <span
             data-testid="prompt-icon"
-            className="mt-1 shrink-0 text-[var(--color-primary)]"
+            className="flex h-6 shrink-0 items-center text-[var(--color-primary)]"
             aria-hidden="true"
           >
             <Icon icon={authorIcon} size={18} />
@@ -508,8 +518,11 @@ export function Prompt({
           >
             {hasDescription ? renderInlineMarkdown(description) : prompt || children}
           </div>
+          {/* -my-2 keeps the 40px hit targets while the buttons occupy one
+              24px text line, so they center on the first preview line and a
+              one-line prompt yields a compact well. */}
           {hasPrompt ? (
-            <div data-testid="prompt-utilities" className="flex shrink-0 items-center gap-1">
+            <div data-testid="prompt-utilities" className="-my-2 flex shrink-0 items-center gap-1">
               <button
                 ref={expandTriggerRef}
                 type="button"
@@ -553,12 +566,32 @@ export function Prompt({
           border-color: var(--color-border);
         }
         .prompt-primary-action {
-          background: var(--color-text-primary);
-          color: var(--color-bg-primary);
+          background: var(--color-primary);
+          color: #fff;
         }
         .prompt-title {
           color: var(--color-text-primary);
         }
+        /* The docs themes' prose CSS is not Tailwind Typography — .prose h3 and
+           .prose a match descendants even inside .not-prose, and the jam theme's
+           body[data-theme] variants outrank Tailwind utilities. These scoped
+           rules win on specificity to keep the header compact and link-free. */
+        .prompt-card-fern .prompt-title {
+          margin: 0;
+          font-size: 1rem;
+          line-height: 1.5;
+          font-weight: 600;
+          letter-spacing: normal;
+        }
+        .prompt-card-fern .prompt-primary-action {
+          text-decoration: none;
+          font-weight: 600;
+        }
+        .prompt-card-fern .prompt-menu-item {
+          text-decoration: none;
+          font-weight: 400;
+          color: var(--color-text-primary);
+        }
         @supports (color: color-mix(in srgb, black, white)) {
           .prompt-card-fern {
             border-color: color-mix(in srgb, var(--color-primary) 48%, var(--color-border));
@@ -568,9 +601,16 @@ export function Prompt({
             border-color: color-mix(in srgb, var(--color-border) 88%, var(--color-primary));
             box-shadow: inset 0 0 0 1px color-mix(in srgb, var(--color-primary) 3%, transparent);
           }
+          /* 40% primary keeps >=4.5:1 against the card background even when
+             --color-primary is set to the mode's background extreme; 45% fails. */
+          .prompt-card-fern .prompt-title {
+            color: color-mix(in srgb, var(--color-primary) 40%, var(--color-text-primary));
+          }
         }
+        /* Three lines of leading-6, then scroll — the Expand dialog carries
+           the full prompt. */
         .prompt-preview {
-          max-height: 10rem;
+          max-height: 4.5rem;
           overflow-y: auto;
           overflow-wrap: anywhere;
         }

package/vendored/components/navigation/Sidebar.tsx

@@ -760,7 +760,11 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
     const visibilityClass = showTabsInSidebar ? '' : 'lg:hidden';
 
     return (
-      <div className={`sidebar-tabs flex flex-col gap-2 px-4 pt-2 pb-6 ${visibilityClass}`}>
+      // Inline-start padding is 12px (pl-3), not 16px, so each tab's px-3
+      // padding lands its icon at 24px — flush with the sidebar group icons
+      // (ml-6) below — and the active tab's highlight left edge lands at 12px
+      // to match the lower nav items' pill (.sidebar-scroll ...::before).
+      <div className={`sidebar-tabs flex flex-col gap-2 pl-3 pr-4 pt-2 pb-6 ${visibilityClass}`}>
         {resolvedNav.tabs.map((tab) => {
           const isActive = tab.name === resolvedNav.activeTab;