chore: prepare for docs sidebar

test/load/docs/__snapshots__/order.test.js.snap

@@ -0,0 +1,59 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`createOrder should populate docs index from multiple sidebars 1`] = `
+Object {
+  "doc1": Object {
+    "category": "Category1",
+    "next": "doc2",
+    "previous": undefined,
+    "sidebar": "docs",
+  },
+  "doc2": Object {
+    "category": "Category1",
+    "next": "doc3",
+    "previous": "doc1",
+    "sidebar": "docs",
+  },
+  "doc3": Object {
+    "category": "Category2",
+    "next": "doc4",
+    "previous": "doc2",
+    "sidebar": "docs",
+  },
+  "doc4": Object {
+    "category": "Category2",
+    "next": undefined,
+    "previous": "doc3",
+    "sidebar": "docs",
+  },
+  "doc5": Object {
+    "category": "Category1",
+    "next": undefined,
+    "previous": undefined,
+    "sidebar": "otherDocs",
+  },
+}
+`;
+
+exports[`createOrder should resolve docs from older versions 1`] = `
+Object {
+  "doc1": Object {
+    "category": "Category1",
+    "next": undefined,
+    "previous": undefined,
+    "sidebar": "docs",
+  },
+  "version-1.2.3-doc1": Object {
+    "category": "Category2",
+    "next": undefined,
+    "previous": "version-1.2.3-doc2",
+    "sidebar": "version-1.2.3-docs",
+  },
+  "version-1.2.3-doc2": Object {
+    "category": "Category1",
+    "next": "version-1.2.3-doc1",
+    "previous": undefined,
+    "sidebar": "version-1.2.3-docs",
+  },
+}
+`;

test/load/docs/__snapshots__/sidebars.test.js.snap

@@ -0,0 +1,45 @@
+// Jest Snapshot v1, https://goo.gl/fbAQLP
+
+exports[`loadSidebars normal site with sidebars 1`] = `
+Object {
+  "docs": Object {
+    "Getting Started": Array [
+      "installation",
+    ],
+    "Guides": Array [
+      "blog",
+    ],
+  },
+}
+`;
+
+exports[`loadSidebars site with sidebars & versioned sidebars 1`] = `
+Object {
+  "docs": Object {
+    "Getting Started": Array [
+      "installation",
+    ],
+    "Guides": Array [
+      "blog",
+    ],
+  },
+  "version-1.0.0-docs": Object {
+    "Getting Started": Array [
+      "version-1.0.0-installation",
+    ],
+    "Guides": Array [
+      "version-1.0.0-blog",
+    ],
+  },
+  "version-1.0.1-docs": Object {
+    "Getting Started": Array [
+      "version-1.0.1-installation",
+    ],
+    "Guides": Array [
+      "version-1.0.1-blog",
+    ],
+  },
+}
+`;
+
+exports[`loadSidebars site without sidebars 1`] = `Object {}`;

test/load/docs/order.test.js

@@ -0,0 +1,35 @@
+import createOrder from '@lib/load/docs/order';
+
+describe('createOrder', () => {
+  test('should populate docs index from multiple sidebars', () => {
+    const result = createOrder({
+      docs: {
+        Category1: ['doc1', 'doc2'],
+        Category2: ['doc3', 'doc4']
+      },
+      otherDocs: {
+        Category1: ['doc5']
+      }
+    });
+    expect(result).toMatchSnapshot();
+  });
+
+  test('should resolve docs from older versions', () => {
+    const result = createOrder({
+      docs: {
+        Category1: ['doc1']
+      },
+      'version-1.2.3-docs': {
+        Category1: ['version-1.2.3-doc2'],
+        Category2: ['version-1.2.3-doc1']
+      }
+    });
+    expect(result).toMatchSnapshot();
+  });
+
+  test('edge cases', () => {
+    expect(createOrder({})).toEqual({});
+    expect(createOrder(null)).toEqual({});
+    expect(createOrder(undefined)).toEqual({});
+  });
+});

test/load/docs/sidebars.test.js

