@lowdefy/e2e-utils 4.7.0 → 4.7.2

package/dist/core/navigation.js

@@ -24,14 +24,21 @@ async function waitForReady(page) {
     });
 }
 async function goto(page, path) {
-    await page.goto(path);
+    // domcontentloaded is sufficient — waitForReady gates on the Lowdefy client
+    // context, which is a stronger readiness signal than the browser 'load' event.
+    // Using 'load' can hang when pages have WebSocket connections or slow resources.
+    await page.goto(path, {
+        waitUntil: 'domcontentloaded'
+    });
     await waitForReady(page);
 }
 async function expectNavigation(page, urlPattern) {
     await expect(page).toHaveURL(urlPattern);
 }
 async function waitForPage(page, path) {
-    await page.waitForURL(path);
+    await page.waitForURL(path, {
+        waitUntil: 'domcontentloaded'
+    });
     await waitForReady(page);
 }
 export { goto, waitForReady, expectNavigation, waitForPage };

package/dist/init/index.js

@@ -13,12 +13,22 @@
   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   See the License for the specific language governing permissions and
   limitations under the License.
-*/ /* eslint-disable no-console */ import path from 'path';
+*/ /* eslint-disable no-console */ import fs from 'fs';
+import path from 'path';
 import prompts from 'prompts';
 import detectApps from './detectApps.js';
 import generateFiles from './generateFiles.js';
-import installDeps, { detectPackageManager } from './installDeps.js';
 import updateGitignore from './updateGitignore.js';
