cstesting 0.1.0

package/README.md

@@ -0,0 +1,174 @@
+# CSTesting
+
+A simple, extensible **Node.js testing framework**. Start with a test runner and assertions (like a minimal Jest/Mocha), plus CDP-based browser automation (no Playwright/Cypress).
+
+## For end users — install and run
+
+```bash
+# Install in your project
+npm install cstesting
+
+# Run tests (discovers *.test.js / *.spec.js)
+npx cstesting
+npx cstesting "**/*.test.js"
+npx cst
+```
+
+Use in code: `const { describe, it, expect, createBrowser } = require('cstesting');`
+
+## Quick Start
+
+1. **Create a test file** (e.g. `math.test.js`):
+
+```js
+const { describe, it, expect } = require('cstesting');
+
+describe('Math', () => {
+  it('adds numbers', () => {
+    expect(1 + 1).toBe(2);
+  });
+
+  it('compares objects', () => {
+    expect({ a: 1 }).toEqual({ a: 1 });
+  });
+});
+```
+
+2. **Run tests**:
+
+```bash
+npx cstesting
+# or
+npx cstesting "**/*.test.js"
+npx cstesting tests/
+```
+
+## API
+
+### Test structure
+
+- **`describe(name, fn)`** — define a suite (nested suites supported)
+- **`it(name, fn)`** — define a test (async supported)
+- **`describe.only` / `it.only`** — run only this suite/test
+- **`describe.skip` / `it.skip`** — skip this suite/test
+
+### Hooks
+
+- **`beforeAll(fn)`** — run once before all tests in the suite
+- **`afterAll(fn)`** — run once after all tests in the suite
+- **`beforeEach(fn)`** — run before each test
+- **`afterEach(fn)`** — run after each test
+
+### Assertions (`expect(value)`)
+
+| Matcher | Example |
+|--------|--------|
+| `toBe(expected)` | strict equality (`Object.is`) |
+| `toEqual(expected)` | deep equality (JSON) |
+| `toBeTruthy()` / `toBeFalsy()` | boolean check |
+| `toBeNull()` / `toBeDefined()` / `toBeUndefined()` | null/undefined |
+| `toThrow(message?)` | expect(fn).toThrow() |
+| `toBeGreaterThan(n)` / `toBeLessThan(n)` | numbers |
+| `toContain(item)` | arrays and strings |
+| `toHaveLength(n)` | length |
+| `expect(x).not.toBe(y)` | negate any matcher |
+
+## Programmatic usage
+
+```js
+const { describe, it, expect, run } = require('cstesting');
+
+describe('My tests', () => {
+  it('works', () => {
+    expect(1).toBe(1);
+  });
+});
+
+run().then((result) => {
+  console.log(result); // { passed, failed, skipped, total, duration, errors }
+});
+```
+
+## Browser automation (no Playwright/Cypress)
+
+EasyTesting includes a **CDP-based** browser API using the [Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/) via `chrome-remote-interface` and `chrome-launcher`. No Playwright or Cypress — just Chrome (or Chromium) and Node.
+
+**Requirements:** Chrome or Chromium installed (the same binary Puppeteer uses; `chrome-launcher` finds it).
+
+```js
+const { createBrowser, describe, it, expect, beforeAll, afterAll } = require('cstesting');
+
+describe('My site', () => {
+  let browser;
+
+  beforeAll(async () => {
+    browser = await createBrowser({ headless: true });
+  });
+
+  afterAll(async () => {
+    await browser.close();
+  });
+
+  it('loads the page', async () => {
+    await browser.goto('https://example.com');
+    const html = await browser.content();
+    expect(html).toContain('Example Domain');
+  });
+
+  it('clicks and types', async () => {
+    await browser.goto('https://example.com');
+    await browser.click('a');           // click first link
+    await browser.type('input', 'hi');  // type into first input
+  });
+});
+```
+
+### Browser API
+
+| Method | Description |
+|--------|-------------|
+| `createBrowser(options?)` | Launch Chrome (or connect to existing `port`). Returns a browser object. |
+| `browser.goto(url)` | Navigate to URL (waits for load). |
+| `browser.click(selector)` | Click element matching CSS `selector`. |
+| `browser.type(selector, text)` | Focus and type into element. |
+| `browser.pressKey(key)` | Press a key (e.g. `'Enter'`). |
+| `browser.waitForLoad()` | Wait for the next page load (e.g. after form submit). |
+| `browser.content()` | Return page HTML. |
+| `browser.evaluate(expression)` | Run JS in the page and return the value. |
+| `browser.close()` | Close the browser. |
+
+**Options for `createBrowser({ ... })`:**
+
+- `headless` (default: `true`) — run without a visible window
+- `port` — use an existing Chrome with `--remote-debugging-port=9222` instead of launching
+- `args` — extra Chrome flags (e.g. `['--disable-web-security']`)
+- `userDataDir` — custom Chrome profile path (avoids Windows EPERM on default temp folder)
+
+**Windows EPERM / Permission denied:** If you see `EPERM, Permission denied` on a `lighthouse.xxxxx` temp path, the launcher now uses a custom profile dir under your project (`node_modules/.cache/`) or `os.tmpdir()` instead of the default. You can also set `userDataDir` to a path you control, e.g. `createBrowser({ userDataDir: 'C:\\MyChromeProfile' })`.
+
+## Roadmap (improve after publish)
+
+1. **Browser automation** — Done. CDP-based `browser.goto()`, `click()`, `type()` (no Playwright/Cypress).
+2. **DOM / jsdom** — Add optional `cstesting-dom` for testing DOM in Node without a browser.
+3. **More browser APIs** — `waitForSelector`, screenshots, multiple tabs.
+4. **Reporters** — JSON, JUnit XML, HTML report for CI and dashboards.
+5. **Watch mode** — Re-run tests on file changes.
+6. **Coverage** — Optional integration with Istanbul/c8.
+7. **More matchers** — `toMatchObject`, `toMatch(regex)`, `resolves`/`rejects` for promises.
+8. **Timeouts** — Per-test and global timeouts.
+9. **Parallel runs** — Run test files in parallel (with care for shared resources).
+
+## Development
+
+From the repo root:
+
+```bash
+npm install
+npm run build
+npm install .          # install this package into node_modules so example can require('cstesting')
+npm run test:example   # run example tests
+```
+
+## License
+
+MIT

