testeranto 0.177.0 → 0.197.0

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/test-page-components.md

@@ -0,0 +1,91 @@
+# TestPage and TestPageView Components
+
+## Overview
+These components provide a test results viewing interface that resembles VS Code, using Monaco Editor for code display and editing. The interface is split into three main sections:
+1. Left sidebar: Navigation for logs, source files, and artifacts
+2. Center panel: Monaco Editor for viewing and editing content
+3. Right panel: Test results and artifact previews
+
+## TestPage Component
+The main container component that handles data fetching and state management.
+
+### Key Responsibilities:
+1. **Route Management**: Syncs the active tab with URL hash changes
+2. **Data Fetching**: Retrieves test data, logs, and source files from the server
+3. **State Management**: Maintains loading states, errors, and test metadata
+4. **Source File Organization**: Builds a file tree structure from metafile data
+
+### Props:
+- Uses React Router hooks: `useNavigate`, `useLocation`, `useParams`
+- No explicit props passed from parent components
+
+### State Variables:
+- `route`: Active tab ('results', 'logs', 'types', 'lint', 'coverage')
+- `testName`: Name of the current test
+- `logs`: Collected logs and test data
+- `loading`: Data loading status
+- `error`: Error information
+- `testsExist`: Whether tests exist for this path
+- `errorCounts`: Counts of different error types
+- `summary`: Test summary data
+
+## TestPageView Component
+The presentational component that renders the VS Code-like interface.
+
+### Key Sections:
+1. **Navigation Bar**: Top bar with test name, runtime badge, and AI assistant button
+2. **Sidebar**: File tree navigation for logs, source files, and artifacts
+3. **Editor Panel**: Monaco Editor instance for code viewing/editing
+4. **Preview Panel**: Test results and artifact previews
+
+### Props:
+```typescript
+interface TestPageViewProps {
+  projectName: string;
+  testName: string;
+  decodedTestPath: string;
+  runtime: string;
+  logs: Record<string, string>;
+  testsExist: boolean;
+  errorCounts: {
+    runTimeErrors: number;
+    typeErrors: number;
+    staticErrors: number;
+  };
+}
+```
+
+### Sub-components:
+1. **FileTree**: Recursive component for displaying source file hierarchy
+2. **ArtifactTree**: Recursive component for displaying test artifacts
+3. **LogNavItem**: Navigation items for different log types with status indicators
+4. **TestStatusBadge**: Visual indicator of test status
+
+### Monaco Editor Integration:
+- Uses `@monaco-editor/react` package
+- Supports multiple languages based on file extensions
+- Read-only mode for non-source files
+- Theme-aware (light/dark) based on application theme
+
+## Data Flow
+1. TestPage fetches data on mount using test parameters from URL
+2. Data is processed and organized into a structured format
+3. TestPageView receives processed data and renders the interface
+4. User interactions update the active tab and selected file
+5. Monaco Editor displays the content of selected files
+
+## Future VS Code-like Enhancements
+1. **Multi-tab Editor**: Support opening multiple files in tabs
+2. **File Operations**: Create, rename, delete files in the file tree
+3. **Terminal Integration**: Built-in terminal for command execution
+4. **Git Integration**: Source control indicators and operations
+5. **Extensions**: Plugin system for additional functionality
+6. **Workspace Management**: Save and restore editor layouts
+7. **Command Palette**: Quick access to actions via keyboard
+8. **Settings**: Customizable editor preferences
+
+## Key Dependencies
+- React Router: Navigation and routing
+- Monaco Editor: Code editing functionality
+- React Bootstrap: UI components and layout
+- Custom hooks for WebSocket connections and state management

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/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/marketing.md

