testeranto 0.177.0 → 0.197.0

package/dist/module/src/TestReport.js

@@ -1,368 +0,0 @@
-"use strict";
-// import ReactDom from "react-dom/client";
-// import React, { useEffect, useState } from "react";
-// import { Col, Nav, Row, Tab } from "react-bootstrap";
-// import { Footer } from "./Footer";
-// import "./TestReport.scss"
-// const BddPage = () => {
-//   const [bddErrors, setBddErrors] = useState<{
-//     name: string;
-//     givens: {
-//       key: string;
-//       name: string;
-//       whens: {
-//         name: string;
-//         error: string;
-//       }[];
-//       thens: {
-//         name: string;
-//         error: string;
-//       }[];
-//     }[];
-//   } | { error: object }>();
-//   useEffect(() => {
-//     (async () => {
-//       try {
-//         const fetched = await fetch(
-//           `${window.location.href
-//             .split("/")
-//             .slice(0, -1)
-//             .join("/")}/tests.json`
-//         );
-//         const testsJson = await (fetched).json();
-//         setBddErrors(testsJson);
-//       } catch (e) {
-//         setBddErrors({ error: e });
-//       }
-//     })();
-//   }, []);
-//   const [log, setLog] = useState<string | { error: object }>();
-//   const [buildLog, setBuildLog] = useState<string | { error: object }>();
-//   const [typeErrors, setTypeErrors] = useState<string | { error: object }>();
-//   // const [staticAnalysis, setStaticAnalysis] = useState<string | { error: object }>();
-//   const [message, setMessage] = useState<string | { error: object }>();
-//   const [prompt, setPrompt] = useState<string | { error: object }>();
-//   useEffect(() => {
-//     (async () => {
-//       try {
-//         setLog(
-//           await (
-//             await fetch(
-//               `${window.location.href.split("/").slice(0, -1).join("/")}/logs.txt`
-//             )
-//           ).text()
-//         );
-//       } catch (e) {
-//         setLog({ error: e })
-//       }
-//     })();
-//   }, []);
-//   useEffect(() => {
-//     (async () => {
-//       try {
-//         setBuildLog(
-//           await (
-//             await fetch(
-//               `${window.location.href.split("/").slice(0, -1).join("/")}/build_logs.txt`
-//             )
-//           ).text()
-//         );
-//       } catch (e) {
-//         setBuildLog({ error: e })
-//       }
-//     })();
-//   }, []);
-//   useEffect(() => {
-//     (async () => {
-//       try {
-//         setTypeErrors(
-//           await (
-//             await fetch(
-//               `${window.location.href.split("/").slice(0, -1).join("/")}/type_errors.txt`
-//             )
-//           ).text()
-//         );
-//       } catch (e) {
-//         setTypeErrors({ error: e })
-//       }
-//     })();
-//   }, []);
-//   const [staticAnalysis, setStaticAnalysis] = useState<string | { error: object }>();
-//   useEffect(() => {
-//     (async () => {
-//       try {
-//         const response = await fetch(
-//           `${window.location.href.split("/").slice(0, -1).join("/")}/lint_errors.txt`
-//         );
-//         const data = await response.text();
-//         setStaticAnalysis(data);
-//       } catch (e) {
-//         setStaticAnalysis({ error: e })
-//       }
-//     })();
-//   }, []);
-//   useEffect(() => {
-//     (async () => {
-//       try {
-//         const messageText = await (
-//           await fetch(
-//             `${window.location.href.split("/").slice(0, -1).join("/")}/message.txt`
-//           )
-//         ).text();
-//         setMessage(messageText);
-//       } catch (e) {
-//         setMessage({ error: e });
-//         console.error('Error loading message:', e);
-//       }
-//     })();
-//   }, []);
-//   useEffect(() => {
-//     (async () => {
-//       try {
-//         const promptText = await (
-//           await fetch(
-//             `${window.location.href.split("/").slice(0, -1).join("/")}/prompt.txt`
-//           )
-//         ).text();
-//         setPrompt(promptText);
-//       } catch (e) {
-//         setPrompt({ error: e });
-//         console.error('Error loading prompt:', e);
-//       }
-//     })();
-//   }, []);
-//   // })();
-//   //   }, []);
-//   if (bddErrors === undefined || log === undefined) {
-//     return <div>loading...</div>;
-//   }
-//   function stripDomainFromUrl(url) {
-//     try {
-//       const urlObj = new URL(url);
-//       // Construct the new URL by combining pathname, search (query parameters), and hash
-//       // The slice(1) removes the leading '/' from pathname if it's not the root path
-//       return urlObj.pathname + urlObj.search + urlObj.hash;
-//     } catch (error) {
-//       console.error("Invalid URL:", error);
-//       return null; // Or throw an error, depending on desired error handling
-//     }
-//   }
-//   const copyAiderCommand = async () => {
-//     if (typeof prompt !== 'string' || typeof message !== 'string') {
-//       alert('Prompt and message files must be loaded first');
-//       return;
-//     }
-//     const basePath = `.${stripDomainFromUrl(window.location.href).split('/').slice(0, -1).join('/')}`;
-//     const command = `aider --load ${basePath}/prompt.txt  --message-file ${basePath}/message.txt`;
-//     try {
-//       await navigator.clipboard.writeText(command);
-//       alert('Copied to clipboard:\n' + command);
-//     } catch (err) {
-//       alert('Failed to copy command: ' + err);
-//     }
-//   };
-//   const basePath = window.location.href.split('/').slice(0, -1).join('/');
-//   return (
-//     <div className="container-fluid p-4" style={{ backgroundColor: 'transparent', position: 'relative', zIndex: 10 }}>
-//       {/* Full sunrise scene elements */}
-//       <div id="starsContainer">
-//         <div id="stars"></div>
-//       </div>
-//       <div id="sun"></div>
-//       <div id="sunDay"></div>
-//       <div id="sunSet"></div>
-//       <div id="sky"></div>
-//       <div id="horizon"></div>
-//       <div id="horizonNight"></div>
-//       <div id="moon"></div>
-//       <div id="mountainRange">
-//         <div id="mountain"></div>
-//       </div>
-//       <div id="water"></div>
-//       <div id="waterReflectionContainer">
-//         <div id="waterReflectionMiddle"></div>
-//       </div>
-//       <div id="waterDistance"></div>
-//       <div id="darknessOverlaySky"></div>
-//       <div id="darknessOverlay"></div>
-//       <div id="oceanRippleContainer">
-//         <div id="oceanRipple"></div>
-//       </div>
-//       <Tab.Container defaultActiveKey="tests">
-//         <nav className="navbar navbar-expand-lg navbar-light bg-light mb-3 rounded">
-//           <div className="container-fluid">
-//             <span className="navbar-brand text-muted">{basePath.split("testeranto/reports")[1]}</span>
-//             <div className="ms-auto">
-//               <button
-//                 onClick={copyAiderCommand}
-//                 className="btn btn-primary"
-//                 title="Copy aider command to clipboard"
-//               >
-//                 🤖🪄✨
-//               </button>
-//             </div>
-//           </div>
-//         </nav>
-//         <Nav variant="tabs" className="mb-3">
-//           <Nav.Item>
-//             <Nav.Link eventKey="tests">BDD results</Nav.Link>
-//           </Nav.Item>
-//           <Nav.Item>
-//             <Nav.Link eventKey="logs">Runtime logs</Nav.Link>
-//           </Nav.Item>
-//           <Nav.Item>
-//             <Nav.Link eventKey="build">Build logs</Nav.Link>
-//           </Nav.Item>
-//           <Nav.Item>
-//             <Nav.Link eventKey="types">Type errors</Nav.Link>
-//           </Nav.Item>
-//           <Nav.Item>
-//             <Nav.Link eventKey="analysis">Static analysis</Nav.Link>
-//           </Nav.Item>
-//           <Nav.Item>
-//             <Nav.Link eventKey="ai">Aider</Nav.Link>
-//           </Nav.Item>
-//         </Nav>
-//         <Row>
-//           <Col sm={12}>
-//             <Tab.Content>
-//               <Tab.Pane eventKey="tests">
-//                 {'error' in bddErrors ? (
-//                   <div className="alert alert-danger">
-//                     <h4>Error loading test results</h4>
-//                     <pre>{JSON.stringify(bddErrors.error, null, 2)}</pre>
-//                   </div>
-//                 ) : (
-//                   <div>
-//                     {/* <h2>BDD Results</h2> */}
-//                     {bddErrors.name && <h3>{bddErrors.name}</h3>}
-//                     {bddErrors.givens.map((given, i) => (
-//                       <div key={i} className="mb-4">
-//                         <h4>Given: {given.name}</h4>
-//                         <ul className="list-group">
-//                           {given.whens.map((when, j) => (
-//                             <li key={`w-${j}`} className={`list-group-item ${when.error ? 'list-group-item-danger' : 'list-group-item-success'}`}>
-//                               <strong>When:</strong> {when.name}
-//                               {when.error && (
-//                                 <div className="mt-2">
-//                                   <pre className="text-danger">{when.error}</pre>
-//                                 </div>
-//                               )}
-//                             </li>
-//                           ))}
-//                         </ul>
-//                         <ul className="list-group mt-2">
-//                           {given.thens.map((then, k) => (
-//                             <li key={`t-${k}`} className={`list-group-item ${then.error ? 'list-group-item-danger' : 'list-group-item-success'}`}>
-//                               <strong>Then:</strong> {then.name}
-//                               {then.error && (
-//                                 <div className="mt-2">
-//                                   <pre className="text-danger">{then.error}</pre>
-//                                 </div>
-//                               )}
-//                             </li>
-//                           ))}
-//                         </ul>
-//                       </div>
-//                     ))}
-//                   </div>
-//                 )}
-//               </Tab.Pane>
-//               <Tab.Pane eventKey="logs">
-//                 {typeof log === 'string' ? (
-//                   <div>
-//                     <pre className="bg-secondary text-white p-3" style={{ overflow: 'auto' }}>
-//                       {log}
-//                     </pre>
-//                   </div>
-//                 ) : (
-//                   <div className="alert alert-danger">
-//                     <h4>Error loading logs</h4>
-//                     {/* <pre>{JSON.stringify(log.error, null, 2)}</pre> */}
-//                   </div>
-//                 )}
-//               </Tab.Pane>
-//               <Tab.Pane eventKey="build">
-//                 {/* {typeof buildLog === 'string' ? (
-//                   <div>
-//                     <pre className="bg-secondary text-white p-3" style={{ overflow: 'auto' }}>
-//                       {buildLog}
-//                     </pre>
-//                   </div>
-//                 ) : (
-//                   <div className="alert alert-danger">
-//                     <h4>Error loading build logs</h4>
-//                     <pre>{JSON.stringify(buildLog.error, null, 2)}</pre>
-//                   </div>
-//                 )} */}
-//               </Tab.Pane>
-//               <Tab.Pane eventKey="types">
-//                 {typeof typeErrors === 'string' ? (
-//                   <div>
-//                     <pre className="bg-secondary text-white p-3" style={{ overflow: 'auto' }}>
-//                       {typeErrors}
-//                     </pre>
-//                   </div>
-//                 ) : (
-//                   <div className="alert alert-danger">
-//                     <h4>Error loading type errors</h4>
-//                     {/* <pre>{JSON.stringify(typeErrors.error, null, 2)}</pre> */}
-//                   </div>
-//                 )}
-//               </Tab.Pane>
-//               <Tab.Pane eventKey="analysis">
-//                 {typeof staticAnalysis === 'string' ? (
-//                   <div>
-//                     <pre>{staticAnalysis}</pre>
-//                   </div>
-//                 ) : (
-//                   <div className="alert alert-danger">
-//                     <h4>Error loading static analysis</h4>
-//                     {/* <pre>{JSON.stringify(staticAnalysis.error, null, 2)}</pre> */}
-//                   </div>
-//                 )}
-//               </Tab.Pane>
-//               <Tab.Pane eventKey="ai">
-//                 <div className="row">
-//                   <div className="col-md-12">
-//                     {/* {(!message.error) ? (
-//                       <pre className="bg-secondary text-white p-3" style={{ overflow: 'auto' }}>
-//                         {message}
-//                       </pre>
-//                     ) : (
-//                       <div className="alert alert-danger">
-//                         <h5>Error loading AI message</h5>
-//                         <pre>{JSON.stringify(message.error, null, 2)}</pre>
-//                       </div>
-//                     )} */}
-//                     {/* {typeof prompt === 'string' ? (
-//                       <pre className="bg-secondary text-white  p-3" style={{ overflow: 'auto' }}>
-//                         {prompt}
-//                       </pre>
-//                     ) : (
-//                       <div className="alert alert-danger">
-//                         <h5>Error loading AI prompt</h5>
-//                         <pre>{JSON.stringify(prompt.error, null, 2)}</pre>
-//                       </div>
-//                     )} */}
-//                   </div>
-//                 </div>
-//               </Tab.Pane>
-//             </Tab.Content>
-//           </Col>
-//         </Row>
-//       </Tab.Container>
-//       <Footer />
-//     </div>
-//   );
-// };
-// document.addEventListener("DOMContentLoaded", function () {
-//   const elem = document.getElementById("root");
-//   if (elem) {
-//     if (elem) {
-//       const root = ReactDom.createRoot(elem);
-//       root.render(React.createElement(BddPage, {}));
-//       // document.body.classList.add(`${themeToApply}-theme`);
-//     }
-//   }
-// });

