tungsten 0.6.3 → 0.7.1

package/dist/testing/hydrateTestApp.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 { $props, $type } from '../contentNodeSymbols.js';
 import { Instance } from '../Instance/Instance.js';
+import { toRoutes } from '../routing/routesArray.js';
 import { hydrateRootComponent, makeDefaultHydrateMeta } from "../hydrate/hydrate.js";
 import { contentTreeToRenderingTree } from '../render/contentTreeToRenderingTree.js';
 import { renderingNodeToHtml } from '../render/renderingTreeToHtml.js';
@@ -15,13 +16,21 @@ import { initStores } from '../Servers/initStores.js';
 import { deleteNodeIfRendered } from '../update/integrateUpdateVdom.js';
 import { UpdateScheduler } from '../update/UpdateScheduler.js';
 import { DomPointer } from '../DomPointer.js';
+import { isClient } from '../isClient.js';
 import { waitForEnvIfLoading } from './loadEnv.js';
 // hydrate.tsx references several DOM globals directly (Node.COMMENT_NODE, `instanceof Text`, the
 // bare `document`) the way real browser code always can - happy-dom only puts these on its own
 // Window, not on Node.js's global scope. Every hand-written hydration test before this harness
 // bridged them manually; a caller of hydrateTestApp() shouldn't need to know that hydrate() was
 // written assuming a real browser to begin with.
