jamdesk 1.1.74 → 1.1.76

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":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AAC5B,OAAO,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,IAAI,OAAe,CAAC;IACpB,IAAI,UAAkB,CAAC;IACvB,IAAI,mBAA2B,CAAC;IAEhC,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;QACzD,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC3C,mBAAmB,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;QAEtE,sEAAsE;QACtE,aAAa;QACb,sCAAsC;QACtC,uCAAuC;QACvC,mCAAmC;QACnC,kCAAkC;QAClC,gBAAgB;QAChB,sBAAsB;QACtB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;QAC3C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;QACnE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC,CAAC;QACpD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1E,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACjD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;QACzE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACjD,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;QACzE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,EAAE,IAAI,CAAC,CAAC;QAC3D,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC/C,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,4BAA4B,CAAC,UAAU,EAAE,mBAAmB,EAAE,IAAI,GAAG,EAAU,CAAC,CAAC;QAEvF,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpF,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1F,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC1E,qEAAqE;QACrE,sEAAsE;QACtE,2BAA2B;QAC3B,MAAM,4BAA4B,CAAC,UAAU,EAAE,mBAAmB,EAAE,IAAI,GAAG,EAAU,CAAC,CAAC;QACvF,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,4BAA4B,CAAC,UAAU,EAAE,mBAAmB,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAE3F,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpF,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3F,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvF,WAAW;QACX,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxE,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxE,2DAA2D;QAC3D,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC7E,sBAAsB;QACtB,MAAM,4BAA4B,CAAC,UAAU,EAAE,mBAAmB,EAAE,IAAI,GAAG,EAAU,CAAC,CAAC;QACvF,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEvE,uBAAuB;QACvB,MAAM,4BAA4B,CAAC,UAAU,EAAE,mBAAmB,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACrF,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxE,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8EAA8E,EAAE,KAAK,IAAI,EAAE;QAC5F,8CAA8C;QAC9C,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC;QACjD,EAAE,CAAC,WAAW,CAAC,UAAU,EAAE,mBAAmB,EAAE,UAAU,CAAC,CAAC;QAE5D,MAAM,4BAA4B,CAAC,UAAU,EAAE,mBAAmB,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAE3F,MAAM,KAAK,GAAG,EAAE,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpF,MAAM,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2EAA2E,EAAE,KAAK,IAAI,EAAE;QACzF,2EAA2E;QAC3E,0EAA0E;QAC1E,oEAAoE;QACpE,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACjC,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAa,EAAE,EAAE;YAC9E,MAAM,IAAI,KAAK,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;QAC1C,CAAC,CAAU,CAAC,CAAC;QACb,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAE/E,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QAC/E,uEAAuE;QACvE,2EAA2E;QAC3E,KAAK,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;QAEnC,MAAM,MAAM,CACV,4BAA4B,CAAC,UAAU,EAAE,mBAAmB,EAAE,IAAI,GAAG,EAAE,CAAC,CACzE,CAAC,OAAO,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAEpC,MAAM,GAAG,GAAY,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAY,IAAI,EAAE,CAAC;QAClE,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;QACxD,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAClC,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;QAExC,EAAE,CAAC,eAAe,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

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/__tests__/unit/output.test.d.ts

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

package/dist/__tests__/unit/output.test.d.ts.map

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

package/dist/__tests__/unit/output.test.js