package/dist/assertions.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Simple assertion library (expect-style API).
+ * Similar to Jest/Cypress expect — extend later with matchers.
+ */
+export declare class AssertionError extends Error {
+    readonly expected?: unknown | undefined;
+    readonly actual?: unknown | undefined;
+    constructor(message: string, expected?: unknown | undefined, actual?: unknown | undefined);
+}
+export interface ExpectApi {
+    toBe(expected: unknown): void;
+    toEqual(expected: unknown): void;
+    toBeTruthy(): void;
+    toBeFalsy(): void;
+    toBeNull(): void;
+    toBeDefined(): void;
+    toBeUndefined(): void;
+    toThrow(expectedMessage?: string | RegExp): void;
+    toBeGreaterThan(n: number): void;
+    toBeLessThan(n: number): void;
+    toContain(item: unknown): void;
+    toHaveLength(n: number): void;
+    not: ExpectApi;
+}
+/**
+ * Expect API — use in tests: expect(value).toBe(3), expect(fn).toThrow(), etc.
+ */
+export declare function expect(actual: unknown): ExpectApi;
+//# sourceMappingURL=assertions.d.ts.map

package/dist/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../src/assertions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qBAAa,cAAe,SAAQ,KAAK;aAGrB,QAAQ,CAAC,EAAE,OAAO;aAClB,MAAM,CAAC,EAAE,OAAO;gBAFhC,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,EAAE,OAAO,YAAA,EAClB,MAAM,CAAC,EAAE,OAAO,YAAA;CAMnC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,OAAO,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACjC,UAAU,IAAI,IAAI,CAAC;IACnB,SAAS,IAAI,IAAI,CAAC;IAClB,QAAQ,IAAI,IAAI,CAAC;IACjB,WAAW,IAAI,IAAI,CAAC;IACpB,aAAa,IAAI,IAAI,CAAC;IACtB,OAAO,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACjD,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC/B,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,GAAG,EAAE,SAAS,CAAC;CAChB;AAyGD;;GAEG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAEjD"}

package/dist/assertions.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Simple assertion library (expect-style API).
+ * Similar to Jest/Cypress expect — extend later with matchers.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AssertionError = void 0;
+exports.expect = expect;
+class AssertionError extends Error {
+    constructor(message, expected, actual) {
+        super(message);
+        this.expected = expected;
+        this.actual = actual;
+        this.name = 'AssertionError';
+        Object.setPrototypeOf(this, AssertionError.prototype);
+    }
+}
+exports.AssertionError = AssertionError;
+function assert(condition, message, actual, expected) {
+    if (!condition) {
+        throw new AssertionError(message, expected, actual);
+    }
+}
+function expectApi(actual, negate = false) {
+    const wrap = (pass, failMessage, passMessage) => {
+        const ok = negate ? !pass : pass;
+        const msg = ok ? (negate ? failMessage : passMessage || failMessage) : (negate ? passMessage || failMessage : failMessage);
+        assert(ok, msg, actual);
+    };
+    const api = {
+        toBe(expected) {
+            wrap(Object.is(actual, expected), `Expected ${String(actual)} to be ${String(expected)}`, `Expected not to be ${String(expected)}`);
+        },
+        toEqual(expected) {
+            const pass = JSON.stringify(actual) === JSON.stringify(expected);
+            wrap(pass, `Expected ${JSON.stringify(actual)} to equal ${JSON.stringify(expected)}`, `Expected not to equal ${JSON.stringify(expected)}`);
+        },
+        toBeTruthy() {
+            wrap(!!actual, `Expected ${String(actual)} to be truthy`, `Expected ${String(actual)} to be falsy`);
+        },
+        toBeFalsy() {
+            wrap(!actual, `Expected ${String(actual)} to be falsy`, `Expected ${String(actual)} to be truthy`);
+        },
+        toBeNull() {
+            wrap(actual === null, `Expected ${String(actual)} to be null`, `Expected not to be null`);
+        },
+        toBeDefined() {
+            wrap(actual !== undefined, `Expected value to be defined`, `Expected value to be undefined`);
+        },
+        toBeUndefined() {
+            wrap(actual === undefined, `Expected value to be undefined`, `Expected value to be defined`);
+        },
+        toThrow(expectedMessage) {
+            if (typeof actual !== 'function') {
+                throw new AssertionError('Expected value to be a function', undefined, actual);
+            }
+            let threw = false;
+            let thrown;
+            try {
+                actual();
+            }
+            catch (e) {
+                threw = true;
+                thrown = e;
+            }
+            wrap(threw, 'Expected function to throw', 'Expected function not to throw');
+            if (expectedMessage !== undefined && threw) {
+                const msg = thrown instanceof Error ? thrown.message : String(thrown);
+                const match = typeof expectedMessage === 'string'
+                    ? msg === expectedMessage
+                    : expectedMessage.test(msg);
+                assert(match, `Expected throw message to match, got: ${msg}`, msg, expectedMessage);
+            }
+        },
+        toBeGreaterThan(n) {
+            const val = Number(actual);
+            wrap(!Number.isNaN(val) && val > n, `Expected ${actual} to be greater than ${n}`, `Expected ${actual} not to be greater than ${n}`);
+        },
+        toBeLessThan(n) {
+            const val = Number(actual);
+            wrap(!Number.isNaN(val) && val < n, `Expected ${actual} to be less than ${n}`, `Expected ${actual} not to be less than ${n}`);
+        },
+        toContain(item) {
+            const isArray = Array.isArray(actual);
+            const isString = typeof actual === 'string';
+            const has = isArray
+                ? actual.includes(item)
+                : isString
+                    ? actual.includes(String(item))
+                    : false;
+            wrap(has, `Expected ${JSON.stringify(actual)} to contain ${JSON.stringify(item)}`, `Expected ${JSON.stringify(actual)} not to contain ${JSON.stringify(item)}`);
+        },
+        toHaveLength(n) {
+            const len = actual?.length;
+            wrap(len === n, `Expected length ${len ?? 'undefined'} to be ${n}`, `Expected length not to be ${n}`);
+        },
+        get not() {
+            return expectApi(actual, true);
+        },
+    };
+    return api;
+}
+/**
+ * Expect API — use in tests: expect(value).toBe(3), expect(fn).toThrow(), etc.
+ */
+function expect(actual) {
+    return expectApi(actual);
+}
+//# sourceMappingURL=assertions.js.map

