tamash-playwright 0.1.0 → 0.3.0

package/LICENSE

@@ -0,0 +1,25 @@
+Copyright (c) 2026 QtpSudhakar / VibeTestQ
+
+All rights reserved.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to use
+the Software for any purpose, including commercial use, subject to the
+following conditions:
+
+1. The Software may not be copied, modified, merged, published, distributed,
+   sublicensed, or sold, in whole or in part, without prior written
+   permission from the copyright holder.
+
+2. The above copyright notice and this permission notice shall be included
+   in all copies of the Software that are permitted under these terms.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+
+For questions or concerns, contact us at support@vibetestq.com.

package/README.md

@@ -1,10 +1,16 @@
 # tamash-playwright
 
-**Self-healing tests for Playwright.**
+`tamash-playwright` is a plug and play self-healing solution for any Playwright test framework. All you need to do is install the package, update your AI API key details, and import `test` from `tamash-playwright`.
 
-When you write an automated test, you tell it exactly where to find things on a webpage — a button, a text box, a link. But websites change all the time. A developer renames a field, moves a button, or tweaks the page layout, and suddenly your test can't find what it's looking for anymore. It fails — even though the feature itself works perfectly fine for real users.
+That's it. No code changes required if you're following standard Playwright best practices.
 
-`tamash-playwright` fixes that. It's a drop-in replacement for `@playwright/test` — you barely change your test code at all. Whenever a test action fails because it can't find something, `tamash-playwright` sends a snapshot of the current page to an AI model, which figures out where the element probably moved to, and tries the action again before giving up. If it finds a good match, your test keeps running like nothing happened. If it can't find anything sensible, your test fails normally — it never pretends something worked when it didn't.
+### Why you need this
+
+Websites change often. A button gets renamed or moved, and your test can't find it anymore — even though the app still works fine for real users. Normally, that just means a broken test.
+
+`tamash-playwright` fixes this automatically. When a test can't find an element, it asks an AI model to find it on the current page and tries again. If it succeeds, your test keeps going. If not, it fails normally, just like before.
+
+Here are the detailed steps to use this package.
 
 ## Step 1: Install it
 
@@ -87,22 +93,46 @@ import { test, expect } from 'tamash-playwright';
 
 test('logs in', async ({ page }) => {
   await page.goto('/');
-  await page.getByPlaceholder('Username').fill('Admin'); // fixed automatically if this breaks
-  await page.getByRole('button', { name: 'Login' }).click();
+  const txtUserName = page.locator('input[name="username"]').describe('User Name Textbox');
+  await txtUserName.fill('testadmin');
+
+  const txtPassword = page.locator('input[placeholder="Password"]').describe('Password Textbox');
+  await txtPassword.fill('secret');
+
+  const btnLogin = page.locator('button[type="submit"]').describe('Login Button');
+  await btnLogin.click();
+
   await expect(page.getByRole('heading', { name: 'Dashboard' })).toBeVisible();
 });
 ```
 
 ### A quick tip for better results
 
-If you're using plain CSS selectors (like `page.locator('input[name="username"]')`) rather than Playwright's more descriptive locators (`getByRole`, `getByPlaceholder`, etc.), it helps to add a short, human-readable label so the healer knows what it's actually looking for:
+If you're using plain CSS selectors (like `page.locator('input[name="username"]')`) rather than Playwright's more descriptive locators (`getByRole`, `getByPlaceholder`, etc.), it helps to add a short, human-readable label so the healer knows what it's actually looking for. Chain `.describe('...')` right onto the locator:
 
 ```ts
-page.locator('input[name="username"]').describe('Username Textbox')
+test('login test using CSS Selectors', async ({ page }) => {
+  await page.goto('https://example.com/auth/login');
+
+  const txtUserName = page.locator('input[name="username"]').describe('User Name Textbox');
+  await txtUserName.fill('testadmin');
+
+  const txtPassword = page.locator('input[placeholder="Password"]').describe('Password Textbox');
+  await txtPassword.fill('secret');
+
+  const btnLogin = page.locator('button[type="submit"]').describe('Login Button');
+  await btnLogin.click();
+
+  await expect(page.locator('h6')).toHaveText('Dashboard');
+});
 ```
 
 This step is optional, but recommended — without it, the healer has to guess purely from a broken CSS selector, which gives it a lot less to work with.
 
 ## License
 
-ISC
+Free to use, including commercially. The source code may not be copied, modified, redistributed, or resold without prior written permission. See [LICENSE](LICENSE) for the full terms.
+
+## Support
+
+For questions or concerns, contact us at support@vibetestq.com.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tamash-playwright",
-  "version": "0.1.0",
-  "description": "Self-healing bindings for Playwright: wraps page/locator/frame actions and automatically recovers broken selectors using an AI model (Ollama, OpenAI, Anthropic, or Gemini).",
+  "version": "0.3.0",
+  "description": "Plug and Play Self-healing for Playwright and automatically recovers broken selectors using an AI model (Ollama, OpenAI, Anthropic, or Gemini).",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
@@ -23,8 +23,8 @@
     "anthropic",
     "gemini"
   ],
-  "author": "",
-  "license": "ISC",
+  "author": "QtpSudhakar / VibeTestQ",
+  "license": "SEE LICENSE IN LICENSE",
   "peerDependencies": {
     "@playwright/test": ">=1.40.0"
   },