package/dist/module/src/components/pure/ProjectPageView.test/adapter.js

@@ -1,17 +0,0 @@
-export const adapter = {
-    beforeEach: async (subject, initializer, testResource, initialValues, pm) => {
-        return initializer();
-    },
-    andWhen: async (store, whenCB, testResource, pm) => {
-        return whenCB(store, pm);
-    },
-    butThen: async (store, thenCB, testResource, pm) => {
-        return thenCB(store, pm);
-    },
-    afterEach: async (store, key, pm) => {
-        if (store === null || store === void 0 ? void 0 : store.container) {
-            store.container.remove();
-        }
-        return store;
-    },
-};

package/dist/module/src/lib/dailyAnimation.js

@@ -1,130 +0,0 @@
-"use strict";
-// type AnimationElement = 'sun' | 'sunDay' | 'sunSet' | 'waterReflectionMiddle';
-// let animationInterval: NodeJS.Timeout | null = null;
-// const ANIMATION_DURATION = 60000; // 60 seconds
-// let animationStartTime: number;
-// export function startDailyAnimation(): void {
-//   stopDailyAnimation(); // Clear any existing animation
-//   animationStartTime = Date.now();
-//   animationInterval = setInterval(() => {
-//     updateDailyAnimation();
-//   }, 1000); // Update every second
-//   // Initialize sun at bottom position
-//   updateSunPosition(0);
-// }
-// export function stopDailyAnimation(): void {
-//   if (animationInterval) {
-//     clearInterval(animationInterval);
-//     animationInterval = null;
-//   }
-// }
-// function updateDailyAnimation(): void {
-//   const elapsed = Date.now() - animationStartTime;
-//   const progress = (elapsed % ANIMATION_DURATION) / ANIMATION_DURATION;
-//   // Use sine wave for smooth up-down movement
-//   const position = 0.5 - Math.cos(progress * Math.PI * 2) * 0.5;
-//   // Calculate target position for smooth interpolation
-//   const targetYPos = document.body.clientHeight * (1 - position);
-//   // Update all elements at once
-//   updateSunPosition(position);
-// }
-// function updateSunPosition(normalizedPosition: number): void {
-//   // normalizedPosition is 0-1 where 0=bottom, 1=top
-//   const body = document.body;
-//   const height = body.clientHeight;
-//   const yPos = height * (1 - normalizedPosition); // Invert since y=0 is top
-//   const width = body.clientWidth;
-//   // Update all sun-related elements
-//   const elements: AnimationElement[] = [
-//     'sun', 'sunDay', 'sunSet', 'waterReflectionMiddle'
-//   ];
-//   elements.forEach(id => {
-//     const el = document.getElementById(id);
-//     if (el) {
-//       el.style.background = el.style.background.replace(
-//         /radial-gradient\([^)]+\)/,
-//         `radial-gradient(${width/2}px ${yPos}px, circle, ${getGradientColors(id, normalizedPosition)})`
-//       );
-//     }
-//   });
-//   // Update water reflection position
-//   const reflectionContainer = document.getElementById('waterReflectionContainer');
-//   const reflectionMiddle = document.getElementById('waterReflectionMiddle');
-//   if (reflectionContainer && reflectionMiddle) {
-//     reflectionContainer.style.perspectiveOrigin = `${(width/2)/width * 100}% ${-15 + (normalizedPosition * 30)}%`;
-//     reflectionMiddle.style.left = `${(width/2) - width - (width * 0.03)}px`;
-//   }
-//   // Update opacity of various elements based on sun position
-//   const darknessOverlay = document.getElementById('darknessOverlay');
-//   const darknessOverlaySky = document.getElementById('darknessOverlaySky');
-//   const moon = document.getElementById('moon');
-//   const horizonNight = document.getElementById('horizonNight');
-//   const starsContainer = document.getElementById('starsContainer');
-//   const waterDistance = document.getElementById('waterDistance');
-//   const sunDay = document.getElementById('sunDay');
-//   const sky = document.getElementById('sky');
-//   const sunSet = document.getElementById('sunSet');
-//   const sun = document.getElementById('sun');
-//   const horizon = document.getElementById('horizon');
-//   if (darknessOverlay) {
-//     darknessOverlay.style.opacity = Math.min((yPos - (height / 2)) / (height / 2), 1).toString();
-//   }
-//   if (darknessOverlaySky) {
-//     darknessOverlaySky.style.opacity = Math.min((yPos - (height * 7 / 10)) / (height - (height * 7 / 10)), 1).toString();
-//   }
-//   if (moon) {
-//     moon.style.opacity = Math.min((yPos - (height * 9 / 10)) / (height - (height * 9 / 10)), 0.65).toString();
-//   }
-//   if (horizonNight) {
-//     horizonNight.style.opacity = ((yPos - (height * 4 / 5)) / (height - (height * 4 / 5))).toString();
-//   }
-//   if (starsContainer) {
-//     starsContainer.style.opacity = (yPos / height - 0.6).toString();
-//   }
-//   if (waterDistance) {
-//     waterDistance.style.opacity = (yPos / height + 0.6).toString();
-//   }
-//   if (sunDay) {
-//     sunDay.style.opacity = (1 - yPos / height).toString();
-//   }
-//   if (sky) {
-//     sky.style.opacity = Math.min((1 - yPos / height), 0.99).toString();
-//   }
-//   if (sunSet) {
-//     sunSet.style.opacity = (yPos / height - 0.2).toString();
-//   }
-//   // Update stars opacity
-//   const stars = document.getElementsByClassName('star');
-//   for (let i = 0; i < stars.length; i++) {
-//     (stars[i] as HTMLElement).style.opacity = (yPos / height - 0.6).toString();
-//   }
-//   // Update sun and horizon based on position
-//   if (yPos > height / 2) {
-//     if (sun) sun.style.opacity = Math.min((height - yPos) / (height / 2) + 0.2, 0.5).toString();
-//     if (horizon) horizon.style.opacity = ((height - yPos) / (height / 2) + 0.2).toString();
-//     if (reflectionMiddle) reflectionMiddle.style.opacity = ((height - yPos) / (height / 2) - 0.1).toString();
-//   } else {
-//     if (horizon) horizon.style.opacity = Math.min(yPos / (height / 2), 0.99).toString();
-//     if (sun) sun.style.opacity = Math.min(yPos / (height / 2), 0.5).toString();
-//     if (reflectionMiddle) reflectionMiddle.style.opacity = (yPos / (height / 2) - 0.1).toString();
-//   }
-// }
-// function getGradientColors(elementId: AnimationElement, position: number): string {
-//   // Simplified gradient colors that change based on sun position
-//   switch(elementId) {
-//     case 'sun':
-//       return `rgba(242,248,247,1) 0%,rgba(249,249,28,1) 3%,rgba(247,214,46,1) 8%,rgba(248,200,95,1) 12%,rgba(201,165,132,1) 30%,rgba(115,130,133,1) 51%,rgba(46,97,122,1) 85%,rgba(24,75,106,1) 100%`;
-//     case 'sunDay':
-//       return `rgba(252,255,251,0.9) 0%,rgba(253,250,219,0.4) 30%,rgba(226,219,197,0.01) 70%,rgba(226,219,197,0.0) 70%,rgba(201,165,132,0) 100%`;
-//     case 'sunSet':
-//       return position > 0.5
-//         ? `rgba(254,255,255,0.8) 5%,rgba(236,255,0,1) 10%,rgba(253,50,41,1) 25%,rgba(243,0,0,1) 40%,rgba(93,0,0,1) 100%`
-//         : `rgba(254,255,255,0.0) 5%,rgba(236,255,0,0) 10%,rgba(253,50,41,0) 25%,rgba(243,0,0,0) 40%,rgba(93,0,0,0) 100%`;
-//     case 'waterReflectionMiddle':
-//       return position > 0.5
-//         ? `rgba(247,177,72,1) 3%,rgba(248,175,65,1) 6%,rgba(207,62,30,0.4) 35%,rgba(176,91,48,0.1) 45%,rgba(141,88,47,0.0) 60%,rgba(116,82,63,0.0) 70%,rgba(44,65,68,0.0) 80%,rgba(7,19,31,0.0) 100%`
-//         : `rgba(247,177,72,0) 3%,rgba(248,175,65,0) 6%,rgba(207,62,30,0) 35%,rgba(176,91,48,0) 45%,rgba(141,88,47,0.0) 60%,rgba(116,82,63,0.0) 70%,rgba(44,65,68,0.0) 80%,rgba(7,19,31,0.0) 100%`;
-//     default:
-//       return '';
-//   }
-// }