@@ -0,0 +1,46 @@
+import path from 'path';
+import loadSidebars from '@lib/load/docs/sidebars';
+
+describe('loadSidebars', () => {
+  const fixtures = path.join(__dirname, '..', '__fixtures__');
+  test('normal site with sidebars', () => {
+    const env = {};
+    const siteDir = path.join(fixtures, 'simple-site');
+    const result = loadSidebars({siteDir, env});
+    expect(result).toMatchSnapshot();
+  });
+
+  test('site without sidebars', () => {
+    const env = {};
+    const siteDir = path.join(fixtures, 'bad-site');
+    const result = loadSidebars({siteDir, env});
+    expect(result).toMatchSnapshot();
+  });
+
+  test('site with sidebars & versioned sidebars', () => {
+    const env = {
+      versioning: {
+        enabled: true,
+        versions: ['1.0.1', '1.0.0']
+      }
+    };
+    const siteDir = path.join(fixtures, 'versioned-site');
+    const result = loadSidebars({siteDir, env});
+    expect(result).toMatchSnapshot();
+  });
+
+  test('site with missing versioned sidebars', () => {
+    const env = {
+      versioning: {
+        enabled: true,
+        versions: ['2.0.0']
+      }
+    };
+    const siteDir = path.join(fixtures, 'versioned-site');
+    expect(() => {
+      loadSidebars({siteDir, env});
+    }).toThrowErrorMatchingInlineSnapshot(
+      `"Failed to load versioned_sidebars/version-2.0.0-sidebars.json. It does not exist."`
+    );
+  });
+});

test/load/utils.test.js

@@ -1,4 +1,10 @@
-import {fileToPath, fileToComponentName} from '@lib/load/utils';
+import path from 'path';
+import {
+  fileToPath,
+  fileToComponentName,
+  idx,
+  getSubFolder
+} from '@lib/load/utils';
 
 describe('load utils', () => {
   test('fileToComponentName', () => {
@@ -34,4 +40,59 @@ describe('load utils', () => {
       expect(fileToPath(file)).toBe(asserts[file]);
     });
   });
+
+  test('idx', () => {
+    const a = {};
+    const b = {hello: 'world'};
+    const env = {
+      translation: {
+        enabled: true,
+        enabledLanguages: [
+          {
+            enabled: true,
+            name: 'English',
+            tag: 'en'
+          },
+          {
+            enabled: true,
+            name: '日本語',
+            tag: 'ja'
+          }
+        ]
+      },
+      versioning: {
+        enabled: false,
+        versions: []
+      }
+    };
+    const variable = 'enabledLanguages';
+    expect(idx(a, [('b', 'c')])).toBeUndefined();
+    expect(idx(b, ['hello'])).toEqual('world');
+    expect(idx(b, 'hello')).toEqual('world');
+    expect(idx(env, 'typo')).toBeUndefined();
+    expect(idx(env, 'versioning')).toEqual({
+      enabled: false,
+      versions: []
+    });
+    expect(idx(env, ['translation', 'enabled'])).toEqual(true);
+    expect(idx(env, ['translation', variable]).map(lang => lang.tag)).toEqual([
+      'en',
+      'ja'
+    ]);
+    expect(idx(undefined)).toBeUndefined();
+    expect(idx(null)).toBeNull();
+  });
+
+  test('getSubFolder', () => {
+    const testA = path.join('folder', 'en', 'test.md');
+    const testB = path.join('folder', 'ja', 'test.md');
+    const testC = path.join('folder', 'ja', 'en', 'test.md');
+    const testD = path.join('docs', 'ro', 'test.md');
+    const testE = path.join('docs', 'test.md');
+    expect(getSubFolder(testA, 'folder')).toBe('en');
+    expect(getSubFolder(testB, 'folder')).toBe('ja');
+    expect(getSubFolder(testC, 'folder')).toBe('ja');
+    expect(getSubFolder(testD, 'docs')).toBe('ro');
+    expect(getSubFolder(testE, 'docs')).toBeNull();
+  });
 });