jamdesk 1.1.129 → 1.1.131

package/dist/__tests__/unit/validate-risky-expressions.test.js

@@ -0,0 +1,111 @@
+/**
+ * Tests for validate-risky-expressions.ts
+ *
+ * Mirrors the shape of validate-snippets.test.ts. Focuses on the
+ * `validateRiskyExpressions` function — fast, pure-ish, no process.exit.
+ *
+ * Key properties:
+ *   - A page with a `{x, y}`-style undefined-reference expression → warning.
+ *   - A page with only valid expressions ({2+2}, {Math.max(...)}, props) → none.
+ *   - Scans the full file list it's given (orphan pages included).
+ *   - Returns warnings WITHOUT throwing / without a non-zero exit code.
+ *
+ * The exhaustive scanner-behavior suite lives in build-service's
+ * __tests__/lib/risky-expression-scanner.test.ts (same scanner, vendored).
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, mkdirSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { validateRiskyExpressions } from '../../lib/validate-risky-expressions.js';
+let projectDir;
+beforeEach(() => {
+    projectDir = mkdtempSync(path.join(tmpdir(), 'jamdesk-risky-val-'));
+});
+afterEach(() => {
+    rmSync(projectDir, { recursive: true, force: true });
+});
+function write(relPath, content) {
+    const abs = path.join(projectDir, relPath);
+    mkdirSync(path.dirname(abs), { recursive: true });
+    writeFileSync(abs, content);
+}
+describe('validateRiskyExpressions — undefined-reference expressions', () => {
+    it('warns on the {x, y} literal-braces bug', async () => {
+        write('tests/tap.mdx', 'Coordinates: {x, y} pixel positions.\n');
+        const warnings = await validateRiskyExpressions(projectDir, ['tests/tap.mdx']);
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].file).toBe('tests/tap.mdx');
+        expect(warnings[0].message).toContain('tests/tap.mdx');
+        expect(warnings[0].message).toContain('`x`');
+    });
+    it('warns on a single undefined identifier', async () => {
+        write('page.mdx', 'Hello {name}, welcome.\n');
+        const warnings = await validateRiskyExpressions(projectDir, ['page.mdx']);
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].message).toContain('`name`');
+    });
+});
+describe('validateRiskyExpressions — valid expressions are not flagged', () => {
+    it('does NOT warn on literal/global/props expressions', async () => {
+        write('p.mdx', 'Sum {2 + 2}, max {Math.max(1, 2)}, prop {props.x}, year {new Date().getFullYear()}.\n');
+        const warnings = await validateRiskyExpressions(projectDir, ['p.mdx']);
+        expect(warnings).toHaveLength(0);
+    });
+    it('does NOT warn on imported/exported bindings', async () => {
+        write('p.mdx', "import Foo from '/snippets/foo.mdx'\nexport const greeting = 'hi'\n\n{Foo} {greeting}\n");
+        const warnings = await validateRiskyExpressions(projectDir, ['p.mdx']);
+        expect(warnings).toHaveLength(0);
+    });
+    it('does NOT warn on braces inside fenced or inline code', async () => {
+        write('p.mdx', 'Inline `{x, y}` is code.\n\n```js\nconst {x, y} = pt\n```\n');
+        const warnings = await validateRiskyExpressions(projectDir, ['p.mdx']);
+        expect(warnings).toHaveLength(0);
+    });
+});
+describe('validateRiskyExpressions — orphan pages (full project walk)', () => {
+    it('warns on a page that is NOT in navigation but IS in the file list', async () => {
+        write('orphan-not-in-nav.mdx', 'Coordinates: {x, y}.\n');
+        const warnings = await validateRiskyExpressions(projectDir, ['orphan-not-in-nav.mdx']);
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].file).toBe('orphan-not-in-nav.mdx');
+    });
+});
+describe('validateRiskyExpressions — robustness', () => {
+    it('skips files that do not exist on disk (no throw)', async () => {
+        const warnings = await validateRiskyExpressions(projectDir, ['nonexistent.mdx']);
+        expect(warnings).toHaveLength(0);
+    });
+    it('accepts absolute file paths (the full project walk passes absolutes)', async () => {
+        write('tests/tap.mdx', 'Coordinates: {x, y}.\n');
+        const warnings = await validateRiskyExpressions(projectDir, [
+            path.join(projectDir, 'tests/tap.mdx'),
+        ]);
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].file).toBe('tests/tap.mdx');
+    });
+    it('does not throw on malformed MDX (returns no warnings)', async () => {
+        write('p.mdx', '<Tabs>\n\nunclosed\n');
+        await expect(validateRiskyExpressions(projectDir, ['p.mdx'])).resolves.toBeDefined();
+    });
+    it('caps at 50 warnings even when there are more issues', async () => {
+        const files = [];
+        for (let i = 0; i < 60; i++) {
+            write(`page-${i}.mdx`, `Value: {undefinedVar${i}}.\n`);
+            files.push(`page-${i}.mdx`);
+        }
+        const warnings = await validateRiskyExpressions(projectDir, files);
+        expect(warnings.length).toBe(50);
+    });
+    it('returns no warnings when there are no files', async () => {
+        const warnings = await validateRiskyExpressions(projectDir, []);
+        expect(warnings).toHaveLength(0);
+    });
+    it('supports .md files (not just .mdx)', async () => {
+        write('guide.md', 'Coordinates: {x, y}.\n');
+        const warnings = await validateRiskyExpressions(projectDir, ['guide.md']);
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].file).toBe('guide.md');
+    });
+});
+//# sourceMappingURL=validate-risky-expressions.test.js.map

package/dist/__tests__/unit/validate-risky-expressions.test.js.map

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

package/dist/__tests__/unit/validate-snippets.test.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Tests for validate-snippets.ts
+ *
+ * Mirrors the shape of validate-image-refs.test.ts.
+ * Focuses on the `validateSnippets` function — fast, pure-ish, no process.exit.
+ *
+ * Key properties:
+ *   - A page with a <Snippet file="x"/> tag → unsupported_tag warning.
+ *   - A page importing a MISSING /snippets/… target → missing_import warning.
+ *   - A page importing a PRESENT snippet → NO warning.
+ *   - Scans the full file list it's given (orphan pages included), mirroring
+ *     the cloud build — NOT just navigation pages.
+ *   - Validator returns warnings WITHOUT throwing / without a non-zero exit code.
+ *
+ * validateSnippets takes a list of MDX/MD files (absolute or relative to
+ * projectDir), so the helpers below pass the written page paths explicitly.
+ */
+export {};
+//# sourceMappingURL=validate-snippets.test.d.ts.map