package/dist/assertions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.js","sourceRoot":"","sources":["../src/assertions.ts"],"names":[],"mappings":"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"}

package/dist/browser/cdp-page.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Page API: goto, click, type using Chrome DevTools Protocol only.
+ * No Playwright, no Cypress — raw CDP via chrome-remote-interface.
+ */
+interface EvalResult {
+    result?: {
+        type: string;
+        value?: unknown;
+    };
+}
+export type CDPClient = {
+    Page: {
+        enable(): Promise<void>;
+        navigate(params: {
+            url: string;
+        }): Promise<unknown>;
+        loadEventFired(): Promise<unknown>;
+    };
+    Runtime: {
+        evaluate(params: {
+            expression: string;
+            returnByValue?: boolean;
+        }): Promise<EvalResult>;
+    };
+    Input: {
+        dispatchMouseEvent(params: {
+            type: string;
+            x: number;
+            y: number;
+            button?: string;
+            clickCount?: number;
+        }): Promise<void>;
+        dispatchKeyEvent(params: {
+            type: string;
+            text?: string;
+            key?: string;
+        }): Promise<void>;
+    };
+    close(): Promise<void>;
+};
+export interface PageApi {
+    goto(url: string): Promise<void>;
+    click(selector: string): Promise<void>;
+    type(selector: string, text: string): Promise<void>;
+    pressKey(key: string): Promise<void>;
+    waitForLoad(): Promise<void>;
+    content(): Promise<string>;
+    evaluate<T>(expression: string): Promise<T>;
+}
+export declare function createPage(client: CDPClient): PageApi;
+export {};
+//# sourceMappingURL=cdp-page.d.ts.map

package/dist/browser/cdp-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-page.d.ts","sourceRoot":"","sources":["../../src/browser/cdp-page.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,UAAU,UAAU;IAClB,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC5C;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE;QAAE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE;YAAE,GAAG,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAAC,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;KAAE,CAAC;IAC3H,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,aAAa,CAAC,EAAE,OAAO,CAAA;SAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;KAAE,CAAC;IACpG,KAAK,EAAE;QAAE,kBAAkB,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAAC,gBAAgB,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC;IAC3N,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,CAAC;AAEF,MAAM,WAAW,OAAO;IACtB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC7C;AASD,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CA0ErD"}

package/dist/browser/cdp-page.js

