[docs] simplify main documentation page component (expo#20503)

Author: Simek

docs/common/routes.test.ts

@@ -0,0 +1,19 @@
+import { isReferencePath } from '~/common/routes';
+
+describe(isReferencePath, () => {
+  it('returns true for unversioned pathname', () => {
+    expect(isReferencePath('/versions/unversioned')).toBe(true);
+  });
+
+  it('returns true for sdk pathname', () => {
+    expect(isReferencePath('/versions/latest/sdk/notifications')).toBe(true);
+  });
+
+  it('returns true for react-native pathname', () => {
+    expect(isReferencePath('/versions/v44.0.0/react-native/stylesheet/')).toBe(true);
+  });
+
+  it('returns false for non-versioned pathname', () => {
+    expect(isReferencePath('/build-reference/how-tos/')).toBe(false);
+  });
+});

docs/common/routes.ts

@@ -0,0 +1,57 @@
+import * as Utilities from '~/common/utilities';
+import { PageApiVersionContextType } from '~/providers/page-api-version';
+import navigation from '~/public/static/constants/navigation.json';
+import { NavigationRoute } from '~/types/common';
+
+export const getRoutes = (
+  path: string,
+  version: PageApiVersionContextType['version']
+): NavigationRoute[] => {
+  if (isReferencePath(path)) {
+    return navigation.reference[version] as NavigationRoute[];
+  } else {
+    return navigation[getPageSection(path)] as NavigationRoute[];
+  }
+};
+
+export const isArchivePath = (path: string) => {
+  return Utilities.pathStartsWith('archive', path);
+};
+
+export const isReferencePath = (path: string) => {
+  return Utilities.pathStartsWith('versions', path);
+};
+
+export const isGeneralPath = (path: string) => {
+  return navigation.generalDirectories.some(name => Utilities.pathStartsWith(name, path));
+};
+
+export const isFeaturePreviewPath = (path: string) => {
+  return navigation.featurePreview.some(name => Utilities.pathStartsWith(name, path));
+};
+
+export const isPreviewPath = (path: string) => {
+  return navigation.previewDirectories.some(name => Utilities.pathStartsWith(name, path));
+};
+
+export const isEasPath = (path: string) => {
+  return navigation.easDirectories.some(name => Utilities.pathStartsWith(name, path));
+};
+
+export const getPageSection = (path: string) => {
+  if (isReferencePath(path)) {
+    return 'reference';
+  } else if (isEasPath(path)) {
+    return 'eas';
+  } else if (isGeneralPath(path)) {
+    return 'general';
+  } else if (isFeaturePreviewPath(path)) {
+    return 'featurePreview';
+  } else if (isPreviewPath(path)) {
+    return 'preview';
+  } else if (isArchivePath(path)) {
+    return 'archive';
+  }
+
+  return 'general';
+};

docs/common/utilities.ts

@@ -31,6 +31,9 @@ export const generateSlug = (slugger: GithubSlugger, node: React.ReactNode, leng
   return slugger.slug(stringToSlug);
 };
 
+/**
+ * Replace the version in the pathname from the URL.
+ */
 export const replaceVersionInUrl = (url: string, replaceWith: string) => {
   const urlArr = url.split('/');
   urlArr[2] = replaceWith;
@@ -65,3 +68,7 @@ export const stripVersionFromPath = (path: string) => {
   }
   return path.replace(/\/versions\/[\w.]+/, '');
 };
+
+export const pathStartsWith = (name: string, path: string) => {
+  return path.startsWith(`/${name}`);
+};