jamdesk 1.1.149 → 1.1.150

package/vendored/lib/validate-config.ts

@@ -257,10 +257,65 @@ function deduplicateErrors(errors: ErrorObject[]): ErrorObject[] {
   });
 }
 
+const NAV_BRANCH_KEYS = [
+  'products', 'languages', 'versions', 'tabs',
+  'dropdowns', 'groups', 'pages',
+] as const;
+
+/**
+ * Collapse the navigation anyOf noise. When the user's navigation clearly uses
+ * one discriminator key (e.g. `tabs`), drop the sibling-branch
+ * `required`/`additionalProperties` errors AT `/navigation` and keep the deeper
+ * child errors (e.g. /navigation/tabs/0) that say what's actually wrong. No-op
+ * when navigation is absent or the intent is ambiguous (0 or >1 known keys).
+ *
+ * IMPORTANT: key the predicate on `instancePath` + `keyword` + `params`, NOT
+ * `schemaPath`. Ajv resolves the `$ref: "#/definitions/navigationSchema"`, so
+ * the nav-branch errors carry schemaPaths like `#/anyOf/0/required` — the
+ * string "navigationSchema" never appears in them. (Verified by compiling the
+ * real schema against a malformed-tabs config.) `instancePath` is the stable
+ * signal: every sibling-branch red herring sits exactly at `/navigation`,
+ * while the actionable child error sits at `/navigation/<key>/...`.
+ * Runs BEFORE `filterAnyOfNoise`, so schemaPaths are still `#/anyOf/N/...` here.
+ */
+export function filterNavigationAnyOfNoise(
+  errors: ErrorObject[],
+  navigation: Record<string, unknown> | undefined,
+): ErrorObject[] {
+  if (!navigation) return errors;
+  const present = NAV_BRANCH_KEYS.filter((k) => k in navigation);
+  // Only collapse noise when the user's intent is unambiguous — exactly one
+  // discriminator key. Zero keys or multiple keys (itself invalid) → leave
+  // the raw errors so we never hide the real problem.
+  if (present.length !== 1) return errors;
+  const usedKey = present[0];
+
+  return errors.filter((err) => {
+    // Keep everything except the two red-herring classes AT /navigation.
+    // Child errors like /navigation/tabs/0 have a deeper instancePath -> kept.
+    if (err.instancePath !== '/navigation') return true;
+    // Drop sibling-branch "missing required <otherKey>" noise (e.g. products).
+    if (err.keyword === 'required') {
+      const missing =
+        (err.params as { missingProperty?: string }).missingProperty;
+      return !(missing && missing !== usedKey &&
+        (NAV_BRANCH_KEYS as readonly string[]).includes(missing));
+    }
+    // Drop "unknown property <usedKey>" flagged by non-matching sibling
+    // branches (e.g. additionalProperty "tabs").
+    if (err.keyword === 'additionalProperties') {
+      const extra =
+        (err.params as { additionalProperty?: string }).additionalProperty;
+      return extra !== usedKey;
+    }
+    return true;
+  });
+}
+
 /**
  * Format validation errors into user-friendly messages
  */
