tungsten 0.6.2 → 0.7.0

package/dist/testing/createTestApp.d.ts

@@ -2,7 +2,13 @@ import type { ConstructPackage, TungstenBaseComponent, TungstenBaseComponentType
 import type { TrueStore } from '../Store/makeStore.js';
 import type { Endpoint, Path } from '../routing/RouteTypes.js';
 import type { ErrorRouteType } from '../routing/ErrorRouteType.js';
+import type { RoutesArray } from '../routing/routesArray.js';
 import type { ReqRes } from '../ReqRes.js';
+import type { Context } from '../context/registerContext.js';
+import type { NetworkedData } from '../routing/routingRegistry.js';
+import { Instance } from '../Instance/Instance.js';
+import { type MountedTungstenRoot } from '../update/integrateUpdateVdom.js';
+import { UpdateScheduler } from '../update/UpdateScheduler.js';
 export type ComponentProps<ComponentType extends TungstenBaseComponentType<any, any>> = InstanceType<ComponentType>['props'];
 export type TestStoreRegistration<Schema extends object> = {
     getStore: (stores: TrueStore<unknown>[]) => TrueStore<Schema>;
@@ -22,8 +28,14 @@ export type TestAppOptions<Props extends object> = {
     routeData?: unknown;
     globalData?: Record<string, unknown>;
     stores?: readonly TestStoreOverride<any>[];
-    routes?: TestRoutes | ((reqRes: ReqRes | null) => TestRoutes);
+    routes?: TestRoutes | RoutesArray | TestRoutesFunction;
+    fileVersions?: Record<string, string>;
+    context?: Context;
+    networkedData?: NetworkedData;
 };
+type TestRoutesFunction = {
+    routes(reqRes: ReqRes | null, context: Context): TestRoutes | RoutesArray;
+}['routes'];
 export type TestRoutes = {
     [key in Path]: Endpoint<any, any>;
 } & {
@@ -43,5 +55,17 @@ export type TestApp<Component extends TungstenBaseComponent> = {
 export 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 class TestAppImplementation<Component extends TungstenBaseComponent> implements TestApp<Component> {
+    #private;
+    readonly document: Document;
+    readonly container: HTMLElement;
+    readonly component: Component;
+    constructor(document: Document, container: HTMLElement, component: Component, instance: Instance, scheduler: UpdateScheduler, root: MountedTungstenRoot<TungstenBaseComponentType<any, any>>, ownsContainer: boolean);
+    resolved: () => Promise<void>;
+    setProps: (props: Component["props"]) => Promise<void>;
+    [Symbol.asyncDispose]: () => Promise<void>;
+    unmount: () => Promise<void>;
+}
 export declare function createTestApp<Props extends TungstenComponentPropsBase, Component extends TungstenBaseComponent<any, any>, RouteData = undefined>(RootComponent: new (pkg: ConstructPackage<Props, RouteData>) => Component, ...args: CreateTestAppArgs<Props>): Promise<TestApp<Component>>;
+export {};
 //# sourceMappingURL=createTestApp.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"createTestApp.d.ts","sourceRoot":"","sources":["../../src/testing/createTestApp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,gBAAgB,EAChB,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,EAC7B,MAAM,mBAAmB,CAAA;AAI1B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEtD,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAa1C,MAAM,MAAM,cAAc,CACtB,aAAa,SAAS,yBAAyB,CAAC,GAAG,EAAE,GAAG,CAAC,IACzD,YAAY,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,CAAA;AAExC,MAAM,MAAM,qBAAqB,CAAC,MAAM,SAAS,MAAM,IAAI;IACvD,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,CAAC,MAAM,CAAC,CAAA;CAChE,CAAA;AAED,MAAM,MAAM,SAAS,CAAC,MAAM,SAAS,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC,CAAA;AAEhE,MAAM,MAAM,iBAAiB,CAAC,MAAM,SAAS,MAAM,GAAG,MAAM,IAAI;IAC5D,YAAY,EAAE,qBAAqB,CAAC,MAAM,CAAC,CAAA;IAC3C,UAAU,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACjE,CAAA;AAED,wBAAgB,SAAS,CAAC,MAAM,SAAS,MAAM,EAC3C,YAAY,EAAE,qBAAqB,CAAC,MAAM,CAAC,EAC3C,UAAU,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAC/D,iBAAiB,CAAC,MAAM,CAAC,CAE3B;AAED,MAAM,MAAM,cAAc,CAAC,KAAK,SAAS,MAAM,IAAI;IAC/C,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACpC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,MAAM,CAAC,EAAE,SAAS,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAA;IAE1C,MAAM,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,UAAU,CAAC,CAAA;CAChE,CAAA;AAID,MAAM,MAAM,UAAU,GAAG;KAAG,GAAG,IAAI,IAAI,GAAG,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;CAAE,GAAG;IAC7D,KAAK,CAAC,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAC1B,SAAS,CAAC,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAC9B,OAAO,CAAC,EAAE,cAAc,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,OAAO,CAAC,SAAS,SAAS,qBAAqB,IAAI;IAC3D,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAE7B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IAExB,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,MAAM,IAAI,MAAM,SAAS,KAAK,GACpE,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,GACjC,MAAM,KAAK,SAAS,KAAK,GACrB,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,GACjC,CAAC,OAAO,EAAE,cAAc,CAAC,KAAK,CAAC,GAAG;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC,CAAA;AAyE7D,wBAAsB,aAAa,CAC/B,KAAK,SAAS,0BAA0B,EACxC,SAAS,SAAS,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,EACjD,SAAS,GAAG,SAAS,EAGrB,aAAa,EAAE,KAAK,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,SAAS,EACzE,GAAG,IAAI,EAAE,iBAAiB,CAAC,KAAK,CAAC,GAClC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAwH7B"}
+{"version":3,"file":"createTestApp.d.ts","sourceRoot":"","sources":["../../src/testing/createTestApp.ts"],"names":[],"mappings":"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"}

package/dist/testing/createTestApp.js

@@ -8,6 +8,7 @@ function _classPrivateFieldSet(s, a, r) { return s.set(_assertClassBrand(s, a),
 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 { toRoutes } from '../routing/routesArray.js';
 import { createTungstenRootComponent, deleteTungstenRoot } from '../update/integrateUpdateVdom.js';
 import { UpdateScheduler } from '../update/UpdateScheduler.js';
 import { waitForEnvIfLoading } from './loadEnv.js';
@@ -22,7 +23,7 @@ var _scheduler = /*#__PURE__*/new WeakMap();
 var _root = /*#__PURE__*/new WeakMap();
 var _ownsContainer = /*#__PURE__*/new WeakMap();
 var _unmounted = /*#__PURE__*/new WeakMap();
-class TestAppImplementation {
+export class TestAppImplementation {
   constructor(document, container, component, instance, scheduler, root, ownsContainer) {
     _defineProperty(this, "document", void 0);
     _defineProperty(this, "container", void 0);
@@ -103,6 +104,10 @@ RootComponent, ...args) {
   }
   const location = options?.location ?? '/';
   const globalData = options?.globalData ?? {};
+  // made once, as a request makes them: the routes function, the stores and the instance must all
+  // see the same objects, which separate `?? {}`s at each use did not give them
+  const context = options?.context ?? {};
+  const networkedData = options?.networkedData ?? {};
   const matchedRouteInfo = {
     key: null,
     params: options?.routeParams ?? {},
@@ -122,7 +127,7 @@ RootComponent, ...args) {
     internalStore,
     stores,
     storeSubscriptions
-  } = initStores(location, null, globalData, matchedRouteInfo);
+  } = initStores(location, null, globalData, matchedRouteInfo, null, context, networkedData);
   const instanceConfig = {
     prod: false,
     useRootComponent: true,
@@ -134,8 +139,12 @@ RootComponent, ...args) {
   // routing() falls back to the built-in 404 when neither '404' nor 'default' is given
   // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
   const appRoutes = options?.routes ?? {};
-  const routes = typeof appRoutes === 'function' ? appRoutes(null) : appRoutes;
+  // dev, so a path given twice fails the test
+  const routes = toRoutes(typeof appRoutes === 'function' ? appRoutes(null, context, networkedData) : appRoutes, true);
   const instance = new Instance(location, instanceConfig, null, appRoutes, routes, internalStore, stores, storeSubscriptions, globalData, matchedRouteInfo, runtimeContext);
+  instance.fileVersions = options?.fileVersions;
+  instance.context = context;
+  instance.networkedData = networkedData;
   try {
     for (const override of options?.stores ?? []) {
       const store = override.registration.getStore(instance.stores);

package/dist/testing/createTestPipelineApp.d.ts

@@ -0,0 +1,25 @@
+import type { ConstructPackage, TungstenBaseComponent, TungstenComponentPropsBase } from '../Components.jsx';
+import type { PipelineApp } from '../pipeline/pipelineDefinition.js';
+import { type TestApp, type TestStoreOverride } from './createTestApp.js';
+export type TestPipelineAppOptions<Props extends object> = {
+    document?: Document;
+    props?: Props;
+    container?: HTMLElement;
+    location?: string;
+    stores?: readonly TestStoreOverride<any>[];
+    fileVersions?: Record<string, string>;
+    allRoutesData?: object;
+    networked?: object;
+};
+export type TestPipelineApp<Component extends TungstenBaseComponent> = TestApp<Component>;
+export type CreateTestPipelineAppArgs<Props extends object> = object extends Props ? [options?: TestPipelineAppOptions<Props>] : keyof Props extends never ? [options?: TestPipelineAppOptions<Props>] : [options: TestPipelineAppOptions<Props> & {
+    props: Props;
+}];
+/**
+ * createTestApp() for an app built with pipeline() or splitPipeline(): the app's browser stages
+ * run - Init, the all-routes data, Post - and the location is routed against its routes, so the
+ * test sees the context, stores and route the app's own page would. The app is a .routes()
+ * result: the app's own export, a smaller set of routes on the same pipeline, or another pipeline.
+ */
+export declare function createTestPipelineApp<Props extends TungstenComponentPropsBase, Component extends TungstenBaseComponent<any, any>, RouteData = undefined>(app: PipelineApp<any>, RootComponent: new (pkg: ConstructPackage<Props, RouteData>) => Component, ...args: CreateTestPipelineAppArgs<Props>): Promise<TestPipelineApp<Component>>;
+//# sourceMappingURL=createTestPipelineApp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createTestPipelineApp.d.ts","sourceRoot":"","sources":["../../src/testing/createTestPipelineApp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,gBAAgB,EAAE,qBAAqB,EAAE,0BAA0B,EACtE,MAAM,mBAAmB,CAAA;AAM1B,OAAO,KAAK,EAAa,WAAW,EAAgB,MAAM,mCAAmC,CAAA;AAa7F,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,iBAAiB,EAAyB,MAAM,oBAAoB,CAAA;AAIhG,MAAM,MAAM,sBAAsB,CAAC,KAAK,SAAS,MAAM,IAAI;IACvD,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,SAAS,CAAC,EAAE,WAAW,CAAA;IAEvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,SAAS,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAA;IAE1C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAErC,aAAa,CAAC,EAAE,MAAM,CAAA;IAGtB,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,eAAe,CAAC,SAAS,SAAS,qBAAqB,IAAI,OAAO,CAAC,SAAS,CAAC,CAAA;AAEzF,MAAM,MAAM,yBAAyB,CAAC,KAAK,SAAS,MAAM,IAAI,MAAM,SAAS,KAAK,GAC5E,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC,KAAK,CAAC,CAAC,GACzC,MAAM,KAAK,SAAS,KAAK,GACrB,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC,KAAK,CAAC,CAAC,GACzC,CAAC,OAAO,EAAE,sBAAsB,CAAC,KAAK,CAAC,GAAG;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC,CAAA;AAoDrE;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACvC,KAAK,SAAS,0BAA0B,EACxC,SAAS,SAAS,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,EACjD,SAAS,GAAG,SAAS,EAErB,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,EAErB,aAAa,EAAE,KAAK,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,SAAS,EACzE,GAAG,IAAI,EAAE,yBAAyB,CAAC,KAAK,CAAC,GAC1C,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CA+HrC"}

package/dist/testing/createTestPipelineApp.js

@@ -0,0 +1,153 @@
+import { clientRoute } from '../pipeline/pipelineDefinition.js';
+import { Instance } from '../Instance/Instance.js';
+import { JSONstringify } from '../json.js';
+import { initStores } from '../Servers/initStores.js';
+import { routing } from "../Servers/routing.js";
+import { fromTransport, NetworkedTransport } from '../pipeline/networkedTransport.js';
+import { afterRoutingFor, pipelineContext, pipelineRoutes, routingContext, routingNetworkedData } from '../pipeline/runPipeline.js';
+import { splitContext } from '../pipeline/runSplitPipeline.js';
+import { createTungstenRootComponent } from '../update/integrateUpdateVdom.js';
+import { UpdateScheduler } from '../update/UpdateScheduler.js';
+import { TestAppImplementation } from './createTestApp.js';
+import { waitForEnvIfLoading } from './loadEnv.js';
+// the symmetric pipeline's stages, with null for the request
+async function runSymmetric(app, allRoutesData) {
+  const init = await app.init?.(null, undefined);
+  const data = allRoutesData ?? (await app.allRoutesData?.(null, init)) ?? {};
+  const post = await app.post?.(null, init, data);
+  const rerun = app.allRoutesData;
+  return {
+    init,
+    context: pipelineContext(init, post),
+    routingContext: init,
+    routingNetworkedData: undefined,
+    networked: {},
+    allRoutesData: data,
+    rerunAllRoutesData: rerun && (async () => rerun(null, init)),
+    afterRouting: undefined
+  };
+}
+async function runSplit(app, allRoutesData, served) {
+  const page = JSON.parse(JSONstringify(new NetworkedTransport(served))); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- toJSON gives an object
+  const networked = fromTransport(page) ?? {};
+  const init = await app.clientInit?.(networked);
+  const data = allRoutesData ?? (await app.clientAllRoutesData?.(init)) ?? {};
+  const post = await app.clientPost?.(init, data);
+  const context = splitContext(init, post);
+  const rerun = app.clientAllRoutesData;
+  const afterRouting = app.clientAfterRouting;
+  return {
+    init,
+    context,
+    routingContext: init?.context,
+    routingNetworkedData: init?.networked,
+    networked,
+    allRoutesData: data,
+    rerunAllRoutesData: rerun && (async () => rerun(init)),
+    afterRouting: afterRouting && (async (route, allRoutes) => splitContext(await afterRouting(context, route, allRoutes), undefined))
+  };
+}
+/**
+ * createTestApp() for an app built with pipeline() or splitPipeline(): the app's browser stages
+ * run - Init, the all-routes data, Post - and the location is routed against its routes, so the
+ * test sees the context, stores and route the app's own page would. The app is a .routes()
+ * result: the app's own export, a smaller set of routes on the same pipeline, or another pipeline.
+ */
+export async function createTestPipelineApp(app,
+// Props is inferred from both the class and `props`, so literal props are typed by the component
+RootComponent, ...args) {
+  await waitForEnvIfLoading();
+  const options = args[0];
+  const suppliedDocument = options?.document ?? globalThis.document;
+  if (suppliedDocument === undefined) {
+    // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+    throw new Error('createTestPipelineApp() 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.');
+  }
+  const stages = app.split === true ? await runSplit(app, options?.allRoutesData, options?.networked ?? {}) : await runSymmetric(app, options?.allRoutesData);
+  const location = options?.location ?? '/';
+  const allRoutesData = stages.allRoutesData; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- the framework brands what it builds
+  const routeContext = routingContext(stages.routingContext);
+  const networkedData = routingNetworkedData(stages.routingNetworkedData);
+  // dev, so a path given twice fails the test
+  const routes = pipelineRoutes(app, null, stages.init, true);
+  const matchedRouteInfo = await routing(location, routes, routeContext, networkedData);
+  const afterRouting = afterRoutingFor(stages.afterRouting);
+  const context = afterRouting === undefined ? stages.context // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- as above
+  : await afterRouting(clientRoute(matchedRouteInfo, location), allRoutesData);
+  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 scheduler = new UpdateScheduler();
+  const runtimeContext = {
+    document,
+    window: document.defaultView,
+    scheduler,
+    navigation: false
+  };
+  const {
+    internalStore,
+    stores,
+    storeSubscriptions
+  } = initStores(location, null, allRoutesData, matchedRouteInfo, null, context, networkedData);
+  const instanceConfig = {
+    prod: false,
+    useRootComponent: true,
+    clientSideNav: true,
+    siteBasePath: '/',
+    staticSite: false,
+    csr: false
+  };
+  const appRoutes = reqRes => pipelineRoutes(app, reqRes, stages.init, true);
+  const instance = new Instance(location, instanceConfig, null, appRoutes, routes, internalStore, stores, storeSubscriptions, allRoutesData, matchedRouteInfo, runtimeContext);
+  instance.fileVersions = options?.fileVersions;
+  instance.context = context;
+  instance.networkedData = networkedData;
+  instance.pipelineNetworked = stages.networked;
+  const rerun = stages.rerunAllRoutesData;
+  instance.pipeline = {
+    routingContext: routeContext,
+    routingNetworkedData: networkedData,
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- as above
+    allRoutesData: rerun && (async () => await rerun()),
+    afterRouting
+  };
+  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, matchedRouteInfo.params, matchedRouteInfo.data, 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/dist/testing/ensure.d.ts

@@ -0,0 +1,108 @@
+import type { ContentNode } from '../ContentNode.js';
+type Kind = 'text' | 'interruptedText' | ElementKind | 'fragment' | 'className' | 'id' | 'children' | `prop:${string}`;
+type ElementKind = `html:${string}` | `component:${string}`;
+type Test = (seen: unknown) => boolean;
+type Failure = {
+    actual: unknown;
+    expected: unknown;
+    saw: string;
+    showDiff: boolean;
+};
+type TrackFn = (match: boolean) => boolean | void;
+type DecideFn = (ofKind: number) => Failure | undefined;
+type Requirement = () => [track: TrackFn, decide: DecideFn];
+type Fact = [
+    Kind,
+    Test,
+    Requirement,
+    quantifier: string,
+    end: string,
+    spoken: string,
+    explain?: Explain | undefined
+];
+type Explain = (seen: unknown) => Outcome | undefined;
+type Outcome = 'not content' | {
+    misses: Miss[];
+    met: BuiltFact[];
+    score: number;
+};
+type Miss = {
+    fact: BuiltFact;
+    failure: Failure;
+    sightings: Sighting[];
+};
+export type EnsureOptions = {
+    readable?: boolean;
+    color?: boolean;
+};
+type Props = Record<string, unknown> & {
+    children?: ContentNode;
+};
+type WithFn = (props: Props) => boolean;
+type Quantifiers = {
+    readonly no: Ends;
+    readonly none: Ends;
+    readonly one: Ends;
+    readonly two: Ends;
+    readonly three: Ends;
+    readonly count: (num: number) => Ends;
+    readonly a: Ends;
+    readonly an: Ends;
+    readonly some: Ends;
+    readonly all: Ends;
+};
+type StringEnd = ((text: string) => Fact) & {
+    contains: (substring: string) => Fact;
+    matches: (regex: RegExp) => Fact;
+};
+type ElementEnd = Fact & {
+    with: ((facts: Fact[] | WithFn) => Fact) & Quantifiers & {
+        children: ((facts: Fact[]) => Fact) & Quantifiers;
+    };
+};
+type Ends = {
+    text: StringEnd;
+    textCi: StringEnd;
+    interruptedText: StringEnd;
+    html: (tag: string) => ElementEnd;
+    component: (name: string) => ElementEnd;
+    fragment: () => Fact;
+    className: (className?: string) => Fact;
+    id: (id?: string) => Fact;
+    prop: (prop: string) => Fact & {
+        is: (value: unknown) => Fact;
+        contains: (substring: string) => Fact;
+        matches: (regex: RegExp) => Fact;
+        exact: (value: unknown) => Fact;
+        subset: (shape: unknown) => Fact;
+        duck: (shape: unknown) => Fact;
+        content: () => Fact & {
+            with: ((facts: Fact[]) => Fact) & Quantifiers;
+        };
+    };
+};
+declare const _ensure: typeof ensure & Quantifiers;
+export { _ensure as ensure };
+export declare const no: Ends, none: Ends, one: Ends, two: Ends, three: Ends, a: Ends, an: Ends, some: Ends, all: Ends, count: (num: number) => Ends;
+export declare class EnsureError extends Error {
+    actual: unknown;
+    expected: unknown;
+    operator: string;
+    showDiff: boolean;
+    name: string;
+    constructor(message: string, actual: unknown, expected: unknown, operator: string, showDiff: boolean);
+}
+declare function ensure(tree: ContentNode, facts: Fact[], options?: EnsureOptions): void;
+export declare const children: ((facts: Fact[]) => Fact) & Quantifiers;
+type BuiltFact = {
+    kind: Kind;
+    test: Test;
+    track: TrackFn;
+    decide: DecideFn;
+    explain: Explain | undefined;
+    chained: string;
+    spoken: string;
+    operator: string;
+};
+type Sighting = ['text', string] | [Exclude<Kind, 'text'>, unknown];
+//# sourceMappingURL=ensure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ensure.d.ts","sourceRoot":"","sources":["../../src/testing/ensure.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAWpD,KAAK,IAAI,GAAG,MAAM,GAAG,iBAAiB,GAAG,WAAW,GAAG,UAAU,GAC3D,WAAW,GAAG,IAAI,GAAG,UAAU,GAAG,QAAQ,MAAM,EAAE,CAAA;AACxD,KAAK,WAAW,GAAG,QAAQ,MAAM,EAAE,GAAG,aAAa,MAAM,EAAE,CAAA;AAE3D,KAAK,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAA;AAEtC,KAAK,OAAO,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAA;AAErF,KAAK,OAAO,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,GAAG,IAAI,CAAA;AACjD,KAAK,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAA;AAEvD,KAAK,WAAW,GAAG,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;AAG3D,KAAK,IAAI,GAAG;IACR,IAAI;IAAE,IAAI;IAAE,WAAW;IAAE,UAAU,EAAE,MAAM;IAAE,GAAG,EAAE,MAAM;IAAE,MAAM,EAAE,MAAM;IACxE,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS;CAChC,CAAA;AAED,KAAK,OAAO,GAAG,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,GAAG,SAAS,CAAA;AAErD,KAAK,OAAO,GAAG,aAAa,GAAG;IAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAAC,GAAG,EAAE,SAAS,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAA;AAClF,KAAK,IAAI,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,QAAQ,EAAE,CAAA;CAAE,CAAA;AACxE,MAAM,MAAM,aAAa,GAAG;IAGxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB,CAAA;AAKD,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,WAAW,CAAA;CAAE,CAAA;AAMjE,KAAK,MAAM,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAA;AAGvC,KAAK,WAAW,GAAG;IAEf,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IAC3D,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhF,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;CAC3C,CAAA;AACD,KAAK,SAAS,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG;IACxC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC3E,CAAA;AAGD,KAAK,UAAU,GAAG,IAAI,GAAG;IACrB,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,IAAI,CAAC,GAAG,WAAW,GAAG;QACrD,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,GAAG,WAAW,CAAC;KACrD,CAAC;CACL,CAAA;AACD,KAAK,IAAI,GAAG;IACR,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC;IAEnC,eAAe,EAAE,SAAS,CAAC;IAC3B,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,UAAU,CAAC;IAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC;IAC3E,QAAQ,EAAE,MAAM,IAAI,CAAC;IAErB,SAAS,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACnE,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG;QAC3B,EAAE,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;QAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;QACpE,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;QAAC,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;QAClE,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;QAAC,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;QACjE,OAAO,EAAE,MAAM,IAAI,GAAG;YAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC,GAAG,WAAW,CAAA;SAAE,CAAC;KAC3E,CAAC;CACL,CAAA;AAGD,QAAA,MAAM,OAAO,6BAAiD,CAAA;AAC9D,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,CAAA;AAE5B,eAAO,MAAQ,EAAE,QAAE,IAAI,QAAE,GAAG,QAAE,GAAG,QAAE,KAAK,QAAE,CAAC,QAAE,EAAE,QAAE,IAAI,QAAE,GAAG,QAAE,KAAK,QAnCG,MAAM,KAAK,IAmCF,CAAA;AA+M7E,qBAAa,WAAY,SAAQ,KAAK;IAIvB,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE,MAAM;IAChB,QAAQ,EAAE,OAAO;IANnB,IAAI,SAAgB;gBAEzB,OAAO,EAAE,MAAM,EACR,MAAM,EAAE,OAAO,EACf,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO;CAK/B;AAED,iBAAS,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,GAAE,aAAkB,QAkB5E;AAoHD,eAAO,MAAM,QAAQ,WACT,IAAI,EAAE,wBAEjB,CAAA;AASD,KAAK,SAAS,GAAG;IACb,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IACvF,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;CACrD,CAAA;AAwID,KAAK,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAA"}