jamdesk 1.1.136 → 1.1.138

package/dist/lib/config-suggestions.js

@@ -0,0 +1,45 @@
+/**
+ * Config Suggestions (CLI)
+ *
+ * Detects optional-but-recommended docs.json fields the user hasn't set
+ * (favicon, description, logo) and returns suggestions with docs links.
+ * Softer than warnings: printed in a separate dim "Suggestions" section by
+ * `validate` and `dev`; never affects exit codes.
+ *
+ * Independent twin of build-service/lib/config-suggestions.ts (same
+ * precedent as validate-branding.ts). Keep messages/links aligned.
+ */
+const BRANDING_DOCS_URL = 'https://jamdesk.com/docs/customization/branding';
+/** A branding image field counts as set when it carries at least one path. */
+function hasImageValue(value) {
+    if (!value)
+        return false;
+    if (typeof value === 'string')
+        return value.trim() !== '';
+    return Boolean(value.light?.trim() || value.dark?.trim());
+}
+export function suggestConfigImprovements(config) {
+    const suggestions = [];
+    if (!hasImageValue(config.favicon)) {
+        suggestions.push({
+            message: 'Add a favicon so browser tabs and bookmarks show your brand icon instead of a generic page icon.',
+            link: `${BRANDING_DOCS_URL}#favicon`,
+        });
+    }
+    if (!config.description || config.description.trim() === '') {
+        suggestions.push({
+            message: 'Add a site description to improve how your docs appear in search results and social shares.',
+            // #site-name is deliberate: description is documented inside the docs
+            // page's "Site Name" section (no #description anchor exists yet).
+            link: `${BRANDING_DOCS_URL}#site-name`,
+        });
+    }
+    if (!hasImageValue(config.logo)) {
+        suggestions.push({
+            message: 'Add a logo so your site header shows your brand instead of the default Jamdesk logo.',
+            link: `${BRANDING_DOCS_URL}#logo`,
+        });
+    }
+    return suggestions;
+}
+//# sourceMappingURL=config-suggestions.js.map

package/dist/lib/config-suggestions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-suggestions.js","sourceRoot":"","sources":["../../src/lib/config-suggestions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAiBH,MAAM,iBAAiB,GAAG,iDAAiD,CAAC;AAE5E,8EAA8E;AAC9E,SAAS,aAAa,CAAC,KAA6D;IAClF,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAC1D,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,MAAwB;IAChE,MAAM,WAAW,GAAuB,EAAE,CAAC;IAC3C,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,WAAW,CAAC,IAAI,CAAC;YACf,OAAO,EAAE,kGAAkG;YAC3G,IAAI,EAAE,GAAG,iBAAiB,UAAU;SACrC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC5D,WAAW,CAAC,IAAI,CAAC;YACf,OAAO,EAAE,6FAA6F;YACtG,sEAAsE;YACtE,kEAAkE;YAClE,IAAI,EAAE,GAAG,iBAAiB,YAAY;SACvC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;QAChC,WAAW,CAAC,IAAI,CAAC;YACf,OAAO,EAAE,sFAAsF;YAC/F,IAAI,EAAE,GAAG,iBAAiB,OAAO;SAClC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/lib/language-filter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Picks which `<lang>/` directories under projectDir to keep as workspace
+ * symlinks and which to skip. Skipping non-active language directories
+ * shrinks Turbopack's filesystem scan and dropped cold compile from ~67s
+ * to ~12s on jamdesk-docs (commit 90d781b4).
+ *
+ * The dev server still reads content from the user's source tree via
+ * JAMDESK_PROJECTS_DIR, so the language picker keeps showing every
+ * language and clicks always 200 OK — the workspace symlinks are a
+ * Turbopack-only performance layer.
+ *
+ * Default rules:
+ *   1. Language with `default: true`
+ *   2. First language in `navigation.languages[]`
+ */
+export interface LanguageFilter {
+    active: string | null;
+    skip: Set<string>;
+}
+interface NavigationLanguageEntry {
+    language?: string;
+    default?: boolean;
+}
+interface MinimalConfig {
+    navigation?: {
+        languages?: NavigationLanguageEntry[];
+    };
+}
+export declare function getActiveLanguageFilter(config: MinimalConfig): LanguageFilter;
+export {};
+//# sourceMappingURL=language-filter.d.ts.map

package/dist/lib/language-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-filter.d.ts","sourceRoot":"","sources":["../../src/lib/language-filter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CACnB;AAED,UAAU,uBAAuB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,aAAa;IACrB,UAAU,CAAC,EAAE;QACX,SAAS,CAAC,EAAE,uBAAuB,EAAE,CAAC;KACvC,CAAC;CACH;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CAc7E"}

