@harnessed-ts/angular 0.0.0-stage → 0.7.0

package/CHANGELOG.md

@@ -0,0 +1,27 @@
+# @harnessed-ts/angular
+
+## 0.7.0
+
+### Minor Changes
+
+- ec06bdf: Vue, Solid, Svelte and Angular join React and Ember as conformance-tested UI frameworks, and node:test, Bun and Nightwatch join the runners.
+
+  New packages: `@harnessed-ts/nightwatch` drives Nightwatch 3 through the injected resolver, under Nightwatch's own runner and its Mocha runner, in end-to-end and component tests (`@nightwatch/react`, `@nightwatch/vue`), with cross-origin frames. `@harnessed-ts/angular` drives zoneless Angular 21+: every action settles at `fixture.whenStable()`, or at the `ApplicationRef`'s for an app bootstrapped without TestBed, and `goto()` drives a provided router.
+
+  `@harnessed-ts/core/register` loads TypeScript harnesses under `node --import`: esbuild strips the types, lowers standard decorators and `accessor`, and compiles JSX. `@harnessed-ts/core/bun` does the same as a `bun test` preload, so harnesses keep the standard decorator protocol whatever `experimentalDecorators` the tsconfig sets.
+
+  `@harnessed-ts/dom/matchers/bun` registers the matchers with `bun:test`. The dom driver runs on happy-dom too: it focuses the frames leading to an interaction's target, finds a frame's `<iframe>` where `frameElement` is unset, and reads a select's selection off `options`.
+
+  `@harnessed-ts/resolve/webdriver` holds the WebDriver half of injected resolution, shared by the WebdriverIO and Nightwatch drivers. `@harnessed-ts/gherkin/nightwatch` adapts the cucumber-js world to Nightwatch's Cucumber runner.
+
+  `@harnessed-ts/playwright`, and `@harnessed-ts/cypress` under `realEvents`, give the page a task after every action, so a read straight after it sees what a framework that renders on a timer (zoneless Angular) has rendered. The injectable resolver installs on the page's `window` rather than the script's global, which under Firefox's WebDriver is a sandbox in front of it.
+
+  `@harnessed-ts/conformance` exports `fixtureParity()`, the per-view parity check a port of the fixture to another framework runs, naming the first place its markup parts from the React original; it detects a simulated DOM from the DOM's own window.
+
+  `@harnessed-ts/eslint-plugin` recognises Nightwatch's, Angular's and Vue Test Utils' raw queries, and looks in `nightwatch/` by default. `npx @harnessed-ts/claude install` detects Angular, Nightwatch, node:test and Bun.
+
+### Patch Changes
+
+- Updated dependencies [ec06bdf]
+  - @harnessed-ts/core@0.7.0
+  - @harnessed-ts/resolve@0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joe Gaudet, Jay Seo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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.

package/README.md