@@ -0,0 +1,166 @@
+# Marketing Strategy
+
+## Unique Value Proposition
+
+"Testeranto brings vibe coding to the real world - the only framework that lets you effortlessly maintain flow state while working with large codebases, thanks to AI-powered test fixing with intelligent context optimization."
+
+## Key Differentiators
+
+✨ **Vibe Coding At Scale** - Maintain flow state in large codebases  
+🧠 **Precision Context** - Only what's needed for each fix  
+🤖 **AI-Powered Flow** - Tests fix themselves without breaking your focus  
+🔄 **Write Once, Test Anywhere** - Node/Browser/Pure  
+📝 **Living Documentation** - Requirements stay in sync  
+🛡️ **Type-Safe Flow** - No context switching for type errors
+
+## Target Audiences
+
+1. **TypeScript Developers**
+
+   - Frustrated with test maintenance overhead
+   - Want type-safe BDD at scale
+
+2. **BDD Teams**
+
+   - Need better requirements traceability
+   - Want living documentation
+
+3. **AI Early Adopters**
+
+   - Excited about AI-assisted development
+   - Want to reduce debugging time
+
+4. **Full-Stack Teams**
+   - Need cross-runtime test coverage
+   - Tired of maintaining multiple test suites
+
+## Beta Program Rollout
+
+### Phase 1: Private Beta (GitHub Stargazers)
+
+**Email Template:**
+
+```markdown
+Subject: Exclusive Invite: Testeranto Private Beta Access
+
+Hi [First Name],
+
+We noticed you starred testeranto on GitHub - thank you! We'd love to invite you to join our private beta program where you'll get:
+
+🔧 Early access to AI-powered test fixing
+💬 Lifetime priority support from the core team
+👨‍💻 Personal onboarding assistance from the creator
+🗺️ Direct influence on the product roadmap
+🎁 Exclusive swag + permanent "Pioneer" badge
+
+To join:
+
+1. Reply to this email to confirm interest
+2. We'll send your private invite code
+3. Join our beta Discord for support
+
+The beta includes:
+
+- Full access to testeranto + Aider integration
+- Weekly 1:1 office hours with me (Adam)
+- Lifetime priority support for your projects
+- Personal assistance integrating testeranto
+- Early documentation and examples
+- Permanent "Beta Pioneer" status
+
+We're limiting this first wave to 100 developers. Let us know if you'd like to participate!
+
+Cheers,
+The Testeranto Team
+```
+
+- [x] Identify top 100 stargazers
+- [ ] Personalized email invitations
+- [ ] Private Discord channel
+- [ ] Weekly office hours
+- [ ] Exclusive early-access docs
+
+### Phase 2: Public Beta (Reddit/HN)
+
+**Reddit/HN Announcement Draft:**
+
+```markdown
+Title: Testeranto Public Beta: The AI-Powered Test Framework That Fixes Itself
+
+After a successful private beta with 100+ GitHub stargazers, we're opening up testeranto to the public!
+
+What makes testeranto unique:
+✨ **Vibe Coding For Real Projects**
+
+- Stay in flow state even in large codebases
+- AI handles test maintenance without breaking focus
+- Context optimized for minimal distractions
+
+🧠 **Precision Context Engine**
+
+- Esbuild-powered dependency analysis
+- Just the files/docs/types needed
+- Preserves your mental model
+
+🤖 **AI That Understands Flow**
+
+- Fixes tests without context switching
+- Learns your coding style
+- Respects your thought process
+
+We've already seen:
+
+- 70% reduction in test maintenance time (case study)
+- 5x faster test creation for BDD workflows
+- Seamless cross-runtime testing
+
+Try it now:
+
+1. `npm install testeranto@beta`
+2. Check our starter project: [github.com/adamwong246/testeranto-starter]
+3. Join our "Fix My Tests" challenge with $500 in prizes
+
+HN/Reddit special: First 50 signups get free 1:1 onboarding!
+
+FAQ:
+Q: How does the AI fixing work?
+A: Testeranto generates detailed prompts that Aider uses to suggest fixes.
+
+Q: What about type safety?
+A: Full TypeScript support with runtime type checking.
+
+Q: Can I test frontend and backend together?
+A: Yes! Our cross-runtime testing is unique in the JS ecosystem.
+```
+
+- [ ] Technical write-up on AI-assisted testing
+- [ ] Showcase success stories from private beta
+- [ ] "Fix My Tests" community challenge ($500 prize pool)
+- [ ] Public bug bounty program ($20 per verified bug)
+
+## Marketing Channels
+
+1. **Content Marketing**
+
+   - [ ] Case study: "70% reduction in test maintenance"
+   - [ ] Interactive explainer video (JS-based)
+   - [ ] Screen-recorded demo: AI fixing tests in real-time
+   - [ ] Framework comparison whitepaper
+
+2. **Community Growth**
+
+   - [ ] "Testeranto Champions" early adopter program
+   - [ ] Monthly hackathons with prizes
+   - [ ] Curated examples gallery
+
+3. **Technical Outreach**
+   - [ ] Conference talks on AI-assisted testing
+   - [ ] Deep-dive blog series on architecture
+   - [ ] Performance benchmarks vs competitors
+
+## Success Metrics
+
+- GitHub stars growth rate
+- npm download trends
+- Case study conversions
+- Community engagement metrics

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "testeranto",
   "description": "the AI powered BDD test framework for typescript projects",