-function bridgeHappyDomGlobals(document) {
+// Hydration is browser code: isClient decides what tungsten's modules do from the moment they load,
+// so a node-only run would take server paths and fail far from here
+export function requireClient(harness) {
+  if (!isClient) {
+    throw new Error(`${harness} needs a browser-like environment, and isClient is false: no global window` + ` existed when tungsten loaded. Run it in a DOM test suite whose setup puts happy-dom's` + ` window on the global before the tests are imported.`);
+  }
+}
+export function bridgeHappyDomGlobals(document) {
   const window = document.defaultView;
   if (window === null) return;
   const globals = globalThis; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- bridging happy-dom's globals onto the global scope
@@ -38,7 +47,7 @@ var _instance = /*#__PURE__*/new WeakMap();
 var _scheduler = /*#__PURE__*/new WeakMap();
 var _ownsContainer = /*#__PURE__*/new WeakMap();
 var _unmounted = /*#__PURE__*/new WeakMap();
-class HydrateTestAppImplementation {
+export class HydrateTestAppImplementation {
   constructor(document, container, component, instance, scheduler, ownsContainer, html, mismatches) {
     _defineProperty(this, "document", void 0);
     _defineProperty(this, "container", void 0);
@@ -111,6 +120,7 @@ class HydrateTestAppImplementation {
  * client hydrator does, so a caller reproducing that class of bug should assert on the rejection.
  */
 export async function hydrateTestApp(RootComponent, ...args) {
+  requireClient('hydrateTestApp()');
   await waitForEnvIfLoading();
   const options = args[0];
   const suppliedDocument = options?.document ?? globalThis.document;
@@ -137,7 +147,8 @@ export async function hydrateTestApp(RootComponent, ...args) {
   const clientProps = options?.props ?? {}; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
   const serverProps = options?.serverProps ?? clientProps;
   const location = options?.location ?? '/';
-  const globalData = options?.globalData ?? {};
+  const globalData = options?.globalData ? options.globalData // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
+  : {}; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
   const matchedRouteInfo = {
     key: null,
     params: options?.routeParams ?? {},
@@ -157,7 +168,11 @@ export async function hydrateTestApp(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;
+  const context = options?.context ?? {}; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
+  // one object for both passes: the server's is serialized into the page and carried to the client
+  const networkedData = options?.networkedData ?? {}; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
+  // dev, so a path given twice fails the test
+  const routes = toRoutes(typeof appRoutes === 'function' ? appRoutes(null, context, networkedData) : appRoutes, true);
   // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- rootToHtml.ts builds a root content node the same way
   const componentNode = {
     [$type]: RootComponent,
@@ -172,13 +187,16 @@ export async function hydrateTestApp(RootComponent, ...args) {
       internalStore,
       stores,
       storeSubscriptions
-    } = initStores(location, null, globalData, matchedRouteInfo);
+    } = initStores(location, null, globalData, matchedRouteInfo, null, context, networkedData);
     const ssrInstance = new Instance(location, instanceConfig, null, appRoutes, routes, internalStore, stores, storeSubscriptions, globalData, matchedRouteInfo, {
       document,
       window: document.defaultView,
       scheduler: ssrScheduler,
       navigation: false
     });
+    ssrInstance.fileVersions = options?.fileVersions;
+    ssrInstance.context = context;
+    ssrInstance.networkedData = networkedData;
     for (const override of options?.stores ?? []) {
       const store = override.registration.getStore(ssrInstance.stores);
       await override.initialize(store);
@@ -210,7 +228,7 @@ export async function hydrateTestApp(RootComponent, ...args) {
     internalStore,
     stores,
     storeSubscriptions
-  } = initStores(location, null, globalData, matchedRouteInfo);
+  } = initStores(location, null, globalData, matchedRouteInfo, null, context, networkedData);
   const runtimeContext = {
     document,
     window: document.defaultView,
@@ -218,6 +236,9 @@ export async function hydrateTestApp(RootComponent, ...args) {
     navigation: false
   };
   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/index.d.ts

@@ -1,9 +1,11 @@
 export { loadEnv } from './loadEnv.js';
 export { testEnvVariableName } from './testEnvIsRequested.js';
-export { hydrateTestApp, type HydrateTestApp, type HydrateTestAppOptions } from './hydrateTestApp.js';
-export { createTestApp, testStore, type ComponentProps, type CreateTestAppArgs, type TestApp, type TestAppOptions, type TestStore, type TestStoreOverride, type TestStoreRegistration, type TestRoutes, } from './createTestApp.js';
-export { host, type HostOptions, type HostStoreOptions, type Hosted } from './host.js';
+export { type HydrateTestApp, type HydrateTestAppOptions, hydrateTestApp, } from './hydrateTestApp.js';
+export { type ComponentProps, type CreateTestAppArgs, type TestApp, type TestAppOptions, type TestStore, type TestStoreOverride, type TestStoreRegistration, type TestRoutes, createTestApp, testStore, } from './createTestApp.js';
+export { type HostDontResolveOptions, type HostOptions, type HostResolveOptions, type HostStoreDontResolveOptions, type HostStoreOptions, type HostStoreResolveOptions, type Hosted, type HostedResolved, host, hostGeneric, hostJsx, } from './host.js';
 export { testingComponentPackage } from './testingComponentPackage.js';
 export { contentHtmlElements } from './helpers/contentHtmlElements.js';
+export { ensure } from './ensure.js';
+export { contentToString, type ContentToStringOptions } from './contentToString.js';
 export { makeStore, type TrueStore } from '../Store/makeStore.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAA;AACrG,OAAO,EACH,aAAa,EACb,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,UAAU,GAClB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,IAAI,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,MAAM,EAAE,MAAM,WAAW,CAAA;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAC7D,OAAO,EACH,KAAK,cAAc,EAAE,KAAK,qBAAqB,EAC/C,cAAc,GACjB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACH,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAC9F,KAAK,iBAAiB,EAAE,KAAK,qBAAqB,EAAE,KAAK,UAAU,EACnE,aAAa,EAAE,SAAS,GAC3B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACH,KAAK,sBAAsB,EAAE,KAAK,WAAW,EAAE,KAAK,kBAAkB,EACtE,KAAK,2BAA2B,EAAE,KAAK,gBAAgB,EAAE,KAAK,uBAAuB,EACrF,KAAK,MAAM,EAAE,KAAK,cAAc,EAChC,IAAI,EAAE,WAAW,EAAE,OAAO,GAC7B,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AACtE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AACnF,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAA"}

package/dist/testing/index.js

@@ -2,7 +2,9 @@ export { loadEnv } from './loadEnv.js';
 export { testEnvVariableName } from './testEnvIsRequested.js';
 export { hydrateTestApp } from './hydrateTestApp.js';
 export { createTestApp, testStore } from './createTestApp.js';
-export { host } from './host.js';
+export { host, hostGeneric, hostJsx } from './host.js';
 export { testingComponentPackage } from './testingComponentPackage.js';
 export { contentHtmlElements } from './helpers/contentHtmlElements.js';
+export { ensure } from './ensure.js';
+export { contentToString } from './contentToString.js';
 export { makeStore } from '../Store/makeStore.js';

package/dist/testing/pipeline/createTestPacketApp.d.ts

@@ -0,0 +1,30 @@
+import type { ConstructPackage, TungstenBaseComponent, TungstenComponentPropsBase } from '../../Components.jsx';
+import type { Nothing } from '../../pipeline/pipeline.js';
+import type { TestApp } from '../createTestApp.js';
+import type { PipelineTestAppOptions } from './pipelineTestApp.js';
+type Field<K extends string, T, Default> = Default extends T ? {
+    [_ in K]?: T;
+} : {
+    [_ in K]: T;
+};
+export type PacketForComponent<C> = C extends {
+    readonly tungsten: {
+        readonly context: infer Ctx;
+        readonly networked: infer N;
+        readonly allRoutesData: infer G;
+    };
+} ? Field<'context', Ctx, Nothing> & Field<'networked', N, Nothing> & Field<'allRoutesData', G, undefined> & {
+    routes?: never;
+} : 'invalid component';
+export type TestPacketAppOptions<Props extends object> = PipelineTestAppOptions<Props>;
+export type CreateTestPacketAppArgs<Props extends object> = object extends Props ? [options?: TestPacketAppOptions<Props>] : [options: TestPacketAppOptions<Props> & {
+    props: Props;
+}];
+/**
+ * createTestPipelineApp() with the pipeline's result in place of the pipeline: the component is
+ * handed the packet's context, networked data and all-routes data as they are, with no stages run.
+ * There are no routes; the location still reaches the instance.
+ */
+export declare function createTestPacketApp<Props extends TungstenComponentPropsBase, Component extends TungstenBaseComponent<any, any>, RouteData = undefined>(packet: PacketForComponent<Component>, RootComponent: new (pkg: ConstructPackage<Props, RouteData>) => Component, ...args: CreateTestPacketAppArgs<Props>): Promise<TestApp<Component>>;
+export {};
+//# sourceMappingURL=createTestPacketApp.d.ts.map

package/dist/testing/pipeline/createTestPacketApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTestPacketApp.d.ts","sourceRoot":"","sources":["../../../src/testing/pipeline/createTestPacketApp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,gBAAgB,EAAE,qBAAqB,EAAE,0BAA0B,EACtE,MAAM,sBAAsB,CAAA;AAE7B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AAEzD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAUlE,KAAK,KAAK,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,OAAO,IAAI,OAAO,SAAS,CAAC,GAAG;KAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;CAAE,GAAG;KAAG,CAAC,IAAI,CAAC,GAAG,CAAC;CAAE,CAAA;AAIjG,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,SAAS;IAC1C,QAAQ,CAAC,QAAQ,EAAE;QACf,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAA;KAC5F,CAAA;CACJ,GACK,KAAK,CAAC,SAAS,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,EAAE,OAAO,CAAC,GAC3D,KAAK,CAAC,eAAe,EAAE,CAAC,EAAE,SAAS,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GAC7D,mBAAmB,CAAA;AAIzB,MAAM,MAAM,oBAAoB,CAAC,KAAK,SAAS,MAAM,IAAI,sBAAsB,CAAC,KAAK,CAAC,CAAA;AAEtF,MAAM,MAAM,uBAAuB,CAAC,KAAK,SAAS,MAAM,IAAI,MAAM,SAAS,KAAK,GAC1E,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC,GACvC,CAAC,OAAO,EAAE,oBAAoB,CAAC,KAAK,CAAC,GAAG;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC,CAAA;AAE/D;;;;GAIG;AACH,wBAAsB,mBAAmB,CACrC,KAAK,SAAS,0BAA0B,EACxC,SAAS,SAAS,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,EACjD,SAAS,GAAG,SAAS,EAErB,MAAM,EAAE,kBAAkB,CAAC,SAAS,CAAC,EAErC,aAAa,EAAE,KAAK,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,SAAS,EACzE,GAAG,IAAI,EAAE,uBAAuB,CAAC,KAAK,CAAC,GACxC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CA8B7B"}

package/dist/testing/pipeline/createTestPacketApp.js

@@ -0,0 +1,45 @@
+import { isPipelineApp } from '../../pipeline/pipelineDefinition.js';
+import { routingNetworkedData } from '../../pipeline/runPipeline.js';
+import { routing } from "../../Servers/routing.js";
+import { toRoutes } from '../../routing/routesArray.js';
+import { waitForEnvIfLoading } from '../loadEnv.js';
+import { mountPipelineTestApp, pipelineTestTarget } from './pipelineTestApp.js';
+/**
+ * createTestPipelineApp() with the pipeline's result in place of the pipeline: the component is
+ * handed the packet's context, networked data and all-routes data as they are, with no stages run.
+ * There are no routes; the location still reaches the instance.
+ */
+export async function createTestPacketApp(packet,
+// 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];
+  if (isPipelineApp(packet) || typeof packet === 'object' && 'routes' in packet) {
+    throw new Error('createTestPacketApp() takes what a pipeline makes, { context, networked,' + ' allRoutesData }: for a pipeline or app, use createTestPipelineApp().');
+  }
+  const target = pipelineTestTarget(options, 'createTestPacketApp()');
+  const given = packet; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- the constraint above
+  const location = options?.location ?? '/';
+  const context = given.context ?? {}; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- the framework brands what it builds
+  const allRoutesData = given.allRoutesData; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- as above
+  const networkedData = routingNetworkedData(undefined);
+  const routes = toRoutes([], true);
+  const matchedRouteInfo = await routing(location, routes, context, networkedData);
+  return mountPipelineTestApp(target, {
+    location,
+    routes,
+    matchedRouteInfo,
+    allRoutesData,
+    context,
+    networkedData,
+    appRoutes: () => routes,
+    networked: given.networked ?? {},
+    // a navigation keeps the packet's all-routes data
+    pipeline: {
+      routingContext: context,
+      routingNetworkedData: networkedData,
+      allRoutesData: undefined,
+      afterRouting: undefined
+    }
+  }, RootComponent, options);
+}

package/dist/testing/pipeline/createTestPacketApp.types.test.d.ts

@@ -0,0 +1,3 @@
+export declare function checks(): Promise<void>;
+export declare function notAPipeline(): Promise<void>;
+//# sourceMappingURL=createTestPacketApp.types.test.d.ts.map

package/dist/testing/pipeline/createTestPacketApp.types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTestPacketApp.types.test.d.ts","sourceRoot":"","sources":["../../../src/testing/pipeline/createTestPacketApp.types.test.ts"],"names":[],"mappings":"AAkCA,wBAAsB,MAAM,kBAgB3B;AAGD,wBAAsB,YAAY,kBAUjC"}

package/dist/testing/pipeline/createTestPacketApp.types.test.js

@@ -0,0 +1,101 @@
+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 { TungstenSimpleComponent } from "../../Components.js";
+import { contextStore } from '../../pipeline/contextStore.js';
+import { pipeline } from '../../pipeline/pipeline.js';
+import { splitPipeline } from '../../pipeline/splitPipeline.js';
+import { createTestPacketApp } from './createTestPacketApp.js';
+// Type tests: tsc is the assertion - nothing here runs. The packet must be what the root reads
+const stage = pipeline.server('express').init(() => ({
+  api: 'client'
+})).allRoutesData(() => ({
+  theme: 'dark'
+}));
+class Reads extends stage.SimpleComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "content", () => `${this.tungsten.context.api} ${this.tungsten.allRoutesData.theme}`);
+  }
+}
+class Plain extends TungstenSimpleComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "content", () => null);
+  }
+}
+const bare = pipeline.server('express');
+class ReadsNothing extends bare.SimpleComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "content", () => null);
+  }
+}
+const split = splitPipeline.server('express').serverInit(() => ({
+  networked: {
+    count: contextStore({
+      n: 0
+    })
+  }
+})).clientInit(() => undefined);
+class ReadsNetworked extends split.SimpleComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "content", () => String(this.tungsten.networked.count.n.get()));
+  }
+}
+export async function checks() {
+  await createTestPacketApp({
+    context: {
+      api: 'a'
+    },
+    allRoutesData: {
+      theme: 't'
+    }
+  }, Reads);
+  // @ts-expect-error -- Reads reads a context: it has no default
+  await createTestPacketApp({
+    allRoutesData: {
+      theme: 't'
+    }
+  }, Reads);
+  // @ts-expect-error -- nor does its all-routes data
+  await createTestPacketApp({
+    context: {
+      api: 'a'
+    }
+  }, Reads);
+  // @ts-expect-error -- not the context Reads reads
+  await createTestPacketApp({
+    context: {
+      api: 1
+    },
+    allRoutesData: {
+      theme: 't'
+    }
+  }, Reads);
+  // the defaults: nothing read, nothing needed
+  await createTestPacketApp({}, ReadsNothing);
+  await createTestPacketApp({}, Plain);
+  await createTestPacketApp({
+    networked: {
+      count: contextStore({
+        n: 1
+      })
+    }
+  }, ReadsNetworked);
+  // @ts-expect-error -- ReadsNetworked reads networked data
+  await createTestPacketApp({}, ReadsNetworked);
+}
+// a pipeline or app belongs to createTestPipelineApp()
+export async function notAPipeline() {
+  // @ts-expect-error -- a stage
+  await createTestPacketApp(bare, ReadsNothing);
+  // @ts-expect-error -- an app
+  await createTestPacketApp(bare.routes(() => []), ReadsNothing);
+  // a loose component: an app's allRoutesData function would pass for its all-routes data
+  // @ts-expect-error -- a stage
+  await createTestPacketApp(stage, Plain);
+  // @ts-expect-error -- an app
+  await createTestPacketApp(stage.routes(() => []), Plain);
+}

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

