testeranto 0.177.0 → 0.189.0

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.189.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,8 +131,7 @@
     "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",
+    "compile-docs": "node scripts/compile-docs.js",
     "prepublish": "self-import"
   },
   "peerDependencies": {
@@ -152,6 +150,8 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.23.0",
+    "@revideo/cli": "0.10.4",
+    "@revideo/ui": "0.10.4",
     "@swc/core": "^1.3.26",
     "@types/express": "^5.0.0",
     "@types/express-session": "^1.18.1",
@@ -170,12 +170,14 @@
     "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",
     "@types/eslint": "^9.6.1",
     "@types/node-static": "^0.7.11",
     "@types/react-router-dom": "^5.3.3",
+    "@types/xmldom": "^0.1.34",
     "@ungap/structured-clone": "^1.3.0",
     "ansi-colors": "^4.1.3",
     "babel-loader": "^8.2.5",
@@ -195,23 +197,29 @@
     "eslint-plugin-react": "^7.31.11",
     "eslint-plugin-react-hooks": "^5.1.0",
     "express": "^4.21.2",
+    "fast-xml-parser": "^5.2.5",
     "fs-extra": "^11.2.0",
     "fs.promises.exists": "^1.1.4",
+    "get-audio-duration": "^4.0.1",
     "mermaid": "^11.8.1",
     "mermaid-isomorphic": "^3.0.4",
     "node-static": "^0.7.11",
+    "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-router-dom": "^7.7.0",
-    "sass": "^1.89.2",
+    "sass": "^1.90.0",
+    "ssml-check": "^0.4.6",
     "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",
+    "xmldom": "^0.6.0"
   }
 }

package/scripts/compile-docs.js

@@ -3,6 +3,7 @@ import path from "path";
 import { marked } from "marked";
 
 import * as sass from 'sass';
