jamdesk 1.1.102 → 1.1.104
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/__tests__/unit/dev-open-browser.test.d.ts +2 -0
- package/dist/__tests__/unit/dev-open-browser.test.d.ts.map +1 -0
- package/dist/__tests__/unit/dev-open-browser.test.js +123 -0
- package/dist/__tests__/unit/dev-open-browser.test.js.map +1 -0
- package/dist/__tests__/unit/dev-workspace-symlinks.test.d.ts +2 -0
- package/dist/__tests__/unit/dev-workspace-symlinks.test.d.ts.map +1 -0
- package/dist/__tests__/unit/dev-workspace-symlinks.test.js +112 -0
- package/dist/__tests__/unit/dev-workspace-symlinks.test.js.map +1 -0
- package/dist/__tests__/unit/first-run-banner.test.js +15 -15
- package/dist/__tests__/unit/first-run-banner.test.js.map +1 -1
- package/dist/__tests__/unit/language-filter.test.d.ts +2 -0
- package/dist/__tests__/unit/language-filter.test.d.ts.map +1 -0
- package/dist/__tests__/unit/language-filter.test.js +166 -0
- package/dist/__tests__/unit/language-filter.test.js.map +1 -0
- package/dist/commands/dev.d.ts +38 -0
- package/dist/commands/dev.d.ts.map +1 -1
- package/dist/commands/dev.js +88 -1
- package/dist/commands/dev.js.map +1 -1
- package/dist/commands/login.d.ts.map +1 -1
- package/dist/commands/login.js +2 -1
- package/dist/commands/login.js.map +1 -1
- package/dist/index.js +13 -6
- package/dist/index.js.map +1 -1
- package/dist/lib/config.d.ts +2 -0
- package/dist/lib/config.d.ts.map +1 -1
- package/dist/lib/config.js.map +1 -1
- package/dist/lib/first-run-banner.d.ts +1 -1
- package/dist/lib/first-run-banner.d.ts.map +1 -1
- package/dist/lib/first-run-banner.js +9 -1
- package/dist/lib/first-run-banner.js.map +1 -1
- package/dist/lib/language-filter.d.ts +31 -0
- package/dist/lib/language-filter.d.ts.map +1 -0
- package/dist/lib/language-filter.js +14 -0
- package/dist/lib/language-filter.js.map +1 -0
- package/dist/lib/open-url.d.ts +12 -0
- package/dist/lib/open-url.d.ts.map +1 -0
- package/dist/lib/open-url.js +14 -0
- package/dist/lib/open-url.js.map +1 -0
- package/package.json +1 -1
- package/vendored/workspace-package-lock.json +61 -61
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dev-open-browser.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/dev-open-browser.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,123 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @vitest-environment node
|
|
3
|
+
*
|
|
4
|
+
* Unit tests for the auto-open helpers (`resolveOpenPreference`,
|
|
5
|
+
* `shouldOpenBrowser`, `createBrowserOpener`) in `src/commands/dev.ts`.
|
|
6
|
+
* The helpers are pure, so flag/rc precedence and the fire-once guard
|
|
7
|
+
* are unit-tested in isolation without launching a browser.
|
|
8
|
+
*/
|
|
9
|
+
import { describe, it, expect, vi } from 'vitest';
|
|
10
|
+
import { shouldOpenBrowser, resolveOpenPreference, createBrowserOpener, } from '../../commands/dev.js';
|
|
11
|
+
// `openUrl` dynamic-imports `open`; mock it so the swallow/void contract is
|
|
12
|
+
// testable without a real browser. Inert for the pure-helper tests below
|
|
13
|
+
// (they inject their own `launch`/never import `open`).
|
|
14
|
+
vi.mock('open', () => ({ default: vi.fn() }));
|
|
15
|
+
const baseOpts = { port: '3000', verbose: false };
|
|
16
|
+
describe('shouldOpenBrowser', () => {
|
|
17
|
+
it('returns true by default (no flag, clean env)', () => {
|
|
18
|
+
expect(shouldOpenBrowser(baseOpts, {})).toBe(true);
|
|
19
|
+
});
|
|
20
|
+
it('returns true when open is explicitly true', () => {
|
|
21
|
+
expect(shouldOpenBrowser({ ...baseOpts, open: true }, {})).toBe(true);
|
|
22
|
+
});
|
|
23
|
+
it('returns false when open is false', () => {
|
|
24
|
+
expect(shouldOpenBrowser({ ...baseOpts, open: false }, {})).toBe(false);
|
|
25
|
+
});
|
|
26
|
+
it('returns false when CI is set', () => {
|
|
27
|
+
expect(shouldOpenBrowser(baseOpts, { CI: 'true' })).toBe(false);
|
|
28
|
+
});
|
|
29
|
+
it('returns false when JAMDESK_NO_OPEN is set', () => {
|
|
30
|
+
expect(shouldOpenBrowser(baseOpts, { JAMDESK_NO_OPEN: '1' })).toBe(false);
|
|
31
|
+
});
|
|
32
|
+
it('ignores empty-string env vars (commander/shell noise)', () => {
|
|
33
|
+
expect(shouldOpenBrowser(baseOpts, { CI: '', JAMDESK_NO_OPEN: '' })).toBe(true);
|
|
34
|
+
});
|
|
35
|
+
});
|
|
36
|
+
describe('resolveOpenPreference', () => {
|
|
37
|
+
it('defaults to true when nothing is set', () => {
|
|
38
|
+
expect(resolveOpenPreference(true, undefined)).toBe(true);
|
|
39
|
+
});
|
|
40
|
+
it('flag --no-open (false) always wins over rc', () => {
|
|
41
|
+
expect(resolveOpenPreference(false, true)).toBe(false);
|
|
42
|
+
});
|
|
43
|
+
it('rc "open": false opts out when flag not given', () => {
|
|
44
|
+
expect(resolveOpenPreference(true, false)).toBe(false);
|
|
45
|
+
});
|
|
46
|
+
it('rc "open": true keeps default on', () => {
|
|
47
|
+
expect(resolveOpenPreference(true, true)).toBe(true);
|
|
48
|
+
});
|
|
49
|
+
it('undefined flag behaves like default-on', () => {
|
|
50
|
+
expect(resolveOpenPreference(undefined, undefined)).toBe(true);
|
|
51
|
+
});
|
|
52
|
+
// ~/.jamdeskrc is parsed with a blind `as JamdeskConfig` cast (no schema
|
|
53
|
+
// validation), so the rc value may be a malformed-but-intentional opt-out.
|
|
54
|
+
it('rc "open": "false" (string) opts out — malformed but clear intent', () => {
|
|
55
|
+
expect(resolveOpenPreference(true, 'false')).toBe(false);
|
|
56
|
+
});
|
|
57
|
+
it('rc "open": 0 opts out', () => {
|
|
58
|
+
expect(resolveOpenPreference(true, 0)).toBe(false);
|
|
59
|
+
});
|
|
60
|
+
it('rc "open": null opts out', () => {
|
|
61
|
+
expect(resolveOpenPreference(true, null)).toBe(false);
|
|
62
|
+
});
|
|
63
|
+
it('flag --no-open still wins over a non-boolean rc value', () => {
|
|
64
|
+
expect(resolveOpenPreference(false, 'anything')).toBe(false);
|
|
65
|
+
});
|
|
66
|
+
it('a non-falsy non-boolean rc value does not opt out (only explicit falsy spellings)', () => {
|
|
67
|
+
expect(resolveOpenPreference(true, 'true')).toBe(true);
|
|
68
|
+
});
|
|
69
|
+
});
|
|
70
|
+
describe('createBrowserOpener', () => {
|
|
71
|
+
it('invokes launch once with the url when allowed', () => {
|
|
72
|
+
const launch = vi.fn();
|
|
73
|
+
const open = createBrowserOpener(() => true, launch);
|
|
74
|
+
open('http://localhost:3000/intro');
|
|
75
|
+
expect(launch).toHaveBeenCalledExactlyOnceWith('http://localhost:3000/intro');
|
|
76
|
+
});
|
|
77
|
+
it('is fire-once: the second call is a no-op', () => {
|
|
78
|
+
const launch = vi.fn();
|
|
79
|
+
const open = createBrowserOpener(() => true, launch);
|
|
80
|
+
open('http://localhost:3000/intro');
|
|
81
|
+
open('http://localhost:3000/intro');
|
|
82
|
+
expect(launch).toHaveBeenCalledTimes(1);
|
|
83
|
+
});
|
|
84
|
+
it('never launches when shouldOpen() is false', () => {
|
|
85
|
+
const launch = vi.fn();
|
|
86
|
+
const open = createBrowserOpener(() => false, launch);
|
|
87
|
+
open('http://localhost:3000/intro');
|
|
88
|
+
expect(launch).not.toHaveBeenCalled();
|
|
89
|
+
});
|
|
90
|
+
// The headline correctness claim of the feature: dev() builds ONE opener
|
|
91
|
+
// and calls it from two sites — site (a) with accessUrl during compile,
|
|
92
|
+
// site (b) with displayUrl in prewarm. These lock the no-double-open
|
|
93
|
+
// invariant across distinct call sites (not just a repeated same-url call).
|
|
94
|
+
it('two-call-site contract: fires once with the FIRST url even when a later site passes a different url', () => {
|
|
95
|
+
const launch = vi.fn();
|
|
96
|
+
const open = createBrowserOpener(() => true, launch);
|
|
97
|
+
open('http://localhost:3000/loading'); // site (a) accessUrl
|
|
98
|
+
open('http://localhost:3000/intro'); // site (b) displayUrl — no-op
|
|
99
|
+
expect(launch).toHaveBeenCalledExactlyOnceWith('http://localhost:3000/loading');
|
|
100
|
+
});
|
|
101
|
+
it('suppression holds across both call sites: zero opens when shouldOpen() is false', () => {
|
|
102
|
+
const launch = vi.fn();
|
|
103
|
+
const open = createBrowserOpener(() => false, launch);
|
|
104
|
+
open('http://localhost:3000/loading'); // site (a)
|
|
105
|
+
open('http://localhost:3000/intro'); // site (b)
|
|
106
|
+
expect(launch).not.toHaveBeenCalled();
|
|
107
|
+
});
|
|
108
|
+
});
|
|
109
|
+
describe('openUrl', () => {
|
|
110
|
+
it('returns void synchronously — never awaited on the dev hot path', async () => {
|
|
111
|
+
const { openUrl } = await import('../../lib/open-url.js');
|
|
112
|
+
expect(openUrl('http://localhost:3000/intro')).toBeUndefined();
|
|
113
|
+
});
|
|
114
|
+
it('swallows a rejecting open() — no throw, no unhandled rejection', async () => {
|
|
115
|
+
const { default: openMock } = await import('open');
|
|
116
|
+
vi.mocked(openMock).mockReturnValueOnce(Promise.reject(new Error('no display')));
|
|
117
|
+
const { openUrl } = await import('../../lib/open-url.js');
|
|
118
|
+
expect(() => openUrl('http://localhost:3000/intro')).not.toThrow();
|
|
119
|
+
// Flush the detached promise chain; the .catch(() => {}) must absorb it.
|
|
120
|
+
await new Promise((r) => setTimeout(r, 0));
|
|
121
|
+
});
|
|
122
|
+
});
|
|
123
|
+
//# sourceMappingURL=dev-open-browser.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dev-open-browser.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/dev-open-browser.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"dev-workspace-symlinks.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/dev-workspace-symlinks.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,112 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @vitest-environment node
|
|
3
|
+
*
|
|
4
|
+
* Tests prepareProjectWorkspaceLinks — replaces the single
|
|
5
|
+
* <workspace>/projects/<name> -> <projectDir> symlink with per-entry
|
|
6
|
+
* symlinks that skip non-active language directories. This is what
|
|
7
|
+
* actually reduces Turbopack's filesystem scan from 403 MDX files to
|
|
8
|
+
* 135 on jamdesk-docs.
|
|
9
|
+
*/
|
|
10
|
+
import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
|
|
11
|
+
import fs from 'fs-extra';
|
|
12
|
+
import path from 'path';
|
|
13
|
+
import { tmpdir } from 'os';
|
|
14
|
+
import { prepareProjectWorkspaceLinks } from '../../commands/dev.js';
|
|
15
|
+
import { output } from '../../lib/output.js';
|
|
16
|
+
describe('prepareProjectWorkspaceLinks', () => {
|
|
17
|
+
let tmpRoot;
|
|
18
|
+
let projectDir;
|
|
19
|
+
let workspaceProjectDir;
|
|
20
|
+
beforeEach(() => {
|
|
21
|
+
tmpRoot = fs.mkdtempSync(path.join(tmpdir(), 'jam-ws-'));
|
|
22
|
+
projectDir = path.join(tmpRoot, 'project');
|
|
23
|
+
workspaceProjectDir = path.join(tmpRoot, 'ws', 'projects', 'project');
|
|
24
|
+
// Set up a project layout that mirrors a multi-language docs project:
|
|
25
|
+
// project/
|
|
26
|
+
// ai/intro.mdx (en at root)
|
|
27
|
+
// development/foo.mdx (en at root)
|
|
28
|
+
// es/ai/intro.mdx (spanish)
|
|
29
|
+
// fr/ai/intro.mdx (french)
|
|
30
|
+
// docs.json
|
|
31
|
+
// images/logo.png
|
|
32
|
+
fs.mkdirpSync(path.join(projectDir, 'ai'));
|
|
33
|
+
fs.writeFileSync(path.join(projectDir, 'ai', 'intro.mdx'), '# en');
|
|
34
|
+
fs.mkdirpSync(path.join(projectDir, 'development'));
|
|
35
|
+
fs.writeFileSync(path.join(projectDir, 'development', 'foo.mdx'), '# en');
|
|
36
|
+
fs.mkdirpSync(path.join(projectDir, 'es', 'ai'));
|
|
37
|
+
fs.writeFileSync(path.join(projectDir, 'es', 'ai', 'intro.mdx'), '# es');
|
|
38
|
+
fs.mkdirpSync(path.join(projectDir, 'fr', 'ai'));
|
|
39
|
+
fs.writeFileSync(path.join(projectDir, 'fr', 'ai', 'intro.mdx'), '# fr');
|
|
40
|
+
fs.writeFileSync(path.join(projectDir, 'docs.json'), '{}');
|
|
41
|
+
fs.mkdirpSync(path.join(projectDir, 'images'));
|
|
42
|
+
fs.writeFileSync(path.join(projectDir, 'images', 'logo.png'), '');
|
|
43
|
+
});
|
|
44
|
+
afterEach(() => {
|
|
45
|
+
fs.removeSync(tmpRoot);
|
|
46
|
+
});
|
|
47
|
+
it('symlinks every top-level entry when skip set is empty', async () => {
|
|
48
|
+
await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set());
|
|
49
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'ai', 'intro.mdx'))).toBe(true);
|
|
50
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'es', 'ai', 'intro.mdx'))).toBe(true);
|
|
51
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'fr', 'ai', 'intro.mdx'))).toBe(true);
|
|
52
|
+
});
|
|
53
|
+
it('does not symlink docs.json (caller writes a filtered copy)', async () => {
|
|
54
|
+
// docs.json must not be symlinked — the caller writes a per-language
|
|
55
|
+
// filtered copy, and fs.writeFile through a symlink would clobber the
|
|
56
|
+
// user's source docs.json.
|
|
57
|
+
await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set());
|
|
58
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'docs.json'))).toBe(false);
|
|
59
|
+
});
|
|
60
|
+
it('skips entries whose names are in the skip set', async () => {
|
|
61
|
+
await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set(['es', 'fr']));
|
|
62
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'ai', 'intro.mdx'))).toBe(true);
|
|
63
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'development', 'foo.mdx'))).toBe(true);
|
|
64
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'images', 'logo.png'))).toBe(true);
|
|
65
|
+
// Skipped:
|
|
66
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'es'))).toBe(false);
|
|
67
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'fr'))).toBe(false);
|
|
68
|
+
// docs.json not symlinked — caller writes a filtered copy.
|
|
69
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'docs.json'))).toBe(false);
|
|
70
|
+
});
|
|
71
|
+
it('rebuilds the workspace links from scratch on subsequent calls', async () => {
|
|
72
|
+
// First call: no skip
|
|
73
|
+
await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set());
|
|
74
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'es'))).toBe(true);
|
|
75
|
+
// Second call: skip es
|
|
76
|
+
await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set(['es']));
|
|
77
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'es'))).toBe(false);
|
|
78
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'fr'))).toBe(true);
|
|
79
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'ai', 'intro.mdx'))).toBe(true);
|
|
80
|
+
});
|
|
81
|
+
it('handles a pre-existing single symlink at workspaceProjectDir (legacy layout)', async () => {
|
|
82
|
+
// Pre-create the legacy single-symlink layout
|
|
83
|
+
fs.mkdirpSync(path.dirname(workspaceProjectDir));
|
|
84
|
+
fs.symlinkSync(projectDir, workspaceProjectDir, 'junction');
|
|
85
|
+
await prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set(['es', 'fr']));
|
|
86
|
+
const lstat = fs.lstatSync(workspaceProjectDir);
|
|
87
|
+
expect(lstat.isDirectory()).toBe(true);
|
|
88
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'ai', 'intro.mdx'))).toBe(true);
|
|
89
|
+
expect(fs.existsSync(path.join(workspaceProjectDir, 'es'))).toBe(false);
|
|
90
|
+
});
|
|
91
|
+
it('surfaces friendly error (not raw stack trace) when fs.rm throws ENOTEMPTY', async () => {
|
|
92
|
+
// Regression: before safeRemoveCache, fs.remove raised an unfriendly stack
|
|
93
|
+
// trace when Turbopack still held open files. Now safeRemoveCache detects
|
|
94
|
+
// the race and calls process.exit(1) with a human-readable message.
|
|
95
|
+
const rmSpy = vi.spyOn(fs, 'rm');
|
|
96
|
+
const exitSpy = vi.spyOn(process, 'exit').mockImplementation(((code) => {
|
|
97
|
+
throw new Error(`process.exit:${code}`);
|
|
98
|
+
}));
|
|
99
|
+
const errorSpy = vi.spyOn(output, 'error').mockImplementation(() => undefined);
|
|
100
|
+
const enotempty = Object.assign(new Error('ENOTEMPTY'), { code: 'ENOTEMPTY' });
|
|
101
|
+
// fs.rm will be called by safeRemoveCache; make it fail with ENOTEMPTY
|
|
102
|
+
// even after the internal maxRetries — simulate persistent race condition.
|
|
103
|
+
rmSpy.mockRejectedValue(enotempty);
|
|
104
|
+
await expect(prepareProjectWorkspaceLinks(projectDir, workspaceProjectDir, new Set())).rejects.toThrow('process.exit:1');
|
|
105
|
+
const msg = errorSpy.mock.calls[0]?.[0] ?? '';
|
|
106
|
+
expect(msg).toContain('Another `jamdesk dev` instance');
|
|
107
|
+
expect(msg).toContain('pkill -f');
|
|
108
|
+
expect(exitSpy).toHaveBeenCalledWith(1);
|
|
109
|
+
vi.restoreAllMocks();
|
|
110
|
+
});
|
|
111
|
+
});
|
|
112
|
+
//# sourceMappingURL=dev-workspace-symlinks.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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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"}
|
|
@@ -39,45 +39,45 @@ afterEach(() => {
|
|
|
39
39
|
fs.rmSync(tmp, { recursive: true, force: true });
|
|
40
40
|
});
|
|
41
41
|
describe('maybeShowFirstRunBanner', () => {
|
|
42
|
-
it('shows the art once on the first real command, then writes the sentinel',
|
|
43
|
-
|
|
42
|
+
it('shows the art once on the first real command, then writes the sentinel', () => {
|
|
43
|
+
maybeShowFirstRunBanner({ argv: ['dev'], jamdeskDir: tmp });
|
|
44
44
|
const text = out();
|
|
45
45
|
expect(text).toContain('| | __ _ _ __ ___ __| | ___ ___| | __'); // art line
|
|
46
46
|
expect(text).toContain('Get started:');
|
|
47
47
|
expect(text).toContain('jamdesk init');
|
|
48
48
|
expect(fs.existsSync(path.join(tmp, '.welcomed'))).toBe(true);
|
|
49
49
|
});
|
|
50
|
-
it('stays silent once the sentinel exists (shows exactly once)',
|
|
50
|
+
it('stays silent once the sentinel exists (shows exactly once)', () => {
|
|
51
51
|
fs.writeFileSync(path.join(tmp, '.welcomed'), 'x\n');
|
|
52
|
-
|
|
52
|
+
maybeShowFirstRunBanner({ argv: ['dev'], jamdeskDir: tmp });
|
|
53
53
|
expect(out()).toBe('');
|
|
54
54
|
});
|
|
55
|
-
it('does not show OR consume first-run for --version',
|
|
56
|
-
|
|
55
|
+
it('does not show OR consume first-run for --version', () => {
|
|
56
|
+
maybeShowFirstRunBanner({ argv: ['--version'], jamdeskDir: tmp });
|
|
57
57
|
expect(out()).toBe('');
|
|
58
58
|
expect(fs.existsSync(path.join(tmp, '.welcomed'))).toBe(false);
|
|
59
59
|
});
|
|
60
|
-
it('does not show for bare `jamdesk` (help) or --json',
|
|
61
|
-
|
|
62
|
-
|
|
60
|
+
it('does not show for bare `jamdesk` (help) or --json', () => {
|
|
61
|
+
maybeShowFirstRunBanner({ argv: [], jamdeskDir: tmp });
|
|
62
|
+
maybeShowFirstRunBanner({ argv: ['doctor', '--json'], jamdeskDir: tmp });
|
|
63
63
|
expect(out()).toBe('');
|
|
64
64
|
expect(fs.existsSync(path.join(tmp, '.welcomed'))).toBe(false);
|
|
65
65
|
});
|
|
66
|
-
it('stays silent in CI',
|
|
66
|
+
it('stays silent in CI', () => {
|
|
67
67
|
process.env.CI = 'true';
|
|
68
|
-
|
|
68
|
+
maybeShowFirstRunBanner({ argv: ['dev'], jamdeskDir: tmp });
|
|
69
69
|
expect(out()).toBe('');
|
|
70
70
|
});
|
|
71
|
-
it('stays silent when stdout is not a TTY (piped / scripted)',
|
|
71
|
+
it('stays silent when stdout is not a TTY (piped / scripted)', () => {
|
|
72
72
|
Object.defineProperty(process.stdout, 'isTTY', { value: false, configurable: true });
|
|
73
|
-
|
|
73
|
+
maybeShowFirstRunBanner({ argv: ['dev'], jamdeskDir: tmp });
|
|
74
74
|
expect(out()).toBe('');
|
|
75
75
|
});
|
|
76
|
-
it('still prints (and never throws) if the sentinel write fails',
|
|
76
|
+
it('still prints (and never throws) if the sentinel write fails', () => {
|
|
77
77
|
// jamdeskDir points at a file → mkdir/write fail, banner must still show.
|
|
78
78
|
const asFile = path.join(tmp, 'not-a-dir');
|
|
79
79
|
fs.writeFileSync(asFile, 'x');
|
|
80
|
-
|
|
80
|
+
expect(() => maybeShowFirstRunBanner({ argv: ['dev'], jamdeskDir: asFile })).not.toThrow();
|
|
81
81
|
expect(out()).toContain('Get started:');
|
|
82
82
|
});
|
|
83
83
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"first-run-banner.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/first-run-banner.test.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAExE,IAAI,GAAW,CAAC;AAChB,IAAI,QAAqC,CAAC;AAC1C,MAAM,QAAQ,GAAG,MAAM,CAAC,wBAAwB,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1E,MAAM,QAAQ,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;AAE1F,SAAS,GAAG;IACV,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAY,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,UAAU,CAAC,GAAG,EAAE;IACd,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;IAC7D,QAAQ,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACnE,gEAAgE;IAChE,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;IACpF,OAAO,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;IACtB,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;AACvC,CAAC,CAAC,CAAC;AAEH,SAAS,CAAC,GAAG,EAAE;IACb,QAAQ,CAAC,WAAW,EAAE,CAAC;IACvB,IAAI,QAAQ;QAAE,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;IACvE,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,IAAI,CAAC,KAAK,SAAS;YAAE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;;YACtC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,wEAAwE,EAAE,
|
|
1
|
+
{"version":3,"file":"first-run-banner.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/first-run-banner.test.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"language-filter.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/unit/language-filter.test.ts"],"names":[],"mappings":""}
|
|
@@ -0,0 +1,166 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @vitest-environment node
|
|
3
|
+
*
|
|
4
|
+
* Tests for getActiveLanguageFilter — pure helper that decides which
|
|
5
|
+
* top-level language directories to skip when symlinking project content
|
|
6
|
+
* into the dev workspace. Multi-language sites' non-default languages
|
|
7
|
+
* inflate Turbopack's filesystem scan and balloon cold compile time
|
|
8
|
+
* (jamdesk-docs: 67s with 3 langs vs. 12.5s with 1 lang).
|
|
9
|
+
*/
|
|
10
|
+
import { describe, it, expect } from 'vitest';
|
|
11
|
+
import { getActiveLanguageFilter, isPageInSkippedLanguage, filterConfigByActiveLanguage, } from '../../lib/language-filter.js';
|
|
12
|
+
const config = (langs) => ({
|
|
13
|
+
navigation: { languages: langs.map(l => ({ language: l.language, default: l.default })) },
|
|
14
|
+
});
|
|
15
|
+
describe('getActiveLanguageFilter', () => {
|
|
16
|
+
it('returns null filter when project has no languages array', () => {
|
|
17
|
+
const result = getActiveLanguageFilter({ navigation: {} }, undefined, false);
|
|
18
|
+
expect(result).toEqual({ active: null, skip: new Set() });
|
|
19
|
+
});
|
|
20
|
+
it('returns null filter when project has only one language', () => {
|
|
21
|
+
const result = getActiveLanguageFilter(config([{ language: 'en', default: true }]), undefined, false);
|
|
22
|
+
expect(result).toEqual({ active: 'en', skip: new Set() });
|
|
23
|
+
});
|
|
24
|
+
it('skips non-default languages when active is the default', () => {
|
|
25
|
+
const result = getActiveLanguageFilter(config([
|
|
26
|
+
{ language: 'en', default: true },
|
|
27
|
+
{ language: 'es' },
|
|
28
|
+
{ language: 'fr' },
|
|
29
|
+
]), undefined, false);
|
|
30
|
+
expect(result.active).toBe('en');
|
|
31
|
+
expect(result.skip).toEqual(new Set(['es', 'fr']));
|
|
32
|
+
});
|
|
33
|
+
it('falls back to first language when none is marked default', () => {
|
|
34
|
+
const result = getActiveLanguageFilter(config([{ language: 'en' }, { language: 'es' }, { language: 'fr' }]), undefined, false);
|
|
35
|
+
expect(result.active).toBe('en');
|
|
36
|
+
expect(result.skip).toEqual(new Set(['es', 'fr']));
|
|
37
|
+
});
|
|
38
|
+
it('accepts --lang matching the default language (no-op equivalence)', () => {
|
|
39
|
+
const result = getActiveLanguageFilter(config([
|
|
40
|
+
{ language: 'en', default: true },
|
|
41
|
+
{ language: 'es' },
|
|
42
|
+
]), 'en', false);
|
|
43
|
+
expect(result.active).toBe('en');
|
|
44
|
+
expect(result.skip).toEqual(new Set(['es']));
|
|
45
|
+
});
|
|
46
|
+
it('throws on --lang for a non-default language (initial release scope)', () => {
|
|
47
|
+
// Non-default-language layouts mix root-level default-lang content with
|
|
48
|
+
// <lang>/ subdirs for translations; correctly stripping the default
|
|
49
|
+
// content while keeping <lang>/ takes more work and is deferred to a
|
|
50
|
+
// follow-up. For now, surface the workaround clearly.
|
|
51
|
+
expect(() => getActiveLanguageFilter(config([
|
|
52
|
+
{ language: 'en', default: true },
|
|
53
|
+
{ language: 'es' },
|
|
54
|
+
{ language: 'fr' },
|
|
55
|
+
]), 'es', false)).toThrow(/--lang es: previewing non-default languages.*--all-langs/i);
|
|
56
|
+
});
|
|
57
|
+
it('returns empty skip set when --all-langs is set', () => {
|
|
58
|
+
const result = getActiveLanguageFilter(config([
|
|
59
|
+
{ language: 'en', default: true },
|
|
60
|
+
{ language: 'es' },
|
|
61
|
+
]), undefined, true);
|
|
62
|
+
expect(result.active).toBe('en');
|
|
63
|
+
expect(result.skip).toEqual(new Set());
|
|
64
|
+
});
|
|
65
|
+
it('throws on --lang code that does not exist in docs.json', () => {
|
|
66
|
+
expect(() => getActiveLanguageFilter(config([{ language: 'en', default: true }, { language: 'es' }]), 'de', false)).toThrow(/--lang de.*not.*docs\.json.*Available: en, es/);
|
|
67
|
+
});
|
|
68
|
+
it('handles malformed languages array (entries missing language field) by ignoring them', () => {
|
|
69
|
+
const malformed = {
|
|
70
|
+
navigation: {
|
|
71
|
+
languages: [
|
|
72
|
+
{ language: 'en', default: true },
|
|
73
|
+
{ default: false }, // missing language: ignored
|
|
74
|
+
{ language: 'es' },
|
|
75
|
+
{ language: 42 }, // wrong type: ignored
|
|
76
|
+
],
|
|
77
|
+
},
|
|
78
|
+
};
|
|
79
|
+
const result = getActiveLanguageFilter(malformed, undefined, false);
|
|
80
|
+
expect(result.active).toBe('en');
|
|
81
|
+
expect(result.skip).toEqual(new Set(['es']));
|
|
82
|
+
});
|
|
83
|
+
it('returns null active when no valid language entries exist', () => {
|
|
84
|
+
const result = getActiveLanguageFilter({ navigation: { languages: [{ default: true }] } }, undefined, false);
|
|
85
|
+
expect(result).toEqual({ active: null, skip: new Set() });
|
|
86
|
+
});
|
|
87
|
+
it('rejects empty-string --lang as an invalid code (commander passes "" through)', () => {
|
|
88
|
+
// commander.js treats `--lang ""` as a value, not as missing — so
|
|
89
|
+
// langOption is "" (defined, but empty). Empty string is never a valid
|
|
90
|
+
// language code; surface it as a clear error rather than silently
|
|
91
|
+
// falling back to the default.
|
|
92
|
+
expect(() => getActiveLanguageFilter(config([{ language: 'en', default: true }, { language: 'es' }]), '', false)).toThrow(/--lang.*not.*docs\.json/);
|
|
93
|
+
});
|
|
94
|
+
});
|
|
95
|
+
describe('isPageInSkippedLanguage', () => {
|
|
96
|
+
it('returns false when skip set is empty', () => {
|
|
97
|
+
expect(isPageInSkippedLanguage('fr/introduction', new Set())).toBe(false);
|
|
98
|
+
});
|
|
99
|
+
it('returns true when first path segment is a skipped language', () => {
|
|
100
|
+
expect(isPageInSkippedLanguage('fr/introduction', new Set(['fr']))).toBe(true);
|
|
101
|
+
});
|
|
102
|
+
it('returns true for nested paths inside a skipped language', () => {
|
|
103
|
+
expect(isPageInSkippedLanguage('fr/setup/connecting-github', new Set(['fr', 'de']))).toBe(true);
|
|
104
|
+
});
|
|
105
|
+
it('returns false when first segment is the active language', () => {
|
|
106
|
+
expect(isPageInSkippedLanguage('en/introduction', new Set(['fr']))).toBe(false);
|
|
107
|
+
});
|
|
108
|
+
it('returns false for unprefixed root pages', () => {
|
|
109
|
+
expect(isPageInSkippedLanguage('introduction', new Set(['fr']))).toBe(false);
|
|
110
|
+
});
|
|
111
|
+
it('does not match when the skip code is a prefix-substring of a different segment', () => {
|
|
112
|
+
// Guard against startsWith('fr/') matching e.g. 'fr-something/foo'
|
|
113
|
+
expect(isPageInSkippedLanguage('fr-something/foo', new Set(['fr']))).toBe(false);
|
|
114
|
+
});
|
|
115
|
+
it('returns true for a path with a fragment anchor in a skipped language', () => {
|
|
116
|
+
// Broken-anchor warnings from validate-links.cjs surface as link values
|
|
117
|
+
// like `fr/introduction#missing-section` — the fragment lives past the
|
|
118
|
+
// first segment so the language check still works.
|
|
119
|
+
expect(isPageInSkippedLanguage('fr/introduction#setup', new Set(['fr']))).toBe(true);
|
|
120
|
+
});
|
|
121
|
+
});
|
|
122
|
+
describe('filterConfigByActiveLanguage', () => {
|
|
123
|
+
it('returns the input unchanged (same reference) when skip is empty', () => {
|
|
124
|
+
const config = { name: 'foo', navigation: { languages: [{ language: 'en' }] } };
|
|
125
|
+
const result = filterConfigByActiveLanguage(config, { active: 'en', skip: new Set() });
|
|
126
|
+
expect(result).toBe(config);
|
|
127
|
+
});
|
|
128
|
+
it('drops skipped languages from navigation.languages', () => {
|
|
129
|
+
const config = {
|
|
130
|
+
name: 'jamdesk-docs',
|
|
131
|
+
navigation: {
|
|
132
|
+
languages: [
|
|
133
|
+
{ language: 'en', default: true, tabs: [{ tab: 'Guide' }] },
|
|
134
|
+
{ language: 'fr', tabs: [{ tab: 'Guide' }] },
|
|
135
|
+
{ language: 'de', tabs: [{ tab: 'Guide' }] },
|
|
136
|
+
],
|
|
137
|
+
},
|
|
138
|
+
};
|
|
139
|
+
const result = filterConfigByActiveLanguage(config, {
|
|
140
|
+
active: 'en',
|
|
141
|
+
skip: new Set(['fr', 'de']),
|
|
142
|
+
});
|
|
143
|
+
expect(result.navigation.languages).toEqual([
|
|
144
|
+
{ language: 'en', default: true, tabs: [{ tab: 'Guide' }] },
|
|
145
|
+
]);
|
|
146
|
+
// Top-level fields preserved.
|
|
147
|
+
expect(result.name).toBe('jamdesk-docs');
|
|
148
|
+
// Original config untouched.
|
|
149
|
+
expect(config.navigation.languages).toHaveLength(3);
|
|
150
|
+
});
|
|
151
|
+
it('preserves other navigation fields (tabs, global, anchors, etc.)', () => {
|
|
152
|
+
const config = {
|
|
153
|
+
navigation: {
|
|
154
|
+
languages: [{ language: 'en' }, { language: 'fr' }],
|
|
155
|
+
global: { anchors: [{ anchor: 'Support' }] },
|
|
156
|
+
},
|
|
157
|
+
};
|
|
158
|
+
const result = filterConfigByActiveLanguage(config, {
|
|
159
|
+
active: 'en',
|
|
160
|
+
skip: new Set(['fr']),
|
|
161
|
+
});
|
|
162
|
+
expect(result.navigation.global).toEqual({ anchors: [{ anchor: 'Support' }] });
|
|
163
|
+
expect(result.navigation.languages).toHaveLength(1);
|
|
164
|
+
});
|
|
165
|
+
});
|
|
166
|
+
//# sourceMappingURL=language-filter.test.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"language-filter.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/language-filter.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,4BAA4B,GAC7B,MAAM,8BAA8B,CAAC;AAEtC,MAAM,MAAM,GAAG,CAAC,KAAgD,EAAE,EAAE,CAAC,CAAC;IACpE,UAAU,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE;CAC1F,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,MAAM,GAAG,uBAAuB,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAC7E,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,EAAU,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,MAAM,GAAG,uBAAuB,CACpC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAC3C,SAAS,EACT,KAAK,CACN,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,EAAU,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,MAAM,GAAG,uBAAuB,CACpC,MAAM,CAAC;YACL,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;YACjC,EAAE,QAAQ,EAAE,IAAI,EAAE;YAClB,EAAE,QAAQ,EAAE,IAAI,EAAE;SACnB,CAAC,EACF,SAAS,EACT,KAAK,CACN,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,MAAM,GAAG,uBAAuB,CACpC,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EACpE,SAAS,EACT,KAAK,CACN,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,MAAM,GAAG,uBAAuB,CACpC,MAAM,CAAC;YACL,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;YACjC,EAAE,QAAQ,EAAE,IAAI,EAAE;SACnB,CAAC,EACF,IAAI,EACJ,KAAK,CACN,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,GAAG,EAAE;QAC7E,wEAAwE;QACxE,oEAAoE;QACpE,qEAAqE;QACrE,sDAAsD;QACtD,MAAM,CAAC,GAAG,EAAE,CACV,uBAAuB,CACrB,MAAM,CAAC;YACL,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;YACjC,EAAE,QAAQ,EAAE,IAAI,EAAE;YAClB,EAAE,QAAQ,EAAE,IAAI,EAAE;SACnB,CAAC,EACF,IAAI,EACJ,KAAK,CACN,CACF,CAAC,OAAO,CAAC,2DAA2D,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,MAAM,GAAG,uBAAuB,CACpC,MAAM,CAAC;YACL,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;YACjC,EAAE,QAAQ,EAAE,IAAI,EAAE;SACnB,CAAC,EACF,SAAS,EACT,IAAI,CACL,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,EAAU,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,CAAC,GAAG,EAAE,CACV,uBAAuB,CACrB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAC/D,IAAI,EACJ,KAAK,CACN,CACF,CAAC,OAAO,CAAC,+CAA+C,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qFAAqF,EAAE,GAAG,EAAE;QAC7F,MAAM,SAAS,GAAG;YAChB,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;oBACjC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAU,4BAA4B;oBACxD,EAAE,QAAQ,EAAE,IAAI,EAAE;oBAClB,EAAE,QAAQ,EAAE,EAAuB,EAAE,EAAE,sBAAsB;iBAC9D;aACF;SACF,CAAC;QACF,MAAM,MAAM,GAAG,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QACpE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,MAAM,GAAG,uBAAuB,CACpC,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAClD,SAAS,EACT,KAAK,CACN,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,EAAU,EAAE,CAAC,CAAC;IACpE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8EAA8E,EAAE,GAAG,EAAE;QACtF,kEAAkE;QAClE,uEAAuE;QACvE,kEAAkE;QAClE,+BAA+B;QAC/B,MAAM,CAAC,GAAG,EAAE,CACV,uBAAuB,CACrB,MAAM,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAC/D,EAAE,EACF,KAAK,CACN,CACF,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,CAAC,uBAAuB,CAAC,iBAAiB,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,CAAC,uBAAuB,CAAC,iBAAiB,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CACJ,uBAAuB,CAAC,4BAA4B,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAC7E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,uBAAuB,CAAC,iBAAiB,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,uBAAuB,CAAC,cAAc,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gFAAgF,EAAE,GAAG,EAAE;QACxF,mEAAmE;QACnE,MAAM,CAAC,uBAAuB,CAAC,kBAAkB,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,wEAAwE;QACxE,uEAAuE;QACvE,mDAAmD;QACnD,MAAM,CAAC,uBAAuB,CAAC,uBAAuB,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,MAAM,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QAChF,MAAM,MAAM,GAAG,4BAA4B,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC,CAAC;QACvF,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG;YACb,IAAI,EAAE,cAAc;YACpB,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE;oBAC3D,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE;oBAC5C,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE;iBAC7C;aACF;SACF,CAAC;QACF,MAAM,MAAM,GAAG,4BAA4B,CAAC,MAAM,EAAE;YAClD,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;SAC5B,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC;YAC1C,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE;SAC5D,CAAC,CAAC;QACH,8BAA8B;QAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACzC,6BAA6B;QAC7B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,MAAM,GAAG;YACb,UAAU,EAAE;gBACV,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;gBACnD,MAAM,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE;aAC7C;SACF,CAAC;QACF,MAAM,MAAM,GAAG,4BAA4B,CAAC,MAAM,EAAE;YAClD,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;SACtB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/E,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
|
package/dist/commands/dev.d.ts
CHANGED
|
@@ -21,11 +21,49 @@ export declare function resolveNextBin(depsDir: string): {
|
|
|
21
21
|
bin: string;
|
|
22
22
|
shell: boolean;
|
|
23
23
|
};
|
|
24
|
+
/**
|
|
25
|
+
* Resolve the effective auto-open preference from the `--no-open` flag and
|
|
26
|
+
* the `~/.jamdeskrc` `"open"` setting. Precedence: an explicit `--no-open`
|
|
27
|
+
* (flag === false) always wins; otherwise a persistent rc opt-out wins;
|
|
28
|
+
* otherwise default on. Same flag-beats-rc precedence intent as the `port`
|
|
29
|
+
* resolution in index.ts (env is gated separately in shouldOpenBrowser).
|
|
30
|
+
*
|
|
31
|
+
* `rcValue` is typed `unknown`: `~/.jamdeskrc` is JSON5-parsed with a blind
|
|
32
|
+
* `as JamdeskConfig` cast (no schema validation), so a user may write
|
|
33
|
+
* `"open": "false"` / `0` / `null` meaning to opt out. Honor every explicit
|
|
34
|
+
* falsy spelling — only a strict `true` or an absent key keeps default-on,
|
|
35
|
+
* so a well-intentioned-but-malformed opt-out isn't silently ignored.
|
|
36
|
+
* Pure + exported for testing.
|
|
37
|
+
*/
|
|
38
|
+
export declare function resolveOpenPreference(flagValue: boolean | undefined, rcValue: unknown): boolean;
|
|
39
|
+
/**
|
|
40
|
+
* Decide whether `jamdesk dev` should auto-open the browser.
|
|
41
|
+
*
|
|
42
|
+
* Applies the environment gate on top of the already-resolved
|
|
43
|
+
* `options.open`. Empty-string env vars are treated as unset — Commander and
|
|
44
|
+
* some shells surface `''` for absent values, and a truthy check there would
|
|
45
|
+
* wrongly suppress the open. NOT gated on `stdout.isTTY`: builder/CLAUDE.md's
|
|
46
|
+
* own debug hint pipes `jamdesk dev … 2>&1 | tee`, which must still
|
|
47
|
+
* auto-open. Pure + exported (same pattern as `resolveNextBin`).
|
|
48
|
+
*/
|
|
49
|
+
export declare function shouldOpenBrowser(options: DevOptions, env: NodeJS.ProcessEnv): boolean;
|
|
50
|
+
/**
|
|
51
|
+
* Build a fire-once browser opener. `shouldOpen` is re-checked on first call;
|
|
52
|
+
* the side-effecting `launch` (console line + dynamic `open` import) is
|
|
53
|
+
* injected so the guard is unit-testable with a spy. Subsequent calls are
|
|
54
|
+
* no-ops — `dev()` invokes it from two call sites (loading-server path and
|
|
55
|
+
* fallback prewarm) and only the first reached should actually open.
|
|
56
|
+
* Callers must construct a fresh opener per `dev()` invocation (not at
|
|
57
|
+
* module scope) so the fire-once state is per-run.
|
|
58
|
+
*/
|
|
59
|
+
export declare function createBrowserOpener(shouldOpen: () => boolean, launch: (url: string) => void): (url: string) => void;
|
|
24
60
|
export interface DevOptions {
|
|
25
61
|
port: string;
|
|
26
62
|
verbose: boolean;
|
|
27
63
|
webpack?: boolean;
|
|
28
64
|
clean?: boolean;
|
|
65
|
+
/** Resolved in index.ts from `--no-open` + ~/.jamdeskrc; default true. */
|
|
66
|
+
open?: boolean;
|
|
29
67
|
}
|
|
30
68
|
/**
|
|
31
69
|
* Returns the resolved (installed) Next.js version from
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;
|
|
1
|
+
{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiCH;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAO/E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,OAAO,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,GACf,OAAO,CAWT;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,UAAU,EACnB,GAAG,EAAE,MAAM,CAAC,UAAU,GACrB,OAAO,CAKT;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,OAAO,EACzB,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,GAC5B,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAQvB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0EAA0E;IAC1E,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAqCD;;;;;;;;;GASG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAO9E;AA+GD;;;;GAIG;AAGH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,GACxC,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA4E/D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,OAAO,CAAC,CAkElB;AAED,wBAAsB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA66B5D"}
|