package/dist/__tests__/unit/validate-snippets.test.d.ts.map

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

package/dist/__tests__/unit/validate-snippets.test.js

@@ -0,0 +1,190 @@
+/**
+ * Tests for validate-snippets.ts
+ *
+ * Mirrors the shape of validate-image-refs.test.ts.
+ * Focuses on the `validateSnippets` function — fast, pure-ish, no process.exit.
+ *
+ * Key properties:
+ *   - A page with a <Snippet file="x"/> tag → unsupported_tag warning.
+ *   - A page importing a MISSING /snippets/… target → missing_import warning.
+ *   - A page importing a PRESENT snippet → NO warning.
+ *   - Scans the full file list it's given (orphan pages included), mirroring
+ *     the cloud build — NOT just navigation pages.
+ *   - Validator returns warnings WITHOUT throwing / without a non-zero exit code.
+ *
+ * validateSnippets takes a list of MDX/MD files (absolute or relative to
+ * projectDir), so the helpers below pass the written page paths explicitly.
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { mkdtempSync, rmSync, mkdirSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import path from 'node:path';
+import { validateSnippets } from '../../lib/validate-snippets.js';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+let projectDir;
+beforeEach(() => {
+    projectDir = mkdtempSync(path.join(tmpdir(), 'jamdesk-snippet-val-'));
+});
+afterEach(() => {
+    rmSync(projectDir, { recursive: true, force: true });
+});
+function write(relPath, content) {
+    const abs = path.join(projectDir, relPath);
+    mkdirSync(path.dirname(abs), { recursive: true });
+    writeFileSync(abs, content);
+}
+// ---------------------------------------------------------------------------
+// <Snippet> tag → unsupported_tag warning
+// ---------------------------------------------------------------------------
+describe('validateSnippets — <Snippet> tag (unsupported_tag)', () => {
+    it('returns a warning for a page with a <Snippet file="x"/> tag', async () => {
+        write('guide/intro.mdx', `<Snippet file="foo.mdx" />`);
+        const warnings = await validateSnippets(projectDir, ['guide/intro.mdx']);
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].file).toBe('guide/intro.mdx');
+        expect(warnings[0].variant).toBe('unsupported_tag');
+        // Message must contain the backtick-wrapped token so renderers don't drop it
+        expect(warnings[0].message).toContain('`<Snippet>`');
+        expect(warnings[0].message).toContain('foo.mdx');
+        expect(warnings[0].message).toContain('import');
+    });
+    it('returns a warning for a bare <Snippet/> with no file attr', async () => {
+        write('page.mdx', `<Snippet />`);
+        const warnings = await validateSnippets(projectDir, ['page.mdx']);
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].message).toContain('`<Snippet>`');
+    });
+    it('warns even when the referenced snippet file EXISTS (tag is always unsupported)', async () => {
+        // Critical: the tag is never valid regardless of file existence.
+        // A naive existence check would wrongly suppress this.
+        write('snippets/existing.mdx', 'hello');
+        write('intro.mdx', `<Snippet file="existing.mdx" />`);
+        const warnings = await validateSnippets(projectDir, ['intro.mdx']);
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].message).toContain('`<Snippet>`');
+    });
+});
+// ---------------------------------------------------------------------------
+// import … from '/snippets/…' with a missing target → missing_import warning
+// ---------------------------------------------------------------------------
+describe('validateSnippets — missing import (missing_import)', () => {
+    it('returns a warning for an import of a snippet that does not exist', async () => {
+        write('guide/page.mdx', `import MySnippet from '/snippets/missing.mdx'`);
+        const warnings = await validateSnippets(projectDir, ['guide/page.mdx']);
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].file).toBe('guide/page.mdx');
+        expect(warnings[0].variant).toBe('missing_import');
+        expect(warnings[0].message).toContain('missing.mdx');
+        expect(warnings[0].message).toContain('snippets/');
+    });
+    it('returns NO warning for an import of a snippet that DOES exist', async () => {
+        write('snippets/present.mdx', 'hello');
+        write('guide/page.mdx', `import Present from '/snippets/present.mdx'`);
+        const warnings = await validateSnippets(projectDir, ['guide/page.mdx']);
+        expect(warnings).toHaveLength(0);
+    });
+    it('handles extension mismatch: .tsx file on disk, .mdx in import path', async () => {
+        // normalizeSnippetRef strips extension on both sides → same key
+        write('snippets/card.tsx', 'export const Card = () => null');
+        write('page.mdx', `import Card from '/snippets/card.mdx'`);
+        const warnings = await validateSnippets(projectDir, ['page.mdx']);
+        expect(warnings).toHaveLength(0);
+    });
+    it('returns NO warning for non-snippet imports', async () => {
+        write('page.mdx', `import Button from '/components/Button'`);
+        const warnings = await validateSnippets(projectDir, ['page.mdx']);
+        expect(warnings).toHaveLength(0);
+    });
+});
+// ---------------------------------------------------------------------------
+// Mixed page: both variants
+// ---------------------------------------------------------------------------
+describe('validateSnippets — mixed page', () => {
+    it('returns both unsupported_tag and missing_import warnings on the same page', async () => {
+        write('snippets/present.mdx', 'content');
+        write('page.mdx', [
+            `import P from '/snippets/present.mdx'`,
+            `import M from '/snippets/missing.mdx'`,
+            ``,
+            `<Snippet file="present.mdx" />`,
+        ].join('\n'));
+        const warnings = await validateSnippets(projectDir, ['page.mdx']);
+        // The <Snippet> tag always warns; the import of 'missing.mdx' warns; 'present.mdx' is fine
+        expect(warnings.length).toBeGreaterThanOrEqual(2);
+        expect(warnings.some(w => w.variant === 'unsupported_tag')).toBe(true);
+        expect(warnings.some(w => w.variant === 'missing_import' && w.message.includes('missing.mdx'))).toBe(true);
+    });
+});
+// ---------------------------------------------------------------------------
+// Orphan pages: scans ALL given files, not just navigation pages
+// ---------------------------------------------------------------------------
+describe('validateSnippets — orphan pages (full project walk)', () => {
+    it('warns on a <Snippet> in a page that is NOT in navigation but IS in the file list', async () => {
+        // The cloud build scans every collected MDX file. The CLI is passed the
+        // same full project walk, so an orphan page (not referenced by docs.json
+        // navigation) must still be scanned and warned.
+        write('orphan-not-in-nav.mdx', `<Snippet file="foo.mdx" />`);
+        const warnings = await validateSnippets(projectDir, ['orphan-not-in-nav.mdx']);
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].file).toBe('orphan-not-in-nav.mdx');
+        expect(warnings[0].variant).toBe('unsupported_tag');
+    });
+});
+// ---------------------------------------------------------------------------
+// No warnings when everything is clean
+// ---------------------------------------------------------------------------
+describe('validateSnippets — clean project', () => {
+    it('returns no warnings when snippets are properly imported and present', async () => {
+        write('snippets/shared.mdx', 'shared content');
+        write('intro.mdx', `import Shared from '/snippets/shared.mdx'\n\n<Shared />`);
+        const warnings = await validateSnippets(projectDir, ['intro.mdx']);
+        expect(warnings).toHaveLength(0);
+    });
+    it('returns no warnings when no pages have snippet-related content', async () => {
+        write('intro.mdx', `# Hello\n\nJust some text.`);
+        const warnings = await validateSnippets(projectDir, ['intro.mdx']);
+        expect(warnings).toHaveLength(0);
+    });
+    it('returns no warnings when there are no files', async () => {
+        const warnings = await validateSnippets(projectDir, []);
+        expect(warnings).toHaveLength(0);
+    });
+});
+// ---------------------------------------------------------------------------
+// Robustness
+// ---------------------------------------------------------------------------
+describe('validateSnippets — robustness', () => {
+    it('skips files that do not exist on disk (no throw)', async () => {
+        // 'nonexistent.mdx' was never written — must not throw
+        const warnings = await validateSnippets(projectDir, ['nonexistent.mdx']);
+        expect(warnings).toHaveLength(0);
+    });
+    it('accepts absolute file paths (the full project walk passes absolutes)', async () => {
+        write('guide/intro.mdx', `<Snippet file="foo.mdx" />`);
+        const warnings = await validateSnippets(projectDir, [
+            path.join(projectDir, 'guide/intro.mdx'),
+        ]);
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].file).toBe('guide/intro.mdx');
+    });
+    it('caps at 50 warnings even when there are more issues', async () => {
+        // Write 60 pages each with one <Snippet> tag
+        const files = [];
+        for (let i = 0; i < 60; i++) {
+            write(`page-${i}.mdx`, `<Snippet file="x-${i}.mdx" />`);
+            files.push(`page-${i}.mdx`);
+        }
+        const warnings = await validateSnippets(projectDir, files);
+        expect(warnings.length).toBeLessThanOrEqual(50);
+        expect(warnings.length).toBe(50);
+    });
+    it('supports .md files (not just .mdx)', async () => {
+        write('guide.md', `<Snippet file="foo.mdx" />`);
+        const warnings = await validateSnippets(projectDir, ['guide.md']);
+        expect(warnings).toHaveLength(1);
+        expect(warnings[0].file).toBe('guide.md');
+    });
+});
+//# sourceMappingURL=validate-snippets.test.js.map

package/dist/__tests__/unit/validate-snippets.test.js.map

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

package/dist/commands/migrate/convert-mdx.d.ts

@@ -7,6 +7,18 @@
  */
 import { convertDeprecatedComponents } from '../../lib/deprecated-components.js';
 export { convertDeprecatedComponents };
