jamdesk 1.1.140 → 1.1.142

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/deprecated-components.d.ts

@@ -26,6 +26,7 @@ export interface DeprecatedComponentInfo {
 /**
  * Map of deprecated components to their replacements.
  * Add new deprecated components here as they are removed.
+ * NEVER remove entries: render-time auto-migrate (preprocess-mdx.ts) rewrites stale R2 content with them forever.
  */
 export declare const DEPRECATED_COMPONENTS: Record<string, DeprecatedComponentInfo>;
 export interface DeprecatedComponentError {

package/dist/lib/deprecated-components.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deprecated-components.d.ts","sourceRoot":"","sources":["../../src/lib/deprecated-components.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACjD;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAkBzE,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,wBAAwB,EAAE,CAsB5B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,wBAAwB,GAAG;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAQA;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,wBAAwB,EAAE,GAAG;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAqCA;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA0BnG"}
+{"version":3,"file":"deprecated-components.d.ts","sourceRoot":"","sources":["../../src/lib/deprecated-components.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;CACjD;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAkBzE,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,wBAAwB,EAAE,CAsB5B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,wBAAwB,GAAG;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAQA;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,wBAAwB,EAAE,GAAG;IACxE,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB,CAqCA;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA0BnG"}

package/dist/lib/deprecated-components.js

@@ -15,6 +15,7 @@
 /**
  * Map of deprecated components to their replacements.
  * Add new deprecated components here as they are removed.
+ * NEVER remove entries: render-time auto-migrate (preprocess-mdx.ts) rewrites stale R2 content with them forever.
  */
 export const DEPRECATED_COMPONENTS = {
     CardGroup: {

package/dist/lib/deprecated-components.js.map

@@ -1 +1 @@
-{"version":3,"file":"deprecated-components.js","sourceRoot":"","sources":["../../src/lib/deprecated-components.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deprecated-components.js","sourceRoot":"","sources":["../../src/lib/deprecated-components.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.140",
+  "version": "1.1.142",
   "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/chat/ChatMessage.tsx

@@ -1,16 +1,34 @@
 'use client';
 
 import { memo } from 'react';
+import { useRouter } from 'next/navigation';
 import ReactMarkdown from 'react-markdown';
 import remarkGfm from 'remark-gfm';
+import { slug as githubSlug } from 'github-slugger';
 import { ChatCodeBlock } from './ChatCodeBlock';
 import { CopyButton } from './CopyButton';
+import { isModifiedClick } from '@/lib/is-modified-click';
 import { useLinkPrefix } from '@/lib/link-prefix-context';
 import type { ChatMessage as ChatMessageType } from '@/hooks/useChat';
 
-/** Convert heading text to a URL-friendly slug (same as heading-extractor.ts). */
-function slugify(text: string): string {
-  return text.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+/**
+ * Local path (pathname + query + hash) when href points at this docs site,
+ * null when it's genuinely external. The server rewrites doc links to
+ * canonical ABSOLUTE URLs on the host the user is browsing (link-rewriter.ts
+ * builds them from the forwarded host), so "starts with http" cannot
+ * distinguish doc links from external ones — only an origin comparison can.
+ * Safe to read window here: ChatPanel is loaded with ssr:false, so this never
+ * runs on the server (and the try/catch covers any non-DOM environment).
+ */
+function localPathIfSameSite(href: string): string | null {
+  try {
+    const url = new URL(href, window.location.href);
+    return url.origin === window.location.origin
+      ? `${url.pathname}${url.search}${url.hash}`
+      : null;
+  } catch {
+    return null;
+  }
 }
 
 interface ChatMessageProps {
@@ -41,7 +59,16 @@ function stripOptionList(content: string): string {
  * but without memo every message in the list would re-render.
  */
 export const ChatMessage = memo(function ChatMessage({ message, onSelectOption }: ChatMessageProps) {
+  const router = useRouter();
   const linkPrefix = useLinkPrefix();
+
+  // Same-site links navigate client-side so the chat panel (state in the
+  // root layout) stays open. Modified/middle clicks keep native behavior.
+  const navigateInPage = (e: React.MouseEvent<HTMLAnchorElement>, path: string) => {
+    if (isModifiedClick(e)) return;
+    e.preventDefault();
+    router.push(path);
+  };
   const isUser = message.role === 'user';
   const hasClarificationOptions = !isUser && !!message.clarificationOptions?.length && !message.isStreaming;
   const clarificationDisabled = !!message.clarificationSelected;
@@ -106,11 +133,13 @@ export const ChatMessage = memo(function ChatMessage({ message, onSelectOption }
                       );
                     },
                     a: ({ href, children }) => {
-                      const isExternal = href?.startsWith('http');
+                      const localPath = href ? localPathIfSameSite(href) : null;
                       return (
                         <a
                           href={href}
-                          {...(isExternal ? { target: '_blank', rel: 'noopener noreferrer' } : {})}
+                          onClick={localPath ? (e) => navigateInPage(e, localPath) : undefined}
+                          target={localPath ? undefined : '_blank'}
+                          rel={localPath ? undefined : 'noopener noreferrer'}
                         >
                           {children}
                         </a>
@@ -164,16 +193,21 @@ export const ChatMessage = memo(function ChatMessage({ message, onSelectOption }
             <div className="mt-4 pt-4 border-t border-[var(--color-border)]">
               <p className="text-[11px] font-medium text-[var(--color-text-muted)] mb-1.5">Related docs</p>
               <div className="flex flex-wrap gap-1.5">
-                {message.citations.map((citation) => (
-                  <a
-                    key={citation.slug}
-                    href={`${linkPrefix}/${citation.slug}${citation.section ? `#${slugify(citation.section)}` : ''}`}
-                    className="inline-flex items-center gap-1.5 px-2.5 py-1 rounded-lg border border-[var(--color-border)] bg-[var(--color-bg-secondary)] text-xs text-[var(--color-text-secondary)] hover:border-[var(--color-accent)] hover:text-[var(--color-accent)] transition-colors focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-[var(--color-accent)]"
-                  >
-                    <i className="fa-solid fa-file-lines text-[10px]" aria-hidden="true" />
-                    {citation.title}
-                  </a>
-                ))}
+                {message.citations.map((citation) => {
+                  // github-slugger matches the ids rehype-slug assigns to headings
+                  const citationHref = `${linkPrefix}/${citation.slug}${citation.section ? `#${githubSlug(citation.section)}` : ''}`;
+                  return (
+                    <a
+                      key={citation.slug}
+                      href={citationHref}
+                      onClick={(e) => navigateInPage(e, citationHref)}
+                      className="inline-flex items-center gap-1.5 px-2.5 py-1 rounded-lg border border-[var(--color-border)] bg-[var(--color-bg-secondary)] text-xs text-[var(--color-text-secondary)] hover:border-[var(--color-accent)] hover:text-[var(--color-accent)] transition-colors focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-[var(--color-accent)]"
+                    >
+                      <i className="fa-solid fa-file-lines text-[10px]" aria-hidden="true" />
+                      {citation.title}
+                    </a>
+                  );
+                })}
               </div>
             </div>
           )}

package/vendored/components/layout/EmbedLinkInterceptor.tsx

@@ -1,6 +1,7 @@
 'use client';
 
 import type { ReactNode } from 'react';
+import { isModifiedClick } from '@/lib/is-modified-click';
 
 /**
  * In embed mode the page lives inside a cross-origin iframe (the widget modal).
@@ -12,10 +13,7 @@ import type { ReactNode } from 'react';
  */
 export function EmbedLinkInterceptor({ children }: { children: ReactNode }) {
   const onClick = (e: React.MouseEvent<HTMLDivElement>) => {
-    // Defer entirely to the browser for modified / non-primary clicks: the user
-    // has already asked for new-tab (cmd/ctrl), new-window (shift) or background
-    // (middle) behavior — hijacking it would double-open or break their intent.
-    if (e.defaultPrevented || e.button !== 0 || e.metaKey || e.ctrlKey || e.shiftKey || e.altKey) return;
+    if (isModifiedClick(e)) return;
     const anchor = (e.target as HTMLElement).closest('a');
     if (!anchor) return;
     const href = anchor.getAttribute('href');