tungsten 0.2.9 → 0.2.10

package/dist/testing/createTestApp.sxyt.d.ts

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

package/dist/testing/createTestApp.sxyt.d.ts.map

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

package/dist/testing/createTestApp.sxyt.js

@@ -0,0 +1,424 @@
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { expect } from 'chai';
+import { Window } from 'happy-dom';
+import { describe } from 'sxy-test-runner';
+import { TungstenBaseSimpleStoreComponent, TungstenSimpleComponent, TungstenStatefulComponent } from "../Components.js";
+import { registerStore } from "../Store/registerStore.js";
+import { createTestApp, testStore } from "./index.js";
+import { jsxs as _jsxs, jsx as _jsx } from "tungsten/jsxRuntime.js";
+class Counter extends TungstenStatefulComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "state", {
+      count: 0
+    });
+    _defineProperty(this, "clientInitialized", false);
+    _defineProperty(this, "clientInit", () => {
+      this.clientInitialized = true;
+    });
+    _defineProperty(this, "content", () => _jsxs("button", {
+      onClick: () => {
+        this.state.count++;
+      },
+      children: [this.props.label, ":", this.state.count]
+    }));
+  }
+}
+class TestStoreSchema {
+  constructor() {
+    _defineProperty(this, "value", 0);
+  }
+}
+const testStoreRegistration = registerStore(TestStoreSchema);
+class StoreRoot extends TungstenBaseSimpleStoreComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "store", testStoreRegistration.getComponentStore(this));
+    _defineProperty(this, "init", () => {
+      this.store.value.subscribe();
+    });
+    _defineProperty(this, "content", () => _jsx("p", {
+      children: this.store.value.get()
+    }));
+  }
+}
+describe('createTestApp()', ({
+  it
+}) => {
+  it('mounts, resolves updates, preserves the root for props, and unmounts', async () => {
+    const window = new Window();
+    const document = window.document;
+    const testApp = await createTestApp(Counter, {
+      document,
+      props: {
+        label: 'Count'
+      }
+    });
+    const root = testApp.component;
+    expect(root.clientInitialized).to.equal(true);
+    expect(testApp.container.textContent).to.equal('Count:0');
+    const button = testApp.container.querySelector('button');
+    expect(button).not.to.equal(null);
+    button.dispatchEvent(new window.Event('click', {
+      bubbles: true
+    }));
+    await testApp.resolved();
+    expect(testApp.container.textContent).to.equal('Count:1');
+    await testApp.setProps({
+      label: 'Total'
+    });
+    expect(testApp.component).to.equal(root);
+    expect(testApp.container.textContent).to.equal('Total:1');
+    const container = testApp.container;
+    await testApp.unmount();
+    await testApp.unmount();
+    expect(container.isConnected).to.equal(false);
+  });
+  it('tracks asynchronous event work', async () => {
+    const window = new Window();
+    const document = window.document;
+    let release;
+    const released = new Promise(resolve => {
+      release = resolve;
+    });
+    class AsyncButton extends TungstenStatefulComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "state", {
+          finished: false
+        });
+        _defineProperty(this, "content", () => _jsx("button", {
+          onClick: async () => {
+            await released;
+            this.state.finished = true;
+          },
+          children: this.state.finished ? 'finished' : 'waiting'
+        }));
+      }
+    }
+    const testApp = await createTestApp(AsyncButton, {
+      document
+    });
+    testApp.container.querySelector('button').dispatchEvent(new window.Event('click'));
+    release();
+    await testApp.resolved();
+    expect(testApp.container.textContent).to.equal('finished');
+    await testApp.unmount();
+  });
+  it('settles asynchronous lifecycle-triggered updates', async () => {
+    const window = new Window();
+    const document = window.document;
+    class LifecycleRoot extends TungstenStatefulComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "state", {
+          phase: 'mounting'
+        });
+        _defineProperty(this, "componentDidMount", async () => {
+          await Promise.resolve();
+          this.state.phase = 'ready';
+        });
+        _defineProperty(this, "componentDidUpdate", async () => {
+          if (this.state.phase !== 'clicked') return;
+          await Promise.resolve();
+          this.state.phase = 'settled';
+        });
+        _defineProperty(this, "content", () => _jsx("button", {
+          onClick: () => {
+            this.state.phase = 'clicked';
+          },
+          children: this.state.phase
+        }));
+      }
+    }
+    const testApp = await createTestApp(LifecycleRoot, {
+      document
+    });
+    expect(testApp.container.textContent).to.equal('ready');
+    testApp.container.querySelector('button').dispatchEvent(new window.Event('click'));
+    await testApp.resolved();
+    expect(testApp.container.textContent).to.equal('settled');
+    await testApp.unmount();
+  });
+  it('initializes independent real stores before mounting', async () => {
+    const firstWindow = new Window();
+    const secondWindow = new Window();
+    const first = await createTestApp(StoreRoot, {
+      document: firstWindow.document,
+      stores: [testStore(testStoreRegistration, store => {
+        store.value.set(1);
+      })]
+    });
+    const second = await createTestApp(StoreRoot, {
+      document: secondWindow.document,
+      stores: [testStore(testStoreRegistration, store => {
+        store.value.set(2);
+      })]
+    });
+    expect(first.container.textContent).to.equal('1');
+    expect(second.container.textContent).to.equal('2');
+    first.component.store.value.set(3);
+    await first.resolved();
+    expect(first.container.textContent).to.equal('3');
+    expect(second.container.textContent).to.equal('2');
+    await first.unmount();
+    await second.unmount();
+  });
+  it('recursively unmounts components below HTML elements', async () => {
+    const window = new Window();
+    const document = window.document;
+    const lifecycle = [];
+    class Child extends TungstenSimpleComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "content", () => _jsx("span", {
+          children: "child"
+        }));
+        _defineProperty(this, "componentWillUnmount", () => {
+          lifecycle.push('will');
+        });
+        _defineProperty(this, "componentDidUnmount", () => {
+          lifecycle.push('did');
+        });
+      }
+    }
+    class Root extends TungstenSimpleComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "content", () => _jsx("main", {
+          children: _jsx(Child, {})
+        }));
+      }
+    }
+    const container = window.document.createElement('section');
+    window.document.body.appendChild(container);
+    const testApp = await createTestApp(Root, {
+      document,
+      container: container
+    });
+    await testApp.unmount();
+    expect(lifecycle).to.deep.equal(['will', 'did']);
+    expect(window.document.body.contains(container)).to.equal(true);
+    expect(container.childNodes.length).to.equal(0);
+  });
+  it('rejects a non-empty container without modifying it', async () => {
+    const window = new Window();
+    const document = window.document;
+    const container = window.document.createElement('div');
+    container.textContent = 'existing';
+    let error;
+    try {
+      await createTestApp(Counter, {
+        document,
+        container: container,
+        props: {
+          label: 'Count'
+        }
+      });
+    } catch (caught) {
+      error = caught;
+    }
+    expect(error).to.be.instanceOf(Error);
+    expect(container.textContent).to.equal('existing');
+  });
+  it('rolls back partially mounted descendants after an error', async () => {
+    const window = new Window();
+    const document = window.document;
+    const lifecycle = [];
+    class MountedChild extends TungstenSimpleComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "content", () => _jsx("span", {
+          children: "mounted"
+        }));
+        _defineProperty(this, "componentDidMount", () => {
+          lifecycle.push('mount');
+        });
+        _defineProperty(this, "componentWillUnmount", () => {
+          lifecycle.push('will');
+        });
+        _defineProperty(this, "componentDidUnmount", () => {
+          lifecycle.push('did');
+        });
+      }
+    }
+    class BrokenChild extends TungstenSimpleComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "content", () => {
+          throw new Error('broken child');
+        });
+      }
+    }
+    class BrokenRoot extends TungstenSimpleComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "content", () => _jsxs("main", {
+          children: [_jsx(MountedChild, {}), _jsx(BrokenChild, {})]
+        }));
+      }
+    }
+    const originalBodyChildren = window.document.body.childNodes.length;
+    let error;
+    try {
+      await createTestApp(BrokenRoot, {
+        document
+      });
+    } catch (caught) {
+      error = caught;
+    }
+    expect(error).to.be.instanceOf(Error);
+    expect(lifecycle).to.deep.equal(['mount', 'will', 'did']);
+    expect(window.document.body.childNodes.length).to.equal(originalBodyChildren);
+  });
+  it('supports input, checkbox, and select bindings', async () => {
+    const window = new Window();
+    const document = window.document;
+    class FormRoot extends TungstenStatefulComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "state", {
+          name: 'Robert',
+          checked: false,
+          choice: 'b'
+        });
+        _defineProperty(this, "content", () => _jsxs("form", {
+          children: [_jsx("input", {
+            name: "name",
+            bind: [this.state, 'name']
+          }), _jsx("input", {
+            name: "enabled",
+            type: "checkbox",
+            bindChecked: [this.state, 'checked']
+          }), _jsxs("select", {
+            name: "choice",
+            bind: [this.state, 'choice'],
+            children: [_jsx("option", {
+              value: "a",
+              children: "A"
+            }), _jsx("option", {
+              value: "b",
+              children: "B"
+            }), _jsx("option", {
+              value: "c",
+              children: "C"
+            })]
+          }), _jsxs("output", {
+            children: [this.state.name, ":", String(this.state.checked), ":", this.state.choice]
+          })]
+        }));
+      }
+    }
+    const testApp = await createTestApp(FormRoot, {
+      document
+    });
+    const name = testApp.container.querySelector('input[name="name"]');
+    const enabled = testApp.container.querySelector('input[name="enabled"]');
+    const choice = testApp.container.querySelector('select');
+    name.value = 'Alice';
+    name.dispatchEvent(new window.Event('input', {
+      bubbles: true
+    }));
+    enabled.checked = true;
+    enabled.dispatchEvent(new window.Event('change', {
+      bubbles: true
+    }));
+    choice.value = 'c';
+    choice.dispatchEvent(new window.Event('input', {
+      bubbles: true
+    }));
+    await testApp.resolved();
+    expect(testApp.component.state.name).to.equal('Alice');
+    expect(testApp.component.state.checked).to.equal(true);
+    expect(testApp.component.state.choice).to.equal('c');
+    expect(testApp.container.querySelector('output').textContent).to.equal('Alice:true:c');
+    await testApp.unmount();
+  });
+  it('preserves keyed nodes and controlled select values during reconciliation', async () => {
+    const window = new Window();
+    const document = window.document;
+    class ReconciliationRoot extends TungstenStatefulComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "state", {
+          items: ['a', 'b', 'c'],
+          selected: 'b',
+          updates: 0
+        });
+        _defineProperty(this, "content", () => _jsxs("main", {
+          children: [_jsx("ul", {
+            children: this.state.items.map(item => _jsx("li", {
+              "data-key": item,
+              children: item
+            }, item))
+          }), _jsxs("select", {
+            value: this.state.selected,
+            children: [_jsx("option", {
+              value: "a",
+              children: "A"
+            }), _jsx("option", {
+              value: "b",
+              children: "B"
+            }), _jsx("option", {
+              value: "c",
+              children: "C"
+            })]
+          }), _jsx("button", {
+            onClick: () => {
+              this.state.updates++;
+            },
+            children: "update"
+          }), _jsx("output", {
+            children: this.state.updates
+          })]
+        }));
+      }
+    }
+    const testApp = await createTestApp(ReconciliationRoot, {
+      document
+    });
+    const nodeA = testApp.container.querySelector('[data-key="a"]');
+    const nodeB = testApp.container.querySelector('[data-key="b"]');
+    const select = testApp.container.querySelector('select');
+    testApp.component.state.items = ['c', 'a', 'b'];
+    await testApp.resolved();
+    expect(testApp.container.querySelector('[data-key="a"]')).to.equal(nodeA);
+    expect(testApp.container.querySelector('[data-key="b"]')).to.equal(nodeB);
+    expect(select.value).to.equal('b');
+    testApp.container.querySelector('button').dispatchEvent(new window.Event('click'));
+    await testApp.resolved();
+    expect(select.value).to.equal('b');
+    await testApp.unmount();
+  });
+  it('rejects resolved() when an asynchronous event handler fails', async () => {
+    const window = new Window();
+    const document = window.document;
+    class BrokenEventRoot extends TungstenSimpleComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "content", () => _jsx("button", {
+          onClick: async () => {
+            await Promise.resolve();
+            throw new Error('event failed');
+          },
+          children: "break"
+        }));
+      }
+    }
+    const testApp = await createTestApp(BrokenEventRoot, {
+      document
+    });
+    testApp.container.querySelector('button').dispatchEvent(new window.Event('click'));
+    let error;
+    try {
+      await testApp.resolved();
+    } catch (caught) {
+      error = caught;
+    }
+    expect(error).to.be.instanceOf(Error);
+    expect(error.message).to.contain('BrokenEventRoot click event handler');
+    await testApp.unmount();
+  });
+});