@@ -1,3 +1,138 @@
-# Temporary Holding Version
+# @harnessed-ts/angular
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Angular driver for `@harnessed-ts/core`. Queries resolve through the shared
+resolver, so they agree with every other driver; interactions go through
+user-event, as in the Testing Library driver, and each one returns once the app
+is stable.
+
+```ts
+import { angular } from '@harnessed-ts/angular'
+import { render } from '@testing-library/angular/zoneless'
+
+// a component test, through TestBed or @testing-library/angular
+const { fixture } = await render(LoginForm)
+const form = new LoginFormHarness(angular({ fixture }))
+await form.signInAs('ada@example.com', 'hunter2')
+
+// with the router provided, a page's goto() drives it
+const checkout = new CheckoutPage(angular({ fixture }))
+await checkout.goto({ token })
+
+// an app bootstrapped without TestBed
+const app = await bootstrapApplication(App, appConfig)
+const page = new CheckoutPage(angular({ app }))
+```
+
+Zoneless, standalone components, Angular 21 and later. Runs under Vitest with
+jsdom or in browser mode, and anywhere else TestBed does.
+
+## The env
+
+| Option    | What it is                                                                                                         |
+| --------- | ------------------------------------------------------------------------------------------------------------------ |
+| `fixture` | A `ComponentFixture`. Every action ends at `fixture.whenStable()`.                                                 |
+| `app`     | The `ApplicationRef` from `bootstrapApplication()`, for an app with no fixture. Actions end at its `whenStable()`. |
+| `root`    | Where queries start, scoped and `{ global: true }` alike. Defaults to `document.body`.                             |
+
+One of `fixture` or `app` is required. The driver does not look for an app on
+its own: the `ng` global and `getAllAngularRootElements()` exist only in
+development builds, and testabilities only where zone.js is loaded.
+
+**What "stable" means.** Zoneless, an event handler that sets a signal schedules
+change detection rather than running it. `whenStable()` waits for that render,
+and for anything else the app registers as pending: a navigation, an
+`HttpClient` request, work wrapped in `PendingTasks.run()`. It does not wait for
+a bare `setTimeout`, which a zoneless app does not track.
+
+## Navigation
+
+`goto()` and the URL members go through the app's `Router`, when one is
+provided (`provideRouter()` or `RouterModule.forRoot()`): `goto()` is
+`router.navigateByUrl()` then `whenStable()`, and `currentUrl` is
+`Location.path()`. That is not `window.location`: TestBed swaps in a mock
+platform location, so a test's navigations never reach the address bar.
+
+Without a router, a page still constructs and reads, but `goto()` and the URL
+members refuse with `the "angular" driver cannot navigate`. With one, they
+refuse until its first navigation rather than reading as `/` — TestBed performs
+no initial navigation.
+
+## Where Angular differs from the other drivers
+
+- **`isVisible()`** is a layout check in a real browser, as under Playwright,
+  and the dom driver's computed-style check under jsdom, which lays nothing out.
+- **`boundingBox()`** under jsdom is all zeros, as with the dom driver.
+- **Queries start at `document.body`**, where TestBed attaches each fixture and
+  where CDK overlays render, so `{ global: true }` reaches them.
+
+## Decorators: two kinds in one app
+
+Angular's components compile with the legacy `experimentalDecorators` transform.
+Harnesses use standard decorators and `accessor` fields. Keep them apart by file
+name — `*.harness.ts` and `*.page.ts` — in both the build and the typecheck.
+
+**Vite, through `@analogjs/vite-plugin-angular`.** `harnessedDecorators()` first,
+claiming harness and page files only, and the Angular plugin told to leave them
+alone — it emits each file from its own TypeScript program, so it would
+otherwise replace the lowered harness with a legacy build of it:
+
+```ts
+import angular from '@analogjs/vite-plugin-angular'
+import { harnessedDecorators } from '@harnessed-ts/core/vite'
+
+const HARNESS_FILES = /\.(harness|page)\.ts$/
+
+export default defineConfig({
+  plugins: [
+    harnessedDecorators({ include: HARNESS_FILES }),
+    angular({ transformFilter: (_code, id) => !HARNESS_FILES.test(id) }),
+  ],
+})
+```
+
+**Two tsconfigs.** The app's keeps `experimentalDecorators` and excludes harness
+and page files; a second one checks them, and the tests that use them, without
+it. Angular's own decorators type-check under both, so a harness may import the
+component it drives.
+
+```jsonc
+// tsconfig.app.json — checked with `ngc -p tsconfig.app.json --noEmit`
+{
+  "compilerOptions": { "experimentalDecorators": true /* …the CLI's options */ },
+  "include": ["src/**/*.ts"],
+  "exclude": ["src/**/*.harness.ts", "src/**/*.page.ts"],
+}
+
+// tsconfig.harness.json — checked with `tsc -p tsconfig.harness.json`
+{
+  "extends": "@harnessed-ts/core/tsconfig.json",
+  "compilerOptions": { "noEmit": true, "strict": true, "moduleResolution": "bundler" },
+  "include": ["src/**/*.harness.ts", "src/**/*.page.ts", "src/**/*.spec.ts"],
+}
+```
+
+Under Vitest, load `@angular/compiler` in a setup file: Angular's packages ship
+partially compiled, and Vitest loads them without the linker a build runs.
+Without Vitest globals, also call `getTestBed().resetTestingModule()` in an
+`afterEach`; TestBed registers that itself only where `afterEach` is a global.
+
+## Compared with `@angular/cdk/testing`
+
+The CDK's component harnesses are the closest thing Angular has, and they are a
+good fit for what they are for: harnesses that ship with an Angular component
+library, run through `TestbedHarnessEnvironment` or a WebDriver environment.
+They are Angular-only by design — they find components by their Angular
+selectors and stabilize through Angular.
+
+harnessed harnesses query the DOM — roles, labels, test ids — so one harness
+runs unchanged under Testing Library, Playwright, Cypress, WebdriverIO,
+Puppeteer, TestCafe, Vitest browser mode and Storybook, against an Angular app
+or any other. Every driver is held to one conformance catalog. Pick the CDK to
+publish harnesses for an Angular component library's users; pick harnessed to
+write a harness once and run it at every level of your own app's tests. The two
+do not interoperate, and can sit side by side in one suite.
+
+Full guide: the
+[harnessed README](https://github.com/joegaudet/harnessed#using-with-angular).
+
+MIT © Joe Gaudet, Jay Seo

package/dist/angular-query.d.ts

@@ -0,0 +1,48 @@
+import { Query } from '@harnessed-ts/core';
+import type { BoundingBox, Selector, WaitOptions, WaitState } from '@harnessed-ts/core';
+import type { AngularEnv } from './env';
+/**
+ * Angular driver. Resolution is the shared resolver, so it agrees with every
+ * other in-page driver. Interactions go through user-event, as in the dom
+ * driver, and each one returns only once the app is stable: zoneless, an event
+ * handler that changes a signal schedules change detection rather than running
+ * it, so the DOM a test reads next is the one `whenStable()` hands back.
+ *
+ * Each action is handed the resolved element, never a selector string, so
+ * strictness and scope stay this library's rather than `querySelector`'s.
+ */
+export declare class AngularQuery extends Query {
+    private readonly env;
+    constructor(env: AngularEnv, scope: readonly Selector[], selector: Selector);
+    protected clone(selector: Selector): Query;
+    /** Read per call: the body belongs to the current test, not the env. */
+    protected container(): HTMLElement;
+    protected element(options?: WaitOptions): Promise<HTMLElement>;
+    /** Ends an action where the app does: rendered, with nothing pending. */
+    protected settled(): Promise<void>;
+    /** Every match in one pass, each bound to its node. See `DomQuery.all`. */
+    all(): Promise<Query[]>;
+    click(options?: WaitOptions): Promise<void>;
+    fill(value: string, options?: WaitOptions): Promise<void>;
+    clear(options?: WaitOptions): Promise<void>;
+    check(options?: WaitOptions): Promise<void>;
+    uncheck(options?: WaitOptions): Promise<void>;
+    selectOption(value: string | string[], options?: WaitOptions): Promise<void>;
+    hover(options?: WaitOptions): Promise<void>;
+    focus(options?: WaitOptions): Promise<void>;
+    blur(options?: WaitOptions): Promise<void>;
+    press(key: string, options?: WaitOptions): Promise<void>;
+    upload(files: File | File[], options?: WaitOptions): Promise<void>;
+    text(options?: WaitOptions): Promise<string>;
+    inputValue(options?: WaitOptions): Promise<string>;
+    attribute(name: string, options?: WaitOptions): Promise<string | null>;
+    isVisible(options?: WaitOptions): Promise<boolean>;
+    isEnabled(options?: WaitOptions): Promise<boolean>;
+    isChecked(options?: WaitOptions): Promise<boolean>;
+    selectedOptions(options?: WaitOptions): Promise<string[]>;
+    /** Under jsdom, which computes no layout, every box is all zeros. */
+    boundingBox(options?: WaitOptions): Promise<BoundingBox>;
+    waitFor(state: WaitState, options?: WaitOptions): Promise<void>;
+    count(): Promise<number>;
+}
+//# sourceMappingURL=angular-query.d.ts.map

package/dist/angular-query.d.ts.map

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

package/dist/driver-id.d.ts

@@ -0,0 +1,3 @@
+/** The registry key for this driver. Its own module so env and query share it without a cycle. */
+export declare const ANGULAR_DRIVER = "angular";
+//# sourceMappingURL=driver-id.d.ts.map

package/dist/driver-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-id.d.ts","sourceRoot":"","sources":["../src/driver-id.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,eAAO,MAAM,cAAc,YAAY,CAAA"}

package/dist/env.d.ts

@@ -0,0 +1,56 @@
+import type { ApplicationRef, ComponentRef } from '@angular/core';
+import type { EnvConfig } from '@harnessed-ts/core';
+import { ANGULAR_DRIVER } from './driver-id';
+import './angular-query';
+import './navigation';
+export { ANGULAR_DRIVER };
+/**
+ * What the driver needs of a `ComponentFixture`: a structural type, so a
+ * fixture from TestBed, `@testing-library/angular` or `cypress/angular` all
+ * fit, and nothing here imports `@angular/core/testing` at runtime.
+ */
+export interface AngularFixture {
+    whenStable(): Promise<unknown>;
+    readonly componentRef: Pick<ComponentRef<unknown>, 'injector'>;
+}
+export interface AngularEnv extends EnvConfig {
+    readonly driver: typeof ANGULAR_DRIVER;
+    /** A test's fixture. Every action ends at its `whenStable()`. */
+    readonly fixture: AngularFixture | undefined;
+    /** A bootstrapped app. Without a fixture, every action ends at its `whenStable()`. */
+    readonly app: ApplicationRef | undefined;
+    /**
+     * Where queries start, scoped and `{ global: true }` alike. Defaults to
+     * `document.body`, read at query time: TestBed attaches each fixture there,
+     * and the CDK's overlays and other portals render there too.
+     */
+    readonly root: Element | undefined;
+}
+export interface AngularEnvOptions {
+    /** A `ComponentFixture`: TestBed's `createComponent()`, or a render result's `fixture`. */
+    fixture?: AngularFixture;
+    /** The `ApplicationRef` `bootstrapApplication()` resolves to, for an app with no fixture. */
+    app?: ApplicationRef;
+    root?: Element;
+}
+/**
+ * Builds the env a harness is constructed with in an Angular test:
+ *
+ * ```ts
+ * const { fixture } = await render(LoginForm)
+ * const form = new LoginFormHarness(angular({ fixture }))
+ * ```
+ *
+ * or, for an app bootstrapped without TestBed:
+ *
+ * ```ts
+ * const app = await bootstrapApplication(App, appConfig)
+ * const page = new CheckoutPage(angular({ app }))
+ * ```
+ *
+ * One of the two is required. Nothing else finds an app reliably: the `ng`
+ * global and `getAllAngularRootElements()` exist only in development builds,
+ * and testabilities only where zone.js is loaded.
+ */
+export declare function angular({ fixture, app, root }?: AngularEnvOptions): AngularEnv;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAG5C,OAAO,iBAAiB,CAAA;AACxB,OAAO,cAAc,CAAA;AAErB,OAAO,EAAE,cAAc,EAAE,CAAA;AAEzB;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC,CAAA;IAC9B,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,CAAA;CAC/D;AAED,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,cAAc,CAAA;IACtC,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,CAAA;IAC5C,sFAAsF;IACtF,QAAQ,CAAC,GAAG,EAAE,cAAc,GAAG,SAAS,CAAA;IACxC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAAA;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,2FAA2F;IAC3F,OAAO,CAAC,EAAE,cAAc,CAAA;IACxB,6FAA6F;IAC7F,GAAG,CAAC,EAAE,cAAc,CAAA;IACpB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAE,iBAAsB,GAAG,UAAU,CAQlF"}

package/dist/index.cjs

@@ -0,0 +1,291 @@
+'use strict';
+
+var core = require('@harnessed-ts/core');
+var resolve = require('@harnessed-ts/resolve');
+var dom = require('@testing-library/dom');
+var userEvent = require('@testing-library/user-event');
+var common = require('@angular/common');
+var router = require('@angular/router');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var userEvent__default = /*#__PURE__*/_interopDefault(userEvent);
+
+// src/driver-id.ts
+var ANGULAR_DRIVER = "angular";
+
+// src/stable.ts
+async function settle(env) {
+  await (env.fixture ?? env.app)?.whenStable();
+}
+function injectorOf(env) {
+  return env.fixture?.componentRef.injector ?? env.app?.injector;
+}
+
+// src/angular-query.ts
+var users = /* @__PURE__ */ new WeakMap();
+function userFor(element) {
+  const document2 = element.ownerDocument;
+  let user = users.get(document2);
+  if (user === void 0) {
+    user = userEvent__default.default.setup({ document: document2 });
+    users.set(document2, user);
+  }
+  return user;
+}
+function toKeyboardInput(key) {
+  return key.length === 1 ? key : `{${key}}`;
+}
+function computesLayout(document2) {
+  const agent = document2.defaultView?.navigator.userAgent ?? "";
+  return !/\bjsdom\b|HappyDOM/.test(agent);
+}
+function isVisibleByStyle(element, home) {
+  let current = element;
+  while (current !== null) {
+    const view = current.ownerDocument.defaultView ?? window;
+    const style = view.getComputedStyle(current);
+    if (style.display === "none" || style.visibility === "hidden" || style.opacity === "0") {
+      return false;
+    }
+    if (current.hasAttribute("hidden")) return false;
+    current = current.parentElement ?? (current.ownerDocument === home ? null : view.frameElement);
+  }
+  return true;
+}
+async function waitUntil(condition, timeout) {
+  let refused;
+  await dom.waitFor(
+    async () => {
+      try {
+        await condition();
+      } catch (error) {
+        if (!(error instanceof resolve.FrameEntryError || error instanceof core.StrictModeViolation)) {
+          throw error;
+        }
+        refused = error;
+      }
+    },
+    { timeout }
+  );
+  if (refused !== void 0) throw refused;
+}
+var AngularQuery = class _AngularQuery extends core.Query {
+  constructor(env, scope, selector) {
+    super(scope, selector);
+    this.env = env;
+  }
+  env;
+  clone(selector) {
+    return new _AngularQuery(this.env, this.scope, selector);
+  }
+  /** Read per call: the body belongs to the current test, not the env. */
+  container() {
+    return this.env.root ?? document.body;
+  }
+  element(options) {
+    return resolve.resolveOne(this.container(), this.scope, this.selector, options?.timeout);
+  }
+  /** Ends an action where the app does: rendered, with nothing pending. */
+  settled() {
+    return settle(this.env);
+  }
+  /** Every match in one pass, each bound to its node. See `DomQuery.all`. */
+  async all() {
+    return (await resolve.resolveAll(this.container(), this.scope, this.selector)).map(
+      (element, index) => new BoundAngularQuery(this.env, this.scope, core.nth(this.selector, index), element)
+    );
+  }
+  // --- interactions -------------------------------------------------------
+  async click(options) {
+    const element = await this.element(options);
+    await userFor(element).click(element);
+    await this.settled();
+  }
+  async fill(value, options) {
+    const element = await this.element(options);
+    const user = userFor(element);
+    await user.clear(element);
+    if (value !== "") await user.type(element, value);
+    await this.settled();
+  }
+  async clear(options) {
+    const element = await this.element(options);
+    await userFor(element).clear(element);
+    await this.settled();
+  }
+  async check(options) {
+    const element = await this.element(options);
+    if (!element.checked) await userFor(element).click(element);
+    await this.settled();
+  }
+  async uncheck(options) {
+    const element = await this.element(options);
+    if (element.checked) await userFor(element).click(element);
+    await this.settled();
+  }
+  async selectOption(value, options) {
+    const element = await this.element(options);
+    const user = userFor(element);
+    if (element.multiple) {
+      const selected = [...element.selectedOptions].map((option) => option.value);
+      if (selected.length > 0) await user.deselectOptions(element, selected);
+    }
+    await user.selectOptions(element, value);
+    await this.settled();
+  }
+  async hover(options) {
+    const element = await this.element(options);
+    await userFor(element).hover(element);
+    await this.settled();
+  }
+  async focus(options) {
+    (await this.element(options)).focus();
+    await this.settled();
+  }
+  async blur(options) {
+    (await this.element(options)).blur();
+    await this.settled();
+  }
+  async press(key, options) {
+    const element = await this.element(options);
+    element.focus();
+    await userFor(element).keyboard(toKeyboardInput(key));
+    await this.settled();
+  }
+  async upload(files, options) {
+    const list = Array.isArray(files) ? files : [files];
+    const input = resolve.fileInputOf(await this.element(options));
+    core.checkFileTarget(input, list.length, this.scope, this.selector);
+    await userFor(input).upload(input, list);
+    await this.settled();
+  }
+  // --- observations -------------------------------------------------------
+  async text(options) {
+    return ((await this.element(options)).textContent ?? "").trim();
+  }
+  async inputValue(options) {
+    const element = await this.element(options);
+    return element.value ?? "";
+  }
+  async attribute(name, options) {
+    return (await this.element(options)).getAttribute(name);
+  }
+  async isVisible(options) {
+    try {
+      const element = await this.element(options);
+      const home = this.container().ownerDocument;
+      return computesLayout(home) ? resolve.isVisibleInLayout(element, home) : isVisibleByStyle(element, home);
+    } catch (error) {
+      if (error instanceof resolve.FrameEntryError || error instanceof core.StrictModeViolation) throw error;
+      return false;
+    }
+  }
+  async isEnabled(options) {
+    const element = await this.element(options);
+    const disabled = element.disabled === true || element.closest(":disabled") !== null;
+    return core.enabledFrom(disabled, element.getAttribute("aria-disabled"));
+  }
+  async isChecked(options) {
+    const element = await this.element(options);
+    return core.checkedFrom(
+      element.getAttribute("aria-checked"),
+      Boolean(element.checked)
+    );
+  }
+  async selectedOptions(options) {
+    const element = await this.element(options);
+    return [...element.selectedOptions ?? []].map((option) => option.value);
+  }
+  /** Under jsdom, which computes no layout, every box is all zeros. */
+  async boundingBox(options) {
+    return resolve.boundingBoxOf(await this.element(options), this.container().ownerDocument);
+  }
+  // --- waiting ------------------------------------------------------------
+  async waitFor(state, options) {
+    const timeout = core.timeoutFor(options?.timeout);
+    if (state === "visible") {
+      await waitUntil(async () => {
+        if (!await this.isVisible({ timeout })) throw new Error("not visible yet");
+      }, timeout);
+    } else {
+      await waitUntil(async () => {
+        if (await this.count() !== 0 && await this.isVisible({ timeout })) {
+          throw new Error("still visible");
+        }
+      }, timeout);
+    }
+    await this.settled();
+  }
+  async count() {
+    return resolve.countAll(this.container(), this.scope, this.selector);
+  }
+};
+var BoundAngularQuery = class extends AngularQuery {
+  constructor(env, scope, selector, bound) {
+    super(env, scope, selector);
+    this.bound = bound;
+  }
+  bound;
+  async element(options) {
+    if (this.bound.isConnected) return this.bound;
+    return super.element(options);
+  }
+};
+core.registerDriver(ANGULAR_DRIVER, (env, scope, selector) => {
+  return new AngularQuery(env, scope, selector);
+});
+function routing(env) {
+  const injector = injectorOf(env);
+  if (injector.get(router.ROUTES, null) === null) {
+    throw new Error(
+      `harnessed: the "${ANGULAR_DRIVER}" driver cannot navigate without a Router, so a page cannot navigate with it. Provide one to the app or the TestBed (provideRouter()), or reach the page by rendering it.`
+    );
+  }
+  return { router: injector.get(router.Router), location: injector.get(common.Location) };
+}
+function absolute(env) {
+  const { router, location } = routing(env);
+  if (!router.navigated) {
+    throw new Error(
+      "harnessed: the router has not navigated yet. Call a page\u2019s goto(), or router.navigateByUrl(), first."
+    );
+  }
+  return new URL(location.path(), window.location.origin).href;
+}
+core.registerNavigation(ANGULAR_DRIVER, {
+  async goto(env, url) {
+    const { router } = routing(env);
+    await router.navigateByUrl(url);
+    await settle(env);
+  },
+  currentUrl(env) {
+    return absolute(env);
+  },
+  async waitForUrl(env, matches, timeout) {
+    absolute(env);
+    await dom.waitFor(
+      () => {
+        if (!matches(new URL(absolute(env)))) throw new Error(`still at ${absolute(env)}`);
+      },
+      { timeout }
+    );
+    await settle(env);
+  }
+});
+
+// src/env.ts
+function angular({ fixture, app, root } = {}) {
+  if (fixture === void 0 && app === void 0) {
+    throw new TypeError(
+      "harnessed: angular() needs the app it drives \u2014 pass { fixture } from TestBed or a render result, or { app } with the ApplicationRef bootstrapApplication() resolved to."
+    );
+  }
+  return { driver: ANGULAR_DRIVER, fixture, app, root };
+}
+
+exports.ANGULAR_DRIVER = ANGULAR_DRIVER;
+exports.AngularQuery = AngularQuery;
+exports.angular = angular;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/driver-id.ts","../src/stable.ts","../src/angular-query.ts","../src/navigation.ts","../src/env.ts"],"names":["document","userEvent","waitForCondition","FrameEntryError","StrictModeViolation","Query","resolveOne","resolveAll","withNth","fileInputOf","checkFileTarget","isVisibleInLayout","enabledFrom","checkedFrom","boundingBoxOf","timeoutFor","countAll","registerDriver","ROUTES","Router","Location","registerNavigation"],"mappings":";;;;;;;;;;;;;;AACO,IAAM,cAAA,GAAiB;;;ACQ9B,eAAsB,OAAO,GAAA,EAAgC;AAC3D,EAAA,MAAA,CAAO,GAAA,CAAI,OAAA,IAAW,GAAA,CAAI,GAAA,GAAM,UAAA,EAAW;AAC7C;AAGO,SAAS,WAAW,GAAA,EAA2B;AACpD,EAAA,OAAQ,GAAA,CAAI,OAAA,EAAS,YAAA,CAAa,QAAA,IAAY,IAAI,GAAA,EAAK,QAAA;AACzD;;;ACcA,IAAM,KAAA,uBAAY,OAAA,EAA6B;AAE/C,SAAS,QAAQ,OAAA,EAA6B;AAC5C,EAAA,MAAMA,YAAW,OAAA,CAAQ,aAAA;AACzB,EAAA,IAAI,IAAA,GAAO,KAAA,CAAM,GAAA,CAAIA,SAAQ,CAAA;AAC7B,EAAA,IAAI,SAAS,MAAA,EAAW;AACtB,IAAA,IAAA,GAAOC,0BAAA,CAAU,KAAA,CAAM,EAAE,QAAA,EAAAD,WAAU,CAAA;AACnC,IAAA,KAAA,CAAM,GAAA,CAAIA,WAAU,IAAI,CAAA;AAAA,EAC1B;AACA,EAAA,OAAO,IAAA;AACT;AAGA,SAAS,gBAAgB,GAAA,EAAqB;AAC5C,EAAA,OAAO,GAAA,CAAI,MAAA,KAAW,CAAA,GAAI,GAAA,GAAM,IAAI,GAAG,CAAA,CAAA,CAAA;AACzC;AAMA,SAAS,eAAeA,SAAAA,EAA6B;AACnD,EAAA,MAAM,KAAA,GAAQA,SAAAA,CAAS,WAAA,EAAa,SAAA,CAAU,SAAA,IAAa,EAAA;AAC3D,EAAA,OAAO,CAAC,oBAAA,CAAqB,IAAA,CAAK,KAAK,CAAA;AACzC;AAMA,SAAS,gBAAA,CAAiB,SAAsB,IAAA,EAAyB;AACvE,EAAA,IAAI,OAAA,GAA8B,OAAA;AAClC,EAAA,OAAO,YAAY,IAAA,EAAM;AACvB,IAAA,MAAM,IAAA,GAAe,OAAA,CAAQ,aAAA,CAAc,WAAA,IAAe,MAAA;AAC1D,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,gBAAA,CAAiB,OAAO,CAAA;AAC3C,IAAA,IAAI,KAAA,CAAM,YAAY,MAAA,IAAU,KAAA,CAAM,eAAe,QAAA,IAAY,KAAA,CAAM,YAAY,GAAA,EAAK;AACtF,MAAA,OAAO,KAAA;AAAA,IACT;AACA,IAAA,IAAI,OAAA,CAAQ,YAAA,CAAa,QAAQ,CAAA,EAAG,OAAO,KAAA;AAC3C,IAAA,OAAA,GACE,QAAQ,aAAA,KACP,OAAA,CAAQ,aAAA,KAAkB,IAAA,GAAO,OAAQ,IAAA,CAAK,YAAA,CAAA;AAAA,EACnD;AACA,EAAA,OAAO,IAAA;AACT;AAOA,eAAe,SAAA,CAAU,WAAgC,OAAA,EAAgC;AACvF,EAAA,IAAI,OAAA;AACJ,EAAA,MAAME,WAAA;AAAA,IACJ,YAAY;AACV,MAAA,IAAI;AACF,QAAA,MAAM,SAAA,EAAU;AAAA,MAClB,SAAS,KAAA,EAAO;AACd,QAAA,IAAI,EAAE,KAAA,YAAiBC,uBAAA,IAAmB,KAAA,YAAiBC,wBAAA,CAAA,EAAsB;AAC/E,UAAA,MAAM,KAAA;AAAA,QACR;AACA,QAAA,OAAA,GAAU,KAAA;AAAA,MACZ;AAAA,IACF,CAAA;AAAA,IACA,EAAE,OAAA;AAAQ,GACZ;AACA,EAAA,IAAI,OAAA,KAAY,QAAW,MAAM,OAAA;AACnC;AAYO,IAAM,YAAA,GAAN,MAAM,aAAA,SAAqBC,UAAA,CAAM;AAAA,EACtC,WAAA,CACmB,GAAA,EACjB,KAAA,EACA,QAAA,EACA;AACA,IAAA,KAAA,CAAM,OAAO,QAAQ,CAAA;AAJJ,IAAA,IAAA,CAAA,GAAA,GAAA,GAAA;AAAA,EAKnB;AAAA,EALmB,GAAA;AAAA,EAOA,MAAM,QAAA,EAA2B;AAClD,IAAA,OAAO,IAAI,aAAA,CAAa,IAAA,CAAK,GAAA,EAAK,IAAA,CAAK,OAAO,QAAQ,CAAA;AAAA,EACxD;AAAA;AAAA,EAGU,SAAA,GAAyB;AACjC,IAAA,OAAQ,IAAA,CAAK,GAAA,CAAI,IAAA,IAAQ,QAAA,CAAS,IAAA;AAAA,EACpC;AAAA,EAEU,QAAQ,OAAA,EAA6C;AAC7D,IAAA,OAAOC,kBAAA,CAAW,KAAK,SAAA,EAAU,EAAG,KAAK,KAAA,EAAO,IAAA,CAAK,QAAA,EAAU,OAAA,EAAS,OAAO,CAAA;AAAA,EACjF;AAAA;AAAA,EAGU,OAAA,GAAyB;AACjC,IAAA,OAAO,MAAA,CAAO,KAAK,GAAG,CAAA;AAAA,EACxB;AAAA;AAAA,EAGA,MAAe,GAAA,GAAwB;AACrC,IAAA,OAAA,CAAQ,MAAMC,mBAAW,IAAA,CAAK,SAAA,IAAa,IAAA,CAAK,KAAA,EAAO,IAAA,CAAK,QAAQ,CAAA,EAAG,GAAA;AAAA,MACrE,CAAC,OAAA,EAAS,KAAA,KACR,IAAI,kBAAkB,IAAA,CAAK,GAAA,EAAK,IAAA,CAAK,KAAA,EAAOC,QAAA,CAAQ,IAAA,CAAK,QAAA,EAAU,KAAK,GAAG,OAAO;AAAA,KACtF;AAAA,EACF;AAAA;AAAA,EAIA,MAAe,MAAM,OAAA,EAAsC;AACzD,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA;AAC1C,IAAA,MAAM,OAAA,CAAQ,OAAO,CAAA,CAAE,KAAA,CAAM,OAAO,CAAA;AACpC,IAAA,MAAM,KAAK,OAAA,EAAQ;AAAA,EACrB;AAAA,EAEA,MAAe,IAAA,CAAK,KAAA,EAAe,OAAA,EAAsC;AACvE,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA;AAC1C,IAAA,MAAM,IAAA,GAAO,QAAQ,OAAO,CAAA;AAC5B,IAAA,MAAM,IAAA,CAAK,MAAM,OAAO,CAAA;AAGxB,IAAA,IAAI,UAAU,EAAA,EAAI,MAAM,IAAA,CAAK,IAAA,CAAK,SAAS,KAAK,CAAA;AAChD,IAAA,MAAM,KAAK,OAAA,EAAQ;AAAA,EACrB;AAAA,EAEA,MAAe,MAAM,OAAA,EAAsC;AACzD,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA;AAC1C,IAAA,MAAM,OAAA,CAAQ,OAAO,CAAA,CAAE,KAAA,CAAM,OAAO,CAAA;AACpC,IAAA,MAAM,KAAK,OAAA,EAAQ;AAAA,EACrB;AAAA,EAEA,MAAe,MAAM,OAAA,EAAsC;AACzD,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA;AAC1C,IAAA,IAAI,CAAE,QAA6B,OAAA,EAAS,MAAM,QAAQ,OAAO,CAAA,CAAE,MAAM,OAAO,CAAA;AAChF,IAAA,MAAM,KAAK,OAAA,EAAQ;AAAA,EACrB;AAAA,EAEA,MAAe,QAAQ,OAAA,EAAsC;AAC3D,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA;AAC1C,IAAA,IAAK,QAA6B,OAAA,EAAS,MAAM,QAAQ,OAAO,CAAA,CAAE,MAAM,OAAO,CAAA;AAC/E,IAAA,MAAM,KAAK,OAAA,EAAQ;AAAA,EACrB;AAAA,EAEA,MAAe,YAAA,CAAa,KAAA,EAA0B,OAAA,EAAsC;AAC1F,IAAA,MAAM,OAAA,GAAW,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA;AAC3C,IAAA,MAAM,IAAA,GAAO,QAAQ,OAAO,CAAA;AAG5B,IAAA,IAAI,QAAQ,QAAA,EAAU;AACpB,MAAA,MAAM,QAAA,GAAW,CAAC,GAAG,OAAA,CAAQ,eAAe,CAAA,CAAE,GAAA,CAAI,CAAA,MAAA,KAAU,MAAA,CAAO,KAAK,CAAA;AACxE,MAAA,IAAI,SAAS,MAAA,GAAS,CAAA,QAAS,IAAA,CAAK,eAAA,CAAgB,SAAS,QAAQ,CAAA;AAAA,IACvE;AACA,IAAA,MAAM,IAAA,CAAK,aAAA,CAAc,OAAA,EAAS,KAAK,CAAA;AACvC,IAAA,MAAM,KAAK,OAAA,EAAQ;AAAA,EACrB;AAAA,EAEA,MAAe,MAAM,OAAA,EAAsC;AACzD,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA;AAC1C,IAAA,MAAM,OAAA,CAAQ,OAAO,CAAA,CAAE,KAAA,CAAM,OAAO,CAAA;AACpC,IAAA,MAAM,KAAK,OAAA,EAAQ;AAAA,EACrB;AAAA,EAEA,MAAe,MAAM,OAAA,EAAsC;AACxD,IAAA,CAAC,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,GAAG,KAAA,EAAM;AACrC,IAAA,MAAM,KAAK,OAAA,EAAQ;AAAA,EACrB;AAAA,EAEA,MAAe,KAAK,OAAA,EAAsC;AACvD,IAAA,CAAC,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,GAAG,IAAA,EAAK;AACpC,IAAA,MAAM,KAAK,OAAA,EAAQ;AAAA,EACrB;AAAA,EAEA,MAAe,KAAA,CAAM,GAAA,EAAa,OAAA,EAAsC;AACtE,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA;AAE1C,IAAA,OAAA,CAAQ,KAAA,EAAM;AACd,IAAA,MAAM,QAAQ,OAAO,CAAA,CAAE,QAAA,CAAS,eAAA,CAAgB,GAAG,CAAC,CAAA;AACpD,IAAA,MAAM,KAAK,OAAA,EAAQ;AAAA,EACrB;AAAA,EAEA,MAAe,MAAA,CAAO,KAAA,EAAsB,OAAA,EAAsC;AAChF,IAAA,MAAM,OAAO,KAAA,CAAM,OAAA,CAAQ,KAAK,CAAA,GAAI,KAAA,GAAQ,CAAC,KAAK,CAAA;AAClD,IAAA,MAAM,QAAQC,mBAAA,CAAY,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAC,CAAA;AACrD,IAAAC,oBAAA,CAAgB,OAAO,IAAA,CAAK,MAAA,EAAQ,IAAA,CAAK,KAAA,EAAO,KAAK,QAAQ,CAAA;AAC7D,IAAA,MAAM,OAAA,CAAQ,KAAK,CAAA,CAAE,MAAA,CAAO,OAAO,IAAI,CAAA;AACvC,IAAA,MAAM,KAAK,OAAA,EAAQ;AAAA,EACrB;AAAA;AAAA,EAIA,MAAe,KAAK,OAAA,EAAwC;AAC1D,IAAA,OAAA,CAAA,CAAS,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA,EAAG,WAAA,IAAe,IAAI,IAAA,EAAK;AAAA,EAChE;AAAA,EAEA,MAAe,WAAW,OAAA,EAAwC;AAChE,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA;AAC1C,IAAA,OAAQ,QAAuE,KAAA,IAAS,EAAA;AAAA,EAC1F;AAAA,EAEA,MAAe,SAAA,CAAU,IAAA,EAAc,OAAA,EAA+C;AACpF,IAAA,OAAA,CAAQ,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA,EAAG,aAAa,IAAI,CAAA;AAAA,EACxD;AAAA,EAEA,MAAe,UAAU,OAAA,EAAyC;AAChE,IAAA,IAAI;AACF,MAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA;AAC1C,MAAA,MAAM,IAAA,GAAO,IAAA,CAAK,SAAA,EAAU,CAAE,aAAA;AAG9B,MAAA,OAAO,cAAA,CAAe,IAAI,CAAA,GACtBC,yBAAA,CAAkB,SAAS,IAAI,CAAA,GAC/B,gBAAA,CAAiB,OAAA,EAAS,IAAI,CAAA;AAAA,IACpC,SAAS,KAAA,EAAO;AAGd,MAAA,IAAI,KAAA,YAAiBR,uBAAA,IAAmB,KAAA,YAAiBC,wBAAA,EAAqB,MAAM,KAAA;AAEpF,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAe,UAAU,OAAA,EAAyC;AAChE,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA;AAE1C,IAAA,MAAM,WACH,OAAA,CAA6B,QAAA,KAAa,QAAQ,OAAA,CAAQ,OAAA,CAAQ,WAAW,CAAA,KAAM,IAAA;AACtF,IAAA,OAAOQ,gBAAA,CAAY,QAAA,EAAU,OAAA,CAAQ,YAAA,CAAa,eAAe,CAAC,CAAA;AAAA,EACpE;AAAA,EAEA,MAAe,UAAU,OAAA,EAAyC;AAChE,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA;AAC1C,IAAA,OAAOC,gBAAA;AAAA,MACL,OAAA,CAAQ,aAAa,cAAc,CAAA;AAAA,MACnC,OAAA,CAAS,QAA6B,OAAO;AAAA,KAC/C;AAAA,EACF;AAAA,EAEA,MAAe,gBAAgB,OAAA,EAA0C;AACvE,IAAA,MAAM,OAAA,GAAW,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA;AAC3C,IAAA,OAAO,CAAC,GAAI,OAAA,CAAQ,eAAA,IAAmB,EAAG,CAAA,CAAE,GAAA,CAAI,CAAA,MAAA,KAAU,MAAA,CAAO,KAAK,CAAA;AAAA,EACxE;AAAA;AAAA,EAGA,MAAe,YAAY,OAAA,EAA6C;AACtE,IAAA,OAAOC,qBAAA,CAAc,MAAM,IAAA,CAAK,OAAA,CAAQ,OAAO,CAAA,EAAG,IAAA,CAAK,SAAA,EAAU,CAAE,aAAa,CAAA;AAAA,EAClF;AAAA;AAAA,EAIA,MAAe,OAAA,CAAQ,KAAA,EAAkB,OAAA,EAAsC;AAC7E,IAAA,MAAM,OAAA,GAAUC,eAAA,CAAW,OAAA,EAAS,OAAO,CAAA;AAC3C,IAAA,IAAI,UAAU,SAAA,EAAW;AACvB,MAAA,MAAM,UAAU,YAAY;AAC1B,QAAA,IAAI,CAAE,MAAM,IAAA,CAAK,SAAA,CAAU,EAAE,OAAA,EAAS,CAAA,EAAI,MAAM,IAAI,KAAA,CAAM,iBAAiB,CAAA;AAAA,MAC7E,GAAG,OAAO,CAAA;AAAA,IACZ,CAAA,MAAO;AACL,MAAA,MAAM,UAAU,YAAY;AAC1B,QAAA,IAAK,MAAM,IAAA,CAAK,KAAA,EAAM,KAAO,CAAA,IAAM,MAAM,IAAA,CAAK,SAAA,CAAU,EAAE,OAAA,EAAS,CAAA,EAAI;AACrE,UAAA,MAAM,IAAI,MAAM,eAAe,CAAA;AAAA,QACjC;AAAA,MACF,GAAG,OAAO,CAAA;AAAA,IACZ;AAGA,IAAA,MAAM,KAAK,OAAA,EAAQ;AAAA,EACrB;AAAA,EAEA,MAAe,KAAA,GAAyB;AACtC,IAAA,OAAOC,iBAAS,IAAA,CAAK,SAAA,IAAa,IAAA,CAAK,KAAA,EAAO,KAAK,QAAQ,CAAA;AAAA,EAC7D;AACF;AAGA,IAAM,iBAAA,GAAN,cAAgC,YAAA,CAAa;AAAA,EAC3C,WAAA,CACE,GAAA,EACA,KAAA,EACA,QAAA,EACiB,KAAA,EACjB;AACA,IAAA,KAAA,CAAM,GAAA,EAAK,OAAO,QAAQ,CAAA;AAFT,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAAA,EAGnB;AAAA,EAHmB,KAAA;AAAA,EAKnB,MAAyB,QAAQ,OAAA,EAA6C;AAC5E,IAAA,IAAI,IAAA,CAAK,KAAA,CAAM,WAAA,EAAa,OAAO,IAAA,CAAK,KAAA;AAGxC,IAAA,OAAO,KAAA,CAAM,QAAQ,OAAO,CAAA;AAAA,EAC9B;AACF,CAAA;AAEAC,mBAAA,CAAe,cAAA,EAAgB,CAAC,GAAA,EAAgB,KAAA,EAAO,QAAA,KAAa;AAClE,EAAA,OAAO,IAAI,YAAA,CAAa,GAAA,EAAmB,KAAA,EAAO,QAAQ,CAAA;AAC5D,CAAC,CAAA;ACvTD,SAAS,QAAQ,GAAA,EAAyB;AACxC,EAAA,MAAM,QAAA,GAAW,WAAW,GAAiB,CAAA;AAI7C,EAAA,IAAI,QAAA,CAAS,GAAA,CAAIC,aAAA,EAAQ,IAAI,MAAM,IAAA,EAAM;AACvC,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,mBAAmB,cAAc,CAAA,yKAAA;AAAA,KAGnC;AAAA,EACF;AACA,EAAA,OAAO,EAAE,MAAA,EAAQ,QAAA,CAAS,GAAA,CAAIC,aAAM,GAAG,QAAA,EAAU,QAAA,CAAS,GAAA,CAAIC,eAAQ,CAAA,EAAE;AAC1E;AAYA,SAAS,SAAS,GAAA,EAAwB;AACxC,EAAA,MAAM,EAAE,MAAA,EAAQ,QAAA,EAAS,GAAI,QAAQ,GAAG,CAAA;AACxC,EAAA,IAAI,CAAC,OAAO,SAAA,EAAW;AACrB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACA,EAAA,OAAO,IAAI,IAAI,QAAA,CAAS,IAAA,IAAQ,MAAA,CAAO,QAAA,CAAS,MAAM,CAAA,CAAE,IAAA;AAC1D;AAGAC,uBAAA,CAAmB,cAAA,EAAgB;AAAA,EACjC,MAAM,IAAA,CAAK,GAAA,EAAK,GAAA,EAAK;AACnB,IAAA,MAAM,EAAE,MAAA,EAAO,GAAI,OAAA,CAAQ,GAAG,CAAA;AAG9B,IAAA,MAAM,MAAA,CAAO,cAAc,GAAG,CAAA;AAC9B,IAAA,MAAM,OAAO,GAAiB,CAAA;AAAA,EAChC,CAAA;AAAA,EACA,WAAW,GAAA,EAAK;AACd,IAAA,OAAO,SAAS,GAAG,CAAA;AAAA,EACrB,CAAA;AAAA,EACA,MAAM,UAAA,CAAW,GAAA,EAAK,OAAA,EAAS,OAAA,EAAS;AAEtC,IAAA,QAAA,CAAS,GAAG,CAAA;AACZ,IAAA,MAAMnB,WAAAA;AAAA,MACJ,MAAM;AACJ,QAAA,IAAI,CAAC,OAAA,CAAQ,IAAI,GAAA,CAAI,QAAA,CAAS,GAAG,CAAC,CAAC,CAAA,EAAG,MAAM,IAAI,KAAA,CAAM,CAAA,SAAA,EAAY,QAAA,CAAS,GAAG,CAAC,CAAA,CAAE,CAAA;AAAA,MACnF,CAAA;AAAA,MACA,EAAE,OAAA;AAAQ,KACZ;AAEA,IAAA,MAAM,OAAO,GAAiB,CAAA;AAAA,EAChC;AACF,CAAC,CAAA;;;AClBM,SAAS,QAAQ,EAAE,OAAA,EAAS,KAAK,IAAA,EAAK,GAAuB,EAAC,EAAe;AAClF,EAAA,IAAI,OAAA,KAAY,MAAA,IAAa,GAAA,KAAQ,MAAA,EAAW;AAC9C,IAAA,MAAM,IAAI,SAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACA,EAAA,OAAO,EAAE,MAAA,EAAQ,cAAA,EAAgB,OAAA,EAAS,KAAK,IAAA,EAAK;AACtD","file":"index.cjs","sourcesContent":["/** The registry key for this driver. Its own module so env and query share it without a cycle. */\nexport const ANGULAR_DRIVER = 'angular'\n","import type { Injector } from '@angular/core'\nimport type { AngularEnv } from './env'\n\n/**\n * The app's settle point: the fixture's `whenStable()` if there is one, else\n * the `ApplicationRef`'s. Zoneless, both wait for Angular's pending tasks — a\n * scheduled change detection, a navigation, an `HttpClient` request — and not\n * for a bare `setTimeout`, which a zoneless app does not track.\n */\nexport async function settle(env: AngularEnv): Promise<void> {\n  await (env.fixture ?? env.app)?.whenStable()\n}\n\n/** Where the app's services live: the fixture's component injector, or the app's. */\nexport function injectorOf(env: AngularEnv): Injector {\n  return (env.fixture?.componentRef.injector ?? env.app?.injector) as Injector\n}\n","import { Query, registerDriver } from '@harnessed-ts/core'\nimport type { BoundingBox, EnvConfig, Selector, WaitOptions, WaitState } from '@harnessed-ts/core'\nimport {\n  checkedFrom,\n  checkFileTarget,\n  enabledFrom,\n  nth as withNth,\n  StrictModeViolation,\n  timeoutFor,\n} from '@harnessed-ts/core'\nimport {\n  boundingBoxOf,\n  countAll,\n  fileInputOf,\n  FrameEntryError,\n  isVisibleInLayout,\n  resolveAll,\n  resolveOne,\n} from '@harnessed-ts/resolve'\nimport { waitFor as waitForCondition } from '@testing-library/dom'\nimport userEvent from '@testing-library/user-event'\nimport type { UserEvent } from '@testing-library/user-event'\nimport { ANGULAR_DRIVER } from './driver-id'\nimport type { AngularEnv } from './env'\nimport { settle } from './stable'\n\n/**\n * One user-event instance per document, kept so pointer state carries between\n * calls: hovering B after A has to leave A first.\n */\nconst users = new WeakMap<Document, UserEvent>()\n\nfunction userFor(element: Element): UserEvent {\n  const document = element.ownerDocument\n  let user = users.get(document)\n  if (user === undefined) {\n    user = userEvent.setup({ document })\n    users.set(document, user)\n  }\n  return user\n}\n\n/** Playwright key names such as `Enter` map onto user-event's `{Enter}` syntax. */\nfunction toKeyboardInput(key: string): string {\n  return key.length === 1 ? key : `{${key}}`\n}\n\n/**\n * Whether the engine lays pages out. jsdom and happy-dom do not: every box is\n * zero there, so a layout check would call everything invisible.\n */\nfunction computesLayout(document: Document): boolean {\n  const agent = document.defaultView?.navigator.userAgent ?? ''\n  return !/\\bjsdom\\b|HappyDOM/.test(agent)\n}\n\n/**\n * The dom driver's rule, for an engine with no layout: computed style up the\n * tree, through the frames the scope entered. `home` is the env's own document.\n */\nfunction isVisibleByStyle(element: HTMLElement, home: Document): boolean {\n  let current: HTMLElement | null = element\n  while (current !== null) {\n    const view: Window = current.ownerDocument.defaultView ?? window\n    const style = view.getComputedStyle(current)\n    if (style.display === 'none' || style.visibility === 'hidden' || style.opacity === '0') {\n      return false\n    }\n    if (current.hasAttribute('hidden')) return false\n    current =\n      current.parentElement ??\n      (current.ownerDocument === home ? null : (view.frameElement as HTMLElement | null))\n  }\n  return true\n}\n\n/**\n * Testing Library's `waitFor` retries every throw, but a frame that cannot be\n * entered never becomes enterable, and several matches never become one — so\n * either ends the wait at once.\n */\nasync function waitUntil(condition: () => Promise<void>, timeout: number): Promise<void> {\n  let refused: FrameEntryError | StrictModeViolation | undefined\n  await waitForCondition(\n    async () => {\n      try {\n        await condition()\n      } catch (error) {\n        if (!(error instanceof FrameEntryError || error instanceof StrictModeViolation)) {\n          throw error\n        }\n        refused = error\n      }\n    },\n    { timeout },\n  )\n  if (refused !== undefined) throw refused\n}\n\n/**\n * Angular driver. Resolution is the shared resolver, so it agrees with every\n * other in-page driver. Interactions go through user-event, as in the dom\n * driver, and each one returns only once the app is stable: zoneless, an event\n * handler that changes a signal schedules change detection rather than running\n * it, so the DOM a test reads next is the one `whenStable()` hands back.\n *\n * Each action is handed the resolved element, never a selector string, so\n * strictness and scope stay this library's rather than `querySelector`'s.\n */\nexport class AngularQuery extends Query {\n  constructor(\n    private readonly env: AngularEnv,\n    scope: readonly Selector[],\n    selector: Selector,\n  ) {\n    super(scope, selector)\n  }\n\n  protected override clone(selector: Selector): Query {\n    return new AngularQuery(this.env, this.scope, selector)\n  }\n\n  /** Read per call: the body belongs to the current test, not the env. */\n  protected container(): HTMLElement {\n    return (this.env.root ?? document.body) as HTMLElement\n  }\n\n  protected element(options?: WaitOptions): Promise<HTMLElement> {\n    return resolveOne(this.container(), this.scope, this.selector, options?.timeout)\n  }\n\n  /** Ends an action where the app does: rendered, with nothing pending. */\n  protected settled(): Promise<void> {\n    return settle(this.env)\n  }\n\n  /** Every match in one pass, each bound to its node. See `DomQuery.all`. */\n  override async all(): Promise<Query[]> {\n    return (await resolveAll(this.container(), this.scope, this.selector)).map(\n      (element, index) =>\n        new BoundAngularQuery(this.env, this.scope, withNth(this.selector, index), element),\n    )\n  }\n\n  // --- interactions -------------------------------------------------------\n\n  override async click(options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    await userFor(element).click(element)\n    await this.settled()\n  }\n\n  override async fill(value: string, options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    const user = userFor(element)\n    await user.clear(element)\n    // user-event throws on an empty string, and clearing is the whole intent\n    // anyway — which is also what Playwright's fill('') does.\n    if (value !== '') await user.type(element, value)\n    await this.settled()\n  }\n\n  override async clear(options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    await userFor(element).clear(element)\n    await this.settled()\n  }\n\n  override async check(options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    if (!(element as HTMLInputElement).checked) await userFor(element).click(element)\n    await this.settled()\n  }\n\n  override async uncheck(options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    if ((element as HTMLInputElement).checked) await userFor(element).click(element)\n    await this.settled()\n  }\n\n  override async selectOption(value: string | string[], options?: WaitOptions): Promise<void> {\n    const element = (await this.element(options)) as HTMLSelectElement\n    const user = userFor(element)\n    // user-event adds to a multi-select's existing selection; the shared API\n    // replaces it, so clear first — as the dom driver does.\n    if (element.multiple) {\n      const selected = [...element.selectedOptions].map(option => option.value)\n      if (selected.length > 0) await user.deselectOptions(element, selected)\n    }\n    await user.selectOptions(element, value)\n    await this.settled()\n  }\n\n  override async hover(options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    await userFor(element).hover(element)\n    await this.settled()\n  }\n\n  override async focus(options?: WaitOptions): Promise<void> {\n    ;(await this.element(options)).focus()\n    await this.settled()\n  }\n\n  override async blur(options?: WaitOptions): Promise<void> {\n    ;(await this.element(options)).blur()\n    await this.settled()\n  }\n\n  override async press(key: string, options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    // Focus, then press: the key goes to the focused element, as in a browser.\n    element.focus()\n    await userFor(element).keyboard(toKeyboardInput(key))\n    await this.settled()\n  }\n\n  override async upload(files: File | File[], options?: WaitOptions): Promise<void> {\n    const list = Array.isArray(files) ? files : [files]\n    const input = fileInputOf(await this.element(options))\n    checkFileTarget(input, list.length, this.scope, this.selector)\n    await userFor(input).upload(input, list)\n    await this.settled()\n  }\n\n  // --- observations -------------------------------------------------------\n\n  override async text(options?: WaitOptions): Promise<string> {\n    return ((await this.element(options)).textContent ?? '').trim()\n  }\n\n  override async inputValue(options?: WaitOptions): Promise<string> {\n    const element = await this.element(options)\n    return (element as HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement).value ?? ''\n  }\n\n  override async attribute(name: string, options?: WaitOptions): Promise<string | null> {\n    return (await this.element(options)).getAttribute(name)\n  }\n\n  override async isVisible(options?: WaitOptions): Promise<boolean> {\n    try {\n      const element = await this.element(options)\n      const home = this.container().ownerDocument\n      // In a browser, a real layout check — Playwright's rule. Under jsdom,\n      // which lays nothing out, the dom driver's computed-style walk.\n      return computesLayout(home)\n        ? isVisibleInLayout(element, home)\n        : isVisibleByStyle(element, home)\n    } catch (error) {\n      // Several matches is ambiguity, not invisibility: answering false would\n      // claim that nodes on screen are not.\n      if (error instanceof FrameEntryError || error instanceof StrictModeViolation) throw error\n      // Not on screen at all, or an index past the last match.\n      return false\n    }\n  }\n\n  override async isEnabled(options?: WaitOptions): Promise<boolean> {\n    const element = await this.element(options)\n    // The property, and an ancestor `fieldset[disabled]`: see `DomQuery.isEnabled`.\n    const disabled =\n      (element as HTMLInputElement).disabled === true || element.closest(':disabled') !== null\n    return enabledFrom(disabled, element.getAttribute('aria-disabled'))\n  }\n\n  override async isChecked(options?: WaitOptions): Promise<boolean> {\n    const element = await this.element(options)\n    return checkedFrom(\n      element.getAttribute('aria-checked'),\n      Boolean((element as HTMLInputElement).checked),\n    )\n  }\n\n  override async selectedOptions(options?: WaitOptions): Promise<string[]> {\n    const element = (await this.element(options)) as HTMLSelectElement\n    return [...(element.selectedOptions ?? [])].map(option => option.value)\n  }\n\n  /** Under jsdom, which computes no layout, every box is all zeros. */\n  override async boundingBox(options?: WaitOptions): Promise<BoundingBox> {\n    return boundingBoxOf(await this.element(options), this.container().ownerDocument)\n  }\n\n  // --- waiting ------------------------------------------------------------\n\n  override async waitFor(state: WaitState, options?: WaitOptions): Promise<void> {\n    const timeout = timeoutFor(options?.timeout)\n    if (state === 'visible') {\n      await waitUntil(async () => {\n        if (!(await this.isVisible({ timeout }))) throw new Error('not visible yet')\n      }, timeout)\n    } else {\n      await waitUntil(async () => {\n        if ((await this.count()) !== 0 && (await this.isVisible({ timeout }))) {\n          throw new Error('still visible')\n        }\n      }, timeout)\n    }\n    // Whatever made it appear or go may have scheduled more work; hand back a\n    // stable app, as every interaction does.\n    await this.settled()\n  }\n\n  override async count(): Promise<number> {\n    return countAll(this.container(), this.scope, this.selector)\n  }\n}\n\n/** A query pinned to a node `all()` already found. See `BoundDomQuery`. */\nclass BoundAngularQuery extends AngularQuery {\n  constructor(\n    env: AngularEnv,\n    scope: readonly Selector[],\n    selector: Selector,\n    private readonly bound: HTMLElement,\n  ) {\n    super(env, scope, selector)\n  }\n\n  protected override async element(options?: WaitOptions): Promise<HTMLElement> {\n    if (this.bound.isConnected) return this.bound\n    // A re-render replaced the node; the selector still carries this query's\n    // index, so ordinary resolution finds the replacement.\n    return super.element(options)\n  }\n}\n\nregisterDriver(ANGULAR_DRIVER, (env: EnvConfig, scope, selector) => {\n  return new AngularQuery(env as AngularEnv, scope, selector)\n})\n","import { Location } from '@angular/common'\nimport { Router, ROUTES } from '@angular/router'\nimport { registerNavigation } from '@harnessed-ts/core'\nimport type { EnvConfig } from '@harnessed-ts/core'\nimport { waitFor as waitForCondition } from '@testing-library/dom'\nimport { ANGULAR_DRIVER } from './driver-id'\nimport type { AngularEnv } from './env'\nimport { injectorOf, settle } from './stable'\n\ninterface Routing {\n  router: Router\n  location: Location\n}\n\n/**\n * The app's router, or the standard refusal. A component rendered on its own\n * has no router to drive — the Angular shape of a jsdom test — and a page there\n * constructs and reads, but cannot navigate.\n */\nfunction routing(env: EnvConfig): Routing {\n  const injector = injectorOf(env as AngularEnv)\n  // Not `get(Router, null)`: the Router is provided in root, so it always\n  // resolves — to one with no routes, which matches no URL. The ROUTES token is\n  // what `provideRouter()` and `RouterModule.forRoot()` add.\n  if (injector.get(ROUTES, null) === null) {\n    throw new Error(\n      `harnessed: the \"${ANGULAR_DRIVER}\" driver cannot navigate without a Router, so a page ` +\n        'cannot navigate with it. Provide one to the app or the TestBed (provideRouter()), or ' +\n        'reach the page by rendering it.',\n    )\n  }\n  return { router: injector.get(Router), location: injector.get(Location) }\n}\n\n/**\n * The router's URL, made absolute. `Location.path()` is the truth, not\n * `window.location`: TestBed swaps in a mock platform location, so a test's\n * navigations never reach the address bar. Absolute because a page reads\n * `pathname` and `searchParams` off it with `new URL()`.\n *\n * There is no URL before the router's first navigation — TestBed performs\n * none of its own. Reading that as `/` would let `assertPathname('/')` pass\n * before anything navigated, so it refuses.\n */\nfunction absolute(env: EnvConfig): string {\n  const { router, location } = routing(env)\n  if (!router.navigated) {\n    throw new Error(\n      'harnessed: the router has not navigated yet. Call a page’s goto(), or ' +\n        'router.navigateByUrl(), first.',\n    )\n  }\n  return new URL(location.path(), window.location.origin).href\n}\n\n/** Navigation through the app's Router, wherever one is provided. */\nregisterNavigation(ANGULAR_DRIVER, {\n  async goto(env, url) {\n    const { router } = routing(env)\n    // Resolves once the navigation ends; whenStable() then waits out the\n    // change detection it scheduled, so the destination is on screen.\n    await router.navigateByUrl(url)\n    await settle(env as AngularEnv)\n  },\n  currentUrl(env) {\n    return absolute(env)\n  },\n  async waitForUrl(env, matches, timeout) {\n    // Outside the retry loop: no router is a refusal, not something to wait out.\n    absolute(env)\n    await waitForCondition(\n      () => {\n        if (!matches(new URL(absolute(env)))) throw new Error(`still at ${absolute(env)}`)\n      },\n      { timeout },\n    )\n    // The URL changes before the destination has rendered.\n    await settle(env as AngularEnv)\n  },\n})\n","import type { ApplicationRef, ComponentRef } from '@angular/core'\nimport type { EnvConfig } from '@harnessed-ts/core'\nimport { ANGULAR_DRIVER } from './driver-id'\n// Imported for their side effects: constructing an env is the moment the driver\n// has to be in the registry, and a bare re-export could be tree-shaken away.\nimport './angular-query'\nimport './navigation'\n\nexport { ANGULAR_DRIVER }\n\n/**\n * What the driver needs of a `ComponentFixture`: a structural type, so a\n * fixture from TestBed, `@testing-library/angular` or `cypress/angular` all\n * fit, and nothing here imports `@angular/core/testing` at runtime.\n */\nexport interface AngularFixture {\n  whenStable(): Promise<unknown>\n  readonly componentRef: Pick<ComponentRef<unknown>, 'injector'>\n}\n\nexport interface AngularEnv extends EnvConfig {\n  readonly driver: typeof ANGULAR_DRIVER\n  /** A test's fixture. Every action ends at its `whenStable()`. */\n  readonly fixture: AngularFixture | undefined\n  /** A bootstrapped app. Without a fixture, every action ends at its `whenStable()`. */\n  readonly app: ApplicationRef | undefined\n  /**\n   * Where queries start, scoped and `{ global: true }` alike. Defaults to\n   * `document.body`, read at query time: TestBed attaches each fixture there,\n   * and the CDK's overlays and other portals render there too.\n   */\n  readonly root: Element | undefined\n}\n\nexport interface AngularEnvOptions {\n  /** A `ComponentFixture`: TestBed's `createComponent()`, or a render result's `fixture`. */\n  fixture?: AngularFixture\n  /** The `ApplicationRef` `bootstrapApplication()` resolves to, for an app with no fixture. */\n  app?: ApplicationRef\n  root?: Element\n}\n\n/**\n * Builds the env a harness is constructed with in an Angular test:\n *\n * ```ts\n * const { fixture } = await render(LoginForm)\n * const form = new LoginFormHarness(angular({ fixture }))\n * ```\n *\n * or, for an app bootstrapped without TestBed:\n *\n * ```ts\n * const app = await bootstrapApplication(App, appConfig)\n * const page = new CheckoutPage(angular({ app }))\n * ```\n *\n * One of the two is required. Nothing else finds an app reliably: the `ng`\n * global and `getAllAngularRootElements()` exist only in development builds,\n * and testabilities only where zone.js is loaded.\n */\nexport function angular({ fixture, app, root }: AngularEnvOptions = {}): AngularEnv {\n  if (fixture === undefined && app === undefined) {\n    throw new TypeError(\n      'harnessed: angular() needs the app it drives — pass { fixture } from TestBed or a ' +\n        'render result, or { app } with the ApplicationRef bootstrapApplication() resolved to.',\n    )\n  }\n  return { driver: ANGULAR_DRIVER, fixture, app, root }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { angular, ANGULAR_DRIVER } from './env';
+export type { AngularEnv, AngularEnvOptions, AngularFixture } from './env';
+export { AngularQuery } from './angular-query';
+//# 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,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAC/C,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,283 @@
+import { registerDriver, registerNavigation, Query, nth, checkFileTarget, StrictModeViolation, enabledFrom, checkedFrom, timeoutFor } from '@harnessed-ts/core';
+import { resolveOne, resolveAll, fileInputOf, isVisibleInLayout, FrameEntryError, boundingBoxOf, countAll } from '@harnessed-ts/resolve';
+import { waitFor } from '@testing-library/dom';
+import userEvent from '@testing-library/user-event';
+import { Location } from '@angular/common';
+import { ROUTES, Router } from '@angular/router';
+
+// src/driver-id.ts
+var ANGULAR_DRIVER = "angular";
+
+// src/stable.ts
+async function settle(env) {
+  await (env.fixture ?? env.app)?.whenStable();
+}
+function injectorOf(env) {
+  return env.fixture?.componentRef.injector ?? env.app?.injector;
+}
+
+// src/angular-query.ts
+var users = /* @__PURE__ */ new WeakMap();
+function userFor(element) {
+  const document2 = element.ownerDocument;
+  let user = users.get(document2);
+  if (user === void 0) {
+    user = userEvent.setup({ document: document2 });
+    users.set(document2, user);
+  }
+  return user;
+}
+function toKeyboardInput(key) {
+  return key.length === 1 ? key : `{${key}}`;
+}
+function computesLayout(document2) {
+  const agent = document2.defaultView?.navigator.userAgent ?? "";
+  return !/\bjsdom\b|HappyDOM/.test(agent);
+}
+function isVisibleByStyle(element, home) {
+  let current = element;
+  while (current !== null) {
+    const view = current.ownerDocument.defaultView ?? window;
+    const style = view.getComputedStyle(current);
+    if (style.display === "none" || style.visibility === "hidden" || style.opacity === "0") {
+      return false;
+    }
+    if (current.hasAttribute("hidden")) return false;
+    current = current.parentElement ?? (current.ownerDocument === home ? null : view.frameElement);
+  }
+  return true;
+}
+async function waitUntil(condition, timeout) {
+  let refused;
+  await waitFor(
+    async () => {
+      try {
+        await condition();
+      } catch (error) {
+        if (!(error instanceof FrameEntryError || error instanceof StrictModeViolation)) {
+          throw error;
+        }
+        refused = error;
+      }
+    },
+    { timeout }
+  );
+  if (refused !== void 0) throw refused;
+}
+var AngularQuery = class _AngularQuery extends Query {
+  constructor(env, scope, selector) {
+    super(scope, selector);
+    this.env = env;
+  }
+  env;
+  clone(selector) {
+    return new _AngularQuery(this.env, this.scope, selector);
+  }
+  /** Read per call: the body belongs to the current test, not the env. */
+  container() {
+    return this.env.root ?? document.body;
+  }
+  element(options) {
+    return resolveOne(this.container(), this.scope, this.selector, options?.timeout);
+  }
+  /** Ends an action where the app does: rendered, with nothing pending. */
+  settled() {
+    return settle(this.env);
+  }
+  /** Every match in one pass, each bound to its node. See `DomQuery.all`. */
+  async all() {
+    return (await resolveAll(this.container(), this.scope, this.selector)).map(
+      (element, index) => new BoundAngularQuery(this.env, this.scope, nth(this.selector, index), element)
+    );
+  }
+  // --- interactions -------------------------------------------------------
+  async click(options) {
+    const element = await this.element(options);
+    await userFor(element).click(element);
+    await this.settled();
+  }
+  async fill(value, options) {
+    const element = await this.element(options);
+    const user = userFor(element);
+    await user.clear(element);
+    if (value !== "") await user.type(element, value);
+    await this.settled();
+  }
+  async clear(options) {
+    const element = await this.element(options);
+    await userFor(element).clear(element);
+    await this.settled();
+  }
+  async check(options) {
+    const element = await this.element(options);
+    if (!element.checked) await userFor(element).click(element);
+    await this.settled();
+  }
+  async uncheck(options) {
+    const element = await this.element(options);
+    if (element.checked) await userFor(element).click(element);
+    await this.settled();
+  }
+  async selectOption(value, options) {
+    const element = await this.element(options);
+    const user = userFor(element);
+    if (element.multiple) {
+      const selected = [...element.selectedOptions].map((option) => option.value);
+      if (selected.length > 0) await user.deselectOptions(element, selected);
+    }
+    await user.selectOptions(element, value);
+    await this.settled();
+  }
+  async hover(options) {
+    const element = await this.element(options);
+    await userFor(element).hover(element);
+    await this.settled();
+  }
+  async focus(options) {
+    (await this.element(options)).focus();
+    await this.settled();
+  }
+  async blur(options) {
+    (await this.element(options)).blur();
+    await this.settled();
+  }
+  async press(key, options) {
+    const element = await this.element(options);
+    element.focus();
+    await userFor(element).keyboard(toKeyboardInput(key));
+    await this.settled();
+  }
+  async upload(files, options) {
+    const list = Array.isArray(files) ? files : [files];
+    const input = fileInputOf(await this.element(options));
+    checkFileTarget(input, list.length, this.scope, this.selector);
+    await userFor(input).upload(input, list);
+    await this.settled();
+  }
+  // --- observations -------------------------------------------------------
+  async text(options) {
+    return ((await this.element(options)).textContent ?? "").trim();
+  }
+  async inputValue(options) {
+    const element = await this.element(options);
+    return element.value ?? "";
+  }
+  async attribute(name, options) {
+    return (await this.element(options)).getAttribute(name);
+  }
+  async isVisible(options) {
+    try {
+      const element = await this.element(options);
+      const home = this.container().ownerDocument;
+      return computesLayout(home) ? isVisibleInLayout(element, home) : isVisibleByStyle(element, home);
+    } catch (error) {
+      if (error instanceof FrameEntryError || error instanceof StrictModeViolation) throw error;
+      return false;
+    }
+  }
+  async isEnabled(options) {
+    const element = await this.element(options);
+    const disabled = element.disabled === true || element.closest(":disabled") !== null;
+    return enabledFrom(disabled, element.getAttribute("aria-disabled"));
+  }
+  async isChecked(options) {
+    const element = await this.element(options);
+    return checkedFrom(
+      element.getAttribute("aria-checked"),
+      Boolean(element.checked)
+    );
+  }
+  async selectedOptions(options) {
+    const element = await this.element(options);
+    return [...element.selectedOptions ?? []].map((option) => option.value);
+  }
+  /** Under jsdom, which computes no layout, every box is all zeros. */
+  async boundingBox(options) {
+    return boundingBoxOf(await this.element(options), this.container().ownerDocument);
+  }
+  // --- waiting ------------------------------------------------------------
+  async waitFor(state, options) {
+    const timeout = timeoutFor(options?.timeout);
+    if (state === "visible") {
+      await waitUntil(async () => {
+        if (!await this.isVisible({ timeout })) throw new Error("not visible yet");
+      }, timeout);
+    } else {
+      await waitUntil(async () => {
+        if (await this.count() !== 0 && await this.isVisible({ timeout })) {
+          throw new Error("still visible");
+        }
+      }, timeout);
+    }
+    await this.settled();
+  }
+  async count() {
+    return countAll(this.container(), this.scope, this.selector);
+  }
+};
+var BoundAngularQuery = class extends AngularQuery {
+  constructor(env, scope, selector, bound) {
+    super(env, scope, selector);
+    this.bound = bound;
+  }
+  bound;
+  async element(options) {
+    if (this.bound.isConnected) return this.bound;
+    return super.element(options);
+  }
+};
+registerDriver(ANGULAR_DRIVER, (env, scope, selector) => {
+  return new AngularQuery(env, scope, selector);
+});
+function routing(env) {
+  const injector = injectorOf(env);
+  if (injector.get(ROUTES, null) === null) {
+    throw new Error(
+      `harnessed: the "${ANGULAR_DRIVER}" driver cannot navigate without a Router, so a page cannot navigate with it. Provide one to the app or the TestBed (provideRouter()), or reach the page by rendering it.`
+    );
+  }
+  return { router: injector.get(Router), location: injector.get(Location) };
+}
+function absolute(env) {
+  const { router, location } = routing(env);
+  if (!router.navigated) {
+    throw new Error(
+      "harnessed: the router has not navigated yet. Call a page\u2019s goto(), or router.navigateByUrl(), first."
+    );
+  }
+  return new URL(location.path(), window.location.origin).href;
+}
+registerNavigation(ANGULAR_DRIVER, {
+  async goto(env, url) {
+    const { router } = routing(env);
+    await router.navigateByUrl(url);
+    await settle(env);
+  },
+  currentUrl(env) {
+    return absolute(env);
+  },
+  async waitForUrl(env, matches, timeout) {
+    absolute(env);
+    await waitFor(
+      () => {
+        if (!matches(new URL(absolute(env)))) throw new Error(`still at ${absolute(env)}`);
+      },
+      { timeout }
+    );
+    await settle(env);
+  }
+});
+
+// src/env.ts
+function angular({ fixture, app, root } = {}) {
+  if (fixture === void 0 && app === void 0) {
+    throw new TypeError(
+      "harnessed: angular() needs the app it drives \u2014 pass { fixture } from TestBed or a render result, or { app } with the ApplicationRef bootstrapApplication() resolved to."
+    );
+  }
+  return { driver: ANGULAR_DRIVER, fixture, app, root };
+}
+
+export { ANGULAR_DRIVER, AngularQuery, angular };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/driver-id.ts","../src/stable.ts","../src/angular-query.ts","../src/navigation.ts","../src/env.ts"],"names":["document","waitForCondition","withNth"],"mappings":"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","file":"index.js","sourcesContent":["/** The registry key for this driver. Its own module so env and query share it without a cycle. */\nexport const ANGULAR_DRIVER = 'angular'\n","import type { Injector } from '@angular/core'\nimport type { AngularEnv } from './env'\n\n/**\n * The app's settle point: the fixture's `whenStable()` if there is one, else\n * the `ApplicationRef`'s. Zoneless, both wait for Angular's pending tasks — a\n * scheduled change detection, a navigation, an `HttpClient` request — and not\n * for a bare `setTimeout`, which a zoneless app does not track.\n */\nexport async function settle(env: AngularEnv): Promise<void> {\n  await (env.fixture ?? env.app)?.whenStable()\n}\n\n/** Where the app's services live: the fixture's component injector, or the app's. */\nexport function injectorOf(env: AngularEnv): Injector {\n  return (env.fixture?.componentRef.injector ?? env.app?.injector) as Injector\n}\n","import { Query, registerDriver } from '@harnessed-ts/core'\nimport type { BoundingBox, EnvConfig, Selector, WaitOptions, WaitState } from '@harnessed-ts/core'\nimport {\n  checkedFrom,\n  checkFileTarget,\n  enabledFrom,\n  nth as withNth,\n  StrictModeViolation,\n  timeoutFor,\n} from '@harnessed-ts/core'\nimport {\n  boundingBoxOf,\n  countAll,\n  fileInputOf,\n  FrameEntryError,\n  isVisibleInLayout,\n  resolveAll,\n  resolveOne,\n} from '@harnessed-ts/resolve'\nimport { waitFor as waitForCondition } from '@testing-library/dom'\nimport userEvent from '@testing-library/user-event'\nimport type { UserEvent } from '@testing-library/user-event'\nimport { ANGULAR_DRIVER } from './driver-id'\nimport type { AngularEnv } from './env'\nimport { settle } from './stable'\n\n/**\n * One user-event instance per document, kept so pointer state carries between\n * calls: hovering B after A has to leave A first.\n */\nconst users = new WeakMap<Document, UserEvent>()\n\nfunction userFor(element: Element): UserEvent {\n  const document = element.ownerDocument\n  let user = users.get(document)\n  if (user === undefined) {\n    user = userEvent.setup({ document })\n    users.set(document, user)\n  }\n  return user\n}\n\n/** Playwright key names such as `Enter` map onto user-event's `{Enter}` syntax. */\nfunction toKeyboardInput(key: string): string {\n  return key.length === 1 ? key : `{${key}}`\n}\n\n/**\n * Whether the engine lays pages out. jsdom and happy-dom do not: every box is\n * zero there, so a layout check would call everything invisible.\n */\nfunction computesLayout(document: Document): boolean {\n  const agent = document.defaultView?.navigator.userAgent ?? ''\n  return !/\\bjsdom\\b|HappyDOM/.test(agent)\n}\n\n/**\n * The dom driver's rule, for an engine with no layout: computed style up the\n * tree, through the frames the scope entered. `home` is the env's own document.\n */\nfunction isVisibleByStyle(element: HTMLElement, home: Document): boolean {\n  let current: HTMLElement | null = element\n  while (current !== null) {\n    const view: Window = current.ownerDocument.defaultView ?? window\n    const style = view.getComputedStyle(current)\n    if (style.display === 'none' || style.visibility === 'hidden' || style.opacity === '0') {\n      return false\n    }\n    if (current.hasAttribute('hidden')) return false\n    current =\n      current.parentElement ??\n      (current.ownerDocument === home ? null : (view.frameElement as HTMLElement | null))\n  }\n  return true\n}\n\n/**\n * Testing Library's `waitFor` retries every throw, but a frame that cannot be\n * entered never becomes enterable, and several matches never become one — so\n * either ends the wait at once.\n */\nasync function waitUntil(condition: () => Promise<void>, timeout: number): Promise<void> {\n  let refused: FrameEntryError | StrictModeViolation | undefined\n  await waitForCondition(\n    async () => {\n      try {\n        await condition()\n      } catch (error) {\n        if (!(error instanceof FrameEntryError || error instanceof StrictModeViolation)) {\n          throw error\n        }\n        refused = error\n      }\n    },\n    { timeout },\n  )\n  if (refused !== undefined) throw refused\n}\n\n/**\n * Angular driver. Resolution is the shared resolver, so it agrees with every\n * other in-page driver. Interactions go through user-event, as in the dom\n * driver, and each one returns only once the app is stable: zoneless, an event\n * handler that changes a signal schedules change detection rather than running\n * it, so the DOM a test reads next is the one `whenStable()` hands back.\n *\n * Each action is handed the resolved element, never a selector string, so\n * strictness and scope stay this library's rather than `querySelector`'s.\n */\nexport class AngularQuery extends Query {\n  constructor(\n    private readonly env: AngularEnv,\n    scope: readonly Selector[],\n    selector: Selector,\n  ) {\n    super(scope, selector)\n  }\n\n  protected override clone(selector: Selector): Query {\n    return new AngularQuery(this.env, this.scope, selector)\n  }\n\n  /** Read per call: the body belongs to the current test, not the env. */\n  protected container(): HTMLElement {\n    return (this.env.root ?? document.body) as HTMLElement\n  }\n\n  protected element(options?: WaitOptions): Promise<HTMLElement> {\n    return resolveOne(this.container(), this.scope, this.selector, options?.timeout)\n  }\n\n  /** Ends an action where the app does: rendered, with nothing pending. */\n  protected settled(): Promise<void> {\n    return settle(this.env)\n  }\n\n  /** Every match in one pass, each bound to its node. See `DomQuery.all`. */\n  override async all(): Promise<Query[]> {\n    return (await resolveAll(this.container(), this.scope, this.selector)).map(\n      (element, index) =>\n        new BoundAngularQuery(this.env, this.scope, withNth(this.selector, index), element),\n    )\n  }\n\n  // --- interactions -------------------------------------------------------\n\n  override async click(options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    await userFor(element).click(element)\n    await this.settled()\n  }\n\n  override async fill(value: string, options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    const user = userFor(element)\n    await user.clear(element)\n    // user-event throws on an empty string, and clearing is the whole intent\n    // anyway — which is also what Playwright's fill('') does.\n    if (value !== '') await user.type(element, value)\n    await this.settled()\n  }\n\n  override async clear(options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    await userFor(element).clear(element)\n    await this.settled()\n  }\n\n  override async check(options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    if (!(element as HTMLInputElement).checked) await userFor(element).click(element)\n    await this.settled()\n  }\n\n  override async uncheck(options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    if ((element as HTMLInputElement).checked) await userFor(element).click(element)\n    await this.settled()\n  }\n\n  override async selectOption(value: string | string[], options?: WaitOptions): Promise<void> {\n    const element = (await this.element(options)) as HTMLSelectElement\n    const user = userFor(element)\n    // user-event adds to a multi-select's existing selection; the shared API\n    // replaces it, so clear first — as the dom driver does.\n    if (element.multiple) {\n      const selected = [...element.selectedOptions].map(option => option.value)\n      if (selected.length > 0) await user.deselectOptions(element, selected)\n    }\n    await user.selectOptions(element, value)\n    await this.settled()\n  }\n\n  override async hover(options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    await userFor(element).hover(element)\n    await this.settled()\n  }\n\n  override async focus(options?: WaitOptions): Promise<void> {\n    ;(await this.element(options)).focus()\n    await this.settled()\n  }\n\n  override async blur(options?: WaitOptions): Promise<void> {\n    ;(await this.element(options)).blur()\n    await this.settled()\n  }\n\n  override async press(key: string, options?: WaitOptions): Promise<void> {\n    const element = await this.element(options)\n    // Focus, then press: the key goes to the focused element, as in a browser.\n    element.focus()\n    await userFor(element).keyboard(toKeyboardInput(key))\n    await this.settled()\n  }\n\n  override async upload(files: File | File[], options?: WaitOptions): Promise<void> {\n    const list = Array.isArray(files) ? files : [files]\n    const input = fileInputOf(await this.element(options))\n    checkFileTarget(input, list.length, this.scope, this.selector)\n    await userFor(input).upload(input, list)\n    await this.settled()\n  }\n\n  // --- observations -------------------------------------------------------\n\n  override async text(options?: WaitOptions): Promise<string> {\n    return ((await this.element(options)).textContent ?? '').trim()\n  }\n\n  override async inputValue(options?: WaitOptions): Promise<string> {\n    const element = await this.element(options)\n    return (element as HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement).value ?? ''\n  }\n\n  override async attribute(name: string, options?: WaitOptions): Promise<string | null> {\n    return (await this.element(options)).getAttribute(name)\n  }\n\n  override async isVisible(options?: WaitOptions): Promise<boolean> {\n    try {\n      const element = await this.element(options)\n      const home = this.container().ownerDocument\n      // In a browser, a real layout check — Playwright's rule. Under jsdom,\n      // which lays nothing out, the dom driver's computed-style walk.\n      return computesLayout(home)\n        ? isVisibleInLayout(element, home)\n        : isVisibleByStyle(element, home)\n    } catch (error) {\n      // Several matches is ambiguity, not invisibility: answering false would\n      // claim that nodes on screen are not.\n      if (error instanceof FrameEntryError || error instanceof StrictModeViolation) throw error\n      // Not on screen at all, or an index past the last match.\n      return false\n    }\n  }\n\n  override async isEnabled(options?: WaitOptions): Promise<boolean> {\n    const element = await this.element(options)\n    // The property, and an ancestor `fieldset[disabled]`: see `DomQuery.isEnabled`.\n    const disabled =\n      (element as HTMLInputElement).disabled === true || element.closest(':disabled') !== null\n    return enabledFrom(disabled, element.getAttribute('aria-disabled'))\n  }\n\n  override async isChecked(options?: WaitOptions): Promise<boolean> {\n    const element = await this.element(options)\n    return checkedFrom(\n      element.getAttribute('aria-checked'),\n      Boolean((element as HTMLInputElement).checked),\n    )\n  }\n\n  override async selectedOptions(options?: WaitOptions): Promise<string[]> {\n    const element = (await this.element(options)) as HTMLSelectElement\n    return [...(element.selectedOptions ?? [])].map(option => option.value)\n  }\n\n  /** Under jsdom, which computes no layout, every box is all zeros. */\n  override async boundingBox(options?: WaitOptions): Promise<BoundingBox> {\n    return boundingBoxOf(await this.element(options), this.container().ownerDocument)\n  }\n\n  // --- waiting ------------------------------------------------------------\n\n  override async waitFor(state: WaitState, options?: WaitOptions): Promise<void> {\n    const timeout = timeoutFor(options?.timeout)\n    if (state === 'visible') {\n      await waitUntil(async () => {\n        if (!(await this.isVisible({ timeout }))) throw new Error('not visible yet')\n      }, timeout)\n    } else {\n      await waitUntil(async () => {\n        if ((await this.count()) !== 0 && (await this.isVisible({ timeout }))) {\n          throw new Error('still visible')\n        }\n      }, timeout)\n    }\n    // Whatever made it appear or go may have scheduled more work; hand back a\n    // stable app, as every interaction does.\n    await this.settled()\n  }\n\n  override async count(): Promise<number> {\n    return countAll(this.container(), this.scope, this.selector)\n  }\n}\n\n/** A query pinned to a node `all()` already found. See `BoundDomQuery`. */\nclass BoundAngularQuery extends AngularQuery {\n  constructor(\n    env: AngularEnv,\n    scope: readonly Selector[],\n    selector: Selector,\n    private readonly bound: HTMLElement,\n  ) {\n    super(env, scope, selector)\n  }\n\n  protected override async element(options?: WaitOptions): Promise<HTMLElement> {\n    if (this.bound.isConnected) return this.bound\n    // A re-render replaced the node; the selector still carries this query's\n    // index, so ordinary resolution finds the replacement.\n    return super.element(options)\n  }\n}\n\nregisterDriver(ANGULAR_DRIVER, (env: EnvConfig, scope, selector) => {\n  return new AngularQuery(env as AngularEnv, scope, selector)\n})\n","import { Location } from '@angular/common'\nimport { Router, ROUTES } from '@angular/router'\nimport { registerNavigation } from '@harnessed-ts/core'\nimport type { EnvConfig } from '@harnessed-ts/core'\nimport { waitFor as waitForCondition } from '@testing-library/dom'\nimport { ANGULAR_DRIVER } from './driver-id'\nimport type { AngularEnv } from './env'\nimport { injectorOf, settle } from './stable'\n\ninterface Routing {\n  router: Router\n  location: Location\n}\n\n/**\n * The app's router, or the standard refusal. A component rendered on its own\n * has no router to drive — the Angular shape of a jsdom test — and a page there\n * constructs and reads, but cannot navigate.\n */\nfunction routing(env: EnvConfig): Routing {\n  const injector = injectorOf(env as AngularEnv)\n  // Not `get(Router, null)`: the Router is provided in root, so it always\n  // resolves — to one with no routes, which matches no URL. The ROUTES token is\n  // what `provideRouter()` and `RouterModule.forRoot()` add.\n  if (injector.get(ROUTES, null) === null) {\n    throw new Error(\n      `harnessed: the \"${ANGULAR_DRIVER}\" driver cannot navigate without a Router, so a page ` +\n        'cannot navigate with it. Provide one to the app or the TestBed (provideRouter()), or ' +\n        'reach the page by rendering it.',\n    )\n  }\n  return { router: injector.get(Router), location: injector.get(Location) }\n}\n\n/**\n * The router's URL, made absolute. `Location.path()` is the truth, not\n * `window.location`: TestBed swaps in a mock platform location, so a test's\n * navigations never reach the address bar. Absolute because a page reads\n * `pathname` and `searchParams` off it with `new URL()`.\n *\n * There is no URL before the router's first navigation — TestBed performs\n * none of its own. Reading that as `/` would let `assertPathname('/')` pass\n * before anything navigated, so it refuses.\n */\nfunction absolute(env: EnvConfig): string {\n  const { router, location } = routing(env)\n  if (!router.navigated) {\n    throw new Error(\n      'harnessed: the router has not navigated yet. Call a page’s goto(), or ' +\n        'router.navigateByUrl(), first.',\n    )\n  }\n  return new URL(location.path(), window.location.origin).href\n}\n\n/** Navigation through the app's Router, wherever one is provided. */\nregisterNavigation(ANGULAR_DRIVER, {\n  async goto(env, url) {\n    const { router } = routing(env)\n    // Resolves once the navigation ends; whenStable() then waits out the\n    // change detection it scheduled, so the destination is on screen.\n    await router.navigateByUrl(url)\n    await settle(env as AngularEnv)\n  },\n  currentUrl(env) {\n    return absolute(env)\n  },\n  async waitForUrl(env, matches, timeout) {\n    // Outside the retry loop: no router is a refusal, not something to wait out.\n    absolute(env)\n    await waitForCondition(\n      () => {\n        if (!matches(new URL(absolute(env)))) throw new Error(`still at ${absolute(env)}`)\n      },\n      { timeout },\n    )\n    // The URL changes before the destination has rendered.\n    await settle(env as AngularEnv)\n  },\n})\n","import type { ApplicationRef, ComponentRef } from '@angular/core'\nimport type { EnvConfig } from '@harnessed-ts/core'\nimport { ANGULAR_DRIVER } from './driver-id'\n// Imported for their side effects: constructing an env is the moment the driver\n// has to be in the registry, and a bare re-export could be tree-shaken away.\nimport './angular-query'\nimport './navigation'\n\nexport { ANGULAR_DRIVER }\n\n/**\n * What the driver needs of a `ComponentFixture`: a structural type, so a\n * fixture from TestBed, `@testing-library/angular` or `cypress/angular` all\n * fit, and nothing here imports `@angular/core/testing` at runtime.\n */\nexport interface AngularFixture {\n  whenStable(): Promise<unknown>\n  readonly componentRef: Pick<ComponentRef<unknown>, 'injector'>\n}\n\nexport interface AngularEnv extends EnvConfig {\n  readonly driver: typeof ANGULAR_DRIVER\n  /** A test's fixture. Every action ends at its `whenStable()`. */\n  readonly fixture: AngularFixture | undefined\n  /** A bootstrapped app. Without a fixture, every action ends at its `whenStable()`. */\n  readonly app: ApplicationRef | undefined\n  /**\n   * Where queries start, scoped and `{ global: true }` alike. Defaults to\n   * `document.body`, read at query time: TestBed attaches each fixture there,\n   * and the CDK's overlays and other portals render there too.\n   */\n  readonly root: Element | undefined\n}\n\nexport interface AngularEnvOptions {\n  /** A `ComponentFixture`: TestBed's `createComponent()`, or a render result's `fixture`. */\n  fixture?: AngularFixture\n  /** The `ApplicationRef` `bootstrapApplication()` resolves to, for an app with no fixture. */\n  app?: ApplicationRef\n  root?: Element\n}\n\n/**\n * Builds the env a harness is constructed with in an Angular test:\n *\n * ```ts\n * const { fixture } = await render(LoginForm)\n * const form = new LoginFormHarness(angular({ fixture }))\n * ```\n *\n * or, for an app bootstrapped without TestBed:\n *\n * ```ts\n * const app = await bootstrapApplication(App, appConfig)\n * const page = new CheckoutPage(angular({ app }))\n * ```\n *\n * One of the two is required. Nothing else finds an app reliably: the `ng`\n * global and `getAllAngularRootElements()` exist only in development builds,\n * and testabilities only where zone.js is loaded.\n */\nexport function angular({ fixture, app, root }: AngularEnvOptions = {}): AngularEnv {\n  if (fixture === undefined && app === undefined) {\n    throw new TypeError(\n      'harnessed: angular() needs the app it drives — pass { fixture } from TestBed or a ' +\n        'render result, or { app } with the ApplicationRef bootstrapApplication() resolved to.',\n    )\n  }\n  return { driver: ANGULAR_DRIVER, fixture, app, root }\n}\n"]}

package/dist/navigation.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=navigation.d.ts.map

package/dist/navigation.d.ts.map

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

package/dist/stable.d.ts

@@ -0,0 +1,12 @@
+import type { Injector } from '@angular/core';
+import type { AngularEnv } from './env';
+/**
+ * The app's settle point: the fixture's `whenStable()` if there is one, else
+ * the `ApplicationRef`'s. Zoneless, both wait for Angular's pending tasks — a
+ * scheduled change detection, a navigation, an `HttpClient` request — and not
+ * for a bare `setTimeout`, which a zoneless app does not track.
+ */
+export declare function settle(env: AngularEnv): Promise<void>;
+/** Where the app's services live: the fixture's component injector, or the app's. */
+export declare function injectorOf(env: AngularEnv): Injector;
+//# sourceMappingURL=stable.d.ts.map

package/dist/stable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable.d.ts","sourceRoot":"","sources":["../src/stable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAEvC;;;;;GAKG;AACH,wBAAsB,MAAM,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAE3D;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,QAAQ,CAEpD"}

package/package.json

@@ -1,6 +1,78 @@
 {
   "name": "@harnessed-ts/angular",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.7.0",
+  "description": "Angular driver for @harnessed-ts/core: interactions through user-event, each one ending once the app is stable. TestBed, Testing Library and bootstrapped apps, zoneless.",
+  "keywords": [
+    "testing",
+    "harness",
+    "angular",
+    "testbed",
+    "testing-library"
+  ],
+  "license": "MIT",
+  "contributors": [
+    {
+      "name": "Joe Gaudet",
+      "url": "https://github.com/joegaudet"
+    },
+    {
+      "name": "Jay Seo",
+      "url": "https://github.com/jayseo5953"
+    }
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/joegaudet/harnessed.git",
+    "directory": "packages/angular"
+  },
+  "homepage": "https://github.com/joegaudet/harnessed#readme",
+  "bugs": "https://github.com/joegaudet/harnessed/issues",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "dependencies": {
+    "@harnessed-ts/core": "^0.7.0",
+    "@harnessed-ts/resolve": "^0.7.0"
+  },
+  "peerDependencies": {
+    "@angular/common": ">=21",
+    "@angular/core": ">=21",
+    "@angular/router": ">=21",
+    "@testing-library/dom": ">=10",
+    "@testing-library/user-event": ">=14"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@angular/common": "^22.2.0",
+    "@angular/core": "^22.2.0",
+    "@angular/platform-browser": "^22.2.0",
+    "@angular/router": "^22.2.0",
+    "@testing-library/dom": "^10.4.2",
+    "@testing-library/user-event": "^14.6.7",
+    "rxjs": "^7.8.2"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
 }