@@ -0,0 +1,61 @@
+/**
+ * @vitest-environment node
+ *
+ * Unit tests for output.runWithSlowHint. Covers the close race where
+ * the timer fires on the same tick as the work resolving — `done`
+ * must short-circuit the callback to avoid a stale hint after success.
+ */
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { output } from '../../lib/output.js';
+describe('output.runWithSlowHint', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    afterEach(() => {
+        vi.useRealTimers();
+    });
+    it('does not fire onSlow when work resolves before the threshold', async () => {
+        const onSlow = vi.fn();
+        const promise = output.runWithSlowHint(1000, onSlow, async () => {
+            await new Promise((r) => setTimeout(r, 500));
+            return 'done';
+        });
+        await vi.advanceTimersByTimeAsync(500);
+        const result = await promise;
+        expect(result).toBe('done');
+        expect(onSlow).not.toHaveBeenCalled();
+        // Run any pending timers to confirm the hint stays suppressed even
+        // if the cleanup happened to lose the clearTimeout race.
+        await vi.advanceTimersByTimeAsync(2000);
+        expect(onSlow).not.toHaveBeenCalled();
+    });
+    it('fires onSlow exactly once when work runs past the threshold', async () => {
+        const onSlow = vi.fn();
+        const promise = output.runWithSlowHint(1000, onSlow, async () => {
+            await new Promise((r) => setTimeout(r, 3000));
+            return 42;
+        });
+        await vi.advanceTimersByTimeAsync(1000);
+        expect(onSlow).toHaveBeenCalledTimes(1);
+        await vi.advanceTimersByTimeAsync(2000);
+        const result = await promise;
+        expect(result).toBe(42);
+        expect(onSlow).toHaveBeenCalledTimes(1);
+    });
+    it('clears the timer when work rejects', async () => {
+        const onSlow = vi.fn();
+        const error = new Error('boom');
+        const promise = output.runWithSlowHint(1000, onSlow, async () => {
+            throw error;
+        });
+        await expect(promise).rejects.toBe(error);
+        await vi.advanceTimersByTimeAsync(2000);
+        expect(onSlow).not.toHaveBeenCalled();
+    });
+    it('returns the work result through to the caller', async () => {
+        const onSlow = vi.fn();
+        const result = await output.runWithSlowHint(1000, onSlow, async () => ({ a: 1 }));
+        expect(result).toEqual({ a: 1 });
+    });
+});
+//# sourceMappingURL=output.test.js.map

package/dist/__tests__/unit/output.test.js.map

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

package/dist/lib/deps.js