@@ -0,0 +1,85 @@
+"use strict";
+/**
+ * Page API: goto, click, type using Chrome DevTools Protocol only.
+ * No Playwright, no Cypress — raw CDP via chrome-remote-interface.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPage = createPage;
+function getCenter(rect) {
+    return {
+        x: rect.x + rect.width / 2,
+        y: rect.y + rect.height / 2,
+    };
+}
+function createPage(client) {
+    return {
+        async goto(url) {
+            await client.Page.enable();
+            await client.Page.navigate({ url });
+            await client.Page.loadEventFired();
+        },
+        async click(selector) {
+            const expr = `
+        (function() {
+          var el = document.querySelector(${JSON.stringify(selector)});
+          if (!el) throw new Error('No element found for selector: ${selector.replace(/'/g, "\\'")}');
+          var r = el.getBoundingClientRect();
+          return { x: r.x, y: r.y, width: r.width, height: r.height };
+        })()
+      `;
+            const { result } = await client.Runtime.evaluate({ expression: expr, returnByValue: true });
+            if (!result || result.type !== 'object' || !('value' in result)) {
+                throw new Error(`Selector "${selector}" did not match or element has no box`);
+            }
+            const value = result.value;
+            const { x, y } = getCenter(value);
+            await client.Input.dispatchMouseEvent({ type: 'mousePressed', x, y, button: 'left', clickCount: 1 });
+            await client.Input.dispatchMouseEvent({ type: 'mouseReleased', x, y, button: 'left', clickCount: 1 });
+        },
+        async type(selector, text) {
+            const expr = `
+        (function() {
+          var el = document.querySelector(${JSON.stringify(selector)});
+          if (!el) throw new Error('No element found for selector: ${selector.replace(/'/g, "\\'")}');
+          var r = el.getBoundingClientRect();
+          return { x: r.x, y: r.y, width: r.width, height: r.height };
+        })()
+      `;
+            const { result } = await client.Runtime.evaluate({ expression: expr, returnByValue: true });
+            if (!result || result.type !== 'object' || !('value' in result)) {
+                throw new Error(`Selector "${selector}" did not match`);
+            }
+            const value = result.value;
+            const { x, y } = getCenter(value);
+            await client.Input.dispatchMouseEvent({ type: 'mousePressed', x, y, button: 'left', clickCount: 1 });
+            await client.Input.dispatchMouseEvent({ type: 'mouseReleased', x, y, button: 'left', clickCount: 1 });
+            for (const char of text) {
+                await client.Input.dispatchKeyEvent({ type: 'keyDown', text: char });
+                await client.Input.dispatchKeyEvent({ type: 'keyUp', text: char });
+            }
+        },
+        async pressKey(key) {
+            await client.Input.dispatchKeyEvent({ type: 'keyDown', key });
+            await client.Input.dispatchKeyEvent({ type: 'keyUp', key });
+        },
+        async waitForLoad() {
+            await client.Page.loadEventFired();
+        },
+        async content() {
+            const { result } = await client.Runtime.evaluate({
+                expression: 'document.documentElement.outerHTML',
+                returnByValue: true,
+            });
+            if (result && 'value' in result)
+                return String(result.value);
+            return '';
+        },
+        async evaluate(expression) {
+            const { result } = await client.Runtime.evaluate({ expression, returnByValue: true });
+            if (result && 'value' in result)
+                return result.value;
+            return undefined;
+        },
+    };
+}
+//# sourceMappingURL=cdp-page.js.map

package/dist/browser/cdp-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cdp-page.js","sourceRoot":"","sources":["../../src/browser/cdp-page.ts"],"names":[],"mappings":"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"}

package/dist/browser/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * CSTesting Browser — CDP-based automation (no Playwright/Cypress).
+ * Uses Chrome DevTools Protocol via chrome-remote-interface + chrome-launcher.
+ */
+import { type LaunchOptions } from './launch';
+export interface BrowserApi {
+    goto(url: string): Promise<void>;
+    click(selector: string): Promise<void>;
+    type(selector: string, text: string): Promise<void>;
+    pressKey(key: string): Promise<void>;
+    waitForLoad(): Promise<void>;
+    content(): Promise<string>;
+    evaluate<T>(expression: string): Promise<T>;
+    close(): Promise<void>;
+}
+export interface CreateBrowserOptions extends LaunchOptions {
+    /** Connect to existing Chrome on port instead of launching. */
+    port?: number;
+}
+/**
+ * Launch a new Chrome (or connect to existing port) and return a browser API.
+ * Example:
+ *   const browser = await createBrowser({ headless: true });
+ *   await browser.goto('https://example.com');
+ *   await browser.click('a');
+ *   await browser.close();
+ */
+export declare function createBrowser(options?: CreateBrowserOptions): Promise<BrowserApi>;
+export { launchChrome } from './launch';
+export type { PageApi } from './cdp-page';
+export type { LaunchOptions, LaunchedChrome } from './launch';
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAgB,KAAK,aAAa,EAAuB,MAAM,UAAU,CAAC;AAIjF,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,KAAK,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC3B,QAAQ,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,+DAA+D;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiC3F;AAED,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/browser/index.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * CSTesting Browser — CDP-based automation (no Playwright/Cypress).
+ * Uses Chrome DevTools Protocol via chrome-remote-interface + chrome-launcher.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.launchChrome = void 0;
+exports.createBrowser = createBrowser;
+const chrome_remote_interface_1 = __importDefault(require("chrome-remote-interface"));
+const launch_1 = require("./launch");
+const cdp_page_1 = require("./cdp-page");
+/**
+ * Launch a new Chrome (or connect to existing port) and return a browser API.
+ * Example:
+ *   const browser = await createBrowser({ headless: true });
+ *   await browser.goto('https://example.com');
+ *   await browser.click('a');
+ *   await browser.close();
+ */
+async function createBrowser(options = {}) {
+    let launched = null;
+    let port = options.port;
+    if (port == null || port === 0) {
+        launched = await (0, launch_1.launchChrome)({
+            headless: options.headless,
+            port: options.port,
+            args: options.args,
+            userDataDir: options.userDataDir,
+        });
+        port = launched.port;
+    }
+    const client = (await (0, chrome_remote_interface_1.default)({ port }));
+    const page = (0, cdp_page_1.createPage)(client);
+    return {
+        goto: (url) => page.goto(url),
+        click: (selector) => page.click(selector),
+        type: (selector, text) => page.type(selector, text),
+        pressKey: (key) => page.pressKey(key),
+        waitForLoad: () => page.waitForLoad(),
+        content: () => page.content(),
+        evaluate: (expression) => page.evaluate(expression),
+        async close() {
+            await client.close();
+            if (launched) {
+                const k = launched.kill();
+                if (k && typeof k.then === 'function')
+                    await k;
+            }
+        },
+    };
+}
+var launch_2 = require("./launch");
+Object.defineProperty(exports, "launchChrome", { enumerable: true, get: function () { return launch_2.launchChrome; } });
+//# sourceMappingURL=index.js.map