package/dist/testing/ensureTestEnvLoaded.d.ts

@@ -0,0 +1,2 @@
+export declare function ensureTestEnvLoaded(): Promise<void>;
+//# sourceMappingURL=ensureTestEnvLoaded.d.ts.map

package/dist/testing/ensureTestEnvLoaded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensureTestEnvLoaded.d.ts","sourceRoot":"","sources":["../../src/testing/ensureTestEnvLoaded.ts"],"names":[],"mappings":"AASA,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAWnD"}

package/dist/testing/ensureTestEnvLoaded.js

@@ -0,0 +1,19 @@
+import { getUserConfig } from "../getUserConfig.js";
+import { loadEnvsDev } from "../Servers/loadEnvsDev.js";
+let loadPromise;
+// Populate global.tungstenPublicEnv / global.tungstenPrivateEnv for DOM component
+// tests, exactly once per process. Compiled client component code reads these as
+// bare globals, so they must exist before any component runs under the test runner.
+// Test runs prefer .env.test* files (per-file replacement) via useTestEnvFiles.
+export function ensureTestEnvLoaded() {
+  if (loadPromise === undefined) {
+    loadPromise = (async () => {
+      const config = await getUserConfig('silent');
+      // iteration 0: schemas are stable within a test run.
+      // _firstLoad = false: suppress the CLI boot output.
+      // useTestEnvFiles = true: prefer .env.test* files.
+      await loadEnvsDev(config, 0, process.env, false, true);
+    })();
+  }
+  return loadPromise;
+}