@@ -24,13 +24,13 @@ const JAMDESK_DIR = path.join(homedir(), '.jamdesk');
 // compiled dist/lib/deps.js instead of re-parsing the TypeScript source.
 export const REQUIRED_DEPS = {
     // Next.js and React
-    'next': '^16.2.5',
+    'next': '^16.2.6',
     // OpenAPI validation (for API reference docs)
     '@apidevtools/swagger-parser': '^12.1.0',
     'openapi-types': '^12.1.3',
     'react': '^19.2.6',
     'react-dom': '^19.2.6',
-    '@next/mdx': '^16.2.5',
+    '@next/mdx': '^16.2.6',
     'next-mdx-remote': '^6.0.0',
     'next-themes': '^0.4.6',
     // Icons
@@ -88,10 +88,10 @@ export const REQUIRED_DEPS = {
     '@upstash/redis': '^1.37.0',
     // TypeScript (needed for Next.js to avoid auto-install breaking symlink)
     'typescript': '^6.0.3',
-    '@types/node': '^25.5.2',
+    '@types/node': '^25.6.2',
     '@types/react': '^19.2.14',
     '@types/react-dom': '^19.0.0',
-    '@next/third-parties': '^16.2.5',
+    '@next/third-parties': '^16.2.6',
 };
 /**
  * Generate a hash of REQUIRED_DEPS to detect when dependencies change.

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.74",
+  "version": "1.1.76",
   "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",
@@ -115,12 +115,12 @@
     "nspell": "^2.1.5",
     "open": "^11.0.0",
     "ora": "^9.4.0",
-    "tar": "^7.5.14"
+    "tar": "^7.5.15"
   },
   "devDependencies": {
     "@mdx-js/mdx": "^3.1.1",
     "@types/fs-extra": "^11.0.0",
-    "@types/node": "^25.5.0",
+    "@types/node": "^25.6.2",
     "typescript": "^6.0.2",
     "vitest": "^4.1.5"
   },

package/vendored/app/[[...slug]]/page.tsx

@@ -4,6 +4,7 @@
 // `/[project]/...` URLs without middleware involvement (used by tests and
 // non-ISR local dev). The render body lives in lib/render-doc-page.tsx.
 import { headers } from 'next/headers';
+import { after } from 'next/server';
 import fs from 'fs';
 import path from 'path';
 import type { Metadata } from 'next';
@@ -14,6 +15,7 @@ import {
   getHostAtDocs,
 } from '@/lib/content-loader';
 import { renderDocPage, buildDocMetadata, type RenderInput } from '@/lib/render-doc-page';
+import { withR2OpsContext, emitR2OpsSummary } from '@/lib/r2-content';
 import { readFileSync as readMdxFile } from '@/lib/fs-readfile';
 
 export const dynamic = 'force-dynamic';
@@ -195,11 +197,17 @@ async function resolveInput(params: PageProps['params']): Promise<RenderInput> {
 }
 
 export async function generateMetadata({ params }: PageProps): Promise<Metadata> {
-  const input = await resolveInput(params);
-  return buildDocMetadata(input);
+  return withR2OpsContext(async () => {
+    const input = await resolveInput(params);
+    after(() => emitR2OpsSummary(input.projectSlug, 'page-metadata'));
+    return buildDocMetadata(input);
+  });
 }
 
 export default async function DocPage({ params }: PageProps) {
-  const input = await resolveInput(params);
-  return renderDocPage(input);
+  return withR2OpsContext(async () => {
+    const input = await resolveInput(params);
+    after(() => emitR2OpsSummary(input.projectSlug, 'page-render'));
+    return renderDocPage(input);
+  });
 }

package/vendored/app/layout.tsx

@@ -7,6 +7,7 @@
 // producing the visible flash + next-themes script-tag warnings.
 import type { Metadata } from 'next';
 import { headers } from 'next/headers';
+import { after } from 'next/server';
 import './globals.css';
 import { getDocsConfig } from '@/lib/docs';
 import { getDocsConfig as getIsrDocsConfig } from '@/lib/docs-isr';
@@ -19,10 +20,10 @@ import {
 import { isRTLLanguage, resolveLanguageWithFallback } from '@/lib/language-utils';
 import type { DocsConfig } from '@/lib/docs-types';
 import { buildSiteTitle, getFaviconPath, FALLBACK_METADATA } from '@/lib/seo';
-import { fetchCustomCss, fetchCustomJs } from '@/lib/r2-content';
-import { DocsChrome, getLocalFileContent } from '@/lib/layout-helpers';
+import { withR2OpsContext, emitR2OpsSummary } from '@/lib/r2-content';
+import { DocsChrome, getLocalFileContent, loadCustomAssets } from '@/lib/layout-helpers';
 
-export async function generateMetadata(): Promise<Metadata> {
+async function generateMetadataImpl(): Promise<Metadata> {
   // The placeholder shell would otherwise render with the paused
   // project's title/favicon (and pay an R2 round-trip for it) — the
   // nested (jd-system)/jd-inactive layout supplies neutral metadata.
@@ -32,6 +33,11 @@ export async function generateMetadata(): Promise<Metadata> {
       return {robots: {index: false, follow: false}};
     }
   }
+
+  // No-op when no R2 ops happened (incl. flag-off path) — paths that do no
+  // R2 work simply log nothing.
+  after(() => emitR2OpsSummary(null, 'layout-metadata'));
+
   let config: DocsConfig;
   if (isIsrMode()) {
     const headersList = await headers();
@@ -60,7 +66,11 @@ export async function generateMetadata(): Promise<Metadata> {
   };
 }
 
-export default async function RootLayout({
+export async function generateMetadata(): Promise<Metadata> {
+  return withR2OpsContext(() => generateMetadataImpl());
+}
+
+async function rootLayoutImpl({
   children,
 }: {
   children: React.ReactNode;
@@ -158,12 +168,11 @@ export default async function RootLayout({
   let customCss: string | null = null;
   let customJs: string | null = null;
   if (isIsr && resolvedProjectSlug) {
-    if (config._hasCustomCss) {
-      customCss = await fetchCustomCss(resolvedProjectSlug);
-    }
-    if (config._hasCustomJs) {
-      customJs = await fetchCustomJs(resolvedProjectSlug);
-    }
+    ({ customCss, customJs } = await loadCustomAssets({
+      projectSlug: resolvedProjectSlug,
+      hasCustomCss: !!config._hasCustomCss,
+      hasCustomJs: !!config._hasCustomJs,
+    }));
   } else {
     customCss = getLocalFileContent('custom.css');
     customJs = getLocalFileContent('custom.js');
@@ -173,6 +182,8 @@ export default async function RootLayout({
   const lang = getLanguageFromRequest(headersList) ?? projectDefaultLang;
   const dir = isRTLLanguage(lang) ? 'rtl' : undefined;
 
+  after(() => emitR2OpsSummary(resolvedProjectSlug, 'layout-render'));
+
   return (
     <DocsChrome
       config={config}
@@ -187,3 +198,7 @@ export default async function RootLayout({
     </DocsChrome>
   );
 }
+
+export default async function RootLayout(props: { children: React.ReactNode }) {
+  return withR2OpsContext(() => rootLayoutImpl(props));
+}