package/dist/types/src/components/pure/ProjectPageView.test/adapter.d.ts

@@ -1,3 +0,0 @@
-import { ITestAdapter } from "../../../CoreTypes";
-import { I } from "./types";
-export declare const adapter: ITestAdapter<I>;

package/dist/types/testeranto.config.d.ts

@@ -1,3 +0,0 @@
-import { IProject } from "./src/Types";
-declare const config: IProject;
-export default config;

package/docs/testing.ai.txt

@@ -1,106 +0,0 @@
-# Testeranto Testing Patterns
-
-## Key Learnings From Self-Testing
-
-1. Test Organization Insights:
-- Mock implementations proved essential for testing abstract base classes
-- Type parameters (I/O/M) need careful documentation for test writers
-- Integration tests revealed subtle proxy chain issues
-
-2. Effective Patterns:
-- Builder tests validate both construction and runtime behavior  
-- Proxy tests verify path rewriting and content preservation
-- Error tests check both expected and unexpected cases
-- Lifecycle tests cover full BDD sequence
-
-3. Improvement Opportunities:
-- Need more test utilities for common scenarios
-- Could add test generation from type definitions
-- Should document common test pitfalls
-- Would benefit from more example test suites
-
-## Core Testing Principles
-
-1. Tests follow BDD structure with Given/When/Then
-2. All tests are strongly typed using I/O/M types
-3. Test files are organized in a consistent structure:
-   /src
-     TEST_SUBJECT.ts
-     TEST_SUBJECT.test/
-       implementation.ts - Concrete test operations
-       specification.ts - Test scenarios and assertions  
-       interface.ts - Test lifecycle hooks
-       types.ts - Type definitions
-       index.ts - Main test export
-
-## Key Testing Patterns Observed
-
-1. Builder Testing:
-- TestBaseBuilder provides core test infrastructure
-- TestClassBuilder extends it for class-based testing
-- Both use similar test patterns:
-  * Initialization validation
-  * Spec generation checks
-  * Job creation verification
-  * Artifact tracking
-  * Resource requirement validation
-
-2. Comprehensive Test Cases:
-- Basic functionality tests
-- Custom input scenarios  
-- Resource configuration
-- Dynamic modification
-- Error handling
-- Full test run verification
-
-3. Type Safety:
-- Ibdd_in defines internal test flow
-- Ibdd_out defines external interface
-- M type for specification modifications
-
-## Implementation Notes
-
-1. Test builders follow this pattern:
-- Create concrete test implementation
-- Define test specification with scenarios
-- Implement test interface hooks
-- Export via Testeranto runner
-
-2. Key test assertions:
-- Verify proper initialization
-- Check spec generation
-- Validate job creation
-- Track artifacts
-- Confirm resource setup
-
-3. Error handling:
-- Explicit error type checks
-- Expected error messages
-- Async error propagation
-
-4. Features
-- Tests can have one or more "features"
-- "Features" can be strings, uids, or links to features defined elsewhere.
-- "Features" are not unique across tests. 
-
-5. Rationale
-- In a comment block above each test, put a short rationale for the test. 
-
-## Best Practices
-
-1. For each test:
-- Document test purpose in specification
-- Keep implementations focused
-- Use descriptive type names
-- Include positive and negative cases
-
-2. Test organization:
-- Group related tests in suites  
-- Separate concerns in different files
-- Reuse common test patterns
-- Keep test files small and focused
-
-3. Maintenance:
-- Update docs when patterns change
-- Review test types when interfaces change
-- Verify all test cases after refactors