Merge branch 'main' into adding-descope-testing-strat-guide

Author: allenzhou101

.circleci/config.yml

@@ -67,7 +67,7 @@ jobs:
 
   run-tests-in-parallel:
     executor: cypress/default
-    parallelism: 6
+    parallelism: 2
     steps:
       - attach_workspace:
           at: ~/

cypress.config.ts

@@ -12,36 +12,41 @@ export default defineConfig({
     supportFile: false,
     baseUrl: "http://localhost:3000",
     setupNodeEvents(on, config) {
-      on("task", {
-        "createFileTree"({ path }) {
-          // take the given path and create an array of all file paths
-          // with each files and the directory path of the file as strings
-          // for example: given 'accessibility' return
-          // ['accessibility/get-started/introduction', 'accessibility/core-concepts/how-it-works']
-          path = 'docs/' + path;
-
-          function walk(dir: string): string[] {
-            return readdirSync(dir, { withFileTypes: true }).flatMap((file) => {
-              if (file.name.includes('_category_.json') || file.name.includes('.DS_Store')) {
-                return []
-              }
-
-              if (file.name.includes('.mdx')) {
-                // remove the .mdx file extension
-                file.name = file.name.slice(0, -4)
-              }
-
-              if (file.isDirectory()) {
-                return walk(join(dir, file.name))
-              } else {
-                return [join(dir, file.name)]
-              }
-            })
+      const path = 'docs';
+
+      function walk(dir: string): string[] {
+        return readdirSync(dir, { withFileTypes: true }).flatMap((file) => {
+          // ignore these irrelevant files with no content
+          if (file.name.includes('_category_.json') || file.name.includes('.DS_Store')) {
+            return []
+          }
+
+          if (file.name.includes('lodash')) {
+            // lodash file actually goes to _ URL
+            file.name = file.name.replace('lodash', '_')
+          }
+
+          if (file.name.includes('.mdx')) {
+            // remove the .mdx file extension
+            file.name = file.name.slice(0, -4)
           }
 
-          return walk(path).filter((file) => file !== undefined).map((file) => file.slice(5))
-        }
-      })
+          if (file.isDirectory()) {
+            if(file.name === 'partials') {
+              return []
+            }
+            return walk(join(dir, file.name))
+          } else {
+            return [join(dir, file.name)]
+          }
+        })
       }
+
+      const URLs = walk(path).filter((file) => file !== undefined).map((file) => file.slice(5))
+
+      config.env.URLs = URLs
+
+      return config
     },
-});
+  },
+})

cypress/e2e/a11y_pages.cy.ts

@@ -0,0 +1,15 @@
+const URLs: Array<string> = Cypress.env('URLs')
+
+// Mostly this is to get a UI Coverage and Accessibility report
+describe('Visit all pages', () => {
+  URLs.forEach((URL) => {
+    it(`Visit ${URL} `, () => {
+      cy.visit(URL)
+      cy.get('h1')
+        .should('be.visible')
+        .and('not.have.text', 'Page Not Found')
+        
+      cy.get('[aria-label="Switch to dark mode"]').click()
+    })
+  })
+})

cypress/e2e/all_pages.cy.ts

@@ -49,9 +49,11 @@ describe('Basic tests', () => {
 
   describe('Dark mode', () => {
     it('switch to dark mode when clicked', () => {
-      cy.get('[data-theme=light]').should('have.css', 'background-color', 'rgb(255, 255, 255)')  // white
+      cy.get('[data-theme=light]')
+        .should('have.css', 'background-color', 'rgb(255, 255, 255)')  // white
       cy.get('[aria-label="Switch to dark mode"]').click()
-      cy.get('[data-theme=dark]').should('have.css', 'background-color', 'rgb(27, 30, 46)') // dark gray
+      cy.get('[data-theme=dark]')
+        .should('have.css', 'background-color', 'rgb(27, 30, 46)') // dark gray
     })
   })
 
@@ -61,4 +63,14 @@ describe('Basic tests', () => {
       cy.get('.DocSearch-Modal').should('be.visible')
     })
   })
-})
+
+  describe('404', () => {
+    it('displays 404 page', () => {
+      cy.visit('/foo/bar/baz')
+      cy.get('h1')
+        .should('be.visible')
+        .and('have.text', 'Page Not Found')
+    })
+  })
+})
+

cypress/e2e/api_pages.cy.ts

@@ -5,6 +5,8 @@ sidebar_label: Changelog
 sidebar_position: 200
 ---
 
+<ProductHeading product="accessibility" />
+
 # Changelog
 
 ## Week of 11/11/2024

cypress/e2e/app_pages.cy.ts

@@ -1,4 +1,4 @@
 {
   "label": "Configuration",
-  "position": 30
+  "position": 40
 }

cypress/e2e/basic_tests.cy.ts

@@ -4,9 +4,9 @@ description: 'Configuration for Axe-Core® rules can be configured.'
 sidebar_label: 'Axe Core® configuration'
 ---
 
-# Axe Core® configuration
+<ProductHeading product="accessibility" />
 
-<AccessibilityAddon />
+# Axe Core® configuration
 
 Configuration for Axe-Core® rules is available through your Account Executive. We are happy to have a call with you to dial in your report config to make sure you are getting the most useful reports possible, and we find this onboarding very effective.