jamdesk 1.1.69 → 1.1.71

package/dist/lib/mdx-validator.js

@@ -10,6 +10,7 @@ import { homedir } from 'os';
 import { createRequire } from 'module';
 import { pathToFileURL } from 'url';
 import { preprocessFrontmatter } from './frontmatter-utils.js';
+import { unindentClosingTagsAfterLists } from './mdx-syntax-fixes.js';
 let cachedMdx = null;
 /**
  * Build the user-facing error thrown when @mdx-js/mdx can't be resolved.
@@ -43,9 +44,17 @@ async function importMdx() {
     return cachedMdx;
 }
 /**
- * Validate a single MDX file's content
+ * Validate a single MDX file's content.
+ *
+ * @param applySyntaxFixes - Whether to apply the same in-memory rewrites
+ *   that build-service's preprocessMdx pipeline applies at render time
+ *   (e.g. unindenting closing tags absorbed by list items). Default `true`
+ *   so dev's gate matches what actually compiles. Pass `false` to see the
+ *   verdict against raw on-disk content — used by `jamdesk migrate` to
+ *   detect files that *would* break without the runtime safety net.
  */
-export async function validateMdxFile(content, filePath) {
+export async function validateMdxFile(content, filePath, options = {}) {
+    const { applySyntaxFixes = true } = options;
     const { compile } = await importMdx();
     const matter = (await import('gray-matter')).default;
     // Pre-process frontmatter to handle common issues
@@ -61,9 +70,13 @@ export async function validateMdxFile(content, filePath) {
             suggestion: 'Check YAML syntax between --- markers',
         };
     }
-    // Step 2: Validate MDX syntax
+    // Step 2: Validate MDX syntax. By default, mirror the runtime preprocess
+    // pipeline so dev's gate matches what gets compiled at request time.
+    const toCompile = applySyntaxFixes
+        ? unindentClosingTagsAfterLists(processedContent).content
+        : processedContent;
     try {
-        await compile(processedContent, { jsx: true });
+        await compile(toCompile, { jsx: true });
         return null; // Valid
     }
     catch (err) {
@@ -97,6 +110,10 @@ export function extractAllPages(navigation) {
                 if ('tabs' in item && Array.isArray(item.tabs)) {
                     processItems(item.tabs);
                 }
+                // Handle dropdowns (Mintlify navigation grouping)
+                if ('dropdowns' in item && Array.isArray(item.dropdowns)) {
+                    processItems(item.dropdowns);
+                }
             }
         }
     }