+import * as esbuild from 'esbuild';
 
 marked.use({
     renderer: {
@@ -30,7 +31,6 @@ const template = (title, content) => `
 
     <!-- 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>
@@ -39,12 +39,13 @@ const template = (title, content) => `
         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>
     
@@ -63,7 +64,7 @@ const template = (title, content) => `
                 </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>
 
@@ -72,10 +73,13 @@ const template = (title, content) => `
             <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>
@@ -107,7 +111,7 @@ const processFile = (filePath) => {
 };
 
 // Main function
-const main = () => {
+const main = async () => {
     try {
         // Create docs-output directory if it doesn't exist
         const outDir = "./";
@@ -115,12 +119,18 @@ const main = () => {
             fs.mkdirSync(outDir);
         }
 
-        // Process README.md -> documentation.html
-        const readmeHtml = processFile("README.md");
-        fs.writeFileSync(path.join(outDir, "index.html"), readmeHtml);
+
+        // Process frontpage template -> index.html
+        const frontpageContent = fs.readFileSync("src/templates/frontpage.html", "utf8");
+        fs.writeFileSync(path.join(outDir, "index.html"), template("Testeranto", frontpageContent));
         console.log("Generated: index.html");
 
-        // Process docs/index.md -> api-reference.html
+        // Process README.md -> README.html
+        const readmeHtml = processFile("README.md");
+        fs.writeFileSync(path.join(outDir, "README.html"), readmeHtml);
+        console.log("Generated: README.html");
+
+        // Process docs/index.md -> docs.html 
         const docsHtml = processFile("docs/index.md");
         fs.writeFileSync(path.join(outDir, "docs.html"), docsHtml);
         console.log("Generated: docs.html");

package/smil30/SMIL-anim.mod.xsd

@@ -0,0 +1,163 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- ====================================================================== -->
+<!-- SMIL 3.0 Animation Module ============================================ -->
+<!--
+  file: SMIL-anim.mod
+  
+  This is SMIL 3.0.
+  
+        Copyright: 1998-2008 W3C (MIT, ERCIM, Keio), All Rights
+        Reserved.  See http://www.w3.org/Consortium/Legal/.
+  
+        Editor for SMIL 3.0: Sjoerd Mullender, CWI
+        Editor for previous versions of SMIL: Jacco van Ossenbruggen,
+        Sjoerd Mullender.
+        $Revision: 1.7 $
+        $Date: 2008/09/07 20:36:49 $
+  
+     This DTD module is identified by the PUBLIC and SYSTEM identifiers:
+  
+     PUBLIC "-//W3C//ELEMENTS SMIL 3.0 Animation//EN"
+     SYSTEM "http://www.w3.org/2008/SMIL30/SMIL-anim.mod"
+  
+     ======================================================================
+-->
+<!-- ============================= Dependencies =========================== -->
+<!--
+  The integrating profile is expected to define the following entities,
+  Unless the defaults provided are sufficient.
+-->
+<!--
+  SMIL.SplineAnimation.module entity: Define as "INCLUDE" if the
+  integrating profile includes the SMIL 3.0 SplineAnimation Module,
+  "IGNORE" if not.  The default is "IGNORE", i.e. by default
+  SplineAnimation is not included in the integrating language
+  profile.
+-->
+<!--
+  Language Designer chooses to integrate targetElement or XLink
+  attributes.  To integrate the targetElement attribute, define the
+  entity animation-targetElement as "INCLUDE"; to integrate the
+  XLink attributes, define animation-XLinkTarget as "INCLUDE".
+  
+  One or the other MUST be defined.  It is strongly recommended
+  that only one of the two be defined.
+-->
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" xmlns:its="http://www.w3.org/2005/11/its">
+  <xs:import namespace="http://www.w3.org/2005/11/its" schemaLocation="its.xsd"/>
+  <xs:import namespace="http://www.w3.org/XML/1998/namespace" schemaLocation="xml.xsd"/>
+  <xs:attributeGroup name="SMIL.animTargetElementAttr">
+    <xs:attribute name="targetElement" type="xs:IDREF"/>
+  </xs:attributeGroup>
+  <!-- ========================== Attribute Groups ========================== -->
+  <!-- All animation elements include these attributes -->
+  <xs:attributeGroup name="SMIL.animAttrsCommon">
+    <xs:attributeGroup ref="SMIL.Core.attrib"/>
+    <xs:attributeGroup ref="SMIL.I18n.attrib"/>
+    <xs:attributeGroup ref="SMIL.animTargetElementAttr"/>
+  </xs:attributeGroup>
+  <!-- All except animateMotion need an identified target attribute -->
+  <xs:attributeGroup name="SMIL.animAttrsNamedTarget">
+    <xs:attributeGroup ref="SMIL.animAttrsCommon"/>
+    <xs:attribute name="attributeName" use="required" type="xs:NMTOKEN"/>
+    <xs:attribute name="attributeType" default="auto">
+      <xs:simpleType>
+        <xs:restriction base="xs:token">
+          <xs:enumeration value="CSS"/>
+          <xs:enumeration value="XML"/>
+          <xs:enumeration value="auto"/>
+        </xs:restriction>
+      </xs:simpleType>
+    </xs:attribute>
+  </xs:attributeGroup>
+  <!--
+    All except set support the full animation-function specification,
+    additive and cumulative animation.
+    SplineAnimation adds the attributes keyTimes, keySplines and
+    path, and the calcMode value "spline", to those of
+    BasicAnimation.
+  -->
+  <xs:attributeGroup name="SMIL.animValueAttrs">
+    <xs:attributeGroup ref="SMIL.BasicAnimation.attrib"/>
+    <xs:attribute name="calcMode" default="linear">
+      <xs:simpleType>
+        <xs:restriction base="xs:token">
+          <xs:enumeration value="discrete"/>
+          <xs:enumeration value="linear"/>
+          <xs:enumeration value="paced"/>
+        </xs:restriction>
+      </xs:simpleType>
+    </xs:attribute>
+    <xs:attribute name="additive" default="replace">
+      <xs:simpleType>
+        <xs:restriction base="xs:token">
+          <xs:enumeration value="replace"/>
+          <xs:enumeration value="sum"/>
+        </xs:restriction>
+      </xs:simpleType>
+    </xs:attribute>
+    <xs:attribute name="accumulate" default="none">
+      <xs:simpleType>
+        <xs:restriction base="xs:token">
+          <xs:enumeration value="none"/>
+          <xs:enumeration value="sum"/>
+        </xs:restriction>
+      </xs:simpleType>
+    </xs:attribute>
+  </xs:attributeGroup>
+  <!-- ========================== Animation Elements ======================== -->
+  <xs:element name="animate">
+    <xs:complexType>
+      <xs:complexContent>
+        <xs:extension base="SMIL.animate.content">
+          <xs:attributeGroup ref="SMIL.animate.attrib"/>
+          <xs:attributeGroup ref="SMIL.animAttrsNamedTarget"/>
+          <xs:attributeGroup ref="SMIL.animValueAttrs"/>
+        </xs:extension>
+      </xs:complexContent>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="set">
+    <xs:complexType>
+      <xs:complexContent>
+        <xs:extension base="SMIL.set.content">
+          <xs:attributeGroup ref="SMIL.set.attrib"/>
+          <xs:attributeGroup ref="SMIL.animAttrsNamedTarget"/>
+          <xs:attribute name="to"/>
+        </xs:extension>
+      </xs:complexContent>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="animateMotion">
+    <xs:complexType>
+      <xs:complexContent>
+        <xs:extension base="SMIL.animateMotion.content">
+          <xs:attributeGroup ref="SMIL.animateMotion.attrib"/>
+          <xs:attributeGroup ref="SMIL.animAttrsCommon"/>
+          <xs:attributeGroup ref="SMIL.animValueAttrs"/>
+          <xs:attribute name="origin" default="default">
+            <xs:simpleType>
+              <xs:restriction base="xs:token">
+                <xs:enumeration value="default"/>
+              </xs:restriction>
+            </xs:simpleType>
+          </xs:attribute>
+        </xs:extension>
+      </xs:complexContent>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="animateColor">
+    <xs:complexType>
+      <xs:complexContent>
+        <xs:extension base="SMIL.animateColor.content">
+          <xs:attributeGroup ref="SMIL.animateColor.attrib"/>
+          <xs:attributeGroup ref="SMIL.animAttrsNamedTarget"/>
+          <xs:attributeGroup ref="SMIL.animValueAttrs"/>
+        </xs:extension>
+      </xs:complexContent>
+    </xs:complexType>
+  </xs:element>
+</xs:schema>
+<!-- BasicAnimation.module -->
+<!-- ========================== End Animation ============================= -->
+<!-- end of SMIL-anim.mod -->

package/smil30/SMIL-control.mod.xsd

@@ -0,0 +1,73 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- ====================================================================== -->
+<!-- SMIL 3.0 Content Control Module ====================================== -->
+<!--
+  file: SMIL-control.mod
+  
+   This is SMIL 3.0.
+  
+     Copyright: 1998-2008 W3C (MIT, ERCIM, Keio), All Rights
+     Reserved.  See http://www.w3.org/Consortium/Legal/.
+  
+     Editor for SMIL 3.0: Sjoerd Mullender, CWI
+     Editor for previous versions of SMIL: Jacco van Ossenbruggen,
+     Aaron Cohen, Sjoerd Mullender.
+     $Revision: 1.7 $
+     $Date: 2008/09/07 20:36:49 $
+  
+  This DTD module is identified by the PUBLIC and SYSTEM identifiers:
+  
+  PUBLIC "-//W3C//ELEMENTS SMIL 3.0 Content Control//EN"
+  SYSTEM "http://www.w3.org/2008/SMIL30/SMIL-control.mod"
+  
+  ======================================================================
+-->
+<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" xmlns:its="http://www.w3.org/2005/11/its">
+  <xs:import namespace="http://www.w3.org/2005/11/its" schemaLocation="its.xsd"/>
+  <xs:import namespace="http://www.w3.org/XML/1998/namespace" schemaLocation="xml.xsd"/>
+  <xs:element name="switch" substitutionGroup="SMIL.switch-control"/>
+  <!-- ========================= CustomTest Elements ======================== -->
+  <xs:element name="customTest">
+    <xs:complexType>
+      <xs:complexContent>
+        <xs:extension base="SMIL.customTest.content">
+          <xs:attributeGroup ref="SMIL.customTest.attrib"/>
+          <xs:attributeGroup ref="SMIL.Core.attrib"/>
+          <xs:attributeGroup ref="SMIL.I18n.attrib"/>
+          <xs:attribute name="defaultState" default="false">
+            <xs:simpleType>
+              <xs:restriction base="xs:token">
+                <xs:enumeration value="true"/>
+                <xs:enumeration value="false"/>
+              </xs:restriction>
+            </xs:simpleType>
+          </xs:attribute>
+          <xs:attribute name="override" default="hidden">
+            <xs:simpleType>
+              <xs:restriction base="xs:token">
+                <xs:enumeration value="visible"/>
+                <xs:enumeration value="hidden"/>
+              </xs:restriction>
+            </xs:simpleType>
+          </xs:attribute>
+          <xs:attribute name="uid" type="URI.datatype"/>
+        </xs:extension>
+      </xs:complexContent>
+    </xs:complexType>
+  </xs:element>
+  <xs:element name="customAttributes">
+    <xs:complexType>
+      <xs:complexContent>
+        <xs:extension base="SMIL.customAttributes.content">
+          <xs:attributeGroup ref="SMIL.customAttributes.attrib"/>
+          <xs:attributeGroup ref="SMIL.Core.attrib"/>
+          <xs:attributeGroup ref="SMIL.I18n.attrib"/>
+        </xs:extension>
+      </xs:complexContent>
+    </xs:complexType>
+  </xs:element>
+  <!-- end of CustomTestAttributes -->
+  <!-- ========================= PrefetchControl Elements =================== -->
+  <xs:element name="prefetch" substitutionGroup="SMIL.prefetch-control"/>
+</xs:schema>
+<!-- end of SMIL-control.mod -->