+/**
+ * Resolve a `<Snippet file="X">` reference to the canonical root-relative import
+ * spec (`/snippets/…`) Jamdesk understands, when it points at an existing file
+ * under the project's `snippets/` directory — else `null` (leave untouched).
+ *
+ * Two resolution bases are tried, both clamped to `snippets/` so a converted
+ * import can actually resolve at build time (Jamdesk only resolves
+ * `/snippets/*`) and so a `../`-escaping `file` can never import outside it:
+ *   1. snippets-root relative (the Mintlify convention: `file="essentials/x.mdx"`)
+ *   2. page-relative (`file="../snippets/x.mdx"` from the page's own directory)
+ */
+export declare function resolveSnippetImportSpec(fileAttr: string, pageFile: string, projectDir: string): string | null;
 export interface MdxMigrationResult {
     file: string;
     changes: string[];

package/dist/commands/migrate/convert-mdx.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convert-mdx.d.ts","sourceRoot":"","sources":["../../../src/commands/migrate/convert-mdx.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAIjF,OAAO,EAAE,2BAA2B,EAAE,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA+B5F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAmB3F;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOjE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoC/E"}
+{"version":3,"file":"convert-mdx.d.ts","sourceRoot":"","sources":["../../../src/commands/migrate/convert-mdx.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAMjF,OAAO,EAAE,2BAA2B,EAAE,CAAC;AAQvC;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,GAAG,IAAI,CA2Bf;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,kBAAkB,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CA+B5F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAmB3F;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAOjE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAkE/E"}

package/dist/commands/migrate/convert-mdx.js

@@ -10,8 +10,53 @@ import path from 'path';
 import { glob } from 'glob';
 import { convertDeprecatedComponents } from '../../lib/deprecated-components.js';
 import { rewriteRelativeMdxImports } from '../../lib/relative-mdx-imports.js';
+import { convertSnippetComponents } from './snippet-component-convert.js';
+import { findRiskyExpressions } from '../../lib/risky-expression-scanner.js';
 // Re-export for use by tests and other modules
 export { convertDeprecatedComponents };
+/** True when `child` is strictly inside `parent` (not equal, no `..` escape). */
+function isUnderDir(child, parent) {
+    const rel = path.relative(parent, child);
+    return rel !== '' && !rel.startsWith('..') && !path.isAbsolute(rel);
+}
+/**
+ * Resolve a `<Snippet file="X">` reference to the canonical root-relative import
+ * spec (`/snippets/…`) Jamdesk understands, when it points at an existing file
+ * under the project's `snippets/` directory — else `null` (leave untouched).
+ *
+ * Two resolution bases are tried, both clamped to `snippets/` so a converted
+ * import can actually resolve at build time (Jamdesk only resolves
+ * `/snippets/*`) and so a `../`-escaping `file` can never import outside it:
+ *   1. snippets-root relative (the Mintlify convention: `file="essentials/x.mdx"`)
+ *   2. page-relative (`file="../snippets/x.mdx"` from the page's own directory)
+ */
+export function resolveSnippetImportSpec(fileAttr, pageFile, projectDir) {
+    const snippetsRoot = path.join(projectDir, 'snippets');
+    const rel = fileAttr.replace(/^\//, '');
+    const relNoSnippets = rel.replace(/^snippets[\\/]/, '');
+    const candidates = [
+        path.join(snippetsRoot, relNoSnippets), // snippets-root relative (Mintlify)
+        path.resolve(path.dirname(pageFile), fileAttr), // page-relative
+    ];
+    for (const candidate of candidates) {
+        try {
+            // `statSync` throws ENOENT for a missing path (caught below), so it
+            // doubles as the existence check — no separate `existsSync` stat needed.
+            if (fs.statSync(candidate).isFile() &&
+                isUnderDir(candidate, snippetsRoot)) {
+                const relFromSnippets = path
+                    .relative(snippetsRoot, candidate)
+                    .split(path.sep)
+                    .join('/');
+                return `/snippets/${relFromSnippets}`;
+            }
+        }
+        catch {
+            // ignore unreadable candidate, try the next
+        }
+    }
+    return null;
+}
 /**
  * Normalize YouTube/video iframes to full-width with standard classes.
  *
@@ -95,11 +140,36 @@ export async function migrateMdxFiles(dir) {
         const original = await fs.readFile(file, 'utf-8');
         const { content: transformed, changes } = transformMdxContent(original);
         const importResult = await rewriteRelativeMdxImports(transformed, file, dir);
-        const finalContent = importResult.content;
+        let finalContent = importResult.content;
         if (importResult.rewrites.length > 0) {
             changes.push(`Normalized ${importResult.rewrites.length} relative MDX import(s)`);
         }
-        const warnings = importResult.warnings;
+        const warnings = [...importResult.warnings];
+        // Convert non-standard `<Snippet file="…">` tags to the supported import
+        // pattern, but ONLY when the referenced file actually exists under
+        // `snippets/` (the resolver returns null otherwise → tag left untouched, the
+        // build-time missing_snippet warning covers it).
+        const snippetResult = convertSnippetComponents(finalContent, (fileAttr) => resolveSnippetImportSpec(fileAttr, file, dir));
+        finalContent = snippetResult.content;
+        changes.push(...snippetResult.changes);
+        warnings.push(...snippetResult.warnings);
+        // Warn — but never auto-rewrite — on bare `{…}` prose that won't render
+        // (undefined references). Auto-escaping author prose is too aggressive; the
+        // recma render guard already keeps these from 500ing, and `jamdesk validate`
+        // surfaces the same `risky_expression` diagnostic. A file with no `{` can
+        // hold no expression, so skip the full MDX parse for those (the common case).
+        try {
+            const risky = finalContent.includes('{')
+                ? findRiskyExpressions(finalContent, path.relative(dir, file))
+                : [];
+            if (risky.length > 0) {
+                warnings.push(`${risky.length} bare {…} expression(s) won't render (e.g. \`{${risky[0].expression}}\`) — ` +
+                    `wrap in backticks or escape as \\{…\\}.`);
+            }
+        }
+        catch {
+            // A parse failure here must never block migration — skip the diagnostic.
+        }
         if (finalContent !== original) {
             await fs.writeFile(file, finalContent, 'utf-8');
             filesModified++;

package/dist/commands/migrate/convert-mdx.js.map

@@ -1 +1 @@
-{"version":3,"file":"convert-mdx.js","sourceRoot":"","sources":["../../../src/commands/migrate/convert-mdx.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"convert-mdx.js","sourceRoot":"","sources":["../../../src/commands/migrate/convert-mdx.ts"],"names":[],"mappings":"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"}

package/dist/commands/migrate/convert.d.ts

@@ -58,6 +58,17 @@ export interface JamdeskConfig {
     footerSocials?: undefined;
     [key: string]: unknown;
 }
+/**
+ * Returns true when the converted config's `seo.metatags.robots` contains
+ * the substring "noindex" (case-insensitive). The explicit type guards below
+ * ensure no exception is thrown for any valid `Record<string, unknown>` input;
+ * absent or non-string values simply return false.
+ *
+ * Call this on the POST-conversion result so it catches both:
+ *   - A Mintlify `metadata.robots` that was lifted into `seo.metatags`
+ *   - A docs.json that already carried `seo.metatags.robots`
+ */
+export declare function hasNoindexRobots(config: Record<string, unknown>): boolean;
 /**
  * Convert a Mintlify config object to Jamdesk format.
  *

package/dist/commands/migrate/convert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/commands/migrate/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAuBhE,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,MAAM,GAAG,gBAAgB,CAAC,EAAE,CAAC;CACtC;AAGD,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAGD,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAGD,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,gBAAgB,CAAC,EAAE,CAAC;CACvC;AAED,UAAU,aAAa;IACrB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,UAAU,iBAAiB;IACzB,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,OAAO,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAClC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,aAAa,CAAC,EAAE,SAAS,CAAC;IAE1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,KAAK,EAAE,SAAS,EAChB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAC9B,aAAa,CA2Lf"}
+{"version":3,"file":"convert.d.ts","sourceRoot":"","sources":["../../../src/commands/migrate/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAuBhE,UAAU,gBAAgB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,MAAM,GAAG,gBAAgB,CAAC,EAAE,CAAC;CACtC;AAGD,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,UAAU,oBAAoB;IAC5B,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAGD,UAAU,qBAAqB;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAGD,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,CAAC,MAAM,GAAG,gBAAgB,CAAC,EAAE,CAAC;CACvC;AAED,UAAU,aAAa;IACrB,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IACtB,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED,UAAU,iBAAiB;IACzB,IAAI,CAAC,EAAE,UAAU,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC5B,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,SAAS,CAAC;IACjB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,OAAO,CAAC,EAAE,qBAAqB,EAAE,CAAC;IAClC,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,aAAa,CAAC,EAAE,SAAS,CAAC;IAE1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAQzE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,KAAK,EAAE,SAAS,EAChB,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAC9B,aAAa,CA2Lf"}

package/dist/commands/migrate/convert.js

@@ -8,6 +8,28 @@
  * This module is designed to be extensible - add new converters as needed.
  */
 import { JAMDESK_SCHEMA_URL } from './types.js';
+/**
+ * Returns true when the converted config's `seo.metatags.robots` contains
+ * the substring "noindex" (case-insensitive). The explicit type guards below
+ * ensure no exception is thrown for any valid `Record<string, unknown>` input;
+ * absent or non-string values simply return false.
+ *
+ * Call this on the POST-conversion result so it catches both:
+ *   - A Mintlify `metadata.robots` that was lifted into `seo.metatags`
+ *   - A docs.json that already carried `seo.metatags.robots`
+ */
+export function hasNoindexRobots(config) {
+    const seo = config.seo;
+    if (!seo || typeof seo !== 'object' || Array.isArray(seo))
+        return false;
+    const metatags = seo.metatags;
+    if (!metatags || typeof metatags !== 'object' || Array.isArray(metatags))
+        return false;
+    const robots = metatags.robots;
+    if (typeof robots !== 'string')
+        return false;
+    return robots.toLowerCase().includes('noindex');
+}
 /**
  * Convert a Mintlify config object to Jamdesk format.
  *

package/dist/commands/migrate/convert.js.map

@@ -1 +1 @@
-{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/commands/migrate/convert.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"convert.js","sourceRoot":"","sources":["../../../src/commands/migrate/convert.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,kBAAkB,EAAkB,MAAM,YAAY,CAAC;AAuFhE;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA+B;IAC9D,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;IACvB,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACxE,MAAM,QAAQ,GAAI,GAA+B,CAAC,QAAQ,CAAC;IAC3D,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IACvF,MAAM,MAAM,GAAI,QAAoC,CAAC,MAAM,CAAC;IAC5D,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC7C,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,wBAAwB,CACtC,cAAuC,EACvC,KAAgB,EAChB,eAA+B;IAE/B,sDAAsD;IACtD,MAAM,EACJ,OAAO,EACP,KAAK,EAAE,cAAc,EAAE,iEAAiE;IACxF,WAAW,EACX,eAAe,EACf,OAAO,EACP,UAAU,EACV,aAAa,EACb,QAAQ,EACR,UAAU,EACV,QAAQ,EACR,MAAM,EACN,GAAG,IAAI,EACR,GAAG,cAAc,CAAC;IAEnB,MAAM,MAAM,GAAkB;QAC5B,OAAO,EAAE,kBAAkB;QAC3B,KAAK;QACL,GAAG,IAAI;KACR,CAAC;IAEF,2BAA2B;IAC3B,MAAM,MAAM,GAAkB,EAAE,CAAC;IAEjC,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,KAAK,GAAI,WAA8B,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC5D,KAAK,EAAE,IAAI,CAAC,IAAI;YAChB,IAAI,EAAE,IAAI,CAAC,GAAG;SACf,CAAC,CAAC,CAAC;IACN,CAAC;IAED,IAAI,eAAe,IAAI,OAAO,eAAe,KAAK,QAAQ,EAAE,CAAC;QAC3D,MAAM,GAAG,GAAG,eAA+B,CAAC;QAC5C,MAAM,CAAC,OAAO,GAAG;YACf,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG,CAAC,IAAI;YACf,IAAI,EAAE,GAAG,CAAC,GAAG;SACd,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC;IAED,sDAAsD;IACtD,MAAM,eAAe,GAA4B,EAAE,CAAC;IAEpD,yDAAyD;IACzD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjD,KAAK,MAAM,MAAM,IAAI,OAA2B,EAAE,CAAC;YACjD,eAAe,CAAC,IAAI,CAAC;gBACnB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,GAAG;gBAChB,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;aAC1C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,8EAA8E;IAC9E,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,sDAAsD;YACtD,MAAM,CAAC,UAAU,GAAG,EAAE,KAAK,EAAE,UAAgC,EAAE,CAAC;QAClE,CAAC;aAAM,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,MAAM,GAAG,UAAqC,CAAC;YACrD,oDAAoD;YACpD,MAAM,GAAG,GAAG,EAAE,GAAG,MAAM,EAA6B,CAAC;YAErD,gDAAgD;YAChD,uEAAuE;YACvE,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC9B,MAAM,aAAa,GAAG,MAAM,CAAC,OAAmC,CAAC;oBACjE,MAAM,aAAa,GAAiB,EAAE,CAAC;oBAEvC,KAAK,MAAM,MAAM,IAAI,aAAa,EAAE,CAAC;wBACnC,qDAAqD;wBACrD,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;4BAClC,aAAa,CAAC,IAAI,CAAC;gCACjB,GAAG,EAAE,MAAM,CAAC,MAAM;gCAClB,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;gCACzC,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;gCAC/C,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;6BAC7C,CAAC,CAAC;wBACL,CAAC;6BAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;4BACvB,0DAA0D;4BAC1D,eAAe,CAAC,IAAI,CAAC;gCACnB,IAAI,EAAE,MAAM,CAAC,MAAM;gCACnB,IAAI,EAAE,MAAM,CAAC,IAAI;gCACjB,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;6BAC1C,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;oBAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC7B,GAAG,CAAC,IAAI,GAAG,aAAa,CAAC;oBAC3B,CAAC;gBACH,CAAC;gBACD,kDAAkD;gBAClD,OAAO,GAAG,CAAC,OAAO,CAAC;YACrB,CAAC;YAED,gEAAgE;YAChE,iEAAiE;YACjE,oEAAoE;YACpE,oEAAoE;YACpE,uCAAuC;YACvC,IAAI,MAAM,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACvD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAiC,CAAC;gBAC3D,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;oBACrC,KAAK,MAAM,MAAM,IAAI,SAAS,CAAC,OAAmC,EAAE,CAAC;wBACnE,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;4BAChB,eAAe,CAAC,IAAI,CAAC;gCACnB,IAAI,EAAE,MAAM,CAAC,MAAM;gCACnB,IAAI,EAAE,MAAM,CAAC,IAAI;gCACjB,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;6BAC1C,CAAC,CAAC;wBACL,CAAC;oBACH,CAAC;oBACD,wDAAwD;oBACxD,kEAAkE;oBAClE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,UAAU,EAAE,GAAG,SAAS,CAAC;oBACxD,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACvC,GAAG,CAAC,MAAM,GAAG,UAAU,CAAC;oBAC1B,CAAC;yBAAM,CAAC;wBACN,OAAO,GAAG,CAAC,MAAM,CAAC;oBACpB,CAAC;gBACH,CAAC;YACH,CAAC;YAED,MAAM,CAAC,UAAU,GAAG,GAAwB,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,mDAAmD;IACnD,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,OAAO,GAAG,eAAe,CAAC;IACnC,CAAC;IAED,yBAAyB;IACzB,IAAI,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACvD,MAAM,CAAC,MAAM,GAAG;YACd,OAAO,EAAE,aAAuC;SACjD,CAAC;IACJ,CAAC;IAED,uDAAuD;IAEvD,mCAAmC;IACnC,IAAI,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACjD,MAAM,EAAE,GAAG,UAAsD,CAAC;QAClE,MAAM,CAAC,UAAU,GAAG;YAClB,OAAO,EAAE,EAAE,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;YACrF,MAAM,EAAE,EAAE,CAAC,QAAQ,KAAK,IAAI;SAC7B,CAAC;IACJ,CAAC;IAED,mCAAmC;IACnC,IAAI,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC7C,MAAM,CAAC,GAAG,GAAG;YACX,GAAI,MAAM,CAAC,GAAc;YACzB,QAAQ,EAAE,QAAkC;SAC7C,CAAC;IACJ,CAAC;IAED,6EAA6E;IAE7E,2EAA2E;IAC3E,0EAA0E;IAC1E,2BAA2B;IAC3B,IAAI,eAAe,EAAE,CAAC;QACpB,qEAAqE;QACrE,uEAAuE;QACvE,uDAAuD;QACvD,MAAM,WAAW,GACf,MAAM,CAAC,GAAG,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC;YACxE,CAAC,CAAE,MAAM,CAAC,GAA+B;YACzC,CAAC,CAAC,SAAS,CAAC;QAChB,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,GAAG,EAAE,GAAG,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;QAC5D,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/commands/migrate/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/migrate/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAmBH,OAAO,EAAU,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,gBAAgB,EACzB,eAAe,EAAE,OAAO,EACxB,aAAa,EAAE,OAAO,GACrB,SAAS,GAAG,IAAI,CAmBlB;AAgFD,wBAAsB,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8ZtE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/migrate/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAmBH,OAAO,EAAU,KAAK,gBAAgB,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE3E;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,gBAAgB,EACzB,eAAe,EAAE,OAAO,EACxB,aAAa,EAAE,OAAO,GACrB,SAAS,GAAG,IAAI,CAmBlB;AAgFD,wBAAsB,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoatE"}