@@ -0,0 +1,70 @@
+import type { ConstructPackage, TungstenBaseComponent, TungstenComponentPropsBase } from '../../Components.jsx';
+import type { AllRoutesDataConstraint, PipelineApp } from '../../pipeline/pipelineDefinition.js';
+import type { TestApp } from '../createTestApp.js';
+import type { PipelineTestAppOptions } from './pipelineTestApp.js';
+type StageForApp<App> = {
+    routes: (routes: () => []) => App;
+};
+type AppOf<A> = A extends PipelineApp<any, any, any, any> ? A : A extends StageForApp<infer App> ? App : never;
+type AppTypes<A> = AppOf<A> extends PipelineApp<any, infer Ctx, infer N, infer G extends AllRoutesDataConstraint> ? {
+    context: Ctx;
+    networked: N & object;
+    allRoutesData: G;
+} : never;
+export type PipelineAppForComponent<C> = C extends {
+    readonly tungsten: {
+        readonly context: infer Ctx;
+        readonly networked: infer N;
+        readonly allRoutesData: infer G;
+    };
+} ? PipelineApp<any, Ctx, N, G> : 'invalid component';
+export type PipelineForComponent<C> = PipelineAppForComponent<C> extends infer App ? App extends PipelineApp<any, any, any, any> ? StageForApp<App> : App : never;
+type ComponentReads<C> = C extends {
+    readonly tungsten: {
+        readonly context: infer Ctx;
+        readonly networked: infer N;
+        readonly allRoutesData: infer G;
+    };
+} ? {
+    context: Ctx;
+    networked: N;
+    allRoutesData: G;
+} : never;
+type DifferingKeys<Made, Read> = {
+    [K in keyof Made & keyof Read]: [Made[K]] extends [Read[K]] ? never : K;
+}[keyof Made & keyof Read];
+type Mismatch<Made, Read> = [DifferingKeys<Made, Read>] extends [never] ? unknown : DifferingKeys<Made, Read> extends infer Ks extends keyof Made & keyof Read ? {
+    'pipeline does not provide required data:': {
+        [K in Ks]: Read[K];
+    };
+    'pipeline provided:': {
+        [K in Ks]: Made[K];
+    };
+} : never;
+export type AppCheck<A, C> = [AppOf<A>] extends [never] ? A extends {
+    clientAllRoutesData: unknown;
+} ? {
+    'add .clientAllRoutesData(): the server makes all-routes data, so the client must': true;
+} : {
+    'not a .routes() app, or a stage .routes() can follow': true;
+} : [ComponentReads<C>] extends [never] ? {
+    'not a tungsten component': true;
+} : Mismatch<AppTypes<A>, ComponentReads<C>>;
+export declare const toApp: (pipelineOrApp: unknown) => PipelineApp;
+export type TestPipelineAppOptions<Props extends object, A = PipelineApp> = PipelineTestAppOptions<Props> & {
+    allRoutesData?: AppTypes<A>['allRoutesData'];
+    networked?: AppTypes<A>['networked'];
+};
+export type TestPipelineApp<Component extends TungstenBaseComponent> = TestApp<Component>;
+export type CreateTestPipelineAppArgs<Props extends object, A = PipelineApp> = object extends Props ? [options?: TestPipelineAppOptions<Props, A>] : [options: TestPipelineAppOptions<Props, A> & {
+    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>, A extends object, RouteData = undefined>(pipelineOrApp: A & AppCheck<A, Component>, RootComponent: new (pkg: ConstructPackage<Props, RouteData>) => Component, ...args: CreateTestPipelineAppArgs<Props, A>): Promise<TestPipelineApp<Component>>;
+export {};
+//# sourceMappingURL=createTestPipelineApp.d.ts.map

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

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

package/dist/testing/pipeline/createTestPipelineApp.js

@@ -0,0 +1,90 @@
+import { clientRoute, isPipelineApp } from '../../pipeline/pipelineDefinition.js';
+import { JSONstringify } from '../../json.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 { waitForEnvIfLoading } from '../loadEnv.js';
+import { mountPipelineTestApp, pipelineTestTarget } from './pipelineTestApp.js';
+// the app, or the stage ended with empty routes
+export const toApp = pipelineOrApp => isPipelineApp(pipelineOrApp) ? pipelineOrApp : pipelineOrApp.routes(() => []); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- the harnesses' constraint: a stage
+// 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(pipelineOrApp,
+// 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 target = pipelineTestTarget(options, 'createTestPipelineApp()');
+  const app = toApp(pipelineOrApp);
+  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);
+  const rerun = stages.rerunAllRoutesData;
+  return mountPipelineTestApp(target, {
+    location,
+    routes,
+    matchedRouteInfo,
+    allRoutesData,
+    context,
+    networkedData,
+    appRoutes: reqRes => pipelineRoutes(app, reqRes, stages.init, true),
+    networked: stages.networked,
+    pipeline: {
+      routingContext: routeContext,
+      routingNetworkedData: networkedData,
+      allRoutesData: rerun && (async () => await rerun()),
+      // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- as above
+      afterRouting
+    }
+  }, RootComponent, options);
+}

package/dist/testing/pipeline/createTestPipelineApp.types.test.d.ts

@@ -0,0 +1,6 @@
+export declare function checks(): Promise<void>;
+export declare function stageChecks(): Promise<void>;
+export declare function bareChecks(): Promise<void>;
+export declare function splitChecks(): Promise<void>;
+export declare function clientDataChecks(): Promise<void>;
+//# sourceMappingURL=createTestPipelineApp.types.test.d.ts.map

package/dist/testing/pipeline/createTestPipelineApp.types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createTestPipelineApp.types.test.d.ts","sourceRoot":"","sources":["../../../src/testing/pipeline/createTestPipelineApp.types.test.ts"],"names":[],"mappings":"AA+BA,wBAAsB,MAAM,kBAU3B;AAcD,wBAAsB,WAAW,kBAOhC;AAOD,wBAAsB,UAAU,kBAE/B;AAeD,wBAAsB,WAAW,kBAQhC;AAmBD,wBAAsB,gBAAgB,kBAIrC"}