feat(docs,blog,pages): add support for "unlisted" front matter - hide md content in production (#8004)

Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com>

packages/docusaurus-plugin-content-docs/src/__tests__/props.test.ts

@@ -5,7 +5,7 @@
  * LICENSE file in the root directory of this source tree.
  */
 
-import {toTagDocListProp} from '../props';
+import {toSidebarDocItemLinkProp, toTagDocListProp} from '../props';
 
 describe('toTagDocListProp', () => {
   type Params = Parameters<typeof toTagDocListProp>[0];
@@ -61,3 +61,74 @@ describe('toTagDocListProp', () => {
     });
   });
 });
+
+describe('toSidebarDocItemLinkProp', () => {
+  type Params = Parameters<typeof toSidebarDocItemLinkProp>[0];
+  type Result = ReturnType<typeof toSidebarDocItemLinkProp>;
+  type DocSidebarItem = Params['item'];
+  type Doc = Params['doc'];
+
+  const id = 'some-doc-id';
+  const unversionedId = 'some-unversioned-doc-id';
+
+  const item: DocSidebarItem = {
+    type: 'doc',
+    id,
+    label: 'doc sidebar item label',
+  };
+
+  const doc: Doc = {
+    id,
+    unversionedId,
+    title: 'doc title',
+    permalink: '/docPermalink',
+    frontMatter: {},
+    unlisted: false,
+  };
+
+  it('works', () => {
+    const result = toSidebarDocItemLinkProp({
+      item,
+      doc,
+    });
+
+    expect(result).toEqual({
+      type: 'link',
+      docId: unversionedId,
+      unlisted: false,
+      label: item.label,
+      autoAddBaseUrl: undefined,
+      className: undefined,
+      href: doc.permalink,
+      customProps: undefined,
+    } as Result);
+  });
+
+  it('uses unlisted from metadata and ignores frontMatter', () => {
+    expect(
+      toSidebarDocItemLinkProp({
+        item,
+        doc: {
+          ...doc,
+          unlisted: true,
+          frontMatter: {
+            unlisted: false,
+          },
+        },
+      }).unlisted,
+    ).toBe(true);
+
+    expect(
+      toSidebarDocItemLinkProp({
+        item,
+        doc: {
+          ...doc,
+          unlisted: false,
+          frontMatter: {
+            unlisted: true,
+          },
+        },
+      }).unlisted,
+    ).toBe(false);
+  });
+});