-  "version": "0.177.0",
+  "version": "0.197.0",
   "engines": {
     "node": "18.18.0"
   },
@@ -118,8 +118,7 @@
     "ATDD"
   ],
   "scripts": {
-    "build-hard": "rm -rf testeranto/**; rm -rf dist/**; yarn build; yarn t-init; yarn t-build allTests once; cp dist/prebuild/Project.* testeranto; cp dist/prebuild/TestReport.* testeranto; node scripts/compile-docs.js; yarn type-check",
-    "doit": "rm -rf node_modules && yarn install && yarn build",
+    "build-hard": "rm -rf testeranto/** && yarn build && yarn type-check; yarn t-init; cp dist/prebuild/App.*  testeranto; yarn t-build core once; yarn t-run core once",
     "build": "sh prebuild.sh; cp ./src/cjs-shim.js ./dist/cjs-shim.js; tsc -p tsconfig.module.json; tsc -p tsconfig.common.json; tsc -p tsconfig.types.json; sh postBuild.sh; yarn bundle",
     "dev": "sh prebuild.sh;  cp ./src/cjs-shim.js ./dist/cjs-shim.js; sh postBuild.sh; tsc -p tsconfig.module.json --watch & tsc -p tsconfig.common.json --watch  ",
     "bundle": "node bundle.js",
@@ -132,9 +131,9 @@
     "t-run": "tsx src/run.ts",
     "t-init": "tsx dist/prebuild/init-docs.mjs",
     "t-report": "tsx dist/prebuild/ReportServer.mjs",
-    "build-docs": "node scripts/compile-docs.js",
-    "do_it": "clear && rm -rf testeranto/** && yarn build && yarn t-init && yarn t-build allTests once && yarn t-run allTests once && yarn build-docs && yarn type-check",
-    "prepublish": "self-import"
+    "compile-docs": "node scripts/compile-docs.js",
+    "prepublish": "self-import",
+    "summarizeLicenses": "yarn licenses list > ALL_LICENSES.txt; yarn license-checker >> ALL_LICENSES.txt; yarn license-checker --summary >> ALL_LICENSES.txt"
   },
   "peerDependencies": {
     "@types/react": "18.2.0",
@@ -160,26 +159,33 @@
     "@types/react-dom": "18.2.0",
     "@types/react-test-renderer": "19.0.0",
     "@types/uuid": "^10.0.0",
-    "@types/ws": "^8.5.10",
+    "@types/ws": "^8.18.1",
     "@typescript-eslint/eslint-plugin": "^5.46.0",
     "@typescript-eslint/parser": "^5.46.0",
-    "marked": "^12.0.2",
     "self-import": "*",
     "testeranto-react": "0.0.8",
     "ts-node": "^10.9.1",
     "typescript": "^5.8.2"
   },
   "dependencies": {
+    "@aws-sdk/client-polly": "^3.864.0",
     "@bscotch/debounce-watch": "^1.1.0",
     "@humanwhocodes/config-array": "^0.13.0",
     "@jest/globals": "^30.0.4",
+    "@monaco-editor/react": "^4.7.0",
     "@types/eslint": "^9.6.1",
+    "@types/fabric": "^5.3.10",
+    "@types/file-saver": "^2.0.7",
     "@types/node-static": "^0.7.11",
     "@types/react-router-dom": "^5.3.3",
+    "@types/xmldom": "^0.1.34",
     "@ungap/structured-clone": "^1.3.0",
+    "@xterm/addon-fit": "^0.10.0",
     "ansi-colors": "^4.1.3",
+    "axios": "^1.11.0",
     "babel-loader": "^8.2.5",
-    "bootstrap": "^5.3.4",
+    "bootstrap": "^5.3.7",
+    "bootstrap-icons": "^1.13.1",
     "chai": "^5.2.0",
     "chromium": "^3.0.3",
     "dynamic-base": "^1.1.2",
@@ -195,23 +201,44 @@
     "eslint-plugin-react": "^7.31.11",
     "eslint-plugin-react-hooks": "^5.1.0",
     "express": "^4.21.2",
+    "fabric": "6.7.1",
+    "fast-xml-parser": "^5.2.5",
+    "file-saver": "^2.0.5",
     "fs-extra": "^11.2.0",
     "fs.promises.exists": "^1.1.4",
+    "get-audio-duration": "^4.0.1",
+    "html-to-image": "^1.11.13",
+    "license-checker": "^25.0.1",
     "mermaid": "^11.8.1",
     "mermaid-isomorphic": "^3.0.4",
+    "micromark": "^4.0.2",
+    "micromark-extension-gfm-table": "^2.1.1",
+    "monaco-editor": "^0.45.0",
     "node-static": "^0.7.11",
+    "octokit": "^5.0.3",
+    "openai": "^5.12.2",
     "puppeteer": "^24.4.0",
     "puppeteer-core": "24.4.0",
     "react": "18.2.0",
     "react-bootstrap": "^2.10.9",
     "react-dom": "18.2.0",
+    "react-draggable": "^4.5.0",
+    "react-resizable": "^3.0.5",
     "react-router-dom": "^7.7.0",
-    "sass": "^1.89.2",
+    "sass": "^1.90.0",
+    "ssml-check": "^0.4.6",
+    "testeranto-stilo": "0.0.7",
     "tsc-prog": "^2.3.0",
     "tsx": "^4.19.3",
     "type-fest": "^4.41.0",
     "typescript-eslint": "^8.29.1",
     "url": "^0.11.4",
-    "uuid": "^10.0.0"
+    "uuid": "^10.0.0",
+    "validate-with-xmllint": "^1.2.1",
+    "ws": "^8.18.3",
+    "xmldom": "^0.6.0",
+    "xterm": "^5.3.0",
+    "xterm-addon-fit": "^0.8.0",
+    "xterm-react": "^1.0.0"
   }
 }