package/dist/testing/index.d.ts

@@ -0,0 +1,36 @@
+import type { TungstenBaseComponent, TungstenBaseComponentType } from '../Components.jsx';
+import type { TrueStore } from '../Store/makeStore.js';
+export type ComponentProps<ComponentType extends TungstenBaseComponentType<any, any>> = InstanceType<ComponentType>['props'];
+export type TestStoreRegistration<Schema extends object> = {
+    getStore: (stores: TrueStore<unknown>[]) => TrueStore<Schema>;
+};
+export type TestStore<Schema extends object> = TrueStore<Schema>;
+export type TestStoreOverride<Schema extends object = object> = {
+    registration: TestStoreRegistration<Schema>;
+    initialize: (store: TrueStore<Schema>) => void | Promise<void>;
+};
+export declare function testStore<Schema extends object>(registration: TestStoreRegistration<Schema>, initialize: (store: TestStore<Schema>) => void | Promise<void>): TestStoreOverride<Schema>;
+export type TestAppOptions<Props extends object> = {
+    document?: Document;
+    props?: Props;
+    container?: HTMLElement;
+    location?: string;
+    routeParams?: Record<string, string>;
+    routeData?: unknown;
+    globalData?: Record<string, unknown>;
+    stores?: readonly TestStoreOverride<any>[];
+};
+export type TestApp<Component extends TungstenBaseComponent> = {
+    readonly document: Document;
+    readonly container: HTMLElement;
+    readonly component: Component;
+    resolved(): Promise<void>;
+    setProps(props: Component['props']): Promise<void>;
+    unmount(): Promise<void>;
+};
+type CreateTestAppArgs<Props extends object> = object extends Props ? [options?: TestAppOptions<Props>] : keyof Props extends never ? [options?: TestAppOptions<Props>] : [options: TestAppOptions<Props> & {
+    props: Props;
+}];
+export declare function createTestApp<ComponentType extends TungstenBaseComponentType<any, any>>(RootComponent: ComponentType, ...args: CreateTestAppArgs<ComponentProps<ComponentType>>): Promise<TestApp<InstanceType<ComponentType>>>;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/testing/index.js

