tungsten 0.7.0 → 0.7.1

package/dist/testing/host.types.test.js

@@ -0,0 +1,81 @@
+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 { TungstenStatefulComponent } from "../Components.js";
+// Type tests: tsc is the assertion - nothing here runs. What each wrapper's content and updates
+// hand back: the component's own content type, or resolved content
+class Counter extends TungstenStatefulComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "state", {
+      n: 0
+    });
+    _defineProperty(this, "content", () => `${this.state.n}`);
+    _defineProperty(this, "bump", () => {
+      this.setState({
+        n: this.state.n + 1
+      });
+    });
+  }
+}
+const _ownContent = true;
+const _ownUpdate = true;
+const _ownState = true;
+const _resolvedContent = true;
+const _resolvedUpdate = true;
+const _resolvedState = true;
+// the rest is shared, and the component's own methods come out on both
+const _props = true;
+const _api = true;
+const _storeResolve = {
+  storeData: {
+    n: 1
+  },
+  resolve: true
+};
+const _storeResolveAbsent = {
+  storeData: {
+    n: 1
+  }
+};
+// @ts-expect-error -- resolve is true or absent
+const _storeResolveFalse = {
+  storeData: {
+    n: 1
+  },
+  resolve: false
+};
+const _storeDont = {
+  storeData: {
+    n: 1
+  },
+  resolve: false
+};
+// @ts-expect-error -- resolve: false is required
+const _storeDontAbsent = {
+  storeData: {
+    n: 1
+  }
+};
+// @ts-expect-error -- one store form, as host()'s own options
+const _storeTwoForms = {
+  storeData: {
+    n: 1
+  },
+  store: {}
+};
+const _resolve = {
+  location: '/leads'
+};
+// @ts-expect-error -- resolve is true or absent
+const _resolveFalse = {
+  resolve: false
+};
+const _dont = {
+  location: '/leads',
+  resolve: false
+};
+// @ts-expect-error -- resolve: false is required
+const _dontAbsent = {
+  location: '/leads'
+};

package/dist/testing/hydrateTestApp.js

@@ -147,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 ? 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 ?? {},
@@ -167,9 +168,9 @@ 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 context = options?.context ?? {};
+  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 ?? {};
+  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

package/dist/testing/index.d.ts

@@ -1,12 +1,11 @@
 export { loadEnv } from './loadEnv.js';
 export { testEnvVariableName } from './testEnvIsRequested.js';
 export { type HydrateTestApp, type HydrateTestAppOptions, hydrateTestApp, } from './hydrateTestApp.js';
-export { type HydrateTestPipelineApp, type HydrateTestPipelineAppOptions, hydrateTestPipelineApp, } from './hydrateTestPipelineApp.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 CreateTestPipelineAppArgs, type TestPipelineApp, type TestPipelineAppOptions, createTestPipelineApp, } from './createTestPipelineApp.js';
-export { type HostOptions, type HostStoreOptions, type Hosted, type HostedResolved, host, hostGeneric, hostJsx, } from './host.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,EACH,KAAK,cAAc,EAAE,KAAK,qBAAqB,EAC/C,cAAc,GACjB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EACH,KAAK,sBAAsB,EAAE,KAAK,6BAA6B,EAC/D,sBAAsB,GACzB,MAAM,6BAA6B,CAAA;AACpC,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,yBAAyB,EAAE,KAAK,eAAe,EAAE,KAAK,sBAAsB,EACjF,qBAAqB,GACxB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACH,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAE,KAAK,MAAM,EAAE,KAAK,cAAc,EACzE,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,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

@@ -1,11 +1,10 @@
 export { loadEnv } from './loadEnv.js';
 export { testEnvVariableName } from './testEnvIsRequested.js';
 export { hydrateTestApp } from './hydrateTestApp.js';
-export { hydrateTestPipelineApp } from './hydrateTestPipelineApp.js';
 export { createTestApp, testStore } from './createTestApp.js';
-export { createTestPipelineApp } from './createTestPipelineApp.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"}