package/src/App.tsx

@@ -1,43 +1,40 @@
-/* eslint-disable @typescript-eslint/no-unused-vars */
-
 import React from 'react';
 import ReactDom from "react-dom/client";
 import { HashRouter as Router, Routes, Route } from 'react-router-dom';
 
 import { TestPage } from './components/stateful/TestPage';
-import { Container } from 'react-bootstrap';
-import { SettingsButton } from './SettingsButton';
 import { ProjectPage } from './components/stateful/ProjectPage';
 import { ProjectsPage } from './components/stateful/ProjectsPage';
+import { AppFrame } from './components/pure/AppFrame';
+import { FeaturesReporter } from './components/stateful/FeaturesReporter';
+import { DesignEditorPage } from './components/DesignEditorPage';
+import { TextEditorPage } from './components/stateful/TextEditorPage';
+import { ProcessManagerPage } from './components/stateful/ProcessManagerPage';
+import { SingleProcessPage } from './components/stateful/SingleProcessPage';
+import { SettingsPage } from './components/stateful/SettingsPage';
+
 
 export const App = () => {
   return (
     <Router>
-      <div className="d-flex flex-column min-vh-100" key={window.location.pathname}>
-        <main className="flex-grow-1 p-3">
-          <Container fluid>
-            <Routes>
-              <Route path="/" element={<ProjectsPage />} />
-              <Route path="/projects/:projectName" element={<ProjectPage />} />
-              <Route path="/projects/:projectName/tests/*" element={<TestPage />} />
-              <Route path="/projects/:projectName#:tab" element={<ProjectPage />} />
-            </Routes>
-          </Container>
-        </main>
-        <footer className="bg-light py-3 d-flex justify-content-between align-items-center">
-          <div className="ms-3">
-            <SettingsButton />
-          </div>
-          <Container className="text-end" fluid={true}>
-            made with ❤️ and <a href="https://www.npmjs.com/package/testeranto">testeranto</a>
-          </Container>
-        </footer>
-      </div>
+      <AppFrame>
+        <Routes>
+          <Route path="/" element={<ProjectsPage />} />
+          <Route path="/projects/:projectName" element={<ProjectPage />} />
+          <Route path="/projects/:projectName/tests/*" element={<TestPage />} />
+          <Route path="/projects/:projectName#:tab" element={<ProjectPage />} />
+          <Route path="/features-reporter" element={<FeaturesReporter />} />
+          <Route path="/design-editor" element={<DesignEditorPage />} />
+          <Route path="/text-editor" element={<TextEditorPage />} />
+          <Route path="/processes" element={<ProcessManagerPage />} />
+          <Route path="/processes/:processId" element={<SingleProcessPage />} />
+          <Route path="/settings" element={<SettingsPage />} />
+        </Routes>
+      </AppFrame>
     </Router>
   );
 };
 
