jamdesk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Jamdesk
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,323 @@
+# Jamdesk CLI
+
+[![npm version](https://img.shields.io/npm/v/jamdesk)](https://www.npmjs.com/package/jamdesk)
+[![Node.js](https://img.shields.io/node/v/jamdesk)](https://nodejs.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
+
+CLI for [Jamdesk](https://jamdesk.com) — build, preview, and deploy documentation sites from MDX.
+
+![Jamdesk documentation site showing dark mode with sidebar navigation and API reference](https://jamdesk.com/cli-screenshot.jpg)
+
+## What is Jamdesk?
+
+Jamdesk is a docs-as-code platform. Connect a GitHub repo, write in MDX, and your docs deploy globally in seconds — with AI search, analytics, and custom domains built in. The CLI is how you develop locally: preview your site, validate config, catch broken links, and migrate from other tools.
+
+- **Dev server** — Turbopack-powered with hot reload on every save
+- **50+ MDX components** — accordions, tabs, code groups, callouts, [and more](https://jamdesk.com/docs/components/overview)
+- **Three themes** — Jam, Nebula, Pulsar. Configured in `docs.json`
+- **OpenAPI** — auto-generate API reference pages from your specs
+- **Full-text search** — works locally and in production, with AI search on hosted sites
+- **Validation** — broken links, MDX syntax errors, config issues. Catch them before deploy
+- **Mintlify migration** — one command to convert your existing docs
+
+## Quick Start
+
+```bash
+jamdesk init my-docs
+cd my-docs
+jamdesk dev
+```
+
+Your docs are at **http://localhost:3000/docs**. That's it.
+
+## Installation
+
+### npm (recommended)
+
+```bash
+npm install -g jamdesk
+```
+
+### Homebrew (macOS/Linux)
+
+```bash
+brew tap jamdesk/tap
+brew install jamdesk
+```
+
+### curl (macOS/Linux)
+
+```bash
+curl -fsSL https://get.jamdesk.com | bash
+
+# Install specific version
+curl -fsSL https://get.jamdesk.com | bash -s -- --version 1.2.3
+
+# Upgrade
+curl -fsSL https://get.jamdesk.com/upgrade | bash
+
+# Uninstall
+curl -fsSL https://get.jamdesk.com/uninstall | bash
+```
+
+### PowerShell (Windows)
+
+```powershell
+# Install
+iwr https://get.jamdesk.com/win | iex
+
+# Upgrade
+iwr https://get.jamdesk.com/upgrade | iex
+
+# Uninstall
+iwr https://get.jamdesk.com/uninstall | iex
+```
+
+### npx (no install)
+
+```bash
+npx jamdesk dev
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `jamdesk init [name]` | Create a new docs project |
+| `jamdesk dev` | Start dev server with Turbopack |
+| `jamdesk preview` | Alias for `jamdesk dev` |
+| `jamdesk dev --webpack` | Use Webpack instead of Turbopack |
+| `jamdesk dev --clean` | Clear cache before starting |
+| `jamdesk dev --port 3001` | Custom port |
+| `jamdesk migrate` | Migrate from Mintlify |
+| `jamdesk validate` | Validate docs.json, MDX syntax, OpenAPI specs |
+| `jamdesk openapi-check <spec>` | Validate a single OpenAPI spec |
+| `jamdesk broken-links` | Find broken internal links |
+| `jamdesk rename <from> <to>` | Rename file, update all references |
+| `jamdesk deploy <target>` | Deploy wizard (Cloudflare Worker setup, auth, config) |
+| `jamdesk doctor` | Diagnose environment issues |
+| `jamdesk clean` | Clear ~/.jamdesk cache |
+| `jamdesk update` | Update to latest version |
+| `jamdesk update --check` | Check for updates without installing |
+
+All commands support `--verbose`. Run `jamdesk <command> --help` for details.
+
+## Dev Server
+
+Run `jamdesk dev` at the root of your project (where `docs.json` lives) to preview docs locally. Turbopack is the default and compiles roughly 5x faster than Webpack.
+
+```bash
+jamdesk dev              # Turbopack (default)
+jamdesk dev --webpack    # Webpack (slower, more compatible)
+jamdesk dev --clean      # Clear cache first
+jamdesk dev --port 3001  # Custom port
+```
+
+The dev server auto-validates on startup, auto-recovers from corrupted Turbopack cache, and auto-increments the port if yours is taken. Full search, all themes, and all components work locally.
+
+Set a default port in `~/.jamdeskrc`:
+
+```json
+{
+  "defaultPort": 3001
+}
+```
+
+## Validation
+
+### `jamdesk validate`
+
+Checks your project for issues:
+
+- **docs.json** — schema validation against the [Jamdesk spec](https://jamdesk.com/docs/config/docs-json-reference)
+- **MDX syntax** — catches things like `<50%` being parsed as JSX
+- **OpenAPI specs** — validates if configured
+- **Navigation** — warns when pages in your nav don't exist
+
+```bash
+jamdesk validate
+jamdesk validate --skip-mdx    # Skip MDX checks
+```
+
+Example output:
+
+```
+✗ Found 1 MDX syntax error(s)
+
+  getting-started.mdx:42
+    Unexpected character `5` (U+0035) before name
+    Fix: A < character is being parsed as JSX. Use &lt; or rewrite (e.g., "Below 50%" instead of "<50%")
+```
+
+### `jamdesk openapi-check`
+
+Validate a single OpenAPI spec:
+
+```bash
+jamdesk openapi-check path/to/openapi.yaml
+```
+
+Reports endpoint count, schemas, tags. Warns if you're on Swagger 2.0.
+
+### `jamdesk broken-links`
+
+Find broken internal links across your docs:
+
+```bash
+jamdesk broken-links
+```
+
+```
+docs/getting-started.mdx:15 - /docs/quikstart
+  Did you mean: /docs/quickstart
+
+Found 1 broken link in 45 files.
+```
+
+## File Management
+
+Rename a page and every reference updates automatically — docs.json navigation, internal links, snippet imports:
+
+```bash
+jamdesk rename docs/old-name.mdx docs/new-name.mdx
+```
+
+## Migration
+
+### `jamdesk migrate`
+
+Migrate from Mintlify to Jamdesk:
+
+```bash
+cd /path/to/mintlify-docs
+jamdesk migrate
+```
+
+Detects your `mint.json`, converts config to `docs.json`, lets you pick a theme, copies everything.
+
+**What gets converted:**
+
+- **Config** — `mint.json` → `docs.json` (navbar, navigation, footer, SEO, appearance)
+- **Components** — deprecated components like `<CardGroup>` → `<Columns>`
+- **React hooks** — inline components with `useState`/`useEffect` get extracted to `/snippets` as `.tsx` files with `'use client'`
+- **Video embeds** — iframe normalization
+
+| Option | Description |
+|--------|-------------|
+| `--yes`, `-y` | Skip confirmation prompts |
+| `--theme <theme>` | Pre-select theme (`jam`, `nebula`, `pulsar`) |
+
+After migration:
+
+```bash
+cd jamdesk-docs
+jamdesk dev
+```
+
+See the [migration guide](https://jamdesk.com/docs/migration) for the full list of conversions.
+
+## Deployment
+
+### Jamdesk Hosting
+
+Push your docs to GitHub and Jamdesk builds and deploys them automatically. Your site gets a `*.jamdesk.app` subdomain with SSL, AI search, analytics, and custom domain support — no infrastructure to manage.
+
+[Get started with Jamdesk hosting](https://jamdesk.com/docs/quickstart)
+
+### Cloudflare Worker (subpath hosting)
+
+Host your docs at a subpath on your existing domain (e.g., `yoursite.com/docs`) using a Cloudflare Worker:
+
+```bash
+jamdesk deploy cloudflare
+```
+
+The wizard handles wrangler setup, Cloudflare auth, zone selection, and worker generation. Supports multiple accounts.
+
+| Option | Description |
+|--------|-------------|
+| `--slug <slug>` | Project slug (skip auto-detection) |
+| `--domain <domain>` | Target domain (e.g., yoursite.com) |
+| `--path <path>` | Path prefix (default: /docs) |
+| `--output-dir <dir>` | Output directory (default: cloudflare-worker/) |
+| `--skip-deploy` | Generate files only |
+| `--force` | Overwrite existing directory |
+| `--yes` | Skip prompts (CI mode) |
+
+```bash
+jamdesk deploy cloudflare --slug acme --domain example.com --path /docs --yes
+```
+
+Generates `index.js`, `wrangler.toml`, `package.json`, and `.gitignore`. Deploy manually with `npx wrangler deploy`.
+
+See the [Cloudflare deployment guide](https://jamdesk.com/docs/deploy/cloudflare) for details.
+
+## Configuration
+
+Everything lives in `docs.json` — themes, navigation, branding, integrations (analytics, OpenAPI, search), and SEO. Works with monorepos too.
+
+See the [docs.json reference](https://jamdesk.com/docs/config/docs-json-reference) for all options.
+
+### CLI Defaults
+
+`~/.jamdeskrc`:
+
+```json
+{
+  "defaultPort": 3001,
+  "verbose": false,
+  "checkUpdates": true
+}
+```
+
+## Troubleshooting
+
+**"docs.json not found"**
+- Run from a directory with `docs.json`, or `jamdesk init` to start fresh
+
+**Dev server won't start**
+- `jamdesk doctor` to check your environment
+- `jamdesk clean` to clear the cache
+- `jamdesk dev --verbose` for details
+
+**Turbopack cache corruption**
+- `jamdesk dev --clean` to clear and restart
+- Happens when the dev server is killed mid-build
+
+**Slow first run**
+- First run installs deps to `~/.jamdesk/node_modules`. Subsequent runs are fast.
+
+**Port in use**
+- `jamdesk dev --port 3001` or let auto-increment find the next open port
+
+**MDX syntax errors**
+- `<` is parsed as JSX in MDX. Use `&lt;` or rewrite ("Below 50%" instead of "<50%")
+- `jamdesk validate` shows errors with line numbers
+
+## Requirements
+
+- Node.js v20.0.0+
+- npm v8+ (recommended)
+
+## Learn More
+
+- [Documentation](https://jamdesk.com/docs)
+- [Getting Started](https://jamdesk.com/docs/quickstart)
+- [Components](https://jamdesk.com/docs/components/overview)
+- [Themes](https://jamdesk.com/docs/themes)
+- [Config Reference](https://jamdesk.com/docs/config/docs-json-reference)
+- [OpenAPI](https://jamdesk.com/docs/api-reference/openapi-setup)
+- [Deployment](https://jamdesk.com/docs/deploy)
+- [Homepage](https://jamdesk.com)
+- [Pricing](https://jamdesk.com/pricing)
+
+**Example:** [jamdesk.com/docs](https://jamdesk.com/docs)
+
+## Support
+
+- [Report Issues](https://github.com/jamdesk/jamdesk/issues)
+- [Contact Support](https://jamdesk.com/docs/help/support/contact)
+
+## License
+
+MIT

package/bin/jamdesk.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+
+import { existsSync, statSync, readdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { execSync } from 'child_process';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const cliRoot = join(__dirname, '..');
+
+/**
+ * Check if any TypeScript source files are newer than the compiled dist.
+ * This catches cases where someone edited src/ but forgot to rebuild.
+ */
+function isDistStale() {
+  const srcDir = join(cliRoot, 'src');
+  const distIndex = join(cliRoot, 'dist', 'index.js');
+
+  // Only check in development (when src/ exists)
+  if (!existsSync(srcDir)) return false;
+
+  // Get dist/index.js mtime, or return stale if it doesn't exist
+  let distMtime;
+  try {
+    distMtime = statSync(distIndex).mtimeMs;
+  } catch {
+    return true;
+  }
+
+  return hasNewerSourceFiles(srcDir, distMtime);
+}
+
+/**
+ * Recursively check if any .ts/.tsx files are newer than the given timestamp.
+ */
+function hasNewerSourceFiles(dir, threshold) {
+  let entries;
+  try {
+    entries = readdirSync(dir, { withFileTypes: true });
+  } catch {
+    return false;
+  }
+
+  for (const entry of entries) {
+    if (entry.name.startsWith('.') || entry.name === '__tests__') continue;
+
+    const fullPath = join(dir, entry.name);
+
+    if (entry.isDirectory()) {
+      if (hasNewerSourceFiles(fullPath, threshold)) return true;
+    } else if (entry.name.endsWith('.ts') || entry.name.endsWith('.tsx')) {
+      try {
+        if (statSync(fullPath).mtimeMs > threshold) return true;
+      } catch {
+        // Skip unreadable files
+      }
+    }
+  }
+
+  return false;
+}
+
+// Check for stale dist and auto-rebuild if needed
+if (isDistStale()) {
+  console.log('\x1b[33m⚠ Source files are newer than compiled dist, rebuilding...\x1b[0m');
+  try {
+    // Safe: hardcoded command with no user input
+    execSync('npm run build', { cwd: cliRoot, stdio: 'inherit' });
+    console.log('\x1b[32m✓ Rebuild complete\x1b[0m\n');
+  } catch (err) {
+    console.error('\x1b[31m✗ Rebuild failed. Run "npm run build" manually.\x1b[0m');
+    process.exit(1);
+  }
+}
+
+import('../dist/index.js');

package/dist/__tests__/integration/deprecated-components.integration.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Integration tests for deprecated component detection in CLI
+ *
+ * Tests that the dev command properly detects deprecated components
+ * and provides actionable error messages.
+ */
+export {};
+//# sourceMappingURL=deprecated-components.integration.test.d.ts.map

package/dist/__tests__/integration/deprecated-components.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deprecated-components.integration.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/deprecated-components.integration.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/integration/deprecated-components.integration.test.js

@@ -0,0 +1,165 @@
+/**
+ * Integration tests for deprecated component detection in CLI
+ *
+ * Tests that the dev command properly detects deprecated components
+ * and provides actionable error messages.
+ */
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { checkForDeprecatedComponents, DEPRECATED_COMPONENTS } from '../../lib/deprecated-components.js';
+describe('deprecated component detection integration', () => {
+    let tempDir;
+    beforeAll(async () => {
+        // Create a temporary directory for test fixtures
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'jamdesk-test-'));
+    });
+    afterAll(async () => {
+        // Clean up temp directory
+        await fs.remove(tempDir);
+    });
+    describe('checkForDeprecatedComponents', () => {
+        it('detects CardGroup in MDX content', () => {
+            const content = `---
+title: Getting Started
+---
+
+# Welcome
+
+<CardGroup cols={2}>
+  <Card title="Quick Start" href="/quickstart" />
+  <Card title="Installation" href="/install" />
+</CardGroup>
+`;
+            const errors = checkForDeprecatedComponents(content, 'getting-started.mdx');
+            expect(errors).toHaveLength(1);
+            expect(errors[0].component).toBe('CardGroup');
+            expect(errors[0].file).toBe('getting-started.mdx');
+            expect(errors[0].line).toBe(7); // Line where <CardGroup> appears
+            expect(errors[0].replacement).toBe('Columns');
+            expect(errors[0].migrationHint).toContain('<Columns');
+        });
+        it('detects CardGroup with different casing', () => {
+            const content = `<cardgroup cols={3}></cardgroup>`;
+            const errors = checkForDeprecatedComponents(content, 'test.mdx');
+            expect(errors).toHaveLength(1);
+            expect(errors[0].component).toBe('CardGroup');
+        });
+        it('returns empty array when no deprecated components found', () => {
+            const content = `---
+title: Clean Page
+---
+
+# Clean Content
+
+<Columns cols={2}>
+  <Card title="Item 1" />
+  <Card title="Item 2" />
+</Columns>
+`;
+            const errors = checkForDeprecatedComponents(content, 'clean.mdx');
+            expect(errors).toHaveLength(0);
+        });
+        it('detects multiple deprecated components in same file', () => {
+            const content = `
+# Page with multiple deprecated components
+
+<CardGroup cols={2}>
+  <Card title="First" />
+</CardGroup>
+
+Some text in between.
+
+<CardGroup cols={3}>
+  <Card title="Second" />
+</CardGroup>
+`;
+            const errors = checkForDeprecatedComponents(content, 'multi.mdx');
+            // Implementation finds first occurrence per component type
+            expect(errors).toHaveLength(1);
+            expect(errors[0].component).toBe('CardGroup');
+        });
+        it('provides correct line numbers', () => {
+            const content = `Line 1
+Line 2
+Line 3
+<CardGroup>
+Line 5
+</CardGroup>`;
+            const errors = checkForDeprecatedComponents(content, 'lines.mdx');
+            expect(errors).toHaveLength(1);
+            expect(errors[0].line).toBe(4); // CardGroup is on line 4
+        });
+        it('does not false-positive on CardGroup in code blocks', () => {
+            // Note: Current implementation doesn't skip code blocks
+            // This test documents current behavior
+            const content = `
+\`\`\`jsx
+<CardGroup cols={2}>
+  <Card />
+</CardGroup>
+\`\`\`
+`;
+            const errors = checkForDeprecatedComponents(content, 'codeblock.mdx');
+            // Current behavior: it will detect it even in code blocks
+            // This is acceptable as it's rare to have deprecated components in code examples
+            // and the user can safely ignore the warning
+            expect(errors).toHaveLength(1);
+        });
+    });
+    describe('DEPRECATED_COMPONENTS map', () => {
+        it('includes CardGroup with proper metadata', () => {
+            expect(DEPRECATED_COMPONENTS).toHaveProperty('CardGroup');
+            expect(DEPRECATED_COMPONENTS.CardGroup.replacement).toBe('Columns');
+            expect(DEPRECATED_COMPONENTS.CardGroup.migrationHint).toContain('CardGroup');
+            expect(DEPRECATED_COMPONENTS.CardGroup.migrationHint).toContain('Columns');
+        });
+        it('has required fields for all deprecated components', () => {
+            for (const [name, info] of Object.entries(DEPRECATED_COMPONENTS)) {
+                expect(info.name).toBe(name);
+                expect(typeof info.replacement).toBe('string');
+                expect(info.replacement.length).toBeGreaterThan(0);
+                expect(typeof info.migrationHint).toBe('string');
+                expect(info.migrationHint.length).toBeGreaterThan(0);
+            }
+        });
+    });
+    describe('file scanning workflow', () => {
+        it('scans MDX file from disk and detects deprecated components', async () => {
+            // Create a test MDX file
+            const testFile = path.join(tempDir, 'test-page.mdx');
+            await fs.writeFile(testFile, `---
+title: Test Page
+---
+
+<CardGroup cols={2}>
+  <Card title="Test" />
+</CardGroup>
+`);
+            // Read and check
+            const content = await fs.readFile(testFile, 'utf-8');
+            const errors = checkForDeprecatedComponents(content, 'test-page.mdx');
+            expect(errors).toHaveLength(1);
+            expect(errors[0].component).toBe('CardGroup');
+        });
+        it('scans snippet file from disk and detects deprecated components', async () => {
+            // Create a test snippet file
+            const snippetsDir = path.join(tempDir, 'snippets');
+            await fs.ensureDir(snippetsDir);
+            const snippetFile = path.join(snippetsDir, 'card-layout.mdx');
+            await fs.writeFile(snippetFile, `<CardGroup cols={3}>
+  <Card title="A" />
+  <Card title="B" />
+  <Card title="C" />
+</CardGroup>
+`);
+            // Read and check
+            const content = await fs.readFile(snippetFile, 'utf-8');
+            const errors = checkForDeprecatedComponents(content, 'snippets/card-layout.mdx');
+            expect(errors).toHaveLength(1);
+            expect(errors[0].file).toBe('snippets/card-layout.mdx');
+        });
+    });
+});
+//# sourceMappingURL=deprecated-components.integration.test.js.map

package/dist/__tests__/integration/deprecated-components.integration.test.js.map

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

package/dist/__tests__/integration/migrate.integration.test.d.ts

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

package/dist/__tests__/integration/migrate.integration.test.d.ts.map

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

package/dist/__tests__/integration/migrate.integration.test.js

@@ -0,0 +1,64 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import { findConfigFile, detectMintlify } from '../../commands/migrate/detect.js';
+import { convertMintlifyToJamdesk } from '../../commands/migrate/convert.js';
+describe('migrate integration', () => {
+    let tempDir;
+    beforeEach(async () => {
+        tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'jamdesk-migrate-test-'));
+    });
+    afterEach(async () => {
+        await fs.remove(tempDir);
+    });
+    it('detects and converts a Mintlify project', async () => {
+        // Create a mock Mintlify project
+        const mintConfig = {
+            $schema: 'https://mintlify.com/schema.json',
+            name: 'Test Docs',
+            topbarLinks: [{ name: 'Support', url: 'https://support.example.com' }],
+            navigation: [
+                { group: 'Getting Started', pages: ['intro'] },
+            ],
+            footerSocials: {
+                twitter: 'https://twitter.com/test',
+            },
+        };
+        await fs.writeJSON(path.join(tempDir, 'mint.json'), mintConfig);
+        await fs.writeFile(path.join(tempDir, 'intro.mdx'), '# Introduction');
+        // Detect the config
+        const result = findConfigFile(tempDir);
+        expect(result).not.toBeNull();
+        expect(result.filename).toBe('mint.json');
+        expect(detectMintlify(result.config)).toBe(true);
+        // Convert it
+        const converted = convertMintlifyToJamdesk(result.config, 'jam');
+        expect(converted.$schema).toBe('https://www.jamdesk.com/docs.json');
+        expect(converted.theme).toBe('jam');
+        expect(converted.navbar?.links).toEqual([
+            { label: 'Support', href: 'https://support.example.com' },
+        ]);
+        expect(converted.navigation?.pages).toEqual([
+            { group: 'Getting Started', pages: ['intro'] },
+        ]);
+        expect(converted.footer?.socials).toEqual({
+            twitter: 'https://twitter.com/test',
+        });
+    });
+    it('handles docs.json that is already Jamdesk format', async () => {
+        // Create a non-Mintlify project
+        const jamdeskConfig = {
+            $schema: 'https://www.jamdesk.com/docs.json',
+            name: 'Test Docs',
+            theme: 'jam',
+        };
+        await fs.writeJSON(path.join(tempDir, 'docs.json'), jamdeskConfig);
+        // Detect the config
+        const result = findConfigFile(tempDir);
+        expect(result).not.toBeNull();
+        expect(result.filename).toBe('docs.json');
+        expect(detectMintlify(result.config)).toBe(false);
+    });
+});
+//# sourceMappingURL=migrate.integration.test.js.map