@codeguide/core 0.0.27 → 0.0.29

package/docs/testsprite_tests/testsprite-mcp-test-report.md

@@ -0,0 +1,273 @@
+# TestSprite AI Testing Report(MCP)
+
+---
+
+## 1️⃣ Document Metadata
+
+- **Project Name:** docs
+- **Date:** 2025-11-07
+- **Prepared by:** TestSprite AI Team
+
+---
+
+## 2️⃣ Requirement Validation Summary
+
+### Requirement: Core Page Loading and Display
+
+- **Description:** Documentation site should load quickly and display homepage content correctly including hero section with quick start guidance and feature highlights.
+
+#### Test TC001
+
+- **Test Name:** Homepage Load and Hero Section Display
+- **Test Code:** [TC001_Homepage_Load_and_Hero_Section_Display.py](./TC001_Homepage_Load_and_Hero_Section_Display.py)
+- **Test Error:**
+- **Test Visualization and Result:** https://www.testsprite.com/dashboard/mcp/tests/224532f7-2e10-4c90-906f-c7cdc4615042/811074ee-0ad5-45b2-8f7f-5edafa00ab80
+- **Status:** ✅ Passed
+- **Severity:** HIGH
+- **Analysis / Findings:** Homepage loads successfully within acceptable time limits. Hero section displays correctly with all expected elements including quick start guidance and feature highlights. No performance or rendering issues detected on the homepage.
+
+---
+
+### Requirement: Navigation Functionality
+
+- **Description:** Sidebar navigation should expand/collapse correctly and route users to the correct documentation pages with proper active state highlighting.
+
+#### Test TC002
+
+- **Test Name:** Sidebar Navigation Expand/Collapse Functionality
+- **Test Code:** [TC002_Sidebar_Navigation_ExpandCollapse_Functionality.py](./TC002_Sidebar_Navigation_ExpandCollapse_Functionality.py)
+- **Test Error:** Testing stopped due to critical page error overlay caused by missing end tag in the code. Sidebar navigation expand/collapse and routing validation cannot proceed until this is fixed.
+  Browser Console Logs:
+  [ERROR] Failed to load resource: the server responded with a status of 500 (Internal Server Error) (at http://localhost:5174/codeguide-client.md?import&t=1762500533969:0:0)
+  [ERROR] Failed to load module script: Expected a JavaScript module script but the server responded with a MIME type of "text/html". Strict MIME type checking is enforced for module scripts per HTML spec. (at http://localhost:5174/codeguide-client/index.md?import&t=1762500533969:0:0)
+- **Test Visualization and Result:** https://www.testsprite.com/dashboard/mcp/tests/224532f7-2e10-4c90-906f-c7cdc4615042/16510094-984f-48e7-ae86-c01639b46414
+- **Status:** ❌ Failed
+- **Severity:** HIGH
+- **Analysis / Findings:** Critical blocking issue: Missing end tag in markdown file (`codeguide-client.md`) causes Vue compilation errors and prevents navigation testing. The error overlay blocks all page interactions. This is a high-priority issue that must be fixed before navigation functionality can be verified. The 500 error suggests a markdown parsing or Vue component compilation issue.
+
+---
+
+### Requirement: Search Functionality
+
+- **Description:** Full-text local search should be accessible via keyboard shortcut (Ctrl/Cmd+K), return accurate results with highlighted matching terms, and support keyboard navigation.
+
+#### Test TC003
+
+- **Test Name:** Full-Text Local Search with Keyboard Shortcut
+- **Test Code:** [TC003_Full_Text_Local_Search_with_Keyboard_Shortcut.py](./TC003_Full_Text_Local_Search_with_Keyboard_Shortcut.py)
+- **Test Error:**
+- **Test Visualization and Result:** https://www.testsprite.com/dashboard/mcp/tests/224532f7-2e10-4c90-906f-c7cdc4615042/6be01331-f41b-4a15-8e53-9d6dc18c3ccc
+- **Status:** ✅ Passed
+- **Severity:** HIGH
+- **Analysis / Findings:** Search functionality works correctly. Keyboard shortcut (Ctrl/Cmd+K) opens search modal, search returns accurate results with proper highlighting, and keyboard navigation through results functions as expected. Search successfully navigates to correct documentation pages when results are selected.
+
+---
+
+### Requirement: Theme Management
+
+- **Description:** Dark mode toggle should work correctly, respect system theme preferences on initial load, and persist user choice across browser sessions.
+
+#### Test TC004
+
+- **Test Name:** Dark Mode Toggle and Persistence
+- **Test Code:** [TC004_Dark_Mode_Toggle_and_Persistence.py](./TC004_Dark_Mode_Toggle_and_Persistence.py)
+- **Test Error:** Testing stopped due to persistent error overlay about a missing end tag blocking interaction and preventing verification of dark mode toggle functionality and persistence.
+- **Test Visualization and Result:** https://www.testsprite.com/dashboard/mcp/tests/224532f7-2e10-4c90-906f-c7cdc4615042/0ba9efa8-be12-4c24-9541-d047774965b6
+- **Status:** ❌ Failed
+- **Severity:** HIGH
+- **Analysis / Findings:** Cannot verify dark mode functionality due to the same blocking error overlay issue. Once the markdown parsing error is resolved, dark mode testing should be retried to verify theme persistence and system preference detection.
+
+---
+
+### Requirement: Mobile Responsiveness
+
+- **Description:** Documentation site should be responsive across mobile screen sizes (320px-768px) with touch-friendly navigation and no horizontal scrolling.
+
+#### Test TC005
+
+- **Test Name:** Mobile Responsiveness and Touch Navigation
+- **Test Code:** [TC005_Mobile_Responsiveness_and_Touch_Navigation.py](./TC005_Mobile_Responsiveness_and_Touch_Navigation.py)
+- **Test Error:** The documentation site loaded successfully at desktop viewport size. Due to environment limitations, I was unable to programmatically resize the viewport to test responsiveness at mobile screen sizes ranging from 320px to 768px. Consequently, I could not verify the absence of horizontal scrolling or test the touch-friendly navigation menu usability, including opening, expanding, collapsing, and navigating through the mobile menu. Therefore, the task is only partially completed. Further testing in an environment that supports viewport resizing and touch event simulation is recommended to fully verify mobile responsiveness and navigation usability.
+- **Test Visualization and Result:** https://www.testsprite.com/dashboard/mcp/tests/224532f7-2e10-4c90-906f-c7cdc4615042/ee144c04-e4e1-4266-979a-cf8c49ca1aef
+- **Status:** ❌ Failed
+- **Severity:** HIGH
+- **Analysis / Findings:** Test environment limitations prevented mobile viewport testing. Desktop viewport loads correctly, but mobile responsiveness cannot be verified without viewport resizing capabilities. Manual testing or a different test environment with viewport manipulation support is recommended to complete this validation.
+
+---
+
+### Requirement: GitHub Integration
+
+- **Description:** "Edit this page" links should correctly direct users to the corresponding markdown file on the GitHub repository.
+
+#### Test TC006
+
+- **Test Name:** GitHub Integration 'Edit this page' Links
+- **Test Code:** [TC006_GitHub_Integration_Edit_this_page_Links.py](./TC006_GitHub_Integration_Edit_this_page_Links.py)
+- **Test Error:** Testing stopped due to critical page rendering error caused by missing end tag in markdown file. Unable to verify 'Edit this page' links. Issue reported for resolution.
+  Browser Console Logs:
+  [ERROR] Failed to load resource: the server responded with a status of 500 (Internal Server Error) (at http://localhost:5174/codeguide-client.md?import&t=1762500552219:0:0)
+  [ERROR] Failed to load module script: Expected a JavaScript module script but the server responded with a MIME type of "text/html". Strict MIME type checking is enforced for module scripts per HTML spec. (at http://localhost:5174/codeguide-client/index.md?import&t=1762500552219:0:0)
+- **Test Visualization and Result:** https://www.testsprite.com/dashboard/mcp/tests/224532f7-2e10-4c90-906f-c7cdc4615042/f45e4433-f917-4c90-b7a9-237e1493278a
+- **Status:** ❌ Failed
+- **Severity:** MEDIUM
+- **Analysis / Findings:** Blocked by the same markdown parsing error. Once resolved, GitHub edit links should be verified to ensure they correctly point to the right file paths in the repository and open in edit mode on GitHub.
+
+---
+
+### Requirement: Code Block Features
+
+- **Description:** Code samples should have proper syntax highlighting, line numbers, and a functional copy-to-clipboard button.
+
+#### Test TC007
+
+- **Test Name:** Syntax Highlighting and Code Copy Functionality
+- **Test Code:** [TC007_Syntax_Highlighting_and_Code_Copy_Functionality.py](./TC007_Syntax_Highlighting_and_Code_Copy_Functionality.py)
+- **Test Error:** Testing stopped due to a persistent Vue compilation error overlay triggered by the copy-to-clipboard button. Syntax highlighting and line numbers are confirmed working, but copy functionality cannot be verified. Please fix the Vue component error to proceed.
+- **Test Visualization and Result:** https://www.testsprite.com/dashboard/mcp/tests/224532f7-2e10-4c90-906f-c7cdc4615042/fee0345b-013b-4ae5-b475-e913f694320c
+- **Status:** ❌ Failed
+- **Severity:** MEDIUM
+- **Analysis / Findings:** Partial success: Syntax highlighting and line numbers work correctly for TypeScript and JavaScript code blocks. However, the copy-to-clipboard button triggers a Vue component error, preventing verification of copy functionality. This suggests an issue with the VitePress copy button component or clipboard API integration.
+
+---
+
+### Requirement: Table of Contents
+
+- **Description:** Auto-generated table of contents should accurately reflect page headings and enable smooth navigation to sections.
+
+#### Test TC008
+
+- **Test Name:** Auto-Generated Table of Contents Accuracy
+- **Test Code:** [TC008_Auto_Generated_Table_of_Contents_Accuracy.py](./TC008_Auto_Generated_Table_of_Contents_Accuracy.py)
+- **Test Error:** The table of contents was verified to be generated correctly based on page headings. However, clicking TOC entries triggers a critical error overlay due to a missing end tag in the source markdown file, preventing navigation testing. The issue has been reported. Stopping further testing.
+- **Test Visualization and Result:** https://www.testsprite.com/dashboard/mcp/tests/224532f7-2e10-4c90-906f-c7cdc4615042/9868315d-b626-4e51-a2f2-4d67ce8e80de
+- **Status:** ❌ Failed
+- **Severity:** MEDIUM
+- **Analysis / Findings:** TOC generation works correctly and accurately reflects page structure. However, clicking TOC links triggers the same markdown parsing error, preventing verification of smooth scrolling to sections. Once the underlying markdown issue is fixed, TOC navigation should function properly.
+
+---
+
+### Requirement: SEO Optimization
+
+- **Description:** Documentation pages should include proper meta tags, titles, descriptions, and structured content for search engine optimization.
+
+#### Test TC009
+
+- **Test Name:** SEO and Content Discoverability Verification
+- **Test Code:** [TC009_SEO_and_Content_Discoverability_Verification.py](./TC009_SEO_and_Content_Discoverability_Verification.py)
+- **Test Error:** Stopped SEO inspection due to persistent rendering error caused by missing end tag in the documentation code. Reported the issue for developer fix. No further SEO checks possible until resolved.
+- **Test Visualization and Result:** https://www.testsprite.com/dashboard/mcp/tests/224532f7-2e10-4c90-906f-c7cdc4615042/a1c4e159-9730-4c87-b2c2-d5bcb1c35fb9
+- **Status:** ❌ Failed
+- **Severity:** MEDIUM
+- **Analysis / Findings:** SEO verification blocked by rendering errors. Once pages load correctly, meta tags, titles, descriptions, and structured markup (schema.org, Open Graph) should be verified to ensure proper search engine discoverability.
+
+---
+
+### Requirement: Accessibility Compliance
+
+- **Description:** Documentation site should meet WCAG AA standards with keyboard navigation, proper color contrast, and screen reader compatibility.
+
+#### Test TC010
+
+- **Test Name:** Accessibility Compliance WCAG AA
+- **Test Code:** [TC010_Accessibility_Compliance_WCAG_AA.py](./TC010_Accessibility_Compliance_WCAG_AA.py)
+- **Test Error:** Accessibility testing cannot proceed due to a critical code error causing an error overlay that blocks interaction. The issue has been reported. Please fix the missing end tag in the code to continue testing.
+- **Test Visualization and Result:** https://www.testsprite.com/dashboard/mcp/tests/224532f7-2e10-4c90-906f-c7cdc4615042/ad57cc76-7b61-4fb6-96bc-dafec6c89be4
+- **Status:** ❌ Failed
+- **Severity:** HIGH
+- **Analysis / Findings:** Critical accessibility testing blocked by rendering errors. Once resolved, comprehensive accessibility audit should verify keyboard navigation, color contrast ratios, ARIA labels, alt texts, and screen reader compatibility to ensure WCAG AA compliance.
+
+---
+
+### Requirement: Development Workflow
+
+- **Description:** Local development should support hot module replacement for immediate content updates and build without errors.
+
+#### Test TC011
+
+- **Test Name:** Local Development Workflow Build and Hot Reload
+- **Test Code:** [TC011_Local_Development_Workflow_Build_and_Hot_Reload.py](./TC011_Local_Development_Workflow_Build_and_Hot_Reload.py)
+- **Test Error:**
+- **Test Visualization and Result:** https://www.testsprite.com/dashboard/mcp/tests/224532f7-2e10-4c90-906f-c7cdc4615042/0982e8e2-d59f-4b63-b1e5-5e020a2985c8
+- **Status:** ✅ Passed
+- **Severity:** HIGH
+- **Analysis / Findings:** Development workflow functions correctly. Development server starts without errors, hot module replacement works as expected with immediate content updates, and production build completes successfully without errors. Static assets are generated correctly.
+
+---
+
+### Requirement: Performance Standards
+
+- **Description:** Documentation site should meet performance targets: First Contentful Paint (FCP) under 1.5 seconds and Cumulative Layout Shift (CLS) below 0.1.
+
+#### Test TC012
+
+- **Test Name:** Performance Metrics Compliance
+- **Test Code:** [TC012_Performance_Metrics_Compliance.py](./TC012_Performance_Metrics_Compliance.py)
+- **Test Error:** Stopped testing due to critical content error on documentation page preventing performance measurements. Reported issue for developer fix.
+  Browser Console Logs:
+  [ERROR] Failed to load resource: the server responded with a status of 500 (Internal Server Error) (at http://localhost:5174/codeguide-client.md?import&t=1762500534675:0:0)
+  [ERROR] Failed to load module script: Expected a JavaScript module script but the server responded with a MIME type of "text/html". Strict MIME type checking is enforced for module scripts per HTML spec. (at http://localhost:5174/codeguide-client/index.md?import&t=1762500534675:0:0)
+- **Test Visualization and Result:** https://www.testsprite.com/dashboard/mcp/tests/224532f7-2e10-4c90-906f-c7cdc4615042/82c4e517-cc87-4f9f-9401-8bf7fe751c76
+- **Status:** ❌ Failed
+- **Severity:** HIGH
+- **Analysis / Findings:** Performance metrics cannot be measured due to page rendering errors. Once pages load correctly, performance should be verified against targets: FCP < 1.5s, CLS < 0.1, and full page load within 2 seconds on standard broadband.
+
+---
+
+## 3️⃣ Coverage & Matching Metrics
+
+- **25.00%** of tests passed (3 out of 12 tests)
+
+| Requirement              | Total Tests | ✅ Passed | ❌ Failed |
+| ------------------------ | ----------- | --------- | --------- |
+| Core Page Loading        | 1           | 1         | 0         |
+| Navigation Functionality | 1           | 0         | 1         |
+| Search Functionality     | 1           | 1         | 0         |
+| Theme Management         | 1           | 0         | 1         |
+| Mobile Responsiveness    | 1           | 0         | 1         |
+| GitHub Integration       | 1           | 0         | 1         |
+| Code Block Features      | 1           | 0         | 1         |
+| Table of Contents        | 1           | 0         | 1         |
+| SEO Optimization         | 1           | 0         | 1         |
+| Accessibility Compliance | 1           | 0         | 1         |
+| Development Workflow     | 1           | 1         | 0         |
+| Performance Standards    | 1           | 0         | 1         |
+
+---
+
+## 4️⃣ Key Gaps / Risks
+
+### Critical Issues
+
+1. **Markdown Parsing Error (Blocking Multiple Tests)**
+   - **Issue:** Missing end tag in `codeguide-client.md` causing Vue compilation errors and 500 server errors
+   - **Impact:** Blocks 8 out of 12 tests (67% of test suite)
+   - **Affected Features:** Navigation, dark mode, GitHub links, TOC navigation, SEO verification, accessibility testing, performance metrics
+   - **Priority:** 🔴 CRITICAL - Must be fixed immediately
+   - **Recommendation:** Review `codeguide-client.md` for unclosed HTML tags or malformed markdown syntax. Check for Vue component syntax errors in markdown files.
+
+2. **Copy-to-Clipboard Component Error**
+   - **Issue:** Vue component error when clicking copy button on code blocks
+   - **Impact:** Code copy functionality not working despite syntax highlighting working correctly
+   - **Priority:** 🟡 MEDIUM - Affects user experience but doesn't block core functionality
+   - **Recommendation:** Investigate VitePress copy button component integration and clipboard API permissions
+
+### Test Environment Limitations
+
+3. **Mobile Responsiveness Testing**
+   - **Issue:** Test environment cannot programmatically resize viewport
+   - **Impact:** Mobile responsiveness cannot be verified automatically
+   - **Priority:** 🟡 MEDIUM - Requires manual testing or different test environment
+   - **Recommendation:** Perform manual testing on actual mobile devices or use a test environment with viewport manipulation capabilities
+
+### Summary
+
+- **25% test pass rate** indicates significant issues that need immediate attention
+- **Primary blocker:** Markdown parsing error in `codeguide-client.md` affecting majority of functionality
+- **Working features:** Homepage loading, search functionality, and development workflow are functioning correctly
+- **Next steps:**
+  1. Fix markdown parsing error in `codeguide-client.md`
+  2. Resolve copy-to-clipboard component error
+  3. Retest all blocked functionality
+  4. Perform manual mobile responsiveness testing
+
+---

package/docs/testsprite_tests/testsprite_frontend_test_plan.json

@@ -0,0 +1,390 @@
+[
+  {
+    "id": "TC001",
+    "title": "Homepage Load and Hero Section Display",
+    "description": "Verify that the homepage loads within acceptable time and displays the hero section including quick start guidance and feature highlights correctly.",
+    "category": "functional",
+    "priority": "High",
+    "steps": [
+      {
+        "type": "action",
+        "description": "Navigate to the homepage URL"
+      },
+      {
+        "type": "assertion",
+        "description": "Check that the page loads within 2 seconds on a standard broadband connection"
+      },
+      {
+        "type": "assertion",
+        "description": "Verify the hero section is visible and contains quick start guide and feature highlights"
+      }
+    ]
+  },
+  {
+    "id": "TC002",
+    "title": "Sidebar Navigation Expand/Collapse Functionality",
+    "description": "Validate that the hierarchical sidebar navigation expands and collapses correctly and routes to the correct documentation pages.",
+    "category": "functional",
+    "priority": "High",
+    "steps": [
+      {
+        "type": "action",
+        "description": "Locate the sidebar navigation"
+      },
+      {
+        "type": "action",
+        "description": "Click on a collapsible section in the sidebar"
+      },
+      {
+        "type": "assertion",
+        "description": "Confirm the section expands showing nested links"
+      },
+      {
+        "type": "action",
+        "description": "Click on a nested documentation topic link"
+      },
+      {
+        "type": "assertion",
+        "description": "Verify navigation to the correct documentation page and active page highlighting in the sidebar"
+      },
+      {
+        "type": "action",
+        "description": "Click the same collapsible section to collapse it"
+      },
+      {
+        "type": "assertion",
+        "description": "Confirm the section collapses hiding nested links"
+      }
+    ]
+  },
+  {
+    "id": "TC003",
+    "title": "Full-Text Local Search with Keyboard Shortcut",
+    "description": "Ensure the full-text search is accessible via keyboard shortcut Ctrl/Cmd+K, returns accurate results, and highlights matching terms.",
+    "category": "functional",
+    "priority": "High",
+    "steps": [
+      {
+        "type": "action",
+        "description": "Load any documentation page"
+      },
+      {
+        "type": "action",
+        "description": "Press Ctrl+K (or Cmd+K on Mac) to open search"
+      },
+      {
+        "type": "assertion",
+        "description": "Search input is focused and visible"
+      },
+      {
+        "type": "action",
+        "description": "Enter a relevant search query that exists in markdown content"
+      },
+      {
+        "type": "assertion",
+        "description": "Verify search results are returned and include documents containing the query"
+      },
+      {
+        "type": "assertion",
+        "description": "Check that query terms are highlighted in the search results"
+      },
+      {
+        "type": "action",
+        "description": "Navigate the search results using keyboard arrows"
+      },
+      {
+        "type": "assertion",
+        "description": "Focused search result is visually distinct and can be selected via Enter key"
+      },
+      {
+        "type": "action",
+        "description": "Select a search result"
+      },
+      {
+        "type": "assertion",
+        "description": "User is navigated to the correct documentation page with query highlights present"
+      }
+    ]
+  },
+  {
+    "id": "TC004",
+    "title": "Dark Mode Toggle and Persistence",
+    "description": "Verify that the dark mode toggle works, respects system theme detection on initial load, and persists user choice across sessions.",
+    "category": "functional",
+    "priority": "High",
+    "steps": [
+      {
+        "type": "action",
+        "description": "Load the documentation site with system theme set to light mode"
+      },
+      {
+        "type": "assertion",
+        "description": "Site loads in light mode by default"
+      },
+      {
+        "type": "action",
+        "description": "Manually enable dark mode using toggle"
+      },
+      {
+        "type": "assertion",
+        "description": "Site switches to dark mode appearance immediately"
+      },
+      {
+        "type": "action",
+        "description": "Refresh the page"
+      },
+      {
+        "type": "assertion",
+        "description": "Dark mode remains enabled after refresh"
+      },
+      {
+        "type": "action",
+        "description": "Set system theme to dark and clear local preference"
+      },
+      {
+        "type": "action",
+        "description": "Reload the site"
+      },
+      {
+        "type": "assertion",
+        "description": "Site loads in dark mode automatically respecting system preference"
+      }
+    ]
+  },
+  {
+    "id": "TC005",
+    "title": "Mobile Responsiveness and Touch Navigation",
+    "description": "Check the documentation site's responsiveness on various mobile screen sizes and verify touch-friendly navigation usability.",
+    "category": "functional",
+    "priority": "High",
+    "steps": [
+      {
+        "type": "action",
+        "description": "Load the site on viewport sizes ranging from 320px to 768px width"
+      },
+      {
+        "type": "assertion",
+        "description": "Layout adjusts correctly to mobile screen sizes without horizontal scrolling"
+      },
+      {
+        "type": "action",
+        "description": "Open the mobile navigation menu using touch or tap"
+      },
+      {
+        "type": "assertion",
+        "description": "Mobile navigation menu opens smoothly and sections can be expanded or collapsed"
+      },
+      {
+        "type": "action",
+        "description": "Navigate to multiple pages via mobile navigation"
+      },
+      {
+        "type": "assertion",
+        "description": "Navigation is fluid and pages load correctly without errors"
+      },
+      {
+        "type": "action",
+        "description": "Test scrolling and tap interactions within the content area"
+      },
+      {
+        "type": "assertion",
+        "description": "Touch events respond correctly and user experience is smooth"
+      }
+    ]
+  },
+  {
+    "id": "TC006",
+    "title": "GitHub Integration 'Edit this page' Links",
+    "description": "Verify that all 'Edit this page' links correctly direct to the corresponding markdown file on GitHub repository.",
+    "category": "functional",
+    "priority": "High",
+    "steps": [
+      {
+        "type": "action",
+        "description": "Navigate to multiple documentation pages"
+      },
+      {
+        "type": "action",
+        "description": "Locate the 'Edit this page on GitHub' link"
+      },
+      {
+        "type": "assertion",
+        "description": "Confirm the link URL corresponds to the correct markdown file path in GitHub repository"
+      },
+      {
+        "type": "action",
+        "description": "Click the edit link"
+      },
+      {
+        "type": "assertion",
+        "description": "Verify redirection to GitHub with the editable markdown file open"
+      }
+    ]
+  },
+  {
+    "id": "TC007",
+    "title": "Syntax Highlighting and Code Copy Functionality",
+    "description": "Ensure TypeScript and JavaScript code samples have syntax highlighting with line numbers and copy-to-clipboard button functions correctly.",
+    "category": "functional",
+    "priority": "High",
+    "steps": [
+      {
+        "type": "action",
+        "description": "Open various pages containing TypeScript and JavaScript code samples"
+      },
+      {
+        "type": "assertion",
+        "description": "Verify syntax highlighting is applied correctly with appropriate color and style"
+      },
+      {
+        "type": "assertion",
+        "description": "Check that line numbers are visible for code blocks"
+      },
+      {
+        "type": "action",
+        "description": "Click on the copy-to-clipboard button on a code block"
+      },
+      {
+        "type": "assertion",
+        "description": "Confirm code content is copied to clipboard successfully"
+      }
+    ]
+  },
+  {
+    "id": "TC008",
+    "title": "Auto-Generated Table of Contents Accuracy",
+    "description": "Verify the table of contents is auto-generated correctly based on page headings and links navigate to correct sections.",
+    "category": "functional",
+    "priority": "Medium",
+    "steps": [
+      {
+        "type": "action",
+        "description": "Open documentation pages with multiple heading levels"
+      },
+      {
+        "type": "assertion",
+        "description": "Check that the table of contents reflects all headings hierarchically"
+      },
+      {
+        "type": "action",
+        "description": "Click table of contents entries"
+      },
+      {
+        "type": "assertion",
+        "description": "Verify page scrolls to the correct heading section"
+      }
+    ]
+  },
+  {
+    "id": "TC009",
+    "title": "SEO and Content Discoverability Verification",
+    "description": "Ensure that pages include proper meta tags, titles, descriptions, and structured content to meet SEO standards.",
+    "category": "functional",
+    "priority": "Medium",
+    "steps": [
+      {
+        "type": "action",
+        "description": "Inspect multiple documentation page source code"
+      },
+      {
+        "type": "assertion",
+        "description": "Verify presence of relevant meta title and meta description tags"
+      },
+      {
+        "type": "assertion",
+        "description": "Check structured markup such as schema.org or open graph tags where applicable"
+      },
+      {
+        "type": "assertion",
+        "description": "Confirm URLs are semantic and user-friendly"
+      }
+    ]
+  },
+  {
+    "id": "TC010",
+    "title": "Accessibility Compliance WCAG AA",
+    "description": "Validate documentation site accessibility with keyboard navigation, color contrast, and screen reader compatibility to meet WCAG AA standards.",
+    "category": "accessibility",
+    "priority": "High",
+    "steps": [
+      {
+        "type": "action",
+        "description": "Navigate through the site using keyboard only (Tab, Shift+Tab, Enter, arrow keys)"
+      },
+      {
+        "type": "assertion",
+        "description": "Focus order follows logical reading order and interactive elements are reachable"
+      },
+      {
+        "type": "assertion",
+        "description": "All text and UI elements meet color contrast ratio requirements"
+      },
+      {
+        "type": "action",
+        "description": "Use a screen reader to navigate main sections of the documentation site"
+      },
+      {
+        "type": "assertion",
+        "description": "Content is read correctly with meaningful alt texts and ARIA labels where applicable"
+      }
+    ]
+  },
+  {
+    "id": "TC011",
+    "title": "Local Development Workflow Build and Hot Reload",
+    "description": "Verify that local content edits in markdown files are reflected immediately via hot module replacement and that the site builds without errors.",
+    "category": "functional",
+    "priority": "High",
+    "steps": [
+      {
+        "type": "action",
+        "description": "Start local development server with hot reload enabled"
+      },
+      {
+        "type": "assertion",
+        "description": "Confirm server starts without build errors"
+      },
+      {
+        "type": "action",
+        "description": "Modify a markdown file used in documentation"
+      },
+      {
+        "type": "assertion",
+        "description": "Verify changes appear immediately in the local preview via hot reload without full page refresh"
+      },
+      {
+        "type": "action",
+        "description": "Stop the development server and run full build process"
+      },
+      {
+        "type": "assertion",
+        "description": "No build errors occur and static assets are generated successfully"
+      }
+    ]
+  },
+  {
+    "id": "TC012",
+    "title": "Performance Metrics Compliance",
+    "description": "Ensure the documentation site meets performance targets such as First Contentful Paint (FCP) under 1.5 seconds and Cumulative Layout Shift (CLS) below 0.1.",
+    "category": "performance",
+    "priority": "High",
+    "steps": [
+      {
+        "type": "action",
+        "description": "Open homepage and select various documentation pages"
+      },
+      {
+        "type": "assertion",
+        "description": "Measure FCP and confirm it is less than 1.5 seconds"
+      },
+      {
+        "type": "assertion",
+        "description": "Measure CLS and verify it is below 0.1"
+      },
+      {
+        "type": "assertion",
+        "description": "Page loads fully within 2 seconds on standard broadband"
+      }
+    ]
+  }
+]