+function detectPackageManager(cwd) {
+    let dir = cwd;
+    while(dir !== path.dirname(dir)){
+        if (fs.existsSync(path.join(dir, 'pnpm-lock.yaml'))) return 'pnpm';
+        if (fs.existsSync(path.join(dir, 'yarn.lock'))) return 'yarn';
+        if (fs.existsSync(path.join(dir, 'package-lock.json'))) return 'npm';
+        dir = path.dirname(dir);
+    }
+    return 'npm';
+}
 async function init() {
     const cwd = process.cwd();
     console.log('Setting up Lowdefy e2e testing...\n');
@@ -106,59 +116,40 @@ async function init() {
     }
     // Step 6: Update .gitignore
     updateGitignore(cwd);
-    // Step 7: Ask about dependency installation
-    const installResponse = await prompts({
-        type: 'confirm',
-        name: 'install',
-        message: 'Would you like to run install now?',
-        initial: true
-    });
-    // Handle Ctrl+C
-    if (installResponse.install === undefined) {
-        console.log('\nSetup cancelled.');
-        process.exit(0);
+    // Step 7: Print completion summary and next steps
+    console.log('\n✓ E2E testing setup complete!\n');
+    console.log('Next steps:\n');
+    let step = 1;
+    // Install instructions
+    const packageManager = detectPackageManager(cwd);
+    console.log(`  ${step}. Install dependencies:`);
+    if (selectedApps.length === 1) {
+        console.log(`     cd ${selectedApps[0].path}`);
     }
-    if (installResponse.install) {
-        // Step 8: Install dependencies for each selected app
-        for (const app of selectedApps){
-            const appDir = path.join(cwd, app.path);
-            installDeps({
-                appDir
-            });
-        }
-    } else {
-        // Print manual install instructions per app
-        for (const app of selectedApps){
-            const packageManager = detectPackageManager(path.join(cwd, app.path));
-            console.log(`\nTo install dependencies manually in ${app.path}:`);
-            console.log(`  cd ${app.path}`);
-            console.log(`  ${packageManager} install`);
-            console.log('  npx playwright install chromium');
-        }
+    console.log(`     ${packageManager} install`);
+    console.log('     npx playwright install chromium');
+    step += 1;
+    // MongoDB setup
+    if (useMongoDB) {
+        console.log(`\n  ${step}. Configure MongoDB testing:`);
+        console.log('     Copy .env.e2e to .env.e2e.local');
+        console.log('     Set LOWDEFY_E2E_MONGODB_URI to your test database');
+        console.log('     See mongodb.spec.js for example tests');
+        step += 1;
     }
-    // Step 9: Print completion summary
-    console.log('\n✓ E2E testing setup complete!\n');
+    // Run tests
+    console.log(`\n  ${step}. Run tests:`);
     if (selectedApps.length === 1) {
-        const app = selectedApps[0];
-        console.log(`Run tests from ${app.path}:`);
-        console.log(`  cd ${app.path}`);
-        console.log('  pnpm e2e            # Run all tests');
-        console.log('  pnpm e2e:headed     # Run with visible browser');
-        console.log('  pnpm e2e:ui         # Playwright UI mode');
-        console.log('  pnpm e2e:server     # Start server for reuse');
+        console.log(`     cd ${selectedApps[0].path}`);
+        console.log('     pnpm e2e            # Run all tests');
+        console.log('     pnpm e2e:headed     # Run with visible browser');
+        console.log('     pnpm e2e:ui         # Playwright UI mode');
+        console.log('     pnpm e2e:server     # Start server for reuse');
     } else {
-        console.log('Run tests from each app directory:');
         for (const app of selectedApps){
-            console.log(`\n  ${app.name}:`);
-            console.log(`    cd ${app.path} && pnpm e2e`);
+            console.log(`     cd ${app.path} && pnpm e2e`);
         }
     }
-    if (useMongoDB) {
-        console.log('\nMongoDB testing setup:');
-        console.log('  1. Copy .env.e2e to .env.e2e.local');
-        console.log('  2. Set MDB_E2E_URI to your test database');
-        console.log('  3. See mongodb.spec.js for example tests');
-    }
 }
 init().catch((err)=>{
     console.error('Error:', err.message);

package/dist/init/templates/README.md.template

@@ -324,7 +324,7 @@ Copy `.env.e2e` to `.env.e2e.local` and set your values:
 cp e2e/.env.e2e e2e/.env.e2e.local
 ```
 
-For MongoDB testing, set `MDB_E2E_URI` to a dedicated test database (data will be cleared during tests).
+For MongoDB testing, set `LOWDEFY_E2E_MONGODB_URI` to a dedicated test database (data will be cleared during tests). If using `@lowdefy/community-plugin-e2e-mdb` with `configureMdb()`, the URI is set automatically.
 
 ## More Information
 

package/dist/init/templates/env.e2e.template

@@ -1,4 +1,4 @@
 # MongoDB E2E Testing Configuration
 # Copy this file to .env.e2e.local and fill in your test database URI
 
-MDB_E2E_URI=mongodb://localhost:27017/your-test-db
+LOWDEFY_E2E_MONGODB_URI=mongodb://localhost:27017/your-test-db

package/dist/proxy/createBlockHelper.js

@@ -14,6 +14,13 @@
   limitations under the License.
 */ import { expect } from '@playwright/test';
 import { expectValidationError, expectValidationWarning, expectValidationSuccess } from '../core/validation.js';
+// Each block's e2e helper defines a `locator` function that targets the block element on the page.
+// Two locator patterns exist:
+//   - `#${escapeId(blockId)}` — for blocks that render `id={blockId}` on their root DOM element
+//     (e.g. AgGrid variants, ProgressBar, Markdown variants, QRScanner).
+//   - `#bl-${escapeId(blockId)}` — for blocks whose root element does not carry the blockId;
+//     targets the Lowdefy layout wrapper div instead
+//     (e.g. Skeleton variants, Spinner, EChart, DocSearch, ColorSelector, GoogleMaps variants).
 function createBlockHelper({ locator, do: doMethods, get: getMethods, expect: expectOverrides }) {
     const commonExpect = {
         visible: (page, blockId)=>expect(locator(page, blockId)).toBeVisible(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/e2e-utils",
-  "version": "4.7.0",
+  "version": "4.7.2",
   "license": "Apache-2.0",
   "description": "Lowdefy E2E Testing Utilities for Playwright",
   "homepage": "https://lowdefy.com",
@@ -36,7 +36,7 @@
     "dist/*"
   ],
   "dependencies": {
-    "@lowdefy/helpers": "4.7.0",
+    "@lowdefy/helpers": "4.7.2",
     "js-yaml": "4.1.0",
     "prompts": "2.4.2"
   },

package/dist/init/installDeps.js

@@ -1,62 +0,0 @@
-/*
-  Copyright 2020-2026 Lowdefy, Inc
-
-  Licensed under the Apache License, Version 2.0 (the "License");
-  you may not use this file except in compliance with the License.
-  You may obtain a copy of the License at
-
-      http://www.apache.org/licenses/LICENSE-2.0
-
-  Unless required by applicable law or agreed to in writing, software
-  distributed under the License is distributed on an "AS IS" BASIS,
-  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-  See the License for the specific language governing permissions and
-  limitations under the License.
-*/ /* eslint-disable no-console */ import fs from 'fs';
-import path from 'path';
-import { execSync } from 'child_process';
-function detectPackageManager(cwd) {
-    // Walk up from cwd to find the lock file
-    let dir = cwd;
-    while(dir !== path.dirname(dir)){
-        if (fs.existsSync(path.join(dir, 'pnpm-lock.yaml'))) return 'pnpm';
-        if (fs.existsSync(path.join(dir, 'yarn.lock'))) return 'yarn';
-        if (fs.existsSync(path.join(dir, 'package-lock.json'))) return 'npm';
-        dir = path.dirname(dir);
-    }
-    return 'npm';
-}
-function installDeps({ appDir }) {
-    const packageManager = detectPackageManager(appDir);
-    const installCmd = `${packageManager} install`;
-    console.log(`\nInstalling dependencies in ${appDir}...`);
-    console.log(`  $ ${installCmd}\n`);
-    try {
-        execSync(installCmd, {
-            cwd: appDir,
-            stdio: 'inherit'
-        });
-        console.log('\n✓ Dependencies installed successfully');
-    } catch  {
-        console.error('\n✗ Failed to install dependencies automatically');
-        console.log(`\nInstall manually from ${appDir}:`);
-        console.log(`  ${installCmd}`);
-        console.log('  npx playwright install chromium');
-        return false;
-    }
-    console.log('\nInstalling Playwright browsers...');
-    console.log('  $ npx playwright install chromium\n');
-    try {
-        execSync('npx playwright install chromium', {
-            cwd: appDir,
-            stdio: 'inherit'
-        });
-        console.log('\n✓ Playwright browsers installed');
-    } catch  {
-        console.error('\n✗ Failed to install Playwright browsers');
-        console.error('  Run manually: npx playwright install chromium');
-    }
-    return true;
-}
-export { detectPackageManager };
-export default installDeps;