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."`
+    );
+  });
+});