package/dist/lib/language-filter.js

@@ -0,0 +1,14 @@
+export function getActiveLanguageFilter(config) {
+    const validEntries = (config.navigation?.languages ?? []).filter((l) => typeof l.language === 'string');
+    if (validEntries.length === 0) {
+        return { active: null, skip: new Set() };
+    }
+    const codes = validEntries.map((l) => l.language);
+    const active = validEntries.find((l) => l.default)?.language ?? validEntries[0].language;
+    if (codes.length === 1) {
+        return { active, skip: new Set() };
+    }
+    const skip = new Set(codes.filter((c) => c !== active));
+    return { active, skip };
+}
+//# sourceMappingURL=language-filter.js.map

package/dist/lib/language-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-filter.js","sourceRoot":"","sources":["../../src/lib/language-filter.ts"],"names":[],"mappings":"AA+BA,MAAM,UAAU,uBAAuB,CAAC,MAAqB;IAC3D,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAC9D,CAAC,CAAC,EAAgD,EAAE,CAAC,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CACpF,CAAC;IACF,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAG,EAAU,EAAE,CAAC;IACnD,CAAC;IACD,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACzF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,EAAU,EAAE,CAAC;IAC7C,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC;IACxD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC1B,CAAC"}

package/dist/lib/loading-page.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loading-page.d.ts","sourceRoot":"","sources":["../../src/lib/loading-page.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAiNtE"}
+{"version":3,"file":"loading-page.d.ts","sourceRoot":"","sources":["../../src/lib/loading-page.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAUD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAkNtE"}

package/dist/lib/loading-page.js

@@ -2,6 +2,13 @@
  * Generates a self-contained HTML loading page shown while Next.js compiles.
  * Inline CSS + JS, zero external requests.
  */
+/**
+ * Jamdesk purple mark, shared by the body logo and the favicon data URI.
+ * The favicon must be declared explicitly: without one the browser reuses
+ * whatever icon it last cached for localhost:<port> (often another docs
+ * CLI's), since /favicon.ico requests get this HTML page back while loading.
+ */
+const JAMDESK_MARK_SVG = `<svg viewBox="0 0 2289 2038" fill="none" xmlns="http://www.w3.org/2000/svg"><g clip-path="url(#jd)"><path d="M1129.57 1311.33L874.802 891.18C871.197 885.234 865.147 881.59 858.194 881.554C767.557 881.077 136.784 877.9 113.489 881.612C88.3871 885.611 73.8331 886.702 53.4424 900.608C33.0517 914.514 15.9545 933.404 6.68471 963.597C-2.5851 993.79 -2.17416 1016.09 7.66949 1048.58C17.5131 1081.08 524.5 1921.11 545.5 1952.61C566.5 1984.11 583.272 2010.33 616.006 2023.4C648.739 2036.48 695.461 2035.4 724.5 2023.4C753.539 2011.4 772 1979.11 791 1952.61C808.575 1928.1 1088.41 1408.59 1130.28 1330.82C1133.63 1324.58 1133.24 1317.39 1129.57 1311.33Z" fill="#D6C2FF"/><path d="M2166.5 885.611C2131.07 879.853 1511.26 884.752 1418.96 885.515C1411.63 885.576 1405.35 889.635 1401.91 896.098L809.142 2007.78C802.048 2021.08 811.223 2037.15 826.3 2037.18C987.697 2037.52 1690.61 2038.88 1710.98 2037.11C1734 2035.11 1756.5 2027.11 1774 2013.11C1791.5 1999.11 1803.5 1976.11 1821 1953.11C1838.5 1930.11 2246.48 1130.65 2259.79 1099.11C2273.1 1067.57 2286.88 1046.31 2288.29 1012.11C2289.7 977.909 2277.12 955.19 2252 926.611C2226.88 898.033 2204.79 891.835 2166.5 885.611Z" fill="#AD85FF"/><path d="M501.001 57.6116C483.367 88.4712 161.381 679.447 85.4473 818.837C78.1875 832.164 87.9925 848.112 103.169 848.112H2171.04C2186.72 848.112 2196.44 831.097 2188.15 817.777C2100.22 676.343 1733.69 87.1557 1709.5 54.6116C1682 17.6118 1638 3.11141 1593 3.11126C1548 3.11111 621.001 -3.88914 582.001 3.11146C543.001 10.112 521.001 22.6116 501.001 57.6116Z" fill="#9966FF"/></g><defs><clipPath id="jd"><rect width="2289" height="2038" fill="white"/></clipPath></defs></svg>`;
 export function getLoadingPageHtml(options) {
     const { projectName, targetUrl, statusEndpoint } = options;
     return `<!DOCTYPE html>
@@ -10,6 +17,7 @@ export function getLoadingPageHtml(options) {
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
   <title>Building ${escapeHtml(projectName)} — Jamdesk</title>
+  <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,${encodeURIComponent(JAMDESK_MARK_SVG)}">
   <style>
     *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
 
@@ -140,7 +148,7 @@ export function getLoadingPageHtml(options) {
   <div class="glow"></div>
   <div class="container content">
     <div class="logo" role="img" aria-label="Jamdesk">
-      <svg viewBox="0 0 2289 2038" fill="none" xmlns="http://www.w3.org/2000/svg"><g clip-path="url(#jd)"><path d="M1129.57 1311.33L874.802 891.18C871.197 885.234 865.147 881.59 858.194 881.554C767.557 881.077 136.784 877.9 113.489 881.612C88.3871 885.611 73.8331 886.702 53.4424 900.608C33.0517 914.514 15.9545 933.404 6.68471 963.597C-2.5851 993.79 -2.17416 1016.09 7.66949 1048.58C17.5131 1081.08 524.5 1921.11 545.5 1952.61C566.5 1984.11 583.272 2010.33 616.006 2023.4C648.739 2036.48 695.461 2035.4 724.5 2023.4C753.539 2011.4 772 1979.11 791 1952.61C808.575 1928.1 1088.41 1408.59 1130.28 1330.82C1133.63 1324.58 1133.24 1317.39 1129.57 1311.33Z" fill="#D6C2FF"/><path d="M2166.5 885.611C2131.07 879.853 1511.26 884.752 1418.96 885.515C1411.63 885.576 1405.35 889.635 1401.91 896.098L809.142 2007.78C802.048 2021.08 811.223 2037.15 826.3 2037.18C987.697 2037.52 1690.61 2038.88 1710.98 2037.11C1734 2035.11 1756.5 2027.11 1774 2013.11C1791.5 1999.11 1803.5 1976.11 1821 1953.11C1838.5 1930.11 2246.48 1130.65 2259.79 1099.11C2273.1 1067.57 2286.88 1046.31 2288.29 1012.11C2289.7 977.909 2277.12 955.19 2252 926.611C2226.88 898.033 2204.79 891.835 2166.5 885.611Z" fill="#AD85FF"/><path d="M501.001 57.6116C483.367 88.4712 161.381 679.447 85.4473 818.837C78.1875 832.164 87.9925 848.112 103.169 848.112H2171.04C2186.72 848.112 2196.44 831.097 2188.15 817.777C2100.22 676.343 1733.69 87.1557 1709.5 54.6116C1682 17.6118 1638 3.11141 1593 3.11126C1548 3.11111 621.001 -3.88914 582.001 3.11146C543.001 10.112 521.001 22.6116 501.001 57.6116Z" fill="#9966FF"/></g><defs><clipPath id="jd"><rect width="2289" height="2038" fill="white"/></clipPath></defs></svg>
+      ${JAMDESK_MARK_SVG}
     </div>
     <h1 id="heading">Building Your Site</h1>
     <p class="project-name">${escapeHtml(projectName)}</p>

package/dist/lib/loading-page.js.map

@@ -1 +1 @@
-{"version":3,"file":"loading-page.js","sourceRoot":"","sources":["../../src/lib/loading-page.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,UAAU,kBAAkB,CAAC,OAA2B;IAC5D,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IAE3D,OAAO;;;;;oBAKW,UAAU,CAAC,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;8BAsIb,UAAU,CAAC,WAAW,CAAC;;;;;;;;;;;;;wBAa7B,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;6BACpB,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAoDnD,CAAC;AACT,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG;SACP,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"loading-page.js","sourceRoot":"","sources":["../../src/lib/loading-page.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG,wnDAAwnD,CAAC;AAElpD,MAAM,UAAU,kBAAkB,CAAC,OAA2B;IAC5D,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;IAE3D,OAAO;;;;;oBAKW,UAAU,CAAC,WAAW,CAAC;mEACwB,kBAAkB,CAAC,gBAAgB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAmI/F,gBAAgB;;;8BAGM,UAAU,CAAC,WAAW,CAAC;;;;;;;;;;;;;wBAa7B,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;6BACpB,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;QAoDnD,CAAC;AACT,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAO,GAAG;SACP,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC"}

package/dist/lib/output.d.ts

@@ -8,6 +8,12 @@ declare function header(text: string): void;
 declare function warn(text: string): void;
 declare function info(text: string): void;
 declare function hint(text: string): void;
+/**
+ * Suggestion headline — softer than warn (cyan ◆, not yellow ⚠).
+ * BMP glyph on purpose, NOT an emoji: Windows conhost renders astral-plane
+ * emoji (💡) inconsistently, and this CLI has dedicated Windows CI.
+ */
+declare function suggest(text: string): void;
 /**
  * A blank-line-framed group of hint lines, printed under a headline a spinner
  * already failed (`spin.fail(...)`). An empty string is a blank separator.
@@ -30,6 +36,7 @@ export declare const output: {
     info: typeof info;
     hint: typeof hint;
     hintBlock: typeof hintBlock;
+    suggest: typeof suggest;
     migrationNotice: typeof migrationNotice;
     spinner: typeof spinner;
     check: typeof success;

package/dist/lib/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AACA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAEpC,iBAAS,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEnC;AAED,iBAAS,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAajC;AAED,uEAAuE;AACvE,iBAAS,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAElC;AAED,YAAY,EAAE,GAAG,EAAE,CAAC;AAEpB,iBAAS,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAElC;AAED,iBAAS,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhC;AAED,iBAAS,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhC;AAED,iBAAS,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhC;AAED;;;;;GAKG;AACH,iBAAS,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAOxC;AAED;;;;;GAKG;AACH,iBAAS,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAO5C;AAED,eAAO,MAAM,MAAM;;;;;;;;;;;;CAYlB,CAAC"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AACA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAEpC,iBAAS,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEnC;AAED,iBAAS,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAajC;AAED,uEAAuE;AACvE,iBAAS,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAElC;AAED,YAAY,EAAE,GAAG,EAAE,CAAC;AAEpB,iBAAS,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAElC;AAED,iBAAS,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhC;AAED,iBAAS,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhC;AAED,iBAAS,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEhC;AAED;;;;GAIG;AACH,iBAAS,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEnC;AAED;;;;;GAKG;AACH,iBAAS,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAOxC;AAED;;;;;GAKG;AACH,iBAAS,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAO5C;AAED,eAAO,MAAM,MAAM;;;;;;;;;;;;;CAalB,CAAC"}

package/dist/lib/output.js

@@ -34,6 +34,14 @@ function info(text) {
 function hint(text) {
     console.log(chalk.gray(`  ${text}`));
 }
+/**
+ * Suggestion headline — softer than warn (cyan ◆, not yellow ⚠).
+ * BMP glyph on purpose, NOT an emoji: Windows conhost renders astral-plane
+ * emoji (💡) inconsistently, and this CLI has dedicated Windows CI.
+ */
+function suggest(text) {
+    console.log(chalk.cyan(`◆ ${text}`));
+}
 /**
  * A blank-line-framed group of hint lines, printed under a headline a spinner
  * already failed (`spin.fail(...)`). An empty string is a blank separator.
@@ -72,6 +80,7 @@ export const output = {
     info,
     hint,
     hintBlock,
+    suggest,
     migrationNotice,
     spinner,
     check: success,

package/dist/lib/output.js.map

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

package/dist/lib/tarball.d.ts

@@ -15,6 +15,14 @@ export declare function checkForSecrets(files: string[]): string[];
  * Applies .gitignore rules and always-excluded patterns.
  */
 export declare function collectFiles(dir: string): Promise<string[]>;
+/**
+ * Count content MDX pages in a collected file list. Mirrors the build
+ * service's collectMdxFiles() semantics (glob '**\/*.mdx' ignoring
+ * snippets\/**; collectFiles already excludes node_modules and .git).
+ * A deploy with zero content MDX publishes a site with no pages — the
+ * 2026-06-09 empty-manifest prune-skip incident shipped exactly that.
+ */
+export declare function countContentMdx(files: string[]): number;
 export interface TarballResult {
     buffer: Buffer;
     fileCount: number;

package/dist/lib/tarball.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tarball.d.ts","sourceRoot":"","sources":["../../src/lib/tarball.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoCH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAKzD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqCjE;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAuCvE"}
+{"version":3,"file":"tarball.d.ts","sourceRoot":"","sources":["../../src/lib/tarball.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoCH,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAKzD;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAqCjE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAKvD;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAuCvE"}

package/dist/lib/tarball.js

@@ -86,6 +86,19 @@ export async function collectFiles(dir) {
     await walk(dir);
     return files.sort();
 }
+/**
+ * Count content MDX pages in a collected file list. Mirrors the build
+ * service's collectMdxFiles() semantics (glob '**\/*.mdx' ignoring
+ * snippets\/**; collectFiles already excludes node_modules and .git).
+ * A deploy with zero content MDX publishes a site with no pages — the
+ * 2026-06-09 empty-manifest prune-skip incident shipped exactly that.
+ */
+export function countContentMdx(files) {
+    return files.filter((file) => {
+        const posixPath = file.split(/[\\/]/).join('/');
+        return posixPath.endsWith('.mdx') && !posixPath.startsWith('snippets/');
+    }).length;
+}
 /**
  * Create a gzipped tarball of the docs directory.
  * Respects .gitignore and excludes sensitive files.

package/dist/lib/tarball.js.map

@@ -1 +1 @@
-{"version":3,"file":"tarball.js","sourceRoot":"","sources":["../../src/lib/tarball.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7B,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,cAAc,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,SAAS;AAEnD,2EAA2E;AAC3E,MAAM,eAAe,GAAG;IACtB,MAAM;IACN,cAAc;IACd,OAAO;IACP,MAAM;IACN,QAAQ;IACR,OAAO;IACP,OAAO;IACP,kBAAkB;IAClB,SAAS;IACT,WAAW;IACX,WAAW;CACZ,CAAC;AAEF,kEAAkE;AAClE,MAAM,eAAe,GAAG;IACtB,SAAS;IACT,aAAa;IACb,QAAQ;IACR,QAAQ;IACR,qBAAqB;IACrB,gCAAgC;IAChC,UAAU;CACX,CAAC;AAEF,MAAM,UAAU,mBAAmB;IACjC,OAAO,CAAC,GAAG,eAAe,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,KAAe;IAC7C,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrC,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAW;IAC5C,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IAEzC,8BAA8B;IAC9B,IAAI,CAAC;QACH,MAAM,gBAAgB,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC;QAClF,EAAE,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,UAAU,IAAI,CAAC,UAAkB;QACpC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACnD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAClD,2DAA2D;YAC3D,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAEzD,IAAI,EAAE,CAAC,OAAO,CAAC,SAAS,CAAC;gBAAE,SAAS;YAEpC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,0CAA0C;gBAC1C,IAAI,EAAE,CAAC,OAAO,CAAC,SAAS,GAAG,GAAG,CAAC;oBAAE,SAAS;gBAC1C,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;gBAC1B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YAC3B,CAAC;YACD,0CAA0C;QAC5C,CAAC;IACH,CAAC;IAED,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC;AACtB,CAAC;AAQD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW;IAC7C,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,GAAG,CAAC,CAAC;IAEtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,QAAQ,CAChB,qBAAqB,EACrB,eAAe,EACf,CAAC,EACD,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,KAAK,CAAC,CAAC;IAEvD,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAmB,CAAC,CAAC;QAC7C,SAAS,IAAI,GAAG,CAAC,MAAM,CAAC;QACxB,IAAI,SAAS,GAAG,cAAc,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,CAAC,SAAS,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACtD,MAAM,IAAI,QAAQ,CAChB,uBAAuB,MAAM,sCAAsC,EACnE,mBAAmB,EACnB,CAAC,EACD,kEAAkE,CACnE,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAErC,OAAO;QACL,MAAM;QACN,SAAS,EAAE,KAAK,CAAC,MAAM;QACvB,IAAI,EAAE,MAAM,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"tarball.js","sourceRoot":"","sources":["../../src/lib/tarball.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.136",
+  "version": "1.1.138",
   "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/lib/build/error-parser.ts

@@ -7,6 +7,14 @@ export function generateErrorRef(buildId: string): string {
   return `ERR-${buildId.substring(0, 8).toUpperCase()}`;
 }
 
+/**
+ * Stable prefix of the 0-MDX guard error thrown in build.ts (copy_content
+ * phase). Defined here — not in build.ts — so build.ts imports it without
+ * creating an import cycle; the parser branch below matches on it, so the
+ * throw and the matcher can never drift apart.
+ */
+export const NO_MDX_CONTENT_ERROR = 'No MDX content files found';
+
 /**
  * Extract file path from error output using various patterns.
  * @param pageToFileMap - Optional mapping of URL paths to MDX files
@@ -140,6 +148,31 @@ export function parseErrorDetails(
     };
   }
 
+  // Empty-content guard (thrown in build.ts copy_content phase): the build
+  // collected zero .mdx files. Matched on the guard's stable message prefix.
+  // The --allow-empty hint is CLI-only: git-build owners never ran `jamdesk
+  // deploy` and CANNOT pass the flag (queueBuild scopes allowEmpty to
+  // tarball builds), and old CLI versions reject it as an unknown option —
+  // so lead with the real fix and offer the flag only where it can work.
+  if (message.includes(NO_MDX_CONTENT_ERROR)) {
+    const escapeHint = repoFullName
+      ? 'If you believe an empty site is intentional, contact support@jamdesk.com.'
+      : 'If an empty deploy is intentional, update to the latest CLI (`npm i -g jamdesk`) and re-run with `jamdesk deploy --allow-empty`.';
+    return {
+      type: 'config_error',
+      message: 'No content pages found',
+      details: message,
+      suggestion:
+        'The build collected zero .mdx content files, so it would publish an empty site.\n\n' +
+        'Fix: add at least one .mdx page and rebuild.\n\n' +
+        'Common causes:\n' +
+        '• Running `jamdesk deploy` from the wrong directory (no .mdx files next to docs.json)\n' +
+        '• A docs path setting pointing at a folder without MDX content\n' +
+        '• Pages excluded by .gitignore\n\n' +
+        escapeHint,
+    };
+  }
+
   // Configuration validation errors (from validate phase)
   if (message.includes('Missing docs.json') || message.includes('Invalid docs.json')) {
     const monorepoMatch = message.match(/Missing docs.json at '([^']+)'/);

package/vendored/lib/config-suggestions.ts

@@ -0,0 +1,71 @@
+/**
+ * Config Suggestions
+ *
+ * Detects optional-but-recommended docs.json fields the customer hasn't set
+ * (favicon, description, logo) and returns suggestion-tier BuildWarnings
+ * (types in SUGGESTION_TYPES — see shared/status-reporter.ts for how each
+ * surface treats them; never emailed, excluded from warningCount).
+ *
+ * Distinct from validate-branding-assets.ts: that warns when a field IS set
+ * but the referenced file is missing; this suggests when the field is absent.
+ *
+ * The CLI has an independent twin (cli/src/lib/config-suggestions.ts) —
+ * same precedent as validate-branding.ts. Keep messages/links aligned.
+ */
+
+import type { DocsConfig } from './docs-types.js';
+import type { BuildWarning } from '../shared/status-reporter.js';
+
+const BRANDING_DOCS_URL = 'https://jamdesk.com/docs/customization/branding';
+
+type ImageValue = string | { light?: string; dark?: string; href?: string } | undefined;
+
+/** A branding image field counts as set when it carries at least one path. */
+function hasImageValue(value: ImageValue): boolean {
+  if (!value) return false;
+  if (typeof value === 'string') return value.trim() !== '';
+  return Boolean(value.light?.trim() || value.dark?.trim());
+}
+
+interface SuggestionDef {
+  type: BuildWarning['type'];
+  message: string;
+  link: string;
+  isMissing: (config: DocsConfig) => boolean;
+}
+
+const SUGGESTION_DEFS: SuggestionDef[] = [
+  {
+    type: 'missing_favicon',
+    message: 'Add a favicon so browser tabs and bookmarks show your brand icon instead of a generic page icon.',
+    link: `${BRANDING_DOCS_URL}#favicon`,
+    isMissing: (c) => !hasImageValue(c.favicon as ImageValue),
+  },
+  {
+    type: 'missing_description',
+    message: 'Add a site description to improve how your docs appear in search results and social shares.',
+    // #site-name is deliberate: description is documented inside the docs
+    // page's "Site Name" section (no #description anchor exists yet).
+    link: `${BRANDING_DOCS_URL}#site-name`,
+    isMissing: (c) => !c.description || c.description.trim() === '',
+  },
+  {
+    type: 'missing_logo',
+    message: 'Add a logo so your site header shows your brand instead of the default Jamdesk logo.',
+    link: `${BRANDING_DOCS_URL}#logo`,
+    isMissing: (c) => !hasImageValue(c.logo as ImageValue),
+  },
+];
+
+/**
+ * Suggest optional config improvements. Bounded output (max 3 entries), so
+ * it can be appended to allWarnings without interacting with per-type caps.
+ */
+export function suggestConfigImprovements(config: DocsConfig): BuildWarning[] {
+  return SUGGESTION_DEFS.filter((def) => def.isMissing(config)).map((def) => ({
+    type: def.type,
+    file: 'docs.json',
+    message: def.message,
+    link: def.link,
+  }));
+}

package/vendored/lib/r2-cleanup.ts

@@ -87,7 +87,7 @@ export async function deleteRemovedR2Objects(
  * cached-redis.ts: accepts any truthy value except '0'/'false'. Trims because
  * Vercel/Cloud Run env values can pick up trailing whitespace.
  */
-function envFlag(name: string): boolean {
+export function envFlag(name: string): boolean {
   const v = process.env[name]?.trim().toLowerCase();
   if (!v) return false;
   return v !== '0' && v !== 'false';
@@ -120,9 +120,25 @@ export interface PrunableManifest {
 
 export type PruneSkipReason = 'disabled' | 'empty-manifest' | 'mass-delete' | 'stale-build';
 
+/**
+ * Per-category context for a skipped prune, logged for instant triage — the
+ * 2026-06-10 mass-delete investigation needed manifest archaeology to recover
+ * these numbers. removedCounts = keys that WOULD have been deleted
+ * (post-exclusion); only computable for mass-delete, which runs after the
+ * key diff. Timestamps only for stale-build.
+ */
+export interface PruneSkipDetail {
+  oldCounts: { content: number; snippets: number; openapi: number };
+  newCounts: { content: number; snippets: number; openapi: number };
+  removedCounts?: { content: number; snippets: number; openapi: number };
+  oldCommitTimestamp?: string;
+  newCommitTimestamp?: string;
+}
+
 export interface ContentPruneResult extends CleanupResult {
   skipped: boolean;
   skipReason?: PruneSkipReason;
+  skipDetail?: PruneSkipDetail;
 }
 
 /**
@@ -204,6 +220,12 @@ async function batchDeleteKeys(keys: string[]): Promise<CleanupResult> {
   return { deleted, failed };
 }
 
+const categoryCounts = (m: PrunableManifest) => ({
+  content: Object.keys(m.files ?? {}).length,
+  snippets: Object.keys(m.snippets ?? {}).length,
+  openapi: Object.keys(m.openapi ?? {}).length,
+});
+
 /**
  * Prune content MDX, snippets, and OpenAPI specs that the new build dropped.
  *
@@ -245,7 +267,13 @@ export async function pruneRemovedContent(
     return { deleted: [], failed: [], skipped: true, skipReason: 'disabled' };
   }
   if (Object.keys(newManifest.files ?? {}).length === 0) {
-    return { deleted: [], failed: [], skipped: true, skipReason: 'empty-manifest' };
+    return {
+      deleted: [],
+      failed: [],
+      skipped: true,
+      skipReason: 'empty-manifest',
+      skipDetail: { oldCounts: categoryCounts(oldManifest), newCounts: categoryCounts(newManifest) },
+    };
   }
 
   // Stale-build guard: skip the prune when THIS build's commit is strictly OLDER
@@ -273,7 +301,18 @@ export async function pruneRemovedContent(
   const bothParseable = !Number.isNaN(newCommitMs) && !Number.isNaN(oldCommitMs);
   const neitherFutureDated = newCommitMs <= nowMs && oldCommitMs <= nowMs;
   if (bothParseable && neitherFutureDated && newCommitMs < oldCommitMs) {
-    return { deleted: [], failed: [], skipped: true, skipReason: 'stale-build' };
+    return {
+      deleted: [],
+      failed: [],
+      skipped: true,
+      skipReason: 'stale-build',
+      skipDetail: {
+        oldCounts: categoryCounts(oldManifest),
+        newCounts: categoryCounts(newManifest),
+        oldCommitTimestamp: oldManifest.commitTimestamp,
+        newCommitTimestamp: newManifest.commitTimestamp,
+      },
+    };
   }
 
   // Never prune a snippet still imported by surviving content, nor any key that
@@ -309,7 +348,21 @@ export async function pruneRemovedContent(
     isMassDelete(snippetKeys.length, Object.keys(oldManifest.snippets ?? {}).length) ||
     isMassDelete(openapiKeys.length, Object.keys(oldManifest.openapi ?? {}).length);
   if (massDelete && !envFlag('JD_PRUNE_ALLOW_MASS')) {
-    return { deleted: [], failed: [], skipped: true, skipReason: 'mass-delete' };
+    return {
+      deleted: [],
+      failed: [],
+      skipped: true,
+      skipReason: 'mass-delete',
+      skipDetail: {
+        oldCounts: categoryCounts(oldManifest),
+        newCounts: categoryCounts(newManifest),
+        removedCounts: {
+          content: contentKeys.length,
+          snippets: snippetKeys.length,
+          openapi: openapiKeys.length,
+        },
+      },
+    };
   }
 
   const { deleted, failed } = await batchDeleteKeys([...contentKeys, ...snippetKeys, ...openapiKeys]);

package/vendored/shared/status-reporter.ts

@@ -22,7 +22,7 @@ export interface ProgressUpdate {
 }
 
 /** Warning types that can occur during builds (non-blocking) */
-export type BuildWarningType = 'broken_link' | 'auto_migrate' | 'missing_asset' | 'missing_page' | 'missing_openapi_ref' | 'inline_code_on_api_page' | 'invalid_openapi_spec' | 'missing_snippet' | 'risky_expression';
+export type BuildWarningType = 'broken_link' | 'auto_migrate' | 'missing_asset' | 'missing_page' | 'missing_openapi_ref' | 'inline_code_on_api_page' | 'invalid_openapi_spec' | 'missing_snippet' | 'risky_expression' | 'missing_favicon' | 'missing_description' | 'missing_logo';
 
 /** Build warning structure */
 export interface BuildWarning {
@@ -33,6 +33,39 @@ export interface BuildWarning {
   message?: string;
 }
 
+/**
+ * Suggestion-tier warning types — softer than warnings. A warning means
+ * "something you wrote is broken"; a suggestion means "your site works but
+ * an optional docs.json field (favicon, description, logo) is unset and
+ * setting it would improve branding/SEO". Suggestions ride the same
+ * warnings[] pipeline but every surface treats them differently:
+ *   - CLI validate/dev: separate dim "Suggestions" section
+ *   - Dashboard BuildsList: DISPLAYED_SUGGESTION_TYPES section, excluded
+ *     from the orange warning badge
+ *   - Email: NEVER sent — EMAILABLE_TYPES (dashboard/functions) is a
+ *     fail-closed allowlist that excludes them
+ *   - warningCount (Firestore): excluded via
+ *     countWarningsExcludingSuggestions below. NOTE: the mobile apps
+ *     (jamdesk-mobile, separate repo) display warningCount verbatim —
+ *     keep the exclusion here, not in each consumer.
+ * `link` on a suggestion warning carries a docs URL ("Learn more"), not a
+ * broken link target.
+ */
+export const SUGGESTION_TYPES: ReadonlySet<BuildWarningType> = new Set([
+  'missing_favicon',
+  'missing_description',
+  'missing_logo',
+]);
+
+/**
+ * Warning count for user-facing "N warnings" displays (Firestore
+ * warningCount, editor toast). Suggestions are excluded so a build whose
+ * only findings are unset optional config doesn't read as "3 warnings".
+ */
+export function countWarningsExcludingSuggestions(warnings: BuildWarning[]): number {
+  return warnings.filter((w) => !SUGGESTION_TYPES.has(w.type)).length;
+}
+
 /** File statistics from the build process */
 export interface FileStats {
   sourceFiles: number;

package/vendored/shared/types.ts

@@ -19,6 +19,7 @@ export interface BuildParams {
   commitSha?: string;        // Optional for CLI builds
   commitMessage?: string;    // Optional for CLI builds
   fullRebuild?: boolean;  // If true, forces full R2 upload (ignores manifest)
+  allowEmpty?: boolean;   // CLI --allow-empty: permit a 0-MDX build (default false)
   docsPath?: string | null;  // Monorepo: path to docs.json directory (e.g., "jamdesk")
   domain?: string;  // Project's custom domain or subdomain (e.g., "docs.acme.com" or "acme.jamdesk.app")
   showBranding?: boolean;  // Show "Powered by Jamdesk" in footer (defaults to true)

package/vendored/workspace-package-lock.json

@@ -1932,9 +1932,9 @@
       }
     },
     "node_modules/@types/node": {
-      "version": "25.9.2",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-25.9.2.tgz",
-      "integrity": "sha512-G05zqtJhcDLb8uslf5EjCxXg9G1KQxiV8OS0R26IC//Eoyitzqe8z37I7cqvnZlrlSfgocQRfSn/AHBZJJFyGw==",
+      "version": "25.9.3",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-25.9.3.tgz",
+      "integrity": "sha512-603BddQMv3pUcr4U2dhujk83N2tTDVr/34wII2B6bJy6g+8WD6yUb11jszNs0gdi4PesVWl7ABt8nYMVpnLUcg==",
       "license": "MIT",
       "dependencies": {
         "undici-types": ">=7.24.0 <7.24.7"