-export function formatValidationErrors(errors: ErrorObject[] | null | undefined): string {
+export function formatValidationErrors(errors: ErrorObject[] | null | undefined, navigation?: Record<string, unknown>): string {
   if (!errors || errors.length === 0) {
     return 'Unknown validation error';
   }
@@ -270,8 +325,9 @@ export function formatValidationErrors(errors: ErrorObject[] | null | undefined)
   // Safe only because validateConfig pre-checks `config.theme` before Ajv,
   // so a fully-noise error list is unreachable in practice. A new caller
   // that skips the theme pre-check would break this invariant.
-  const filteredErrors = filterAnyOfNoise(errors);
-  const effectiveErrors = filteredErrors.length > 0 ? filteredErrors : errors;
+  const navFiltered = filterNavigationAnyOfNoise(errors, navigation);
+  const filteredErrors = filterAnyOfNoise(navFiltered);
+  const effectiveErrors = filteredErrors.length > 0 ? filteredErrors : navFiltered;
 
   const messages = effectiveErrors.slice(0, 3).map(err => {
     const path = err.instancePath || 'root';
@@ -548,7 +604,10 @@ export async function validateConfig(
       const valid = validate(config);
       
       if (!valid) {
-        const errorMessage = formatValidationErrors(validate.errors);
+        const errorMessage = formatValidationErrors(
+          validate.errors,
+          config.navigation as Record<string, unknown> | undefined,
+        );
         return {
           valid: false,
           error: `Invalid docs.json: ${errorMessage}`,

package/vendored/scripts/build-search-index.cjs

@@ -233,8 +233,8 @@ function getOutputPath() {
 
 function stripMarkdown(text) {
   return text
-    .replace(/```[\s\S]*?```/g, '')
-    .replace(/`[^`]+`/g, '')
+    .replace(/```[\s\S]*?```/g, '') // code blocks (too noisy to index)
+    .replace(/`([^`]+)`/g, '$1') // inline code → keep text, drop backticks (config keys like starterQuestions stay searchable)
     .replace(/#{1,6}\s/g, '')
     .replace(/\*\*([^*]+)\*\*/g, '$1')
     .replace(/\*([^*]+)\*/g, '$1')

package/vendored/shared/types.ts

@@ -25,6 +25,7 @@ export interface BuildParams {
   showBranding?: boolean;  // Show "Powered by Jamdesk" in footer (defaults to true)
   hostAtDocs?: boolean;  // URL structure: true = /docs/*, false = root /*
   autoMigrate?: boolean;  // If true, auto-convert deprecated components during build
+  aiFix?: boolean;        // If true, collect AI anchor-fix suggestions during build
   tarballKey?: string;       // R2 key for CLI-uploaded tarball
 }
 

package/vendored/workspace-package-lock.json

@@ -7,7 +7,7 @@
       "name": "jamdesk-workspace",
       "dependencies": {
         "@apidevtools/swagger-parser": "^12.1.0",
-        "@babel/standalone": "^7.29.0",
+        "@babel/standalone": "^8.0.1",
         "@fortawesome/fontawesome-svg-core": "^7.1.0",
         "@fortawesome/free-brands-svg-icons": "^7.1.0",
         "@fortawesome/free-regular-svg-icons": "^7.1.0",
@@ -163,12 +163,12 @@
       }
     },
     "node_modules/@babel/standalone": {
-      "version": "7.29.7",
-      "resolved": "https://registry.npmjs.org/@babel/standalone/-/standalone-7.29.7.tgz",
-      "integrity": "sha512-oFh9XoGL20UuHIeIuBQHOvF7r2dOCRnZW0r4SageGb9SWnt6HhbuPLREykNaEnP7/SRpMUwr50SSMJLrmeHvnQ==",
+      "version": "8.0.2",
+      "resolved": "https://registry.npmjs.org/@babel/standalone/-/standalone-8.0.2.tgz",
+      "integrity": "sha512-fxVjA+dyCXC6tZm8sp21egVF0WVpPRnJOhmfG4WavISe2otyfOLleh+owitHWMhILTdjd7W0mfpadS16cj8LBw==",
       "license": "MIT",
       "engines": {
-        "node": ">=6.9.0"
+        "node": "^22.18.0 || >=24.11.0"
       }
     },
     "node_modules/@braintree/sanitize-url": {
@@ -1932,9 +1932,9 @@
       }
     },
     "node_modules/@types/node": {
-      "version": "25.9.3",
-      "resolved": "https://registry.npmjs.org/@types/node/-/node-25.9.3.tgz",
-      "integrity": "sha512-603BddQMv3pUcr4U2dhujk83N2tTDVr/34wII2B6bJy6g+8WD6yUb11jszNs0gdi4PesVWl7ABt8nYMVpnLUcg==",
+      "version": "25.9.4",
+      "resolved": "https://registry.npmjs.org/@types/node/-/node-25.9.4.tgz",
+      "integrity": "sha512-dszCsrKb5U7ZsVZBWiHFklTloVl0mSEnWH/iZXfZUlI4rzCUnsvGmgqfuVRHL54ugE7/wRuxEIXRa2iMZ+BG6g==",
       "license": "MIT",
       "dependencies": {
         "undici-types": ">=7.24.0 <7.24.7"
@@ -2145,9 +2145,9 @@
       }
     },
     "node_modules/baseline-browser-mapping": {
-      "version": "2.10.37",
-      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.37.tgz",
-      "integrity": "sha512-girxaJ7WZssDOFhzCGZTDKoTa1gk6A1TbflaYTpykLJ4UU9Fz9kx1aREM8JCuoVHbL8X8T/mJg7w2oYSq72Oig==",
+      "version": "2.10.38",
+      "resolved": "https://registry.npmjs.org/baseline-browser-mapping/-/baseline-browser-mapping-2.10.38.tgz",
+      "integrity": "sha512-31/02mVB4yuQU6adKk5SlY6m+mxDwUq5KZkyYgnLrrKl7TEm1+3PyDtDBz2kOv/wxZz41GHsvV1A/u6RmiyBvw==",
       "license": "Apache-2.0",
       "bin": {
         "baseline-browser-mapping": "dist/cli.cjs"
@@ -2169,9 +2169,9 @@
       }
     },
     "node_modules/browserslist": {
-      "version": "4.28.2",
-      "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.2.tgz",
-      "integrity": "sha512-48xSriZYYg+8qXna9kwqjIVzuQxi+KYWp2+5nCYnYKPTr0LvD89Jqk2Or5ogxz0NUMfIjhh2lIUX/LyX9B4oIg==",
+      "version": "4.28.4",
+      "resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.28.4.tgz",
+      "integrity": "sha512-MTc8i/x9jBQd1iMw2CFGS+rwMa07eYjLR0CCTLDACl9xhxy+nIs3KeML/biicXtk9JrZ6dnnTatmc7ErPXIxqw==",
       "funding": [
         {
           "type": "opencollective",
@@ -2188,10 +2188,10 @@
       ],
       "license": "MIT",
       "dependencies": {
-        "baseline-browser-mapping": "^2.10.12",
-        "caniuse-lite": "^1.0.30001782",
-        "electron-to-chromium": "^1.5.328",
-        "node-releases": "^2.0.36",
+        "baseline-browser-mapping": "^2.10.38",
+        "caniuse-lite": "^1.0.30001799",
+        "electron-to-chromium": "^1.5.376",
+        "node-releases": "^2.0.48",
         "update-browserslist-db": "^1.2.3"
       },
       "bin": {
@@ -2939,9 +2939,9 @@
       "license": "MIT"
     },
     "node_modules/electron-to-chromium": {
-      "version": "1.5.375",
-      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.375.tgz",
-      "integrity": "sha512-ZWP5eB4BVPW/ZYo9252hQZHZ5XavtsTgpbhcmMmRwymavC5AsLWQWBPaKMeNd2LW0KGby5HPXvj7+sr4ta5j/Q==",
+      "version": "1.5.376",
+      "resolved": "https://registry.npmjs.org/electron-to-chromium/-/electron-to-chromium-1.5.376.tgz",
+      "integrity": "sha512-cUVA7/RvbFTEuw/i3obUwDTRIXojaxkResf+ibByPFxjc6XK3VNtcQXV0NSbAlJ0FMjcJGgftVVB4Qo184EXvA==",
       "license": "ISC"
     },
     "node_modules/enhanced-resolve": {
@@ -2970,9 +2970,9 @@
       }
     },
     "node_modules/es-toolkit": {
-      "version": "1.47.1",
-      "resolved": "https://registry.npmjs.org/es-toolkit/-/es-toolkit-1.47.1.tgz",
-      "integrity": "sha512-5RAqEwf4P4E17p+W75KLOWw/nOvKZzSQpxM32IpI2KZLaVonjTrZ0Ai5ghMaVI9eKC2p8eoQgcBdkEDgzFk6+Q==",
+      "version": "1.48.1",
+      "resolved": "https://registry.npmjs.org/es-toolkit/-/es-toolkit-1.48.1.tgz",
+      "integrity": "sha512-wfnXlwd5I75eXRtdD2vuEs50xHHESECDsGD7yiQnfFVNoa5522NwXEbmgo98LfiukSQHs+mBM7/YG3qKJB9/mQ==",
       "license": "MIT",
       "workspaces": [
         "docs",
@@ -5288,9 +5288,9 @@
       "license": "MIT"
     },
     "node_modules/nanoid": {
-      "version": "3.3.12",
-      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.12.tgz",
-      "integrity": "sha512-ZB9RH/39qpq5Vu6Y+NmUaFhQR6pp+M2Xt76XBnEwDaGcVAqhlvxrl3B2bKS5D3NH3QR76v3aSrKaF/Kiy7lEtQ==",
+      "version": "3.3.15",
+      "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.15.tgz",
+      "integrity": "sha512-y7Wygv/7mEOvxTuEQDB8StXdMRBWf1kR/tlhAzBRUFkB2jfcLOAxO/SHmOO2zgz1pVgK29/kyupn059/bCHdjA==",
       "funding": [
         {
           "type": "github",
@@ -5432,9 +5432,9 @@
       }
     },
     "node_modules/node-releases": {
-      "version": "2.0.47",
-      "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.47.tgz",
-      "integrity": "sha512-Uzmd6LXpouKo8EUK68IjH4+E01w/hXyV3R3g/geCJo+rXLNfh1xucB+LOzYEOQPSiUK3h/xZf0cQGcSsmyL2Og==",
+      "version": "2.0.48",
+      "resolved": "https://registry.npmjs.org/node-releases/-/node-releases-2.0.48.tgz",
+      "integrity": "sha512-1uz8041X6LoI6ZSdZacM9lVY28vuzDlSKitnpbSNK0RfKoIJkX29NBPVEFXhnuSuEOA9Ww0xnPJ+ILWbGAv8DA==",
       "license": "MIT",
       "engines": {
         "node": ">=18"
@@ -6079,9 +6079,9 @@
       }
     },
     "node_modules/semver": {
-      "version": "7.8.4",
-      "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.4.tgz",
-      "integrity": "sha512-rUCObTnP32Q08R2uuIrt7r9PlEonuTmtuXYcW6s5kjdlj3xbnwe+21yXptAUYcMAABLkYYTtnmzb3w3EDZfueA==",
+      "version": "7.8.5",
+      "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
+      "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==",
       "license": "ISC",
       "optional": true,
       "bin": {
@@ -6578,9 +6578,9 @@
       "license": "MIT"
     },
     "node_modules/uuid": {
-      "version": "14.0.0",
-      "resolved": "https://registry.npmjs.org/uuid/-/uuid-14.0.0.tgz",
-      "integrity": "sha512-Qo+uWgilfSmAhXCMav1uYFynlQO7fMFiMVZsQqZRMIXp0O7rR7qjkj+cPvBHLgBqi960QCoo/PH2/6ZtVqKvrg==",
+      "version": "14.0.1",
+      "resolved": "https://registry.npmjs.org/uuid/-/uuid-14.0.1.tgz",
+      "integrity": "sha512-6ZxzVpzDXDa3bJWaHilVayA+BH/1zmxCJoVgvmqJnid/gPoKHxUrS/aC/T6LGQtNHT+XHG9fXPJB4d+IrU30Ew==",
       "funding": [
         "https://github.com/sponsors/broofa",
         "https://github.com/sponsors/ctavan"