@mintlify/common 1.0.1180 → 1.0.1181

package/dist/navigation/filterDivisions.test.js

@@ -1,5 +1,6 @@
 import { decoratedNavigationConfig } from './decoratedNavigationConfig.js';
 import { filterDivisions, isActiveDivision } from './filterDivisions.js';
+import { DivisionMatchLevel } from './updateFirstHrefInDivision.js';
 describe(filterDivisions, () => {
     var _a;
     const defaultArgs = {
@@ -222,6 +223,52 @@ describe(filterDivisions, () => {
             } }));
         expect((_a = result.firstHrefInLanguage.get('es')) === null || _a === void 0 ? void 0 : _a.href).toBe('/es/docs/2025_12/getting-started');
     });
+    describe('when the locale follows a version segment', () => {
+        const versions = ['26.3', '26.2'];
+        const langs = ['en', 'ja'];
+        const pagesFor = (base) => ({
+            tabs: [
+                {
+                    tab: 'Docs',
+                    groups: [
+                        {
+                            group: 'Getting Started',
+                            pages: [
+                                { title: 'Overview', href: `/${base}/overview` },
+                                { title: 'Getting Started', href: `/${base}/getting-started/getting-started` },
+                            ],
+                        },
+                    ],
+                },
+            ],
+        });
+        const prefixed = (version, language) => `${version}/${language}`;
+        const unprefixedDefault = (version, language) => language === 'en' ? version : `${version}/${language}`;
+        it.each([
+            { nesting: 'languages > versions', base: prefixed, languagesFirst: true },
+            { nesting: 'versions > languages', base: prefixed, languagesFirst: false },
+            { nesting: 'an unprefixed default language', base: unprefixedDefault, languagesFirst: true },
+        ])('matches the translated page with $nesting', ({ base, languagesFirst }) => {
+            const decoratedNav = languagesFirst
+                ? {
+                    languages: langs.map((language) => ({
+                        language,
+                        versions: versions.map((version) => (Object.assign({ version }, pagesFor(base(version, language))))),
+                    })),
+                }
+                : {
+                    versions: versions.map((version) => ({
+                        version,
+                        languages: langs.map((language) => (Object.assign({ language }, pagesFor(base(version, language))))),
+                    })),
+                };
+            const result = filterDivisions(Object.assign(Object.assign({}, defaultArgs), { currentPath: `/${base('26.3', 'en')}/getting-started/getting-started`, currentVersion: '26.3', currentLanguage: 'en', decoratedNav }));
+            expect(result.firstHrefInLanguage.get('ja')).toEqual({
+                href: '/26.3/ja/getting-started/getting-started',
+                matchLevel: DivisionMatchLevel.PATH,
+            });
+        });
+    });
 });
 describe('filterDivisions with partial auth', () => {
     const defaultArgs = {

package/dist/navigation/pathsDifferByOneSegment.test.js

@@ -56,6 +56,49 @@ describe('pathsDifferByOneSegment', () => {
                 expect(pathsDifferByOneSegment('/es/docs/2025_12/getting-started', '/docs/getting-started', 'language')).toBe(false);
             });
         });
+        describe('version-prefixed locale paths', () => {
+            it('returns true when only the locale after a version segment differs', () => {
+                expect(pathsDifferByOneSegment('/26.3/ja/getting-started/getting-started', '/26.3/en/getting-started/getting-started', 'language')).toBe(true);
+                expect(pathsDifferByOneSegment('26.3/ja/intro', '/26.3/en/intro', 'language')).toBe(true);
+                expect(pathsDifferByOneSegment('/docs/v2/ja/intro', '/docs/v2/en/intro', 'language')).toBe(true);
+            });
+            it('handles version-prefixed locale index pages', () => {
+                expect(pathsDifferByOneSegment('/26.3/ja/index', '/26.3/en', 'language')).toBe(true);
+            });
+            it('returns false when the version also differs', () => {
+                expect(pathsDifferByOneSegment('/26.2/ja/intro', '/26.3/en/intro', 'language')).toBe(false);
+            });
+            it('returns false when the differing segment is not a locale on both sides', () => {
+                expect(pathsDifferByOneSegment('/26.3/ja/intro', '/26.3/guides/intro', 'language')).toBe(false);
+                expect(pathsDifferByOneSegment('/26.2/intro', '/26.3/intro', 'language')).toBe(false);
+            });
+            it('returns false when the locale is the same', () => {
+                expect(pathsDifferByOneSegment('/26.3/ja/intro', '/26.3/ja/intro', 'language')).toBe(false);
+            });
+            it('returns false when content after the locale differs', () => {
+                expect(pathsDifferByOneSegment('/26.3/ja/intro', '/26.3/en/quickstart', 'language')).toBe(false);
+            });
+        });
+        describe('version-prefixed paths with an unprefixed default language', () => {
+            it('returns true when one path adds a locale after the version', () => {
+                expect(pathsDifferByOneSegment('/v2/es/overview', '/v2/overview', 'language')).toBe(true);
+                expect(pathsDifferByOneSegment('/v2/overview', '/v2/es/overview', 'language')).toBe(true);
+                expect(pathsDifferByOneSegment('/docs/v2/es/guides/setup', '/docs/v2/guides/setup', 'language')).toBe(true);
+            });
+            it('handles unprefixed default index pages', () => {
+                expect(pathsDifferByOneSegment('/v2/es/index', '/v2', 'language')).toBe(true);
+            });
+            it('returns false when the extra segment is not a locale', () => {
+                expect(pathsDifferByOneSegment('/v2/guides/overview', '/v2/overview', 'language')).toBe(false);
+            });
+            it('returns false when the rest of the path differs', () => {
+                expect(pathsDifferByOneSegment('/v2/es/overview', '/v1/overview', 'language')).toBe(false);
+                expect(pathsDifferByOneSegment('/v2/es/overview', '/v2/quickstart', 'language')).toBe(false);
+            });
+            it('returns false when the paths differ by more than one segment', () => {
+                expect(pathsDifferByOneSegment('/v2/es/ja/overview', '/v2/overview', 'language')).toBe(false);
+            });
+        });
     });
     describe('version type', () => {
         it('returns true for paths that differ by one segment (not last)', () => {

package/dist/navigation/updateFirstHrefInDivision.js

@@ -326,6 +326,9 @@ export function pathsDifferByOneSegment(a, b, type) {
         const bPath = parseLanguagePath(bSegments);
         if (aPath.hasDocsBase !== bPath.hasDocsBase)
             return false;
+        if (!aPath.locale && !bPath.locale) {
+            return differByOneLocaleSegment(aPath.contentSegments, bPath.contentSegments);
+        }
         // For language switching, the content parts (including version segments) must be identical.
         if (aPath.contentSegments.length !== bPath.contentSegments.length)
             return false;
@@ -374,6 +377,23 @@ export function pathsDifferByOneSegment(a, b, type) {
     }
     return true;
 }
+function isLocale(segment) {
+    return locales.some((locale) => locale === segment);
+}
+function differByOneLocaleSegment(a, b) {
+    if (a.length === b.length) {
+        const mismatches = a.flatMap((segment, i) => (segment === b[i] ? [] : [i]));
+        if (mismatches.length !== 1)
+            return false;
+        const [index] = mismatches;
+        return index !== undefined && isLocale(a[index]) && isLocale(b[index]);
+    }
+    const [longer, shorter] = a.length > b.length ? [a, b] : [b, a];
+    if (longer.length !== shorter.length + 1)
+        return false;
+    const index = longer.findIndex((segment, i) => segment !== shorter[i]);
+    return (isLocale(longer[index]) && longer.slice(index + 1).every((s, i) => s === shorter[index + i]));
+}
 function checkActiveGroup(group, currentPath) {
     if (isPage(group)) {
         return isEqualIgnoringLeadingSlash(group.href, currentPath);