@@ -119,6 +136,15 @@ export function extractAllPages(navigation) {
     if (navigation.groups && Array.isArray(navigation.groups)) {
         processItems(navigation.groups);
     }
+    // Handle pages structure: { pages: [...] } — produced by
+    // convertMintlifyToJamdesk when the source had a top-level navigation array.
+    if (navigation.pages && Array.isArray(navigation.pages)) {
+        processItems(navigation.pages);
+    }
+    // Handle top-level dropdowns: { dropdowns: [...] }
+    if (navigation.dropdowns && Array.isArray(navigation.dropdowns)) {
+        processItems(navigation.dropdowns);
+    }
     // Handle flat array: [...]
     if (Array.isArray(navigation)) {
         processItems(navigation);
@@ -168,6 +194,17 @@ function formatMdxError(err, filePath) {
         suggestion =
             'A < character is being parsed as JSX. Use &lt; or rewrite (e.g., "Below 50%" instead of "<50%")';
     }
+    else if (message.includes('Expected the closing tag') &&
+        message.includes('listItem')) {
+        // Indented closing tags get absorbed into the previous list item:
+        //   - last bullet
+        //     </Card>     ← 2-space indent makes this part of the listItem
+        // The fix is always to unindent the closing tag flush-left (or
+        // separate it from the list with a blank line).
+        suggestion =
+            'Closing tag is indented and got absorbed into the preceding list item. ' +
+                'Unindent the closing tag flush-left, or add a blank line between the last list item and the closing tag.';
+    }
     else if (message.includes('Expected closing tag')) {
         suggestion = 'Add the missing closing tag or use self-closing syntax (<Component />)';
     }

package/dist/lib/mdx-validator.js.map

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

package/dist/lib/relative-mdx-imports.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Detect and rewrite parent-relative MDX imports.
+ *
+ * Mintlify supports `import X from '../snippets/foo.mdx'`; Jamdesk only
+ * resolves root-relative `import X from '/snippets/foo.mdx'`. The
+ * detector finds candidates; the rewriter fixes the ones that resolve
+ * under a `snippets/` directory (conservative — see plan).
+ */
+export interface RelativeMdxImport {
+    /** The import specifier as written, e.g. '../snippets/foo.mdx'. */
+    specifier: string;
+    /** 1-indexed line number in the source. */
+    line: number;
+    /** The full matched import statement (for replacement). */
+    raw: string;
+}
+export declare function stripFencedCodeBlocks(content: string): string;
+/**
+ * Pass `alreadyStripped: true` when the caller already ran
+ * `stripFencedCodeBlocks` — avoids redoing the regex pass when the same
+ * stripped content drives multiple analyses (e.g. link extraction +
+ * import detection during relocation).
+ */
+export declare function detectRelativeMdxImports(content: string, alreadyStripped?: boolean): RelativeMdxImport[];
+export interface RewriteResult {
+    /** Content with applicable imports rewritten. */
+    content: string;
+    /** Specifiers that were successfully rewritten. */
+    rewrites: {
+        from: string;
+        to: string;
+        line: number;
+    }[];
+    /** Human-readable warnings for imports left untouched. */
+    warnings: string[];
+}
+/**
+ * Rewrite parent-relative MDX imports to root-relative `/snippets/*` form
+ * when the resolved target sits under a top-level `snippets/` directory.
+ * Imports that resolve elsewhere (siblings, non-existent files, paths
+ * outside `projectRoot`) are left untouched and reported in `warnings`.
+ */
+export declare function rewriteRelativeMdxImports(content: string, filePath: string, projectRoot: string): Promise<RewriteResult>;
+//# sourceMappingURL=relative-mdx-imports.d.ts.map

package/dist/lib/relative-mdx-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-mdx-imports.d.ts","sourceRoot":"","sources":["../../src/lib/relative-mdx-imports.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AAEH,MAAM,WAAW,iBAAiB;IAChC,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,GAAG,EAAE,MAAM,CAAC;CACb;AA8BD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ7D;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,MAAM,EACf,eAAe,UAAQ,GACtB,iBAAiB,EAAE,CAiBrB;AAED,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvD,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC,CA0FxB"}

package/dist/lib/relative-mdx-imports.js

@@ -0,0 +1,145 @@
+// builder/cli/src/lib/relative-mdx-imports.ts
+import fs from 'fs-extra';
+import path from 'node:path';
+// Captures: import <binding> from '<./or../><path>.mdx';
+// Quotes: single or double. Named: { Foo, Bar } (multi-line ok). Default: Foo.
+// Namespace: * as Foo. Type-only: import type X. Combined: Default, { Named }.
+// Side-effect imports (`import "..mdx"` with no binding) are intentionally
+// ignored — MDX needs a binding to render the snippet.
+//
+// Anchored to start-of-line (with `gm` + `^[ \t]*`) so the regex can't match
+// the literal English word "import" inside a heading or prose paragraph and
+// then bridge across multiple lines to the real import — that produced wrong
+// `line` numbers in user-facing warnings (validate/dev print `<file>:<line>`).
+//
+// The binding character class allows identifiers, `$`, `*` (namespace), commas,
+// braces, spaces, and newlines (for multi-line `{ ... }` lists). It explicitly
+// excludes quotes and slashes so the bridge can't extend past the next `"` or
+// jump into a sibling import on a later line.
+const RELATIVE_MDX_IMPORT_RE = /^[ \t]*import\s+(?:type\s+)?[\w$*{}, \n\r]+\s+from\s+["'](\.{1,2}\/[^"']+\.mdx)["']\s*;?/gm;
+// Replaces fenced code-block bodies with same-shape blanks so line numbers are
+// preserved but imports inside fences don't match. Handles both ``` and ~~~
+// fences with optional info strings (e.g. ```mdx shared/example.mdx wrap).
+// Indent class is `( *)` (not the CommonMark `{0,3}`) so we also catch fences
+// nested in numbered list items / `<CodeGroup>` blocks where the fence opens
+// at column 4+ (real Mintlify pattern in `create/reusable-snippets.mdx`).
+// The capture binds `\1` to the exact indent so the close has to match.
+const FENCED_CODE_BLOCK_RE = /^( *)(```+|~~~+)[^\n]*\n([\s\S]*?)\n\1\2\s*$/gm;
+export function stripFencedCodeBlocks(content) {
+    return content.replace(FENCED_CODE_BLOCK_RE, (match, _indent, _fence, body) => {
+        // Replace body with blank lines of same count to preserve line numbers.
+        const bodyLines = body.split('\n').length;
+        const fenceOpen = match.split('\n')[0];
+        const fenceClose = match.split('\n').slice(-1)[0];
+        return [fenceOpen, ...Array(bodyLines).fill(''), fenceClose].join('\n');
+    });
+}
+/**
+ * Pass `alreadyStripped: true` when the caller already ran
+ * `stripFencedCodeBlocks` — avoids redoing the regex pass when the same
+ * stripped content drives multiple analyses (e.g. link extraction +
+ * import detection during relocation).
+ */
+export function detectRelativeMdxImports(content, alreadyStripped = false) {
+    const stripped = alreadyStripped ? content : stripFencedCodeBlocks(content);
+    const out = [];
+    RELATIVE_MDX_IMPORT_RE.lastIndex = 0;
+    let match;
+    while ((match = RELATIVE_MDX_IMPORT_RE.exec(stripped)) !== null) {
+        const before = stripped.slice(0, match.index);
+        // 1-indexed line of the `import` keyword. Line numbers preserved by
+        // stripFencedCodeBlocks (replaces body with same-count blank lines).
+        const line = before.split('\n').length;
+        out.push({
+            specifier: match[1],
+            line,
+            raw: match[0],
+        });
+    }
+    return out;
+}
+/**
+ * Rewrite parent-relative MDX imports to root-relative `/snippets/*` form
+ * when the resolved target sits under a top-level `snippets/` directory.
+ * Imports that resolve elsewhere (siblings, non-existent files, paths
+ * outside `projectRoot`) are left untouched and reported in `warnings`.
+ */
+export async function rewriteRelativeMdxImports(content, filePath, projectRoot) {
+    const matches = detectRelativeMdxImports(content);
+    const rewrites = [];
+    const warnings = [];
+    const fileDir = path.dirname(filePath);
+    const snippetsRoot = path.join(projectRoot, 'snippets');
+    const relPath = path.relative(projectRoot, filePath);
+    let next = content;
+    for (const m of matches) {
+        const resolved = path.resolve(fileDir, m.specifier);
+        if (!(await fs.pathExists(resolved))) {
+            // Resume-after-partial: a previous relocate run may have moved the
+            // file to `/snippets/<sameRel>` while leaving this importer's path
+            // untouched (e.g. user manually moved files, or relocate aborted
+            // mid-flight on a second pass). The relocator preserves source-dir
+            // structure when moving, so probing `snippets/<resolved-rel>` is
+            // the inverse of that move and cheaply makes re-runs idempotent.
+            const resolvedRel = path.relative(projectRoot, resolved);
+            if (!resolvedRel.startsWith('..') &&
+                !path.isAbsolute(resolvedRel) &&
+                !resolvedRel.startsWith(`snippets${path.sep}`)) {
+                const movedCandidate = path.join(snippetsRoot, resolvedRel);
+                if (await fs.pathExists(movedCandidate)) {
+                    const newSpec = `/snippets/${resolvedRel.replaceAll(path.sep, '/')}`;
+                    // Replacer functions (not strings) — `$` in user paths would
+                    // otherwise be interpreted as String.replace backreferences.
+                    const newImport = m.raw.replace(m.specifier, () => newSpec);
+                    next = next.replace(m.raw, () => newImport);
+                    rewrites.push({ from: m.specifier, to: newSpec, line: m.line });
+                    continue;
+                }
+            }
+            // Mintlify-style root-snippets fallback. `../snippets/X` from `zh/folder/`
+            // resolves literally to `zh/snippets/X` (doesn't exist), but the user
+            // almost always meant `<root>/snippets/X` — Mintlify resolves it that
+            // way regardless of depth, and localized pages copy the import verbatim.
+            const rootSnippetMatch = m.specifier.match(/^(?:\.\.\/)+snippets\/(.+\.mdx)$/);
+            if (rootSnippetMatch) {
+                const rootCandidate = path.join(snippetsRoot, rootSnippetMatch[1]);
+                if (await fs.pathExists(rootCandidate)) {
+                    const newSpec = `/snippets/${rootSnippetMatch[1]}`;
+                    const newImport = m.raw.replace(m.specifier, () => newSpec);
+                    next = next.replace(m.raw, () => newImport);
+                    rewrites.push({ from: m.specifier, to: newSpec, line: m.line });
+                    continue;
+                }
+            }
+            warnings.push(`${relPath}:${m.line}: ${m.specifier} — target file doesn't exist; ` +
+                `create the snippet or remove this import`);
+            continue;
+        }
+        const rel = path.relative(snippetsRoot, resolved);
+        if (rel.startsWith('..') || path.isAbsolute(rel)) {
+            // Target exists but isn't under /snippets/. The user has to decide.
+            const targetRel = path.relative(projectRoot, resolved);
+            const suggestedSnippetPath = `/snippets/${path.basename(resolved)}`;
+            // If the suggested destination already holds a different file,
+            // saying "Move the file to <X>" would clobber. Surface the conflict
+            // so the user knows to rename or merge instead.
+            const collision = await fs.pathExists(path.join(snippetsRoot, path.basename(resolved)));
+            if (collision) {
+                warnings.push(`${relPath}:${m.line}: ${m.specifier} → ${targetRel} is not under /snippets/, ` +
+                    `but ${suggestedSnippetPath} already exists with different content. ` +
+                    `Rename one of the files or inline this import.`);
+            }
+            else {
+                warnings.push(`${relPath}:${m.line}: ${m.specifier} → ${targetRel} is not under /snippets/. ` +
+                    `Move the file to ${suggestedSnippetPath} (and update this import) or inline its content.`);
+            }
+            continue;
+        }
+        const newSpec = `/snippets/${rel.replaceAll(path.sep, '/')}`;
+        const newImport = m.raw.replace(m.specifier, () => newSpec);
+        next = next.replace(m.raw, () => newImport);
+        rewrites.push({ from: m.specifier, to: newSpec, line: m.line });
+    }
+    return { content: next, rewrites, warnings };
+}
+//# sourceMappingURL=relative-mdx-imports.js.map

package/dist/lib/relative-mdx-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relative-mdx-imports.js","sourceRoot":"","sources":["../../src/lib/relative-mdx-imports.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAoB7B,yDAAyD;AACzD,+EAA+E;AAC/E,+EAA+E;AAC/E,2EAA2E;AAC3E,uDAAuD;AACvD,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,6EAA6E;AAC7E,+EAA+E;AAC/E,EAAE;AACF,gFAAgF;AAChF,+EAA+E;AAC/E,8EAA8E;AAC9E,8CAA8C;AAC9C,MAAM,sBAAsB,GAC1B,4FAA4F,CAAC;AAE/F,+EAA+E;AAC/E,4EAA4E;AAC5E,2EAA2E;AAC3E,8EAA8E;AAC9E,6EAA6E;AAC7E,0EAA0E;AAC1E,wEAAwE;AACxE,MAAM,oBAAoB,GACxB,gDAAgD,CAAC;AAEnD,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO,OAAO,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QAC5E,wEAAwE;QACxE,MAAM,SAAS,GAAI,IAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QACtD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD,OAAO,CAAC,SAAS,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAAe,EACf,eAAe,GAAG,KAAK;IAEvB,MAAM,QAAQ,GAAG,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC5E,MAAM,GAAG,GAAwB,EAAE,CAAC;IACpC,sBAAsB,CAAC,SAAS,GAAG,CAAC,CAAC;IACrC,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,sBAAsB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAChE,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9C,oEAAoE;QACpE,qEAAqE;QACrE,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QACvC,GAAG,CAAC,IAAI,CAAC;YACP,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;YACnB,IAAI;YACJ,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;SACd,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAWD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAe,EACf,QAAgB,EAChB,WAAmB;IAEnB,MAAM,OAAO,GAAG,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,QAAQ,GAA8B,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAErD,IAAI,IAAI,GAAG,OAAO,CAAC;IACnB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;QAEpD,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACrC,mEAAmE;YACnE,mEAAmE;YACnE,iEAAiE;YACjE,mEAAmE;YACnE,iEAAiE;YACjE,iEAAiE;YACjE,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACzD,IACE,CAAC,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC;gBAC7B,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC;gBAC7B,CAAC,WAAW,CAAC,UAAU,CAAC,WAAW,IAAI,CAAC,GAAG,EAAE,CAAC,EAC9C,CAAC;gBACD,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;gBAC5D,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;oBACxC,MAAM,OAAO,GAAG,aAAa,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;oBACrE,6DAA6D;oBAC7D,6DAA6D;oBAC7D,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;oBAC5D,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;oBAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;oBAChE,SAAS;gBACX,CAAC;YACH,CAAC;YAED,2EAA2E;YAC3E,sEAAsE;YACtE,sEAAsE;YACtE,yEAAyE;YACzE,MAAM,gBAAgB,GAAG,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;YAC/E,IAAI,gBAAgB,EAAE,CAAC;gBACrB,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnE,IAAI,MAAM,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;oBACvC,MAAM,OAAO,GAAG,aAAa,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;oBACnD,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;oBAC5D,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;oBAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;oBAChE,SAAS;gBACX,CAAC;YACH,CAAC;YACD,QAAQ,CAAC,IAAI,CACX,GAAG,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,SAAS,gCAAgC;gBACpE,0CAA0C,CAC3C,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QAClD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACjD,oEAAoE;YACpE,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YACvD,MAAM,oBAAoB,GAAG,aAAa,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpE,+DAA+D;YAC/D,oEAAoE;YACpE,gDAAgD;YAChD,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YACxF,IAAI,SAAS,EAAE,CAAC;gBACd,QAAQ,CAAC,IAAI,CACX,GAAG,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,SAAS,MAAM,SAAS,4BAA4B;oBAC/E,OAAO,oBAAoB,0CAA0C;oBACrE,gDAAgD,CACjD,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,IAAI,CACX,GAAG,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,SAAS,MAAM,SAAS,4BAA4B;oBAC/E,oBAAoB,oBAAoB,kDAAkD,CAC3F,CAAC;YACJ,CAAC;YACD,SAAS;QACX,CAAC;QAED,MAAM,OAAO,GAAG,aAAa,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;QAC7D,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;QAC5D,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAC/C,CAAC"}

package/dist/lib/run-build-script.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-build-script.d.ts","sourceRoot":"","sources":["../../src/lib/run-build-script.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAOD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACjE,OAAO,CAAC,YAAY,CAAC,CAgBvB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACjE,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC,CAIjE"}
+{"version":3,"file":"run-build-script.d.ts","sourceRoot":"","sources":["../../src/lib/run-build-script.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAOD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACjE,OAAO,CAAC,YAAY,CAAC,CAsBvB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACjE,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,CAAC,CAIjE"}

package/dist/lib/run-build-script.js

@@ -31,6 +31,13 @@ export async function runBuildScript(script, options) {
             if (stderr)
                 process.stderr.write(stderr);
         }
+        else if (stderr) {
+            // Successful scripts that wrote to stderr signalled a non-fatal warning
+            // (e.g. compile-snippets snippet-name collision). Surfacing these even
+            // in non-verbose mode means the next dev start doesn't blow up
+            // mysteriously when the warning's resolution lapses.
+            process.stderr.write(stderr);
+        }
         return { script, success: true };
     }
     catch (error) {

package/dist/lib/run-build-script.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-build-script.js","sourceRoot":"","sources":["../../src/lib/run-build-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAUlC,qEAAqE;AACrE,iDAAiD;AACjD,uDAAuD;AACvD,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,OAAkE;IAElE,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,gBAAgB,MAAM,EAAE,EAAE;YACnE,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS,EAAE,UAAU;SACtB,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,MAAM;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,MAAM;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,KAA6C,CAAC;QACxD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;IAC/E,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAiB,EACjB,OAAkE;IAElE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACnD,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACxE,CAAC"}
+{"version":3,"file":"run-build-script.js","sourceRoot":"","sources":["../../src/lib/run-build-script.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEjC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAUlC,qEAAqE;AACrE,iDAAiD;AACjD,uDAAuD;AACvD,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAc,EACd,OAAkE;IAElE,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,gBAAgB,MAAM,EAAE,EAAE;YACnE,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,SAAS,EAAE,UAAU;SACtB,CAAC,CAAC;QACH,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,IAAI,MAAM;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACzC,IAAI,MAAM;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;aAAM,IAAI,MAAM,EAAE,CAAC;YAClB,wEAAwE;YACxE,uEAAuE;YACvE,+DAA+D;YAC/D,qDAAqD;YACrD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,KAA6C,CAAC;QACxD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;IAC/E,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,OAAiB,EACjB,OAAkE;IAElE,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAClF,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACnD,OAAO,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACxE,CAAC"}

package/dist/lib/warn-relative-imports.d.ts

@@ -0,0 +1,2 @@
+export declare function warnOnRelativeMdxImports(projectDir: string): Promise<number>;
+//# sourceMappingURL=warn-relative-imports.d.ts.map

package/dist/lib/warn-relative-imports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warn-relative-imports.d.ts","sourceRoot":"","sources":["../../src/lib/warn-relative-imports.ts"],"names":[],"mappings":"AAIA,wBAAsB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA0BlF"}

package/dist/lib/warn-relative-imports.js

@@ -0,0 +1,29 @@
+import { glob } from 'glob';
+import { readFile } from 'node:fs/promises';
+import { detectRelativeMdxImports } from './relative-mdx-imports.js';
+export async function warnOnRelativeMdxImports(projectDir) {
+    const files = await glob('**/*.mdx', {
+        cwd: projectDir,
+        ignore: ['**/node_modules/**', '**/.git/**'],
+        absolute: true,
+    });
+    let offending = 0;
+    for (const file of files) {
+        try {
+            const content = await readFile(file, 'utf-8');
+            if (detectRelativeMdxImports(content).length > 0)
+                offending++;
+        }
+        catch {
+            // unreadable file — skip
+        }
+    }
+    if (offending > 0) {
+        console.warn(`\n⚠ Found ${offending} MDX file(s) with parent-relative imports. ` +
+            `Run "jamdesk migrate" to auto-fix; "jamdesk validate" lists each one with the ` +
+            `specific manual action when migrate can't help. Pages with these imports will ` +
+            `fail to compile.\n`);
+    }
+    return offending;
+}
+//# sourceMappingURL=warn-relative-imports.js.map

package/dist/lib/warn-relative-imports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"warn-relative-imports.js","sourceRoot":"","sources":["../../src/lib/warn-relative-imports.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AAErE,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,UAAkB;IAC/D,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE;QACnC,GAAG,EAAE,UAAU;QACf,MAAM,EAAE,CAAC,oBAAoB,EAAE,YAAY,CAAC;QAC5C,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IAEH,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC9C,IAAI,wBAAwB,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC;gBAAE,SAAS,EAAE,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;IAED,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CACV,aAAa,SAAS,6CAA6C;YACnE,gFAAgF;YAChF,gFAAgF;YAChF,oBAAoB,CACrB,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.69",
+  "version": "1.1.71",
   "description": "CLI for Jamdesk — build, preview, and deploy documentation sites from MDX. Dev server with hot reload, 50+ components, OpenAPI support, AI search, and Mintlify migration",
   "keywords": [
     "jamdesk",

package/vendored/app/(unlock)/jd/unlock/page.tsx

@@ -2,6 +2,7 @@ import { headers } from 'next/headers';
 import { getDocsConfig } from '@/lib/docs-isr';
 import { normalizeLogo } from '@/lib/docs-types';
 import { sanitizeFrom } from '@/lib/sanitize-from';
+import { getBrandingUrl } from '@/lib/branding-url';
 import UnlockForm from './UnlockForm';
 
 interface UnlockPageProps {
@@ -29,14 +30,19 @@ export default async function UnlockPage({ searchParams }: UnlockPageProps) {
   const from = sanitizeFrom(rawFrom ?? null);
   const showError = params.error === '1';
 
+  const showBranding = process.env.NEXT_PUBLIC_SHOW_BRANDING !== 'false';
+  const brandingUrl = getBrandingUrl(slug);
+
   return (
     <main
       style={{
         minHeight: '100vh',
         display: 'flex',
+        flexDirection: 'column',
         alignItems: 'center',
         justifyContent: 'center',
         padding: '24px 16px',
+        gap: 24,
       }}
     >
       <section
@@ -152,6 +158,32 @@ export default async function UnlockPage({ searchParams }: UnlockPageProps) {
           </p>
         )}
       </section>
+
+      {showBranding && (
+        <a
+          href={brandingUrl}
+          target="_blank"
+          rel="noopener noreferrer"
+          style={{
+            display: 'inline-flex',
+            alignItems: 'center',
+            gap: 6,
+            fontSize: 13,
+            color: '#9ca3af',
+            textDecoration: 'none',
+          }}
+        >
+          Powered by
+          {/* eslint-disable-next-line @next/next/no-img-element */}
+          <img
+            src="/_jd/branding/jamdesk-wordmark.svg"
+            alt="Jamdesk"
+            width={58}
+            height={15}
+            style={{ display: 'inline-block', verticalAlign: 'middle' }}
+          />
+        </a>
+      )}
     </main>
   );
 }

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

@@ -25,54 +25,102 @@ interface PageProps {
   }>;
 }
 
-function getAllDocPaths(): string[] {
+// Mirror of the CLI's detector regex in cli/src/lib/relative-mdx-imports.ts.
+// Duplicated intentionally — build-service uses bundler module resolution
+// and shouldn't reach into cli/src/. Keep the regex itself in sync with
+// that file. Two intentional simplifications vs the CLI version:
+//   - no `g` flag (boolean test, not iteration)
+//   - fence stripping replaces matches with empty string instead of
+//     blank lines of equal count — line numbers don't matter here, only
+//     a yes/no skip decision (the CLI preserves them for warning text).
+const PARENT_RELATIVE_MDX_IMPORT_RE =
+  /^[ \t]*import\s+(?:type\s+)?[\w$*{}, \n\r]+\s+from\s+["']\.{1,2}\/[^"']+\.mdx["']\s*;?/m;
+
+const FENCED_CODE_BLOCK_RE =
+  /^( *)(```+|~~~+)[^\n]*\n([\s\S]*?)\n\1\2\s*$/gm;
+
+export function pageHasRelativeMdxImport(filePath: string): boolean {
+  try {
+    // Read the full file — MDX imports can appear at any top-level position
+    // (after a long prose intro or table of contents), and a slice was
+    // missing real imports past byte ~8192 in 70-94 KB customer pages.
+    const content = fs.readFileSync(filePath, 'utf-8');
+    // Strip fenced code blocks so documentation examples (e.g.
+    // ```mdx\nimport X from "../snippets/foo.mdx";\n```) don't false-trigger.
+    return PARENT_RELATIVE_MDX_IMPORT_RE.test(content.replace(FENCED_CODE_BLOCK_RE, ''));
+  } catch {
+    return false;
+  }
+}
+
+interface CollectedPaths {
+  supported: string[];
+  skipped: string[];
+}
+
+function getAllDocPaths(): CollectedPaths {
   const contentDir = getContentDir();
-  const paths: string[] = [];
+  const supported: string[] = [];
+  const skipped: string[] = [];
 
   function traverseDir(dir: string, basePath: string = '') {
     if (!fs.existsSync(dir)) return;
     const files = fs.readdirSync(dir);
     for (const file of files) {
-      // Skip dotfiles (.claude, .git, etc.)
       if (file.startsWith('.')) continue;
       const filePath = path.join(dir, file);
       let stat;
       try {
         stat = fs.statSync(filePath);
       } catch {
-        // Broken symlink or inaccessible — skip
         continue;
       }
       if (stat.isDirectory()) {
         traverseDir(filePath, path.join(basePath, file));
       } else if (file.endsWith('.mdx')) {
         const slug = path.join(basePath, file.replace(/\.mdx$/, ''));
-        paths.push(slug);
+        if (pageHasRelativeMdxImport(filePath)) {
+          skipped.push(slug);
+        } else {
+          supported.push(slug);
+        }
       }
     }
   }
 
   traverseDir(contentDir);
-  return paths;
+  return { supported, skipped };
 }
 
+// In `jamdesk dev`, Next.js calls generateStaticParams during initial
+// compile AND for each lazily-compiled route (every page click). Without
+// a guard the same multi-line warning floods the dev console after every
+// navigation. Cache the prior skipped set and re-log only when it changes
+// — that way a user who fixes one import still sees the list shrink, but
+// repeated calls with no change stay quiet.
+let lastSkippedKey: string | null = null;
+
 export async function generateStaticParams() {
   // ISR: pages generated on-demand, no build-time pre-render.
   if (isIsrMode()) return [];
 
-  const paths = getAllDocPaths();
-  // next-mdx-remote can't compile relative MDX imports — skip those tests.
-  const unsupportedPatterns = ['deep-relative-test', 'relative-snippets-test'];
+  const { supported, skipped } = getAllDocPaths();
 
-  const supportedPaths = paths.filter(p => {
-    const skip = unsupportedPatterns.some(pattern => p.includes(pattern));
-    if (skip) console.log(`[Build] Skipping page with unsupported relative imports: ${p}`);
-    return !skip;
-  });
+  const skippedKey = skipped.length === 0 ? '' : skipped.slice().sort().join('\n');
+  if (skippedKey !== lastSkippedKey) {
+    lastSkippedKey = skippedKey;
+    if (skipped.length > 0) {
+      console.log(`[Build] Skipped ${skipped.length} page(s) with parent-relative MDX imports:`);
+      for (const slug of skipped) {
+        console.log(`  - ${slug}`);
+      }
+      console.log('  Run "jamdesk migrate" to auto-fix moveable imports, or "jamdesk validate" for per-import detail.');
+    }
+  }
 
   return [
     { slug: [] },
-    ...supportedPaths.map((p) => ({ slug: p.split('/') })),
+    ...supported.map((p) => ({ slug: p.split('/') })),
   ];
 }
 

package/vendored/components/navigation/SocialFooter.tsx

@@ -3,19 +3,9 @@
 import Image from 'next/image';
 import type { DocsConfig, SocialPlatform, FooterLinkColumn } from '@/lib/docs-types';
 import { getIconClass } from '@/lib/icon-utils';
+import { getBrandingUrl } from '@/lib/branding-url';
 
-// Branding configuration (read at build time from environment variables)
-// Uses NEXT_PUBLIC_ prefix so these are inlined during build for client components
-const showBranding = process.env.NEXT_PUBLIC_SHOW_BRANDING !== 'false'; // Default true
-
-/**
- * Generate branding URL with UTM parameters for attribution tracking.
- * projectSlug is passed as a prop (works in ISR multi-tenant mode).
- * Falls back to NEXT_PUBLIC_PROJECT_SLUG env var (works in CLI dev mode).
- */
-function getBrandingUrl(projectSlug: string): string {
-  return `https://www.jamdesk.com?utm_campaign=poweredBy&utm_medium=referral&utm_source=${projectSlug}`;
-}
+const showBranding = process.env.NEXT_PUBLIC_SHOW_BRANDING !== 'false';
 
 interface SocialFooterProps {
   config: DocsConfig;
@@ -150,23 +140,19 @@ export function SocialFooter({ config, hidden, projectSlug }: SocialFooterProps)
     return null;
   }
 
-  // Resolve slug: prop (ISR) → env var (CLI dev) → fallback
-  const slug = projectSlug || process.env.NEXT_PUBLIC_PROJECT_SLUG || 'docs';
-
   return (
     <footer className="mt-12 sm:mt-16 pt-6 sm:pt-8 border-t border-[var(--color-border)]">
       {hasLinks && <LinkColumns columns={links} />}
-      {/* Desktop: row layout, Mobile: column layout */}
       <div className="flex flex-col sm:flex-row sm:items-center sm:justify-between gap-4">
         {hasSocials && <SocialIcons socials={socials} />}
         {showBranding && (
           <a
-            href={getBrandingUrl(slug)}
+            href={getBrandingUrl(projectSlug)}
             target="_blank"
             rel="noopener noreferrer"
             className="group flex items-center gap-1 text-sm text-[#AEAEAE] hover:text-[#6A6D70] transition-colors whitespace-nowrap"
           >
-            <span>Powered by</span>
+            Powered by
             <span className="relative inline-block w-[58px] h-[15px] top-[1px]">
               <Image
                 src="/_jd/branding/jamdesk-wordmark.svg"