jamdesk 1.1.139 → 1.1.141

package/dist/__tests__/unit/config-suggestions.test.js

@@ -7,7 +7,7 @@ describe('suggestConfigImprovements (CLI)', () => {
         expect(suggestions).toHaveLength(3);
         expect(suggestions.map((s) => s.link)).toEqual([
             'https://jamdesk.com/docs/customization/branding#favicon',
-            'https://jamdesk.com/docs/customization/branding#site-name',
+            'https://jamdesk.com/docs/customization/branding#description',
             'https://jamdesk.com/docs/customization/branding#logo',
         ]);
     });
@@ -24,7 +24,7 @@ describe('suggestConfigImprovements (CLI)', () => {
     it('empty object logo and whitespace description count as missing', () => {
         const suggestions = suggestConfigImprovements({ favicon: '/f.svg', logo: {}, description: '  ' });
         expect(suggestions.map((s) => s.link)).toEqual([
-            'https://jamdesk.com/docs/customization/branding#site-name',
+            'https://jamdesk.com/docs/customization/branding#description',
             'https://jamdesk.com/docs/customization/branding#logo',
         ]);
     });

package/dist/__tests__/unit/config-suggestions.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-suggestions.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/config-suggestions.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAyB,MAAM,iCAAiC,CAAC;AAEnG,MAAM,QAAQ,GAAG,CAAC,MAAwB,EAAE,EAAE,CAC5C,yBAAyB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAE1D,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,WAAW,GAAG,yBAAyB,CAAC,EAAE,CAAC,CAAC;QAClD,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YAC7C,yDAAyD;YACzD,2DAA2D;YAC3D,sDAAsD;SACvD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,yBAAyB,CAAC;YAC/B,OAAO,EAAE,cAAc;YACvB,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;YAC5B,WAAW,EAAE,MAAM;SACpB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,WAAW,GAAG,yBAAyB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAClG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YAC7C,2DAA2D;YAC3D,sDAAsD;SACvD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,WAAW,GAAG,yBAAyB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QACxH,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kFAAkF,EAAE,GAAG,EAAE;QAC1F,MAAM,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YAClE,kGAAkG;YAClG,6FAA6F;YAC7F,sFAAsF;SACvF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"config-suggestions.test.js","sourceRoot":"","sources":["../../../src/__tests__/unit/config-suggestions.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAyB,MAAM,iCAAiC,CAAC;AAEnG,MAAM,QAAQ,GAAG,CAAC,MAAwB,EAAE,EAAE,CAC5C,yBAAyB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;AAE1D,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACpE,MAAM,WAAW,GAAG,yBAAyB,CAAC,EAAE,CAAC,CAAC;QAClD,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YAC7C,yDAAyD;YACzD,6DAA6D;YAC7D,sDAAsD;SACvD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,CAAC,yBAAyB,CAAC;YAC/B,OAAO,EAAE,cAAc;YACvB,IAAI,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE;YAC5B,WAAW,EAAE,MAAM;SACpB,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAClG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,WAAW,GAAG,yBAAyB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QAClG,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;YAC7C,6DAA6D;YAC7D,sDAAsD;SACvD,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;QAC/C,MAAM,WAAW,GAAG,yBAAyB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;QACxH,MAAM,CAAC,WAAW,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kFAAkF,EAAE,GAAG,EAAE;QAC1F,MAAM,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;YAClE,kGAAkG;YAClG,6FAA6F;YAC7F,sFAAsF;SACvF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/lib/config-suggestions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-suggestions.d.ts","sourceRoot":"","sources":["../../src/lib/config-suggestions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,IAAI,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAWD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAuBtF"}
+{"version":3,"file":"config-suggestions.d.ts","sourceRoot":"","sources":["../../src/lib/config-suggestions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,IAAI,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAWD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAqBtF"}

package/dist/lib/config-suggestions.js

@@ -29,9 +29,7 @@ export function suggestConfigImprovements(config) {
     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`,
+            link: `${BRANDING_DOCS_URL}#description`,
         });
     }
     if (!hasImageValue(config.logo)) {

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

@@ -1 +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"}
+{"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,IAAI,EAAE,GAAG,iBAAiB,cAAc;SACzC,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jamdesk",
-  "version": "1.1.139",
+  "version": "1.1.141",
   "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/components/mdx/MermaidInner.tsx

@@ -47,8 +47,29 @@ interface ColorPalette {
   ganttSections: string[];
   ganttGridLine: string;
   gitBranchColors: string[];
+  pieSliceStroke: string;
 }
 
+// Mermaid's built-in palettes (including 'neutral') color pie slices with
+// washed-out, near-white grays: low-contrast on a light background and wiped to
+// transparent by the dark-mode path-fill inversion below — so slices render with
+// no visible color in either mode. We override slice + legend fills with a
+// distinct, mid-tone palette that reads on both backgrounds, mirroring the
+// curated colors already used for gantt bars and git branches. Every entry has at
+// least one channel < 200, so isLightColor() never flags them.
+const PIE_SLICE_COLORS = [
+  '#3b82f6', // blue
+  '#ef4444', // red
+  '#22c55e', // green
+  '#f59e0b', // amber
+  '#a855f7', // purple
+  '#14b8a6', // teal
+  '#ec4899', // pink
+  '#f97316', // orange
+  '#64748b', // slate
+  '#84cc16', // lime
+];
+
 const darkPalette: ColorPalette = {
   text: '#e5e7eb',
   line: '#9ca3af',
@@ -59,6 +80,7 @@ const darkPalette: ColorPalette = {
   ganttSections: ['#1e1e3f', '#2d2d1e', '#1e2d1e'],
   ganttGridLine: '#374151',
   gitBranchColors: ['#3b82f6', '#eab308', '#22c55e', '#f97316', '#ec4899', '#a78bfa'],
+  pieSliceStroke: '#1f2937', // dark slate — crisp separation between slices on a dark bg
 };
 
 const lightPalette: ColorPalette = {
@@ -71,6 +93,7 @@ const lightPalette: ColorPalette = {
   ganttSections: ['#f0f0ff', '#fff8e6', '#f0fff0'],
   ganttGridLine: '#e5e7eb',
   gitBranchColors: ['#3b82f6', '#eab308', '#22c55e', '#f97316', '#ec4899', '#8b5cf6'],
+  pieSliceStroke: '#ffffff', // white — crisp separation between slices on a light bg
 };
 
 // Styling helper utilities
@@ -129,7 +152,46 @@ function applyClassDiagramStyles(svgEl: SVGElement, palette: ColorPalette): void
 }
 
 function applyPieChartStyles(svgEl: SVGElement, palette: ColorPalette): void {
+  // Title and legend text follow the theme text color.
   styleElements(svgEl, '.pieLabel, .legend text, .pieTitleText', { fill: palette.text });
+
+  const slices = svgEl.querySelectorAll<SVGPathElement>('path.pieCircle');
+  if (slices.length === 0) return; // not a pie chart
+
+  // Re-color slices and legend swatches from PIE_SLICE_COLORS. Each distinct
+  // original (washed-out) color maps to one vivid color, recorded as the slices
+  // are walked, then reused for the legend so a slice and its legend entry —
+  // which share mermaid's original ordinal color — get the same override.
+  const colorMap = new Map<string, string>();
+  let nextColor = 0;
+  const overrideFor = (rawFill: string | null | undefined): string => {
+    const key = normalizeColor(rawFill) ?? `pos-${nextColor}`;
+    let vivid = colorMap.get(key);
+    if (!vivid) {
+      vivid = PIE_SLICE_COLORS[nextColor % PIE_SLICE_COLORS.length];
+      nextColor += 1;
+      colorMap.set(key, vivid);
+    }
+    return vivid;
+  };
+
+  slices.forEach((slice) => {
+    const vivid = overrideFor(slice.style.fill || slice.getAttribute('fill'));
+    slice.style.fill = vivid;
+    slice.style.stroke = palette.pieSliceStroke;
+    slice.style.strokeWidth = '2';
+  });
+
+  // Legend swatches: <g class="legend"> > rect, fill set via inline style.
+  svgEl.querySelectorAll<SVGRectElement>('.legend rect').forEach((swatch) => {
+    const vivid = overrideFor(swatch.style.fill || swatch.getAttribute('fill'));
+    swatch.style.fill = vivid;
+    swatch.style.stroke = vivid;
+  });
+
+  // Percentage labels sit on top of the slices — white reads on every palette
+  // tone. The dark-mode text inversion spares text.slice so this survives there.
+  styleElements(svgEl, 'text.slice', { fill: '#ffffff' });
 }
 
 // Check if an RGB color is light (r,g,b > threshold)
@@ -147,6 +209,26 @@ function isDarkColor(rgbString: string, threshold = 150): boolean {
   return r < threshold && g < threshold && b < threshold;
 }
 
+// Normalize a CSS color (hex or rgb()) to a canonical "r,g,b" string. A pie
+// slice's fill arrives as a hex attribute (e.g. "#ECECFF") while its matching
+// legend swatch's fill is an inline style the browser reports as "rgb(...)" —
+// normalizing lets the same underlying color compare equal across both formats,
+// so a slice and its legend entry get the same override color. Returns null when
+// the value can't be parsed (caller falls back to a positional key).
+function normalizeColor(value: string | null | undefined): string | null {
+  if (!value) return null;
+  const v = value.trim();
+  const rgb = v.match(/rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)/i);
+  if (rgb) return `${+rgb[1]},${+rgb[2]},${+rgb[3]}`;
+  let hex = v.replace(/^#/, '');
+  if (hex.length === 3) hex = hex.split('').map((c) => c + c).join('');
+  if (hex.length === 6 && /^[0-9a-f]{6}$/i.test(hex)) {
+    const n = parseInt(hex, 16);
+    return `${(n >> 16) & 255},${(n >> 8) & 255},${n & 255}`;
+  }
+  return null;
+}
+
 // Shared styles applied to both light and dark modes
 function applyCommonStyles(svgEl: SVGElement, palette: ColorPalette): void {
   // Cluster/subgraph backgrounds
@@ -174,15 +256,22 @@ function applyCommonStyles(svgEl: SVGElement, palette: ColorPalette): void {
 
 // Dark mode requires additional color inversions
 function applyDarkModeInversions(svgEl: SVGElement, palette: ColorPalette): void {
-  // Make background rects transparent
+  // Make background rects transparent. Pie legend swatches (.legend rect) are
+  // re-colored in applyPieChartStyles — leave their fills alone.
   svgEl.querySelectorAll('rect').forEach((rect) => {
-    if (!rect.closest('.cluster') && !rect.closest('.node') && !rect.classList.contains('actor')) {
+    if (
+      !rect.closest('.cluster') &&
+      !rect.closest('.node') &&
+      !rect.classList.contains('actor') &&
+      !rect.closest('.legend')
+    ) {
       (rect as SVGElement).style.fill = 'transparent';
     }
   });
 
-  // Invert text colors
-  styleElements(svgEl, 'text, .nodeLabel, .edgeLabel, .label, tspan', { fill: palette.text });
+  // Invert text colors. text.slice (pie percentage labels) is excluded so the
+  // white set in applyPieChartStyles stays legible on the colored slices.
+  styleElements(svgEl, 'text:not(.slice), .nodeLabel, .edgeLabel, .label, tspan', { fill: palette.text });
   styleElements(svgEl, 'text.actor, .messageText, .labelText, .loopText, .noteText', { fill: palette.text });
 
   // Invert foreignObject text and clear light backgrounds
@@ -198,8 +287,10 @@ function applyDarkModeInversions(svgEl: SVGElement, palette: ColorPalette): void
     }
   });
 
-  // Invert lines and paths
+  // Invert lines and paths. Pie slices (path.pieCircle) carry their own colors
+  // from applyPieChartStyles — skip them so the fill isn't wiped to transparent.
   svgEl.querySelectorAll('path, line').forEach((el) => {
+    if ((el as Element).classList.contains('pieCircle')) return;
     const computed = window.getComputedStyle(el);
     if (computed.stroke && computed.stroke !== 'none') {
       (el as SVGElement).style.stroke = palette.line;

package/vendored/lib/config-suggestions.ts

@@ -44,9 +44,7 @@ const SUGGESTION_DEFS: SuggestionDef[] = [
   {
     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`,
+    link: `${BRANDING_DOCS_URL}#description`,
     isMissing: (c) => !c.description || c.description.trim() === '',
   },
   {

package/vendored/lib/vector-store.ts

@@ -52,15 +52,88 @@ const MIN_SCORE = 0.3;
 /** Max chunks per page — raised from 3 to 4 to match broader topK retrieval budget */
 const MAX_CHUNKS_PER_PAGE = 4;
 
-/** Create a namespaced Upstash Vector index for a project. */
-function getNamespace(projectId: string) {
+/**
+ * Hard deadline for the build-time embedding write (reset + all upsert batches
+ * combined). A transient Upstash stall must fail this step FAST — it is
+ * non-fatal to the build (build.ts swallows it) — instead of hanging the single
+ * Cloud Run build instance until the 21-minute stale-build watchdog reaps it as
+ * a false "timed out" failure (kapptivate, 2026-06-11). Healthy writes finish in
+ * <15s; 90s tolerates a slow-but-alive Upstash while still failing ~14× faster
+ * than the watchdog.
+ */
+const UPSERT_TIMEOUT_MS = 90_000;
+
+/**
+ * Hard deadline for a live chat/search retrieval. Queries normally finish in
+ * <500ms; bound them so a stalled Upstash cannot hang the chat SSE request. The
+ * chat/search routes already treat a rejected query gracefully (rewrite path
+ * resolves to [], original-query reject → 503 chat / 502 docs-search), so a fast
+ * reject is preferable to an open-ended hang.
+ */
+const QUERY_TIMEOUT_MS = 10_000;
+
+/**
+ * Create a namespaced Upstash Vector index for a project.
+ *
+ * `signal` is REQUIRED on purpose: it must come from a withDeadline() wrapper.
+ * A bare getNamespace() would issue UNBOUNDED reset/upsert/query requests — the
+ * exact hang this module guards against (kapptivate, 2026-06-11) — so making the
+ * param non-optional forces every (current and future) caller through a deadline
+ * at compile time rather than by remembering a comment. The signal is forwarded
+ * to the SDK so an aborted deadline closes the underlying socket.
+ */
+function getNamespace(projectId: string, signal: AbortSignal) {
   const index = new Index({
     url: process.env.UPSTASH_VECTOR_REST_URL!,
     token: process.env.UPSTASH_VECTOR_REST_TOKEN!,
+    signal,
   });
   return index.namespace(projectId);
 }
 
+/**
+ * Run an Upstash operation under a hard deadline.
+ *
+ * The Promise.race timer is the GUARANTEE: it rejects the caller at `ms` no
+ * matter what the SDK does. The AbortSignal handed to `op` is best-effort —
+ * @upstash/vector 1.2.3 does NOT propagate an aborted fetch as a rejection; its
+ * request loop catches the AbortError and synthesizes a 200 "success". What the
+ * signal still buys us is closing the underlying socket so a hung connection
+ * does not linger past the deadline. So: timer = correctness, signal = resource
+ * hygiene — do NOT remove the timer believing the signal suffices.
+ *
+ * On timeout this REJECTS — callers decide whether that is fatal. A genuine
+ * pre-deadline rejection (e.g. the SDK exhausting its retries on a flapping
+ * endpoint) propagates as-is so the real Upstash error is logged rather than a
+ * generic timeout.
+ */
+async function withDeadline<T>(
+  ms: number,
+  operation: string,
+  op: (signal: AbortSignal) => Promise<T>,
+): Promise<T> {
+  const controller = new AbortController();
+  let timer: ReturnType<typeof setTimeout> | undefined;
+  const deadline = new Promise<never>((_, reject) => {
+    timer = setTimeout(() => {
+      controller.abort();
+      reject(new Error(`Upstash ${operation} timed out after ${ms}ms`));
+    }, ms);
+  });
+  const work = op(controller.signal);
+  // Swallow the late settlement of the losing promise so it cannot bubble as an
+  // unhandledRejection after the deadline already won the race. (Load-bearing in
+  // prod for the genuine-error case; on an abort the SDK resolves `work` with a
+  // synthetic 200, so this no-ops.) The genuine error still reaches the caller
+  // via the race below.
+  work.catch(() => {});
+  try {
+    return await Promise.race([work, deadline]);
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
 /**
  * Replace all vectors for a project with fresh chunks.
  *
@@ -76,33 +149,35 @@ export async function upsertChunks(
   projectId: string,
   chunks: EmbeddingChunk[],
 ): Promise<void> {
-  const ns = getNamespace(projectId);
-
-  await ns.reset();
-
-  for (let i = 0; i < chunks.length; i += BATCH_SIZE) {
-    const batch = chunks.slice(i, i + BATCH_SIZE);
-    await ns.upsert(
-      batch.map(c => {
-        const metadata: ChunkMetadata = {
-          pageSlug: c.pageSlug,
-          sectionHeading: c.sectionHeading,
-          pageTitle: c.pageTitle,
-          content: c.content.length > MAX_METADATA_CONTENT_CHARS
-            ? c.content.slice(0, MAX_METADATA_CONTENT_CHARS) + '...'
-            : c.content,
-        };
-        if (c.locale) metadata.locale = c.locale; // omit when null
-        return {
-          id: c.id,
-          // Prefix + body goes to Upstash for embedding/BM25; metadata.content
-          // stays prefix-free so consumers display clean body text.
-          data: c.prefix + c.content,
-          metadata,
-        };
-      }),
-    );
-  }
+  await withDeadline(UPSERT_TIMEOUT_MS, 'upsert', async signal => {
+    const ns = getNamespace(projectId, signal);
+
+    await ns.reset();
+
+    for (let i = 0; i < chunks.length; i += BATCH_SIZE) {
+      const batch = chunks.slice(i, i + BATCH_SIZE);
+      await ns.upsert(
+        batch.map(c => {
+          const metadata: ChunkMetadata = {
+            pageSlug: c.pageSlug,
+            sectionHeading: c.sectionHeading,
+            pageTitle: c.pageTitle,
+            content: c.content.length > MAX_METADATA_CONTENT_CHARS
+              ? c.content.slice(0, MAX_METADATA_CONTENT_CHARS) + '...'
+              : c.content,
+          };
+          if (c.locale) metadata.locale = c.locale; // omit when null
+          return {
+            id: c.id,
+            // Prefix + body goes to Upstash for embedding/BM25; metadata.content
+            // stays prefix-free so consumers display clean body text.
+            data: c.prefix + c.content,
+            metadata,
+          };
+        }),
+      );
+    }
+  });
 }
 
 /**
@@ -205,48 +280,50 @@ export async function querySimilarChunks(
   topK = 5,
   options: { locale?: string } = {},
 ): Promise<Array<ChunkMetadata & { score: number }>> {
-  const ns = getNamespace(projectId);
-  const locale = options.locale ? normalizeLocaleForFilter(options.locale) : undefined;
-  // Defense-in-depth: A5 rejects malformed locales at the API boundary. If a
-  // truthy locale here normalizes to empty, A5's guard was bypassed (test or
-  // internal caller) — surface it loudly rather than silently dropping the filter.
-  if (options.locale && !locale) {
-    logger.warn('vector-store: locale normalized to empty — filter skipped', { rawLocale: options.locale });
-  }
-  const filter = locale ? buildLocaleFilter(locale) : undefined;
-  // When filtering, raise effective topK by ~33% so we still get ~topK chunks
-  // back from a mixed-language namespace where filtering cuts the candidate set.
-  const effectiveTopK = filter ? Math.ceil(topK * 1.33) : topK;
-  const queryParams = { topK: effectiveTopK, includeMetadata: true as const, filter };
-
-  const topicQuery = extractTopicQuery(queryText);
-
-  // Dual-query: topic query is the PRIMARY source (better topical relevance);
-  // the full query fills remaining slots with unique results only.
-  let merged: Array<ChunkMetadata & { score: number }>;
-  if (topicQuery) {
-    const [fullResults, topicResults] = await Promise.all([
-      queryWithFallback(ns, { data: queryText, ...queryParams }),
-      queryWithFallback(ns, { data: topicQuery, ...queryParams }),
-    ]);
-    merged = filterAndMerge([topicResults, fullResults], topK);
-  } else {
-    const results = await queryWithFallback(ns, { data: queryText, ...queryParams });
-    merged = filterAndMerge([results], topK);
-  }
+  return withDeadline(QUERY_TIMEOUT_MS, 'query', async signal => {
+    const ns = getNamespace(projectId, signal);
+    const locale = options.locale ? normalizeLocaleForFilter(options.locale) : undefined;
+    // Defense-in-depth: A5 rejects malformed locales at the API boundary. If a
+    // truthy locale here normalizes to empty, A5's guard was bypassed (test or
+    // internal caller) — surface it loudly rather than silently dropping the filter.
+    if (options.locale && !locale) {
+      logger.warn('vector-store: locale normalized to empty — filter skipped', { rawLocale: options.locale });
+    }
+    const filter = locale ? buildLocaleFilter(locale) : undefined;
+    // When filtering, raise effective topK by ~33% so we still get ~topK chunks
+    // back from a mixed-language namespace where filtering cuts the candidate set.
+    const effectiveTopK = filter ? Math.ceil(topK * 1.33) : topK;
+    const queryParams = { topK: effectiveTopK, includeMetadata: true as const, filter };
+
+    const topicQuery = extractTopicQuery(queryText);
+
+    // Dual-query: topic query is the PRIMARY source (better topical relevance);
+    // the full query fills remaining slots with unique results only.
+    let merged: Array<ChunkMetadata & { score: number }>;
+    if (topicQuery) {
+      const [fullResults, topicResults] = await Promise.all([
+        queryWithFallback(ns, { data: queryText, ...queryParams }),
+        queryWithFallback(ns, { data: topicQuery, ...queryParams }),
+      ]);
+      merged = filterAndMerge([topicResults, fullResults], topK);
+    } else {
+      const results = await queryWithFallback(ns, { data: queryText, ...queryParams });
+      merged = filterAndMerge([results], topK);
+    }
 
-  // Telemetry: a filtered query that returns materially fewer chunks than
-  // requested signals the locale filter is hurting recall (project skewed away
-  // from the requested locale, or filter syntax matched a near-empty subset).
-  // Surface it so we can decide whether to widen the carve-out, increase the
-  // 1.33× boost, or rebuild the project's index.
-  if (filter && merged.length < Math.ceil(topK / 2)) {
-    logger.warn('vector-store: locale filter under-fills topK', {
-      projectId, locale, returned: merged.length, requested: topK,
-    });
-  }
+    // Telemetry: a filtered query that returns materially fewer chunks than
+    // requested signals the locale filter is hurting recall (project skewed away
+    // from the requested locale, or filter syntax matched a near-empty subset).
+    // Surface it so we can decide whether to widen the carve-out, increase the
+    // 1.33× boost, or rebuild the project's index.
+    if (filter && merged.length < Math.ceil(topK / 2)) {
+      logger.warn('vector-store: locale filter under-fills topK', {
+        projectId, locale, returned: merged.length, requested: topK,
+      });
+    }
 
-  return merged;
+    return merged;
+  });
 }
 
 /**
@@ -309,6 +386,13 @@ export async function deleteProjectNamespace(slug: string): Promise<boolean> {
   // Ctor failures (e.g., a future SDK adding URL-format validation) are
   // misconfiguration, not transient errors — let them propagate so ops see
   // a 500 instead of a silent `vector_orphan_on_delete`.
+  //
+  // Deliberately UNBOUNDED (unlike upsertChunks/querySimilarChunks, which go
+  // through withDeadline + getNamespace): this is a single best-effort delete on
+  // the request-scoped dashboard delete handler — NOT the shared Cloud Run build
+  // instance — so a stall here cannot wedge other builds or trip the stale-build
+  // watchdog. A hung delete is bounded by the platform request timeout. Don't
+  // "fix" the asymmetry by reflex; bounding it would need its own deadline wiring.
   const index = new Index({ url, token });
   try {
     await index.deleteNamespace(slug);

package/vendored/workspace-package-lock.json

@@ -1997,9 +1997,9 @@
       }
     },
     "node_modules/acorn": {
-      "version": "8.16.0",
-      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.16.0.tgz",
-      "integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==",
+      "version": "8.17.0",
+      "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.17.0.tgz",
+      "integrity": "sha512-xRQbDb9BnwDafYNn6Vwl839DYVjqXYb1XVGtWAZ1kcDc6iwAL4hg3B1dZlRiuENFeO2H53gFG3in621AdERVAg==",
       "license": "MIT",
       "bin": {
         "acorn": "bin/acorn"
@@ -2145,9 +2145,9 @@
       }
     },
     "node_modules/baseline-browser-mapping": {
-      "version": "2.10.35",
-      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.35.tgz",
-      "integrity": "sha512-honAfLBde0HAFLdNyBEfuuENkF6zR+ozxqxa/2zJKHBe1qzLqyTSeRKpdPEHAP03rlDGyQOPnCSxnVpVqQo9Mg==",
+      "version": "2.10.36",
+      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.36.tgz",
+      "integrity": "sha512-lVq/Df7LXlO79MVaaUHztSwWiG9oXoWHlgvNS51v8Dpd4+G4/VIy6qYePTw31nAVls33nUtnfezYeLkYAak9dg==",
       "license": "Apache-2.0",
       "bin": {
         "baseline-browser-mapping": "dist/cli.cjs"
@@ -2208,9 +2208,9 @@
       "license": "MIT"
     },
     "node_modules/caniuse-lite": {
-      "version": "1.0.30001797",
-      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001797.tgz",
-      "integrity": "sha512-l8xKG+gwAIExZGl9FrF7KUwuOmk6wbEPC9Xoy/RtnWv1XG0Q4LFlagaLpUv3Kiza3W/wm27zy0yWJEieYKAP6w==",
+      "version": "1.0.30001799",
+      "resolved": "https://registry.npmjs.org/caniuse-lite/-/caniuse-lite-1.0.30001799.tgz",
+      "integrity": "sha512-hG1bReV+OUU+MOqK4t/ZWI0tZOyz3rqS9XuhOUz1cIcbwBKjOyJEJuw9ER5JuNyqxNk8u/JUVbGibBOL1yrjFw==",
       "funding": [
         {
           "type": "opencollective",
@@ -2945,9 +2945,9 @@
       "license": "ISC"
     },
     "node_modules/enhanced-resolve": {
-      "version": "5.23.0",
-      "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.23.0.tgz",
-      "integrity": "sha512-yJN/BOOLxcOW2aQgeif9mSnaUB8KtvmMMp56oA1kx1CRfBKbhZm2pJ+NBY+3eOboHxix8lfjWpHE0Ei5U8RbSA==",
+      "version": "5.24.0",
+      "resolved": "https://registry.npmjs.org/enhanced-resolve/-/enhanced-resolve-5.24.0.tgz",
+      "integrity": "sha512-SkE2t82KlkkxQRVMVLAGKxLfORGQfrkx5dkj+vlgXRVNEdPc4eZcR+J/Fvj8C+yKSFH5L0q3NFlyufOVQnCcYQ==",
       "license": "MIT",
       "dependencies": {
         "graceful-fs": "^4.2.4",