package/dist/browser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/browser/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;AA+BH,sCAiCC;AA9DD,sFAA0C;AAC1C,qCAAiF;AACjF,yCAAsD;AAmBtD;;;;;;;GAOG;AACI,KAAK,UAAU,aAAa,CAAC,UAAgC,EAAE;IACpE,IAAI,QAAQ,GAA0B,IAAI,CAAC;IAC3C,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAExB,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QAC/B,QAAQ,GAAG,MAAM,IAAA,qBAAY,EAAC;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,OAAO,CAAC,WAAW;SACjC,CAAC,CAAC;QACH,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IACvB,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,MAAM,IAAA,iCAAG,EAAC,EAAE,IAAI,EAAE,CAAC,CAAyB,CAAC;IAC7D,MAAM,IAAI,GAAG,IAAA,qBAAU,EAAC,MAAM,CAAC,CAAC;IAEhC,OAAO;QACL,IAAI,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QACrC,KAAK,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QACjD,IAAI,EAAE,CAAC,QAAgB,EAAE,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC;QACnE,QAAQ,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;QAC7C,WAAW,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE;QACrC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE;QAC7B,QAAQ,EAAE,CAAI,UAAkB,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAI,UAAU,CAAC;QACjE,KAAK,CAAC,KAAK;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,QAAQ,EAAE,CAAC;gBACb,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC;gBAC1B,IAAI,CAAC,IAAI,OAAQ,CAAsB,CAAC,IAAI,KAAK,UAAU;oBAAE,MAAO,CAAmB,CAAC;YAC1F,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,mCAAwC;AAA/B,sGAAA,YAAY,OAAA"}

package/dist/browser/launch.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Launch Chrome with remote-debugging-port for CDP.
+ * Uses chrome-launcher (no Playwright/Puppeteer).
+ * Uses a custom userDataDir to avoid Windows EPERM on the default lighthouse temp folder.
+ */
+export interface LaunchOptions {
+    headless?: boolean;
+    port?: number;
+    args?: string[];
+    /** Custom Chrome profile directory. If not set, a dir under project or os.tmpdir() is used to avoid Windows EPERM. */
+    userDataDir?: string;
+}
+export interface LaunchedChrome {
+    port: number;
+    kill: () => void | Promise<void>;
+}
+export declare function launchChrome(options?: LaunchOptions): Promise<LaunchedChrome>;
+//# sourceMappingURL=launch.d.ts.map

package/dist/browser/launch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.d.ts","sourceRoot":"","sources":["../../src/browser/launch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,sHAAsH;IACtH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAgBD,wBAAsB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyBvF"}

package/dist/browser/launch.js