-
 // Export App to global scope
 function initApp() {
   const rootElement = document.getElementById('root');

package/src/Node.ts

@@ -1,7 +1,6 @@
 import Testeranto from "./lib/core.js";
 import {
   defaultTestResourceRequirement,
-  ITTestResourceConfiguration,
   ITTestResourceRequest,
 } from "./lib/index.js";
 import { PM_Node } from "./PM/node.js";
@@ -41,10 +40,9 @@ export class NodeTesteranto<
   }
 
   async receiveTestResourceConfig(partialTestResource: string) {
-    console.log("receiveTestResourceConfig", partialTestResource);
-    const t: ITTestResourceConfiguration = JSON.parse(partialTestResource);
-    const pm = new PM_Node(t, ipcfile);
-    return await this.testJobs[0].receiveTestResourceConfig(pm);
+    return await this.testJobs[0].receiveTestResourceConfig(
+      new PM_Node(JSON.parse(partialTestResource), ipcfile)
+    );
   }
 }
 
@@ -71,12 +69,11 @@ const testeranto = async <I extends Ibdd_in_any, O extends Ibdd_out, M>(
     });
 
     ipcfile = process.argv[3];
-    const f = await t.receiveTestResourceConfig(process.argv[2]);
 
-    console.error("goodbye node with failures", f.fails);
-    process.exit(f.fails);
+    process.exit((await t.receiveTestResourceConfig(process.argv[2])).fails);
   } catch (e) {
-    console.error("goodbye node with caught error", e);
+    console.error(e);
+    console.error(e.stack);
     process.exit(-1);
   }
 };