jamdesk 1.1.109 → 1.1.111
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-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/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/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/package.json +1 -1
- package/vendored/app/[[...slug]]/error.tsx +1 -1
- package/vendored/components/errors/NotFoundContent.tsx +1 -1
- package/vendored/components/mdx/Accordion.tsx +1 -1
- package/vendored/components/mdx/Expandable.tsx +1 -1
- package/vendored/components/mdx/MDXComponents.tsx +1 -1
- package/vendored/components/mdx/OpenApiEndpoint.tsx +4 -4
- package/vendored/components/mdx/View.tsx +2 -2
- package/vendored/components/navigation/Header.tsx +10 -2
- package/vendored/components/navigation/Sidebar.tsx +2 -2
- package/vendored/components/navigation/TabsNav.tsx +13 -48
- package/vendored/components/theme/ThemeToggle.tsx +2 -2
- package/vendored/workspace-package-lock.json +16 -16
|
@@ -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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"}
|
|
@@ -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":"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"}
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Picks which `<lang>/` directories under projectDir to keep as workspace
|
|
3
|
+
* symlinks and which to skip. Skipping non-active language directories
|
|
4
|
+
* shrinks Turbopack's filesystem scan and dropped cold compile from ~67s
|
|
5
|
+
* to ~12s on jamdesk-docs (commit 90d781b4).
|
|
6
|
+
*
|
|
7
|
+
* The dev server still reads content from the user's source tree via
|
|
8
|
+
* JAMDESK_PROJECTS_DIR, so the language picker keeps showing every
|
|
9
|
+
* language and clicks always 200 OK — the workspace symlinks are a
|
|
10
|
+
* Turbopack-only performance layer.
|
|
11
|
+
*
|
|
12
|
+
* Default rules:
|
|
13
|
+
* 1. Language with `default: true`
|
|
14
|
+
* 2. First language in `navigation.languages[]`
|
|
15
|
+
*/
|
|
16
|
+
export interface LanguageFilter {
|
|
17
|
+
active: string | null;
|
|
18
|
+
skip: Set<string>;
|
|
19
|
+
}
|
|
20
|
+
interface NavigationLanguageEntry {
|
|
21
|
+
language?: string;
|
|
22
|
+
default?: boolean;
|
|
23
|
+
}
|
|
24
|
+
interface MinimalConfig {
|
|
25
|
+
navigation?: {
|
|
26
|
+
languages?: NavigationLanguageEntry[];
|
|
27
|
+
};
|
|
28
|
+
}
|
|
29
|
+
export declare function getActiveLanguageFilter(config: MinimalConfig): LanguageFilter;
|
|
30
|
+
export {};
|
|
31
|
+
//# sourceMappingURL=language-filter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
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"}
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
export function getActiveLanguageFilter(config) {
|
|
2
|
+
const validEntries = (config.navigation?.languages ?? []).filter((l) => typeof l.language === 'string');
|
|
3
|
+
if (validEntries.length === 0) {
|
|
4
|
+
return { active: null, skip: new Set() };
|
|
5
|
+
}
|
|
6
|
+
const codes = validEntries.map((l) => l.language);
|
|
7
|
+
const active = validEntries.find((l) => l.default)?.language ?? validEntries[0].language;
|
|
8
|
+
if (codes.length === 1) {
|
|
9
|
+
return { active, skip: new Set() };
|
|
10
|
+
}
|
|
11
|
+
const skip = new Set(codes.filter((c) => c !== active));
|
|
12
|
+
return { active, skip };
|
|
13
|
+
}
|
|
14
|
+
//# sourceMappingURL=language-filter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "jamdesk",
|
|
3
|
-
"version": "1.1.
|
|
3
|
+
"version": "1.1.111",
|
|
4
4
|
"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",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"jamdesk",
|
|
@@ -73,7 +73,7 @@ The preprocessor should handle this automatically, but if you see this error:
|
|
|
73
73
|
<div className="flex gap-4 justify-center">
|
|
74
74
|
<button
|
|
75
75
|
onClick={reset}
|
|
76
|
-
className="px-4 py-2 bg-theme-accent text-white rounded-lg hover:opacity-90 transition-opacity"
|
|
76
|
+
className="px-4 py-2 bg-theme-accent text-white rounded-lg hover:opacity-90 transition-opacity cursor-pointer"
|
|
77
77
|
>
|
|
78
78
|
Try again
|
|
79
79
|
</button>
|
|
@@ -111,7 +111,7 @@ export function NotFoundContent({ config }: NotFoundContentProps) {
|
|
|
111
111
|
<div className="flex flex-col sm:flex-row gap-3">
|
|
112
112
|
<button
|
|
113
113
|
onClick={() => onSearchOpen()}
|
|
114
|
-
className="inline-flex items-center justify-center gap-2 px-5 py-2.5 rounded-lg border border-[var(--color-border)] text-[var(--color-text-primary)] hover:bg-[var(--color-bg-secondary)] transition-colors"
|
|
114
|
+
className="inline-flex items-center justify-center gap-2 px-5 py-2.5 rounded-lg border border-[var(--color-border)] text-[var(--color-text-primary)] hover:bg-[var(--color-bg-secondary)] transition-colors cursor-pointer"
|
|
115
115
|
>
|
|
116
116
|
<i className="fa-solid fa-magnifying-glass text-sm" aria-hidden="true" />
|
|
117
117
|
Search docs
|
|
@@ -38,7 +38,7 @@ export const Accordion = memo(function Accordion({
|
|
|
38
38
|
<button
|
|
39
39
|
type="button"
|
|
40
40
|
onClick={() => setIsOpen(!isOpen)}
|
|
41
|
-
className="w-full flex items-center gap-3 p-4 text-left hover:bg-[var(--color-bg-secondary)] transition-colors"
|
|
41
|
+
className="w-full flex items-center gap-3 p-4 text-left hover:bg-[var(--color-bg-secondary)] transition-colors cursor-pointer"
|
|
42
42
|
aria-expanded={isOpen}
|
|
43
43
|
>
|
|
44
44
|
{/* Icon */}
|
|
@@ -18,7 +18,7 @@ export function Expandable({ title, children, defaultOpen = false }: ExpandableP
|
|
|
18
18
|
return (
|
|
19
19
|
<div className="border border-[var(--color-border)] rounded-lg my-4 overflow-hidden not-prose">
|
|
20
20
|
<button
|
|
21
|
-
className="w-full px-4 py-3 flex items-center gap-2 text-left bg-theme-bg-secondary hover:bg-theme-bg-tertiary transition-colors"
|
|
21
|
+
className="w-full px-4 py-3 flex items-center gap-2 text-left bg-theme-bg-secondary hover:bg-theme-bg-tertiary transition-colors cursor-pointer"
|
|
22
22
|
onClick={() => setIsOpen(!isOpen)}
|
|
23
23
|
>
|
|
24
24
|
<span className="font-medium text-theme-text-primary capitalize">{title}</span>
|
|
@@ -156,7 +156,7 @@ function HttpCodeBlock({ method, url }: { method: string; url: string }) {
|
|
|
156
156
|
</span>
|
|
157
157
|
{/* Copy button - functionality added via client-side script */}
|
|
158
158
|
<button
|
|
159
|
-
className="http-copy-btn p-1.5 text-[var(--color-text-muted)] hover:text-[var(--color-text-primary)] hover:bg-[var(--color-bg-secondary)] rounded-md transition-colors flex-shrink-0"
|
|
159
|
+
className="http-copy-btn cursor-pointer p-1.5 text-[var(--color-text-muted)] hover:text-[var(--color-text-primary)] hover:bg-[var(--color-bg-secondary)] rounded-md transition-colors flex-shrink-0"
|
|
160
160
|
title="Copy"
|
|
161
161
|
aria-label="Copy"
|
|
162
162
|
type="button"
|
|
@@ -161,7 +161,7 @@ function BodyFieldItem({
|
|
|
161
161
|
<div className="pb-4">
|
|
162
162
|
<button
|
|
163
163
|
onClick={() => setExpanded(!expanded)}
|
|
164
|
-
className="flex items-center gap-1.5 text-[13px] text-[var(--color-text-muted)] hover:text-[var(--color-text-secondary)] transition-colors"
|
|
164
|
+
className="flex items-center gap-1.5 text-[13px] text-[var(--color-text-muted)] hover:text-[var(--color-text-secondary)] transition-colors cursor-pointer"
|
|
165
165
|
>
|
|
166
166
|
<i className={`fa-solid fa-chevron-right text-[10px] transition-transform ${expanded ? 'rotate-90' : ''}`} aria-hidden="true" />
|
|
167
167
|
{expanded ? 'Hide child attributes' : 'Show child attributes'}
|
|
@@ -425,8 +425,8 @@ function ResponseSection({
|
|
|
425
425
|
<button
|
|
426
426
|
key={code}
|
|
427
427
|
onClick={() => setActiveCode(code)}
|
|
428
|
-
className={`text-sm font-medium transition-colors ${
|
|
429
|
-
isActive
|
|
428
|
+
className={`text-sm font-medium transition-colors cursor-pointer ${
|
|
429
|
+
isActive
|
|
430
430
|
? 'text-[var(--color-text-primary)]'
|
|
431
431
|
: 'text-[var(--color-text-muted)] hover:text-[var(--color-text-primary)]'
|
|
432
432
|
}`}
|
|
@@ -703,7 +703,7 @@ function ResponseFieldItem({
|
|
|
703
703
|
<div className="px-4 pb-4">
|
|
704
704
|
<button
|
|
705
705
|
onClick={() => setExpanded(!expanded)}
|
|
706
|
-
className="flex items-center gap-1.5 text-[13px] text-[var(--color-text-muted)] hover:text-[var(--color-text-secondary)] transition-colors"
|
|
706
|
+
className="flex items-center gap-1.5 text-[13px] text-[var(--color-text-muted)] hover:text-[var(--color-text-secondary)] transition-colors cursor-pointer"
|
|
707
707
|
>
|
|
708
708
|
<i className={`fa-solid fa-chevron-right text-[10px] transition-transform ${expanded ? 'rotate-90' : ''}`} aria-hidden="true" />
|
|
709
709
|
{expanded ? 'Hide child attributes' : 'Show child attributes'}
|
|
@@ -187,7 +187,7 @@ export function ViewSelector({ className = '' }: ViewSelectorProps) {
|
|
|
187
187
|
ref={buttonRef}
|
|
188
188
|
type="button"
|
|
189
189
|
onClick={() => setIsOpen(!isOpen)}
|
|
190
|
-
className="flex items-center gap-2 px-3 py-1.5 text-sm font-medium rounded-lg border border-[var(--color-border)] bg-[var(--color-bg-primary)] hover:bg-[var(--color-bg-secondary)] transition-colors"
|
|
190
|
+
className="flex items-center gap-2 px-3 py-1.5 text-sm font-medium rounded-lg border border-[var(--color-border)] bg-[var(--color-bg-primary)] hover:bg-[var(--color-bg-secondary)] transition-colors cursor-pointer"
|
|
191
191
|
aria-expanded={isOpen}
|
|
192
192
|
aria-haspopup="listbox"
|
|
193
193
|
aria-label={`Select view, current: ${currentView?.title || 'none'}`}
|
|
@@ -224,7 +224,7 @@ export function ViewSelector({ className = '' }: ViewSelectorProps) {
|
|
|
224
224
|
setFocusedIndex(-1);
|
|
225
225
|
}}
|
|
226
226
|
onMouseEnter={() => setFocusedIndex(index)}
|
|
227
|
-
className={`w-full flex items-center gap-2 px-3 py-2 text-sm text-left transition-colors outline-none ${
|
|
227
|
+
className={`w-full flex items-center gap-2 px-3 py-2 text-sm text-left transition-colors outline-none cursor-pointer ${
|
|
228
228
|
view.title === selectedView
|
|
229
229
|
? 'text-[var(--color-primary)] font-medium'
|
|
230
230
|
: 'text-[var(--color-text-primary)]'
|
|
@@ -64,7 +64,10 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
|
|
|
64
64
|
// `config.theme` so uppercase docs.json values like "NEBULA" still match.
|
|
65
65
|
const useCompactSearch = themeConfig.name === 'nebula';
|
|
66
66
|
const effectiveTabsPosition: TabsPosition = config.tabsPosition || tabsPositionProp || themeConfig.defaultTabsPosition;
|
|
67
|
-
|
|
67
|
+
// Inline header tabs only render in the sidebar-logo layout (Pulsar). In header-logo
|
|
68
|
+
// layouts (Jam, Nebula), LayoutWrapper mounts <TabsNav> below the header as the
|
|
69
|
+
// canonical top-position renderer — rendering them here too would double them up.
|
|
70
|
+
const showTabsInHeader = effectiveTabsPosition === 'top' && layout === 'sidebar-logo';
|
|
68
71
|
|
|
69
72
|
// Get tabs from navigation config (check both direct tabs and languages wrapper)
|
|
70
73
|
const navigationTabs = useMemo(() => {
|
|
@@ -278,6 +281,11 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
|
|
|
278
281
|
|
|
279
282
|
return (
|
|
280
283
|
<>
|
|
284
|
+
{/* `data-has-tabs` reflects ONLY the inline header tabs (sidebar-logo + top).
|
|
285
|
+
In header-logo + top the canonical tab strip is the sibling <TabsNav> below,
|
|
286
|
+
so this attribute is `false` even though tabs ARE visible on the page.
|
|
287
|
+
CSS that wants to detect the canonical tab strip's presence should target
|
|
288
|
+
`.sidebar-scroll[data-has-tabs="true"]` instead (set by Sidebar.tsx). */}
|
|
281
289
|
<header className={headerClasses} data-has-tabs={showTabsInHeader && hasTabs ? 'true' : 'false'}>
|
|
282
290
|
<div className="max-w-[1440px] 2xl:mx-auto flex items-center py-3" style={{ margin: '0 24px' }}>
|
|
283
291
|
{/* Left: Hamburger + Logo */}
|
|
@@ -392,7 +400,7 @@ export function Header({ config, layout = 'header-logo', tabsPosition: tabsPosit
|
|
|
392
400
|
<div ref={tabsDropdownRef} className="relative">
|
|
393
401
|
<button
|
|
394
402
|
onClick={() => setIsTabsDropdownOpen(!isTabsDropdownOpen)}
|
|
395
|
-
className={`relative flex items-center gap-1.5 px-3 py-2 text-sm font-medium transition-colors
|
|
403
|
+
className={`relative flex items-center gap-1.5 px-3 py-2 text-sm font-medium transition-colors cursor-pointer
|
|
396
404
|
${isOverflowActive
|
|
397
405
|
? 'text-[var(--color-text-primary)]'
|
|
398
406
|
: 'text-[var(--color-text-tertiary)] hover:text-[var(--color-text-primary)]'
|
|
@@ -383,7 +383,7 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
|
|
|
383
383
|
) : (
|
|
384
384
|
<button
|
|
385
385
|
onClick={() => handleGroupClick(group)}
|
|
386
|
-
className={`nav-group-l1 flex items-center gap-1.5 ${layout === 'header-logo' ? 'pr-3' : 'px-3'} py-1.5 rounded-lg text-sm transition-colors w-full text-left text-[var(--color-text-tertiary)] hover:text-[var(--color-text-primary)]`}
|
|
386
|
+
className={`nav-group-l1 flex items-center gap-1.5 ${layout === 'header-logo' ? 'pr-3' : 'px-3'} py-1.5 rounded-lg text-sm transition-colors w-full text-left text-[var(--color-text-tertiary)] hover:text-[var(--color-text-primary)] cursor-pointer`}
|
|
387
387
|
>
|
|
388
388
|
<span className="truncate">{group.name}</span>
|
|
389
389
|
<i
|
|
@@ -693,7 +693,7 @@ export function Sidebar({ config, layout = 'header-logo', tabsPosition: tabsPosi
|
|
|
693
693
|
</div>
|
|
694
694
|
<button
|
|
695
695
|
onClick={onClose}
|
|
696
|
-
className="p-1.5 text-[var(--color-text-secondary)] hover:text-[var(--color-text-primary)] hover:bg-[var(--color-bg-secondary)] rounded-lg transition-colors"
|
|
696
|
+
className="p-1.5 text-[var(--color-text-secondary)] hover:text-[var(--color-text-primary)] hover:bg-[var(--color-bg-secondary)] rounded-lg transition-colors cursor-pointer"
|
|
697
697
|
aria-label="Close sidebar"
|
|
698
698
|
>
|
|
699
699
|
<i className="fa-solid fa-xmark text-[18px]" aria-hidden="true" />
|
|
@@ -4,12 +4,7 @@ import { useMemo } from 'react';
|
|
|
4
4
|
import Link from 'next/link';
|
|
5
5
|
import { usePathname } from 'next/navigation';
|
|
6
6
|
// Icons use Font Awesome CSS classes for lightweight rendering
|
|
7
|
-
import type {
|
|
8
|
-
DocsConfig,
|
|
9
|
-
GroupConfig,
|
|
10
|
-
NavigationPage,
|
|
11
|
-
TabsPosition,
|
|
12
|
-
} from '@/lib/docs-types';
|
|
7
|
+
import type { DocsConfig, TabsPosition } from '@/lib/docs-types';
|
|
13
8
|
import { resolveNavigation } from '@/lib/navigation-resolver';
|
|
14
9
|
import { getIconClass } from '@/lib/icon-utils';
|
|
15
10
|
import { getTheme } from '@/themes';
|
|
@@ -56,7 +51,7 @@ export function TabsNav({ config, className = '' }: TabsNavProps) {
|
|
|
56
51
|
isActive: false,
|
|
57
52
|
};
|
|
58
53
|
}
|
|
59
|
-
|
|
54
|
+
|
|
60
55
|
// For internal tabs, find first page to link to
|
|
61
56
|
// We need to look into the tab's groups
|
|
62
57
|
let firstPath: string | null = null;
|
|
@@ -86,52 +81,18 @@ export function TabsNav({ config, className = '' }: TabsNavProps) {
|
|
|
86
81
|
firstPath = firstPage.page;
|
|
87
82
|
}
|
|
88
83
|
}
|
|
89
|
-
|
|
90
|
-
//
|
|
91
|
-
//
|
|
92
|
-
const
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
const checkPages = (pages: (NavigationPage | GroupConfig)[]): boolean => {
|
|
96
|
-
for (const page of pages) {
|
|
97
|
-
const pagePath =
|
|
98
|
-
typeof page === 'string'
|
|
99
|
-
? page
|
|
100
|
-
: 'page' in page
|
|
101
|
-
? page.page
|
|
102
|
-
: 'group' in page
|
|
103
|
-
? page.group
|
|
104
|
-
: undefined;
|
|
105
|
-
if (pagePath && (pagePath === currentPath || currentPath.startsWith(pagePath + '/'))) {
|
|
106
|
-
return true;
|
|
107
|
-
}
|
|
108
|
-
// Check nested groups
|
|
109
|
-
if (typeof page !== 'string' && 'pages' in page && page.pages) {
|
|
110
|
-
if (checkPages(page.pages)) return true;
|
|
111
|
-
}
|
|
112
|
-
}
|
|
113
|
-
return false;
|
|
114
|
-
};
|
|
115
|
-
|
|
116
|
-
if (tab.groups) {
|
|
117
|
-
for (const group of tab.groups) {
|
|
118
|
-
if (group.pages && checkPages(group.pages)) {
|
|
119
|
-
isActive = true;
|
|
120
|
-
break;
|
|
121
|
-
}
|
|
122
|
-
}
|
|
123
|
-
}
|
|
124
|
-
if (!isActive && tab.pages) {
|
|
125
|
-
isActive = checkPages(tab.pages);
|
|
126
|
-
}
|
|
127
|
-
|
|
84
|
+
|
|
85
|
+
// Defer to navigation-resolver's findActiveTab — single source of truth.
|
|
86
|
+
// Keeps multilingual path-stripping rules and nested-group recursion in one place.
|
|
87
|
+
const isActive = resolved.activeTab === resolvedTab.name;
|
|
88
|
+
|
|
128
89
|
return {
|
|
129
90
|
...resolvedTab,
|
|
130
91
|
path: firstPath ? `${linkPrefix}/${firstPath}` : '#',
|
|
131
92
|
isActive,
|
|
132
93
|
};
|
|
133
94
|
});
|
|
134
|
-
}, [configTabs, resolved.tabs,
|
|
95
|
+
}, [configTabs, resolved.tabs, resolved.activeTab, linkPrefix, effectiveTabsPosition]);
|
|
135
96
|
|
|
136
97
|
// TabsNav is only for 'top' position - when tabs should appear below header
|
|
137
98
|
// When tabsPosition is 'left', tabs are rendered in the Sidebar instead
|
|
@@ -145,7 +106,11 @@ export function TabsNav({ config, className = '' }: TabsNavProps) {
|
|
|
145
106
|
|
|
146
107
|
return (
|
|
147
108
|
<nav className={`hidden lg:block ${className}`}>
|
|
148
|
-
|
|
109
|
+
{/* flex-wrap so the row degrades to two lines instead of clipping when
|
|
110
|
+
the project has many tabs and/or a narrow desktop viewport.
|
|
111
|
+
Left margin is 12px (not 24px) to offset the first tab's `px-3`
|
|
112
|
+
padding so the first tab icon aligns with the sidebar group icons. */}
|
|
113
|
+
<div className="flex flex-wrap items-center gap-x-2 gap-y-1 py-3" style={{ margin: '0 24px 0 12px', borderBottom: '0.5px solid var(--color-border)' }}>
|
|
149
114
|
{tabsWithPaths.map((tab) => {
|
|
150
115
|
if (tab.isExternal && tab.href) {
|
|
151
116
|
return (
|
|
@@ -27,7 +27,7 @@ export function ThemeToggle({ size = 'default' }: ThemeToggleProps) {
|
|
|
27
27
|
const containerClass = isLarge
|
|
28
28
|
? 'flex items-center gap-1 bg-[var(--color-bg-secondary)] rounded-xl px-1.5 py-1.5 border border-[var(--color-border)]'
|
|
29
29
|
: 'flex items-center gap-1 bg-[var(--color-bg-secondary)]/50 rounded-md px-0.5 py-0.5 border border-[var(--color-border)]/50';
|
|
30
|
-
const buttonClass = isLarge ? 'px-5 py-3 rounded-lg' : 'px-1.5 py-0.5 rounded';
|
|
30
|
+
const buttonClass = isLarge ? 'px-5 py-3 rounded-lg cursor-pointer' : 'px-1.5 py-0.5 rounded cursor-pointer';
|
|
31
31
|
const iconClass = isLarge ? 'text-[20px]' : 'text-[12px]';
|
|
32
32
|
|
|
33
33
|
useEffect(() => {
|
|
@@ -97,7 +97,7 @@ export function ThemeToggleCycle() {
|
|
|
97
97
|
return (
|
|
98
98
|
<button
|
|
99
99
|
onClick={cycleTheme}
|
|
100
|
-
className="p-1.5 bg-[var(--color-bg-secondary)]/50 border border-[var(--color-border)]/50 text-[var(--color-text-secondary)] hover:text-[var(--color-text-primary)] hover:bg-[var(--color-bg-secondary)] rounded-md transition-colors"
|
|
100
|
+
className="p-1.5 bg-[var(--color-bg-secondary)]/50 border border-[var(--color-border)]/50 text-[var(--color-text-secondary)] hover:text-[var(--color-text-primary)] hover:bg-[var(--color-bg-secondary)] rounded-md transition-colors cursor-pointer"
|
|
101
101
|
aria-label={label}
|
|
102
102
|
title={label}
|
|
103
103
|
>
|
|
@@ -135,12 +135,12 @@
|
|
|
135
135
|
}
|
|
136
136
|
},
|
|
137
137
|
"node_modules/@babel/code-frame": {
|
|
138
|
-
"version": "7.29.
|
|
139
|
-
"resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.
|
|
140
|
-
"integrity": "sha512-
|
|
138
|
+
"version": "7.29.7",
|
|
139
|
+
"resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.7.tgz",
|
|
140
|
+
"integrity": "sha512-Aup7aUOfpbAUg2ROOJN6Iw5f9DMBlzu0mIkm/malLQFN/YQgO48wCj0Kxa3sEHJvPVFg7siR+qRInwXd2qhQKw==",
|
|
141
141
|
"license": "MIT",
|
|
142
142
|
"dependencies": {
|
|
143
|
-
"@babel/helper-validator-identifier": "^7.
|
|
143
|
+
"@babel/helper-validator-identifier": "^7.29.7",
|
|
144
144
|
"js-tokens": "^4.0.0",
|
|
145
145
|
"picocolors": "^1.1.1"
|
|
146
146
|
},
|
|
@@ -149,18 +149,18 @@
|
|
|
149
149
|
}
|
|
150
150
|
},
|
|
151
151
|
"node_modules/@babel/helper-validator-identifier": {
|
|
152
|
-
"version": "7.
|
|
153
|
-
"resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.
|
|
154
|
-
"integrity": "sha512-
|
|
152
|
+
"version": "7.29.7",
|
|
153
|
+
"resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.29.7.tgz",
|
|
154
|
+
"integrity": "sha512-qehxGkRj55h/ff8EMaJ+cYhyaKlHIxqYDn682wQD7RNp9UujOQsHog2uS0r2vzr4pW+sXf90NeeayjcNaX3fFg==",
|
|
155
155
|
"license": "MIT",
|
|
156
156
|
"engines": {
|
|
157
157
|
"node": ">=6.9.0"
|
|
158
158
|
}
|
|
159
159
|
},
|
|
160
160
|
"node_modules/@babel/standalone": {
|
|
161
|
-
"version": "7.29.
|
|
162
|
-
"resolved": "https://registry.npmjs.org/@babel/standalone/-/standalone-7.29.
|
|
163
|
-
"integrity": "sha512-
|
|
161
|
+
"version": "7.29.7",
|
|
162
|
+
"resolved": "https://registry.npmjs.org/@babel/standalone/-/standalone-7.29.7.tgz",
|
|
163
|
+
"integrity": "sha512-oFh9XoGL20UuHIeIuBQHOvF7r2dOCRnZW0r4SageGb9SWnt6HhbuPLREykNaEnP7/SRpMUwr50SSMJLrmeHvnQ==",
|
|
164
164
|
"license": "MIT",
|
|
165
165
|
"engines": {
|
|
166
166
|
"node": ">=6.9.0"
|
|
@@ -2837,9 +2837,9 @@
|
|
|
2837
2837
|
}
|
|
2838
2838
|
},
|
|
2839
2839
|
"node_modules/dayjs": {
|
|
2840
|
-
"version": "1.11.
|
|
2841
|
-
"resolved": "https://registry.npmjs.org/dayjs/-/dayjs-1.11.
|
|
2842
|
-
"integrity": "sha512-
|
|
2840
|
+
"version": "1.11.21",
|
|
2841
|
+
"resolved": "https://registry.npmjs.org/dayjs/-/dayjs-1.11.21.tgz",
|
|
2842
|
+
"integrity": "sha512-98IT+HOahAisibz/yjKbzuOBwYcjJ7BCLPzARyHiyEBmRz4fatF+KPJszEHXsGYjUG234aH/cOjW1wwTbKUZlA==",
|
|
2843
2843
|
"license": "MIT"
|
|
2844
2844
|
},
|
|
2845
2845
|
"node_modules/debug": {
|
|
@@ -2959,9 +2959,9 @@
|
|
|
2959
2959
|
}
|
|
2960
2960
|
},
|
|
2961
2961
|
"node_modules/es-toolkit": {
|
|
2962
|
-
"version": "1.
|
|
2963
|
-
"resolved": "https://registry.npmjs.org/es-toolkit/-/es-toolkit-1.
|
|
2964
|
-
"integrity": "sha512-
|
|
2962
|
+
"version": "1.47.0",
|
|
2963
|
+
"resolved": "https://registry.npmjs.org/es-toolkit/-/es-toolkit-1.47.0.tgz",
|
|
2964
|
+
"integrity": "sha512-n1GuoD0WEQZMBk5tttoZSqwgyLx01oqa5XsBmCHwPyNe1S9jPBEmtR2pSgp2kJuWE3ciFZ6yRHmY4pM4C3OOkw==",
|
|
2965
2965
|
"license": "MIT",
|
|
2966
2966
|
"workspaces": [
|
|
2967
2967
|
"docs",
|