@@ -0,0 +1,156 @@
+function _classPrivateFieldInitSpec(e, t, a) { _checkPrivateRedeclaration(e, t), t.set(e, a); }
+function _checkPrivateRedeclaration(e, t) { if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object"); }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _classPrivateFieldGet(s, a) { return s.get(_assertClassBrand(s, a)); }
+function _classPrivateFieldSet(s, a, r) { return s.set(_assertClassBrand(s, a), r), r; }
+function _assertClassBrand(e, t, n) { if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n; throw new TypeError("Private element is not present on this object"); }
+import { Instance } from "../Instance/Instance.js";
+import { initStores } from "../Servers/initStores.js";
+import { ensureTestEnvLoaded } from "./ensureTestEnvLoaded.js";
+import { createTungstenRootComponent, deleteTungstenRoot } from "../update/integrateUpdateVdom.js";
+import { UpdateScheduler } from "../update/UpdateScheduler.js";
+export function testStore(registration, initialize) {
+  return {
+    registration,
+    initialize
+  };
+}
+var _instance = /*#__PURE__*/new WeakMap();
+var _scheduler = /*#__PURE__*/new WeakMap();
+var _root = /*#__PURE__*/new WeakMap();
+var _ownsContainer = /*#__PURE__*/new WeakMap();
+var _unmounted = /*#__PURE__*/new WeakMap();
+class TestAppImplementation {
+  constructor(document, container, component, instance, scheduler, root, ownsContainer) {
+    _defineProperty(this, "document", void 0);
+    _defineProperty(this, "container", void 0);
+    _defineProperty(this, "component", void 0);
+    _classPrivateFieldInitSpec(this, _instance, void 0);
+    _classPrivateFieldInitSpec(this, _scheduler, void 0);
+    _classPrivateFieldInitSpec(this, _root, void 0);
+    _classPrivateFieldInitSpec(this, _ownsContainer, void 0);
+    _classPrivateFieldInitSpec(this, _unmounted, false);
+    _defineProperty(this, "resolved", async () => {
+      await _classPrivateFieldGet(_scheduler, this).resolved();
+    });
+    _defineProperty(this, "setProps", async props => {
+      if (_classPrivateFieldGet(_unmounted, this)) throw new Error('Cannot set props on an unmounted Tungsten TestApp.');
+      this.component.props = props;
+      _classPrivateFieldGet(_instance, this).queueUpdate(this.component);
+      await this.resolved();
+    });
+    _defineProperty(this, "unmount", async () => {
+      if (_classPrivateFieldGet(_unmounted, this)) return;
+      _classPrivateFieldSet(_unmounted, this, true);
+      _classPrivateFieldGet(_scheduler, this).cancelPending();
+      let cleanupError;
+      try {
+        deleteTungstenRoot(_classPrivateFieldGet(_root, this));
+        _classPrivateFieldGet(_instance, this).disposeRegisteredComponents();
+        await _classPrivateFieldGet(_scheduler, this).resolved();
+      } catch (error) {
+        cleanupError = error;
+        try {
+          _classPrivateFieldGet(_instance, this).disposeRegisteredComponents();
+        } catch {
+          // Preserve the first cleanup failure.
+        }
+      } finally {
+        _classPrivateFieldGet(_scheduler, this).dispose();
+        if (_classPrivateFieldGet(_ownsContainer, this)) this.container.remove();else while (this.container.firstChild !== null) this.container.removeChild(this.container.firstChild);
+      }
+      if (cleanupError !== undefined) throw cleanupError;
+    });
+    this.document = document;
+    this.container = container;
+    this.component = component;
+    _classPrivateFieldSet(_instance, this, instance);
+    _classPrivateFieldSet(_scheduler, this, scheduler);
+    _classPrivateFieldSet(_root, this, root);
+    _classPrivateFieldSet(_ownsContainer, this, ownsContainer);
+  }
+}
+export async function createTestApp(RootComponent, ...args) {
+  await ensureTestEnvLoaded();
+  const options = args[0];
+  const suppliedDocument = options?.document ?? globalThis.document;
+  if (suppliedDocument === undefined) {
+    // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+    throw new Error('createTestApp() requires options.document when no global document is available.');
+  }
+  const document = suppliedDocument;
+  const ownsContainer = options?.container === undefined;
+  const container = options?.container ?? document.createElement('div');
+  if (container.ownerDocument !== document) {
+    throw new Error('The TestApp container must belong to options.document.');
+  }
+  if (container.childNodes.length > 0) {
+    throw new Error('The TestApp container must be empty before mounting.');
+  }
+  if (ownsContainer) {
+    if (document.body === null) {
+      // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+      throw new Error('The supplied document must have a body element.');
+    }
+    document.body.appendChild(container);
+  }
+  const location = options?.location ?? '/';
+  const globalData = options?.globalData ?? {};
+  const matchedRouteInfo = {
+    key: null,
+    params: options?.routeParams ?? {},
+    content: null,
+    ...(options !== undefined && 'routeData' in options ? {
+      data: options.routeData
+    } : {})
+  };
+  const scheduler = new UpdateScheduler();
+  const runtimeContext = {
+    document,
+    window: document.defaultView,
+    scheduler,
+    navigation: false
+  };
+  const {
+    internalStore,
+    stores,
+    storeSubscriptions
+  } = initStores(location, null, globalData, matchedRouteInfo);
+  const instanceConfig = {
+    prod: false,
+    useRootComponent: true,
+    clientSideNav: false,
+    siteBasePath: '/',
+    staticSite: false
+  };
+  const emptyRoutes = {};
+  const instance = new Instance(location, instanceConfig, null, emptyRoutes, emptyRoutes, internalStore, stores, storeSubscriptions, globalData, matchedRouteInfo, runtimeContext);
+  try {
+    for (const override of options?.stores ?? []) {
+      const store = override.registration.getStore(instance.stores);
+      await override.initialize(store);
+    }
+    const props = options?.props ?? {};
+    const root = await createTungstenRootComponent(RootComponent, props, options?.routeParams, options?.routeData, instance, container);
+    const testApp = new TestAppImplementation(document, container, root.component, instance, scheduler, root, ownsContainer);
+    try {
+      await testApp.resolved();
+      return testApp;
+    } catch (error) {
+      await testApp.unmount();
+      throw error;
+    }
+  } catch (error) {
+    try {
+      instance.disposeRegisteredComponents();
+    } catch {
+      // Preserve the mount failure.
+    }
+    scheduler.dispose();
+    while (container.firstChild !== null) container.removeChild(container.firstChild);
+    if (ownsContainer) container.remove();
+    throw error;
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tungsten",
-  "version": "0.2.9",
+  "version": "0.2.10",
   "description": "",
   "type": "module",
   "bin": {