testeranto 0.177.0 → 0.189.0

package/dist/types/types/features.d.ts

@@ -0,0 +1,7 @@
+export type TreeNode = {
+    name: string;
+    type: 'project' | 'file';
+    path?: string;
+    children?: TreeNode[];
+};
+export declare function buildTree(projects: string[]): TreeNode[];

package/dist/types/{src/utils → utils}/api.d.ts

@@ -4,10 +4,6 @@ export declare const fetchProjectData: (projectName: string) => Promise<{
     config: IBuiltConfig;
 }>;
 export declare const fetchTestData: (projectName: string, filepath: string, runTime: string) => Promise<{
-    testData: any | null;
-    logs: string;
-    typeErrors: string;
-    lintErrors: string;
+    logs: Record<string, string>;
     error: string | null;
 }>;
-export declare const fetchBuildLogs: (projectName: string, runtime: string) => Promise<any>;

package/dist/types/utils/featureUtils.d.ts

@@ -0,0 +1,6 @@
+export interface Feature {
+    name: string;
+    status: string;
+}
+export declare const buildTree: (features: Feature[]) => any;
+export declare const renderTree: (nodes: any) => JSX.Element;

package/dist/types/utils/logFiles.d.ts

@@ -0,0 +1,7 @@
+export declare const NODE_LOG_FILES: readonly ["stdout.log", "stderr.log", "exit.log"];
+export declare const WEB_LOG_FILES: readonly ["info.log", "debug.log", "error.log", "warn.log", "exit.log"];
+export declare const PURE_LOG_FILES: readonly ["exit.log"];
+export type NodeLogFile = (typeof NODE_LOG_FILES)[number];
+export type WebLogFile = (typeof WEB_LOG_FILES)[number];
+export type PureLogFile = (typeof PURE_LOG_FILES)[number];
+export declare const getLogFilesForRuntime: (runtime: string) => readonly ["stdout.log", "stderr.log", "exit.log"] | readonly ["info.log", "debug.log", "error.log", "warn.log", "exit.log"] | readonly ["exit.log"];

package/dist/types/utils/makePrompt.d.ts

@@ -0,0 +1,2 @@
+import { IRunTime, ISummary } from "../Types";
+export declare const makePromptInternal: (summary: ISummary, name: string, entryPoint: string, addableFiles: string[], runTime: IRunTime) => Promise<void> | undefined;

package/dist/types/{src/web.html.d.ts → web.html.d.ts}

@@ -1,2 +1,2 @@
-declare const _default: (jsfilePath: string, htmlFilePath: string) => string;
+declare const _default: (jsfilePath: string, htmlFilePath: string, cssfilePath: string) => string;
 export default _default;

package/docs/index.md