@@ -0,0 +1,87 @@
+"use strict";
+/**
+ * Launch Chrome with remote-debugging-port for CDP.
+ * Uses chrome-launcher (no Playwright/Puppeteer).
+ * Uses a custom userDataDir to avoid Windows EPERM on the default lighthouse temp folder.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.launchChrome = launchChrome;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const chrome_launcher_1 = require("chrome-launcher");
+function makeUserDataDir() {
+    const base = process.cwd();
+    const dirName = `cstesting-chrome-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+    const candidate = path.join(base, 'node_modules', '.cache', dirName);
+    try {
+        fs.mkdirSync(candidate, { recursive: true });
+        return path.resolve(candidate);
+    }
+    catch {
+        const fallback = path.join(os.tmpdir(), dirName);
+        fs.mkdirSync(fallback, { recursive: true });
+        return path.resolve(fallback);
+    }
+}
+async function launchChrome(options = {}) {
+    const { headless = true, port = 0, args = [], userDataDir: customUserDataDir } = options;
+    const chromeFlags = [...args];
+    if (headless) {
+        chromeFlags.push('--headless=new', '--disable-gpu', '--no-sandbox');
+    }
+    const userDataDir = customUserDataDir ?? makeUserDataDir();
+    const chrome = await (0, chrome_launcher_1.launch)({
+        port: port || undefined,
+        chromeFlags,
+        userDataDir,
+    });
+    return {
+        port: chrome.port,
+        kill: () => {
+            chrome.kill();
+            try {
+                if (!customUserDataDir && fs.existsSync(userDataDir)) {
+                    fs.rmSync(userDataDir, { recursive: true, force: true, maxRetries: 3 });
+                }
+            }
+            catch {
+                // ignore cleanup errors
+            }
+        },
+    };
+}
+//# sourceMappingURL=launch.js.map

package/dist/browser/launch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch.js","sourceRoot":"","sources":["../../src/browser/launch.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCH,oCAyBC;AAzDD,uCAAyB;AACzB,2CAA6B;AAC7B,uCAAyB;AACzB,qDAA+D;AAe/D,SAAS,eAAe;IACtB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,oBAAoB,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC5F,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrE,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;QACjD,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;AACH,CAAC;AAEM,KAAK,UAAU,YAAY,CAAC,UAAyB,EAAE;IAC5D,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,WAAW,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC;IACzF,MAAM,WAAW,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9B,IAAI,QAAQ,EAAE,CAAC;QACb,WAAW,CAAC,IAAI,CAAC,gBAAgB,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,WAAW,GAAG,iBAAiB,IAAI,eAAe,EAAE,CAAC;IAC3D,MAAM,MAAM,GAAG,MAAM,IAAA,wBAAkB,EAAC;QACtC,IAAI,EAAE,IAAI,IAAI,SAAS;QACvB,WAAW;QACX,WAAW;KACZ,CAAC,CAAC;IACH,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,GAAG,EAAE;YACT,MAAM,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC;gBACH,IAAI,CAAC,iBAAiB,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;oBACrD,EAAE,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;gBAC1E,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,wBAAwB;YAC1B,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+"use strict";
+// CSTesting CLI — discover and run test files.
+// Usage: npx cstesting [pattern]  or  npx et [pattern]
+// Examples: cstesting  |  cstesting "**/*.test.js"  |  cstesting tests/
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const runner_1 = require("./runner");
+const assertions_1 = require("./assertions");
+const defaultPattern = '**/*.test.js';
+function findTestFiles(pattern, cwd) {
+    const base = pattern.split(/[/\\]/)[0];
+    if (base === '**' || pattern.includes('*')) {
+        const files = [];
+        function walk(dir) {
+            if (!fs.existsSync(dir))
+                return;
+            const entries = fs.readdirSync(dir, { withFileTypes: true });
+            for (const e of entries) {
+                const full = path.join(dir, e.name);
+                if (e.isDirectory()) {
+                    if (e.name !== 'node_modules' && e.name !== 'dist')
+                        walk(full);
+                }
+                else if (e.isFile() && (e.name.endsWith('.test.js') || e.name.endsWith('.spec.js'))) {
+                    files.push(full);
+                }
+            }
+        }
+        walk(cwd);
+        return files;
+    }
+    const full = path.join(cwd, pattern);
+    if (fs.existsSync(full) && fs.statSync(full).isFile())
+        return [path.resolve(full)];
+    const dir = path.join(cwd, base);
+    if (fs.existsSync(dir) && fs.statSync(dir).isDirectory()) {
+        const files = [];
+        function walk(d) {
+            const entries = fs.readdirSync(d, { withFileTypes: true });
+            for (const e of entries) {
+                const fullPath = path.join(d, e.name);
+                if (e.isDirectory())
+                    walk(fullPath);
+                else if (e.name.endsWith('.test.js') || e.name.endsWith('.spec.js'))
+                    files.push(fullPath);
+            }
+        }
+        walk(dir);
+        return files;
+    }
+    return [];
+}
+function loadTestFile(filePath) {
+    require(path.resolve(filePath));
+}
+function formatError(err) {
+    if (err instanceof assertions_1.AssertionError) {
+        return `${err.message}${err.actual !== undefined ? `\n  Actual: ${String(err.actual)}` : ''}${err.expected !== undefined ? `\n  Expected: ${String(err.expected)}` : ''}`;
+    }
+    return err.stack || err.message;
+}
+async function main() {
+    const cwd = process.cwd();
+    const pattern = process.argv[2] || defaultPattern;
+    const resolved = path.resolve(cwd, pattern);
+    let testFiles;
+    if (pattern.includes('*') || pattern.endsWith('.js') || pattern.endsWith('.ts')) {
+        testFiles = findTestFiles(pattern, cwd);
+    }
+    else if (fs.existsSync(resolved) && fs.statSync(resolved).isDirectory()) {
+        testFiles = findTestFiles(pattern, cwd);
+    }
+    else if (fs.existsSync(resolved) && fs.statSync(resolved).isFile()) {
+        testFiles = [resolved];
+    }
+    else {
+        testFiles = findTestFiles(pattern, cwd);
+    }
+    if (testFiles.length === 0) {
+        console.log('No test files found. Create files matching *.test.js or run: cstesting path/to/test.js');
+        process.exit(0);
+        return;
+    }
+    const totalResult = {
+        passed: 0,
+        failed: 0,
+        skipped: 0,
+        total: 0,
+        duration: 0,
+        errors: [],
+    };
+    for (const file of testFiles) {
+        (0, runner_1.resetRunner)();
+        try {
+            loadTestFile(file);
+        }
+        catch (err) {
+            console.error(`Failed to load ${file}:`, err);
+            process.exit(1);
+        }
+        const result = await (0, runner_1.run)();
+        totalResult.passed += result.passed;
+        totalResult.failed += result.failed;
+        totalResult.skipped += result.skipped;
+        totalResult.total += result.total;
+        totalResult.duration += result.duration;
+        totalResult.errors.push(...result.errors);
+        const rel = path.relative(cwd, file);
+        console.log(`\n ${rel}`);
+        if (result.errors.length > 0) {
+            for (const { suite, test, error } of result.errors) {
+                console.log(`  ✗ ${suite} > ${test}`);
+                console.log(formatError(error).split('\n').map((l) => `    ${l}`).join('\n'));
+            }
+        }
+    }
+    console.log('\n' + '─'.repeat(50));
+    console.log(`  Passed: ${totalResult.passed}  Failed: ${totalResult.failed}  Skipped: ${totalResult.skipped}  Total: ${totalResult.total}  (${totalResult.duration}ms)`);
+    if (totalResult.failed > 0)
+        process.exit(1);
+}
+main().catch((err) => {
+    console.error(err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CSTesting — Node.js testing framework
+ *
+ * Usage in test files:
+ *   const { describe, it, expect, beforeAll, afterAll, beforeEach, afterEach } = require('cstesting');
+ */
+export { describe, it, beforeAll, afterAll, beforeEach, afterEach, run, resetRunner } from './runner';
+export { expect, AssertionError } from './assertions';
+export { createBrowser } from './browser';
+export type { RunResult } from './types';
+export type { BrowserApi, CreateBrowserOptions } from './browser';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACtG,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACzC,YAAY,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * CSTesting — Node.js testing framework
+ *
+ * Usage in test files:
+ *   const { describe, it, expect, beforeAll, afterAll, beforeEach, afterEach } = require('cstesting');
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBrowser = exports.AssertionError = exports.expect = exports.resetRunner = exports.run = exports.afterEach = exports.beforeEach = exports.afterAll = exports.beforeAll = exports.it = exports.describe = void 0;
+var runner_1 = require("./runner");
+Object.defineProperty(exports, "describe", { enumerable: true, get: function () { return runner_1.describe; } });
+Object.defineProperty(exports, "it", { enumerable: true, get: function () { return runner_1.it; } });
+Object.defineProperty(exports, "beforeAll", { enumerable: true, get: function () { return runner_1.beforeAll; } });
+Object.defineProperty(exports, "afterAll", { enumerable: true, get: function () { return runner_1.afterAll; } });
+Object.defineProperty(exports, "beforeEach", { enumerable: true, get: function () { return runner_1.beforeEach; } });
+Object.defineProperty(exports, "afterEach", { enumerable: true, get: function () { return runner_1.afterEach; } });
+Object.defineProperty(exports, "run", { enumerable: true, get: function () { return runner_1.run; } });
+Object.defineProperty(exports, "resetRunner", { enumerable: true, get: function () { return runner_1.resetRunner; } });
+var assertions_1 = require("./assertions");
+Object.defineProperty(exports, "expect", { enumerable: true, get: function () { return assertions_1.expect; } });
+Object.defineProperty(exports, "AssertionError", { enumerable: true, get: function () { return assertions_1.AssertionError; } });
+var browser_1 = require("./browser");
+Object.defineProperty(exports, "createBrowser", { enumerable: true, get: function () { return browser_1.createBrowser; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,mCAAsG;AAA7F,kGAAA,QAAQ,OAAA;AAAE,4FAAA,EAAE,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,mGAAA,SAAS,OAAA;AAAE,6FAAA,GAAG,OAAA;AAAE,qGAAA,WAAW,OAAA;AACnF,2CAAsD;AAA7C,oGAAA,MAAM,OAAA;AAAE,4GAAA,cAAc,OAAA;AAC/B,qCAA0C;AAAjC,wGAAA,aAAa,OAAA"}

package/dist/runner.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Test runner: describe, it, beforeAll, afterAll, beforeEach, afterEach.
+ * Runs suites and tests, collects results.
+ */
+import type { TestSuite, RunResult, TestFn, HookFn } from './types';
+declare function resetRunner(): void;
+export declare function describe(name: string, fn: () => void): void;
+export declare namespace describe {
+    var only: (name: string, fn: () => void) => void;
+    var skip: (name: string, fn: () => void) => void;
+}
+export declare function it(name: string, fn: TestFn): void;
+export declare namespace it {
+    var only: (name: string, fn: TestFn) => void;
+    var skip: (name: string, fn: TestFn) => void;
+}
+export declare function beforeAll(fn: HookFn): void;
+export declare function afterAll(fn: HookFn): void;
+export declare function beforeEach(fn: HookFn): void;
+export declare function afterEach(fn: HookFn): void;
+export declare function run(): Promise<RunResult>;
+export declare function getRootSuite(): TestSuite;
+export declare function setRootSuite(suite: TestSuite): void;
+export { resetRunner };
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAY,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAqB9E,iBAAS,WAAW,IAAI,IAAI,CAI3B;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAO3D;yBAPe,QAAQ;qBASoB,MAAM,MAAM,MAAM,IAAI,KAAG,IAAI;qBAW7B,MAAM,MAAM,MAAM,IAAI,KAAG,IAAI;;AAUzE,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAEjD;yBAFe,EAAE;qBAIc,MAAM,MAAM,MAAM,KAAG,IAAI;qBAKzB,MAAM,MAAM,MAAM,KAAG,IAAI;;AAIzD,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE1C;AAiED,wBAAsB,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC,CAa9C;AAED,wBAAgB,YAAY,IAAI,SAAS,CAExC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAGnD;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/runner.js

@@ -0,0 +1,162 @@
+"use strict";
+/**
+ * Test runner: describe, it, beforeAll, afterAll, beforeEach, afterEach.
+ * Runs suites and tests, collects results.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describe = describe;
+exports.it = it;
+exports.beforeAll = beforeAll;
+exports.afterAll = afterAll;
+exports.beforeEach = beforeEach;
+exports.afterEach = afterEach;
+exports.run = run;
+exports.getRootSuite = getRootSuite;
+exports.setRootSuite = setRootSuite;
+exports.resetRunner = resetRunner;
+let rootSuite = makeSuite('root');
+let currentSuite = rootSuite;
+let hasOnly = false;
+function makeSuite(name) {
+    return {
+        name,
+        suites: [],
+        tests: [],
+        beforeAll: [],
+        afterAll: [],
+        beforeEach: [],
+        afterEach: [],
+        only: false,
+        skip: false,
+    };
+}
+function resetRunner() {
+    rootSuite = makeSuite('root');
+    currentSuite = rootSuite;
+    hasOnly = false;
+}
+function describe(name, fn) {
+    const parent = currentSuite;
+    const suite = makeSuite(name);
+    parent.suites.push(suite);
+    currentSuite = suite;
+    fn();
+    currentSuite = parent;
+}
+describe.only = function describeOnly(name, fn) {
+    const parent = currentSuite;
+    const suite = makeSuite(name);
+    suite.only = true;
+    hasOnly = true;
+    parent.suites.push(suite);
+    currentSuite = suite;
+    fn();
+    currentSuite = parent;
+};
+describe.skip = function describeSkip(name, fn) {
+    const parent = currentSuite;
+    const suite = makeSuite(name);
+    suite.skip = true;
+    parent.suites.push(suite);
+    currentSuite = suite;
+    fn();
+    currentSuite = parent;
+};
+function it(name, fn) {
+    currentSuite.tests.push({ name, fn, only: false, skip: false });
+}
+it.only = function itOnly(name, fn) {
+    currentSuite.tests.push({ name, fn, only: true, skip: false });
+    hasOnly = true;
+};
+it.skip = function itSkip(name, fn) {
+    currentSuite.tests.push({ name, fn, only: false, skip: true });
+};
+function beforeAll(fn) {
+    currentSuite.beforeAll.push(fn);
+}
+function afterAll(fn) {
+    currentSuite.afterAll.push(fn);
+}
+function beforeEach(fn) {
+    currentSuite.beforeEach.push(fn);
+}
+function afterEach(fn) {
+    currentSuite.afterEach.push(fn);
+}
+async function runHooks(hooks) {
+    for (const hook of hooks) {
+        await Promise.resolve(hook());
+    }
+}
+function shouldRunSuite(suite) {
+    if (suite.skip)
+        return false;
+    if (hasOnly && !suite.only && !suiteHasOnly(suite))
+        return false;
+    return true;
+}
+function suiteHasOnly(s) {
+    if (s.only)
+        return true;
+    if (s.tests.some((t) => t.only))
+        return true;
+    return s.suites.some(suiteHasOnly);
+}
+async function runSuite(suite, path, result, startTime) {
+    if (!shouldRunSuite(suite))
+        return;
+    const fullPath = path ? `${path} > ${suite.name}` : suite.name;
+    await runHooks(suite.beforeAll);
+    for (const test of suite.tests) {
+        const runTest = !test.skip && (!hasOnly || test.only);
+        if (!runTest) {
+            result.skipped++;
+            result.total++;
+            continue;
+        }
+        result.total++;
+        const testStart = Date.now();
+        try {
+            await runHooks(suite.beforeEach);
+            await Promise.resolve(test.fn());
+            await runHooks(suite.afterEach);
+            result.passed++;
+        }
+        catch (err) {
+            await runHooks(suite.afterEach).catch(() => { });
+            result.failed++;
+            result.errors.push({
+                suite: fullPath,
+                test: test.name,
+                error: err instanceof Error ? err : new Error(String(err)),
+            });
+        }
+    }
+    for (const child of suite.suites) {
+        await runSuite(child, fullPath, result, startTime);
+    }
+    await runHooks(suite.afterAll);
+}
+async function run() {
+    const result = {
+        passed: 0,
+        failed: 0,
+        skipped: 0,
+        total: 0,
+        duration: 0,
+        errors: [],
+    };
+    const start = Date.now();
+    await runSuite(rootSuite, '', result, start);
+    result.duration = Date.now() - start;
+    return result;
+}
+function getRootSuite() {
+    return rootSuite;
+}
+function setRootSuite(suite) {
+    rootSuite = suite;
+    currentSuite = suite;
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Internal types for the test runner.
+ */
+export type TestFn = () => void | Promise<void>;
+export type HookFn = () => void | Promise<void>;
+export interface TestCase {
+    name: string;
+    fn: TestFn;
+    only: boolean;
+    skip: boolean;
+}
+export interface TestSuite {
+    name: string;
+    suites: TestSuite[];
+    tests: TestCase[];
+    beforeAll: HookFn[];
+    afterAll: HookFn[];
+    beforeEach: HookFn[];
+    afterEach: HookFn[];
+    only: boolean;
+    skip: boolean;
+}
+export interface RunResult {
+    passed: number;
+    failed: number;
+    skipped: number;
+    total: number;
+    duration: number;
+    errors: Array<{
+        suite: string;
+        test: string;
+        error: Error;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,MAAM,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAChD,MAAM,MAAM,MAAM,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC,CAAC;CAC9D"}

package/dist/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Internal types for the test runner.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "cstesting",
+  "version": "0.1.0",
+  "description": "A simple, extensible Node.js testing framework — start with a test runner and assertions, extend with browser automation later.",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "cstesting": "dist/cli.js",
+    "cst": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "node dist/cli.js",
+    "test:example": "node dist/cli.js example/",
+    "example": "npm run build && npm run test:example",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "testing",
+    "test-runner",
+    "assertions",
+    "nodejs",
+    "automation"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/YOUR_USERNAME/cstesting.git"
+  },
+  "homepage": "https://github.com/YOUR_USERNAME/cstesting#readme",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "chrome-launcher": "^1.0.0",
+    "chrome-remote-interface": "^0.33.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "typescript": "^5.3.0"
+  }
+}