@@ -552,6 +552,23 @@ export default Testeranto<
 
 ```
 
+## Explainer Video Development
+
+The Testeranto explainer video is built using:
+
+### Revision.js Animation System
+
+- Frame-by-frame animation control
+- Timeline-based sequencing
+- Audio synchronization
+- Custom easing functions
+
+### Audio Integration
+
+- Voiceover track provides timing cues
+- Sound effects enhance key moments
+- Volume automation for emphasis
+
 ## Trouble shooting
 
 ### Double check your runtimes.

package/docs/testing.prompt.txt

@@ -1,3 +1 @@
-/read docs/index.md docs/testing.ai.txt
-
-/add src/CoreTypes.ts src/lib/types.ts
+/add docs/index.md src/CoreTypes.ts src/lib/types.ts

package/docs.html

@@ -12,7 +12,6 @@
 
     <!-- load style AFTER prism -->
     <link rel="stylesheet" href="style.css">
-
     
     <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/prism.min.js"></script>
     <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-typescript.min.js"></script>
@@ -21,12 +20,13 @@
         document.addEventListener('DOMContentLoaded', function() {
             Prism.highlightAll();
             
-            // Parallax effect
             const parallaxBg = document.querySelector('.parallax-background');
-            window.addEventListener('scroll', function() {
-                const scrollPosition = window.pageYOffset;
-                parallaxBg.style.transform = 'translateY(scrollPosition)';
-            });
+            if (parallaxBg) {
+                window.addEventListener('scroll', function() {
+                    const scrollPosition = window.pageYOffset;
+                    parallaxBg.style.transform = 'translateY(' + scrollPosition + 'px)';
+                });
+            }
         });
     </script>
     
@@ -520,7 +520,22 @@ export default Testeranto<
 );
 
 
-</pre><h2>Trouble shooting</h2>
+</pre><h2>Explainer Video Development</h2>
+<p>The Testeranto explainer video is built using:</p>
+<h3>Revision.js Animation System</h3>
+<ul>
+<li>Frame-by-frame animation control</li>
+<li>Timeline-based sequencing</li>
+<li>Audio synchronization</li>
+<li>Custom easing functions</li>
+</ul>
+<h3>Audio Integration</h3>
+<ul>
+<li>Voiceover track provides timing cues</li>
+<li>Sound effects enhance key moments</li>
+<li>Volume automation for emphasis</li>
+</ul>
+<h2>Trouble shooting</h2>
 <h3>Double check your runtimes.</h3>
 <p>Every test has a runtime, which must defined in 2 places. Both must match.</p>
 <ol>
@@ -535,7 +550,7 @@ export default Testeranto<
                 </div>
             </div>
         
-            <div class="col-xs-0 col-sm-0" col-md-1">
+            <div class="col-xs-0 col-sm-0 col-md-1">
         </div>
     </div>
 
@@ -544,10 +559,13 @@ export default Testeranto<
             <div class="container-fluid justify-content-center">
                 <ul class="nav">
                     <li class="nav-item">
-                        <a class="nav-link" href="/">Home</a>
+                        <a class="nav-link" href="README.html">README</a>
+                    </li>
+                    <li class="nav-item">
+                        <a class="nav-link" href="docs.html">Docs</a>
                     </li>
                     <li class="nav-item">
-                        <a class="nav-link" href="https://github.com/testeranto/testeranto" target="_blank">GitHub</a>
+                        <a class="nav-link" href="https://github.com/adamwong246/testeranto" target="_blank">GitHub</a>
                     </li>
                     <li class="nav-item">
                         <a class="nav-link" href="https://www.npmjs.com/package/testeranto" target="_blank">NPM</a>

package/index.d.ts

@@ -1,19 +1,44 @@
-declare module 'tests.test.js' {
-
-  type ITestTypes = [
-    string,
-    IRunTime,
-    ITestTypes[]
-  ];
-
+declare module "*.test.js" {
+  type ITestTypes = [string, IRunTime, ITestTypes[]];
   const content: ITestTypes[];
   export default content;
 }
 
+// declare module '@revideo/core' {
+//   export function makeScene2D(callback: (view: any) => Generator): any;
+//   export function createRef<T>(): { current: T | null };
+//   export function waitFor(seconds: number): Generator;
+//   export function all(...animations: any[]): any;
+//   export function chain(...animations: any[]): any;
 
-declare module 'features.test.js' {
-  import { TesterantoFeatures } from "./src/Features";
-  const content: TesterantoFeatures;
-  export default content;
-}
+//   export class Txt {
+//     constructor(props: {
+//       text: string;
+//       fill: string;
+//       fontSize: number;
+//       fontFamily: string;
+//     });
+//     scale(x: number, duration: number): any;
+//   }
+// }
+
+// declare module '@revideo/player' {
+//   export class Player {
+//     constructor(config: {
+//       container: string;
+//       width: number;
+//       height: number;
+//       autoplay: boolean;
+//       loop: boolean;
+//       scene: any;
+//     });
+//   }
+// }
 
+interface Window {
+  revideo: {
+    core: typeof import("@revideo/core");
+    player: typeof import("@revideo/player");
+    setupVideoPlayer: (container: string) => Promise<void>;
+  };
+}

package/index.html

@@ -4,7 +4,7 @@
 <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>README.md</title>
+    <title>Testeranto</title>
     
     <!-- Prism.js CSS -->
     <link href="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/themes/prism-tomorrow.min.css" rel="stylesheet" />
@@ -12,7 +12,6 @@
 
     <!-- load style AFTER prism -->
     <link rel="stylesheet" href="style.css">
-
     
     <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/prism.min.js"></script>
     <script src="https://cdnjs.cloudflare.com/ajax/libs/prism/1.29.0/components/prism-typescript.min.js"></script>
@@ -21,12 +20,13 @@
         document.addEventListener('DOMContentLoaded', function() {
             Prism.highlightAll();
             
-            // Parallax effect
             const parallaxBg = document.querySelector('.parallax-background');
-            window.addEventListener('scroll', function() {
-                const scrollPosition = window.pageYOffset;
-                parallaxBg.style.transform = 'translateY(scrollPosition)';
-            });
+            if (parallaxBg) {
+                window.addEventListener('scroll', function() {
+                    const scrollPosition = window.pageYOffset;
+                    parallaxBg.style.transform = 'translateY(' + scrollPosition + 'px)';
+                });
+            }
         });
     </script>
     
@@ -41,213 +41,64 @@
 
             <div class="col-xs-12 col-sm-12 col-md-10">
                 <div id="container">
-                    <h1>testeranto</h1>
-<h2>The AI-powered BDD test framework for TypeScript projects</h2>
-<h4>🚧 Testeranto is still under development but a beta version will be released soon. If you are interested in joining the beta program, send an email to <a href="mailto:testeranto.dev@gmail.com">testeranto.dev@gmail.com</a>. 🚧</h4>
-<h2>quick links</h2>
-<ul>
-<li>an example of the reports generated: <a href="/testeranto/projects.html">adamwong246.github.io/testeranto/testeranto</a></li>
-<li>demo of me using testeranto to fix a bug: <a href="https://www.youtube.com/embed/WvU5xMqGi6Q">youtube</a></li>
-<li>a starter testeranto project: <a href="https://github.com/adamwong246/testeranto-starter">testeranto-starter</a></li>
-</ul>
-<h2>What is testeranto?</h2>
-<ul>
-<li>Testeranto produces test results that can be fed to Aider.ai to automatically fix failing tests.</li>
-<li>Testeranto tests are specified in a strongly-typed gherkin-like syntax. Rather than testing your code directly, Testeranto requires you to wrap your code with a semantic interface that is based on TS type signatures.</li>
-<li>Testeranto can run tests in the frontend, the backend, or both.</li>
-<li>Testeranto can be used to test anything that can be bundled with esbuild.</li>
-<li>Testeranto connects &quot;features&quot; to &quot;tests&quot;. This allows the AI to read feature documentation from external systems, like Jira.</li>
-<li>Testeranto generates test results as a static website that can be easily deployed to GitHub Pages.</li>
-<li>Testeranto uses esbuild to bundle its tests. The result is used to refine the list of files added to the AI&#39;s context. <strong>The consequence of this is that you can fit all relevant files, and only the relevant files, into the LLM&#39;s context.</strong></li>
-</ul>
-<h2>Key Technologies</h2>
-<table>
-<thead>
-<tr>
-<th></th>
-<th></th>
-</tr>
-</thead>
-<tbody><tr>
-<td>ESM</td>
-<td>Modern javascript tooling</td>
-</tr>
-<tr>
-<td>TypeScript</td>
-<td>Strongly-typed test definitions</td>
-</tr>
-<tr>
-<td>Puppeteer</td>
-<td>Cross-runtime testing (Node &amp; Browser)</td>
-</tr>
-<tr>
-<td>esbuild</td>
-<td>Fast test bundling</td>
-</tr>
-<tr>
-<td>Aider.ai</td>
-<td>AI-powered test fixing</td>
-</tr>
-<tr>
-<td>ESLint</td>
-<td>Static analysis of test files</td>
-</tr>
-<tr>
-<td>tsc</td>
-<td>Type checking of test files</td>
-</tr>
-</tbody></table>
-<h2>Quick Start</h2>
-<ol>
-<li>Install testeranto:</li>
-</ol>
-<pre>npm install testeranto</pre><ol start="2">
-<li>Create a test file (e.g., <code>rectangle.test.ts</code>):</li>
-</ol>
-<pre class="language-typescript line-numbers"><code class="language-typescript">import { Given, When, Then } from "testeranto";
-
-type Rectangle = { width: number; height: number };
-
-const RectangleSpec = (Suite, Given, When, Then) => [
-  Suite.Default("Rectangle tests", {
-    test1: Given.Default(
-      ["Basic rectangle operations"],
-      [When.setWidth(5), When.setHeight(10)],
-      [Then.getWidth(5), Then.getHeight(10)]
-    ),
-  }),
-];</code></pre><ol start="3">
-<li>Run the tests</li>
-</ol>
-<p>To start testeranto in dev mode, build your tests in one terminal and execute them in another</p>
-<pre># Terminal 1 - Build in watch mode
-yarn t-build rectangle.test.ts yourProject dev
-
-# Terminal 2 - Run in watch mode
-yarn t-run rectangle.test.ts yourProject dev</pre><p>or build and run your tests only once</p>
-<pre>yarn t-build rectangle.test.ts yourProject once && yarn t-run rectangle.test.ts yourProject once</pre><h2>Runtime Platforms</h2>
-<table>
-<thead>
-<tr>
-<th></th>
-<th>You should use this runtime for...</th>
-<th>Important differences</th>
-</tr>
-</thead>
-<tbody><tr>
-<td><strong>Node</strong> : node V8 with fork</td>
-<td>testing backend code, Node APIs (like <code>fs</code> and <code>crypto</code>), or anything needing filesystem access</td>
-<td>has access to the filesystem and io</td>
-</tr>
-<tr>
-<td><strong>Web</strong> : chrome browser</td>
-<td>testing frontend code, anything that uses <code>document</code> or <code>window</code>, UI interactions, or visual regression</td>
-<td>can take screenshots/recordings</td>
-</tr>
-<tr>
-<td><strong>Pure</strong> : node v8, dynamically imported</td>
-<td>testing code that can run on both node-v8 and the browser</td>
-<td>Very similar to &quot;Node&quot; but has no IO access and thus no console.log. This runtime is theoretically faster.</td>
-</tr>
-</tbody></table>
-<h2>CLI Commands</h2>
-<table>
-<thead>
-<tr>
-<th></th>
-<th></th>
-</tr>
-</thead>
-<tbody><tr>
-<td><code>yarn t-init</code></td>
-<td>Create a new testeranto project</td>
-</tr>
-<tr>
-<td><code>yarn t-build &lt;YOUR_TESTS&gt; dev|once</code></td>
-<td>Build test bundles (watch or single-run mode)</td>
-</tr>
-<tr>
-<td><code>yarn t-run &lt;YOUR_TESTS&gt; dev|once</code></td>
-<td>Run tests (watch or single-run mode)</td>
-</tr>
-<tr>
-<td><code>yarn t-report</code></td>
-<td>Launch test report server</td>
-</tr>
-<tr>
-<td><code>yarn t-aider</code></td>
-<td>Fix failing tests with AI</td>
-</tr>
-</tbody></table>
-<h2>Example workflow:</h2>
-<pre># Initialize project
-yarn t-init
-
-# Write tests in test/*.test.ts
-
-# In terminal 1 - Build tests (watch mode)
-yarn t-build test/rectangle.test.ts dev
-
-# In terminal 2 - Run tests (watch mode)
-yarn t-run test/rectangle.test.ts dev
-
-# Or for single-run mode:
-yarn t-build test/rectangle.test.ts once
-yarn t-run test/rectangle.test.ts once
+                    <div class="hero-section">
+  <div class="container">
+    <div class="row align-items-center">
 
-# Get AI help with failures
-yarn t-aider</pre><h2>Aider</h2>
-<p>Testeranto generates a &quot;prompt&quot; alongside test results. This prompt is passed to aider as input.</p>
-<pre>// input src files that can be edited by Aider
-/add test/node.ts
+      <!-- <div class="col-md-2">
 
-// test report files that inform aider but should not be edited
-/read testeranto/reports/allTests/node/test/node/tests.json
-/read testeranto/reports/allTests/test/node/node/lint_errors.json
-/read testeranto/reports/allTests/test/node/node/type_errors.txt
+      </div> -->
+      <div class="col-md-10">
+        <h1>Testeranto</h1>
+        <h2>The AI-powered BDD test framework for typescript projects</h2>
 
-// A list of features which can inform aider.
-/load testeranto/reports/allTests/node/test/node/featurePrompt.txt
 
-// tell the AI what to do
-Fix the failing tests described in testeranto/reports/allTests/node/test/node/tests.json. Correct any type signature errors described in the files testeranto/reports/allTests/test/node/node/type_errors.txt. Implement any method which throws "Function not implemented. Resolve the lint errors described in testeranto/reports/allTests/test/node/node/lint_errors.json"</pre><h2>&quot;Features&quot;</h2>
-<p>Testeranto connects &quot;features&quot; to tests. The features may be simple strings, but they can also take the form of local markdown files, or remote URLs to external feature tracking systems. For instance, this could be a jira ticket or a github issue. These features are used to inform the AI context.</p>
-<pre class="language-typescript line-numbers"><code class="language-typescript">import someMarkdownFile from "someMarkdownFile.md";
+      </div>
+      <!-- <div class="col-md-12">
 
-...
+        <ul class="cta-buttons">
+          <a href="https://github.com/adamwong246/testeranto" class="btn btn-primary">Star on GitHub</a>
+          <li><a href="README.html">README</a></li>
+          <li><a href="docs/index.html">docs</a></li>
+        </ul>
 
-test0: Given.Default(
-  [
-    "https://api.github.com/repos/adamwong246/testeranto/issues/8",
-    "you can set the width and height of a Rectangle",
-    someMarkdownFile
-    ],
+        <iframe width="420" height="315" src="https://www.youtube.com/embed/tgbNymZ7vqY">
+        </iframe>
+        
+        <video width="320" height="240" controls>
+          <source src="output/project.mp4" type="video/mp4">
 
-  [When.setWidth(4), When.setHeight(19)],
-  [Then.getWidth(4), Then.getHeight(19)]
-),
-...
-</code></pre><h2>eslint and tsc</h2>
-<p>Alongside the BDD tests, Testeranto runs ESLint and tsc on the input files to generate a list of static analysis errors and type errors, respectively. Aider will use this to resolve both.</p>
-<h2>Subprojects</h2>
-<p>Testeranto has a core repo, but there are also sub-projects which implement tests by type and by technology</p>
-<h3>testeranto-solidity</h3>
-<p>Test a solidity contract. Also included is an example of deploying a contract to a ganache server.</p>
-<h3>testeranto-reduxtoolkit</h3>
-<p>Tests a Redux store.</p>
-<h3>testeranto-http</h3>
-<p>Tests a Node HTTP server.</p>
-<h3>testeranto-react (COMING SOON)</h3>
-<p>Test a react component. You can choose from a variety of types (jsx functions, class style, etc) and you can test with <code>react</code>, <code>react-dom</code>, or <code>react-test-renderer</code></p>
-<h3>testeranto-express (COMING SOON)</h3>
-<h3>testeranto-xstate (COMING SOON)</h3>
-<h2>Sidecars (COMING SOON)</h2>
-<p>Alongside your test, you can include a number of &quot;sidecars&quot; - other bundled JavaScript assets upon which your test depends. For example, suppose you have an app with frontend and backend components. You could run a React test in the web and include the Node HTTP server as a sidecar.</p>
+          Your browser does not support the video tag.
+        </video>
+      </div> -->
+    </div>
+  </div>
+</div>
 
+<div class="features-section">
+  <div class="container">
+    <div class="row">
+      <div class="col-md-4 feature-card">
+        <h3>✨ Vibe Coding grows up</h3>
+        <p>Harness the power of LLM generated code with the control of a BDD framework.</p>
+      </div>
+      <div class="col-md-4 feature-card">
+        <h3>🧠 Precision Context</h3>
+        <p>Testeranto tests conserve the LLM's limited context. This means you can get better results out of cheaper
+          models.</p>
+      </div>
+      <div class="col-md-4 feature-card">
+        <h3>🤖 Tests so nice they fix themselves!</h3>
+        <p>When a test fails, just press the magic robot button. Testeranto will call an LLM service with a precise
+          prompt fix it.</p>
+      </div>
+    </div>
+  </div>
+</div>
                 </div>
             </div>
         
-            <div class="col-xs-0 col-sm-0" col-md-1">
+            <div class="col-xs-0 col-sm-0 col-md-1">
         </div>
     </div>
 
@@ -256,10 +107,13 @@ test0: Given.Default(
             <div class="container-fluid justify-content-center">
                 <ul class="nav">
                     <li class="nav-item">
-                        <a class="nav-link" href="/">Home</a>
+                        <a class="nav-link" href="README.html">README</a>
+                    </li>
+                    <li class="nav-item">
+                        <a class="nav-link" href="docs.html">Docs</a>
                     </li>
                     <li class="nav-item">
-                        <a class="nav-link" href="https://github.com/testeranto/testeranto" target="_blank">GitHub</a>
+                        <a class="nav-link" href="https://github.com/adamwong246/testeranto" target="_blank">GitHub</a>
                     </li>
                     <li class="nav-item">
                         <a class="nav-link" href="https://www.npmjs.com/package/testeranto" target="_blank">NPM</a>