tungsten 0.7.0 → 0.7.1

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

@@ -0,0 +1,146 @@
+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 { createTestPipelineApp } from './createTestPipelineApp.js';
+// Type tests: tsc is the assertion - nothing here runs. The root says what it reads, from its
+// pipeline base; the app handed in must make it
+const stage = pipeline.server('express').init(() => ({
+  api: 'client'
+})).allRoutesData(() => ({
+  theme: 'dark'
+}));
+const app = stage.routes(() => []);
+class Reads extends stage.SimpleComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "content", () => `${this.tungsten.context.api} ${this.tungsten.allRoutesData.theme}`);
+  }
+}
+const other = pipeline.server('express').init(() => ({
+  db: 1
+}));
+class ReadsOther extends other.SimpleComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "content", () => String(this.tungsten.context.db));
+  }
+}
+class Plain extends TungstenSimpleComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "content", () => null);
+  }
+}
+export async function checks() {
+  await createTestPipelineApp(app, Reads);
+  // not a pipeline component: it reads nothing of the app's
+  await createTestPipelineApp(app, Plain);
+  // @ts-expect-error -- ReadsOther reads a context this app does not make
+  await createTestPipelineApp(app, ReadsOther);
+  // the server's all-routes data, in the app's shape
+  await createTestPipelineApp(app, Reads, {
+    allRoutesData: {
+      theme: 'light'
+    }
+  });
+  // @ts-expect-error -- not the app's all-routes data
+  await createTestPipelineApp(app, Reads, {
+    allRoutesData: {
+      theme: 1
+    }
+  });
+}
+const _mismatch = true;
+const _fits = true;
+// a stage in place of the app: the harness adds empty routes
+export async function stageChecks() {
+  await createTestPipelineApp(stage, Reads);
+  // @ts-expect-error -- another pipeline's stage
+  await createTestPipelineApp(other, Reads);
+  await createTestPipelineApp(stage, Reads, {
+    allRoutesData: {
+      theme: 'light'
+    }
+  });
+  // @ts-expect-error -- not the stage's all-routes data
+  await createTestPipelineApp(stage, Reads, {
+    allRoutesData: {
+      theme: 1
+    }
+  });
+}
+// no Init: the stage's context is undefined, which its components read as Nothing
+const bare = pipeline.server('express');
+class ReadsNothing extends bare.SimpleComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "content", () => null);
+  }
+}
+export async function bareChecks() {
+  await createTestPipelineApp(bare.routes(() => []), ReadsNothing);
+}
+// the split pipeline: the networked data the components read, this.tungsten.networked
+const split = splitPipeline.server('express').serverInit(() => ({
+  networked: {
+    count: contextStore({
+      n: 0
+    }),
+    userId: 0
+  }
+})).clientInit(networked => ({
+  context: {
+    userId: networked.userId
+  }
+}));
+const splitApp = split.routes(() => []);
+class ReadsNetworked extends split.SimpleComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "content", () => String(this.tungsten.networked.count.n.get()));
+  }
+}
+const _networked = true;
+export async function splitChecks() {
+  await createTestPipelineApp(splitApp, ReadsNetworked, {
+    networked: {
+      count: contextStore({
+        n: 3
+      }),
+      userId: 7
+    }
+  });
+  await createTestPipelineApp(splitApp, ReadsNetworked, {
+    // @ts-expect-error -- not the networked data the app makes
+    networked: {
+      count: 3,
+      userId: 7
+    }
+  });
+}
+// the server makes all-routes data, so clientInit's stage has no .routes() until the client's is
+// given: the error says so
+const serverData = splitPipeline.server('express').serverInit(() => undefined).serverAllRoutesData(() => ({
+  theme: 'dark'
+}));
+const noClientData = serverData.clientInit(() => undefined);
+const withClientData = noClientData.clientAllRoutesData(() => ({
+  theme: 'dark'
+}));
+class ReadsTheme extends withClientData.SimpleComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "content", () => this.tungsten.allRoutesData.theme);
+  }
+}
+const _noClientData = true;
+const _notAStage = true;
+export async function clientDataChecks() {
+  await createTestPipelineApp(withClientData, ReadsTheme);
+  // @ts-expect-error -- no .routes() yet
+  await createTestPipelineApp(noClientData, ReadsTheme);
+}

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

@@ -0,0 +1,25 @@
+import type { TungstenBaseComponent, TungstenComponentClass, TungstenComponentPropsBase } from '../../Components.jsx';
+import type { ContentNodeElement } from '../../ContentNode.js';
+import type { AppDataOptions, DontResolve, Hosted, HostedResolved, Resolve, ResolveOption, RouteOptions } from '../host.js';
+export type { ComponentApi, Hosted, HostedResolved, HostedRoute, HostStoreOptions, Navigation, StateSetter, } from '../host.js';
+export type HostPipelineOptions = RouteOptions & ResolveOption & AppDataOptions;
+export type HostPipelineResolveOptions = RouteOptions & AppDataOptions & Resolve;
+export type HostPipelineDontResolveOptions = RouteOptions & AppDataOptions & DontResolve;
+type AnyClassComponent = TungstenBaseComponent<any, any>;
+/** host() for a pipeline component: its data comes from the context, so there is no store option */
+export declare function hostPipeline<Props extends TungstenComponentPropsBase, Component extends AnyClassComponent>(ComponentType: TungstenComponentClass<Props, Component>, props?: Props, options?: HostPipelineResolveOptions): Promise<HostedResolved<Component>>;
+export declare function hostPipeline<Props extends TungstenComponentPropsBase, Component extends AnyClassComponent>(ComponentType: TungstenComponentClass<Props, Component>, props?: Props, options?: HostPipelineDontResolveOptions): Promise<Hosted<Component>>;
+export declare function hostPipeline<Props extends TungstenComponentPropsBase, Component extends AnyClassComponent>(ComponentType: TungstenComponentClass<Props, Component>, props?: Props, options?: HostPipelineOptions): Promise<HostedResolved<Component> | Hosted<Component>>;
+export declare namespace hostPipeline {
+    var generic: typeof hostPipelineGeneric;
+    var jsx: typeof hostPipelineJsx;
+}
+/** host.generic() with hostPipeline()'s options */
+export declare function hostPipelineGeneric<Props extends TungstenComponentPropsBase, Component extends AnyClassComponent>(ComponentType: TungstenComponentClass<Props, Component>, options?: HostPipelineResolveOptions): (props: Props) => Promise<HostedResolved<Component>>;
+export declare function hostPipelineGeneric<Props extends TungstenComponentPropsBase, Component extends AnyClassComponent>(ComponentType: TungstenComponentClass<Props, Component>, options: HostPipelineDontResolveOptions): (props: Props) => Promise<Hosted<Component>>;
+export declare function hostPipelineGeneric<Props extends TungstenComponentPropsBase, Component extends AnyClassComponent>(ComponentType: TungstenComponentClass<Props, Component>, options?: HostPipelineOptions): (props: Props) => Promise<Hosted<Component> | HostedResolved<Component>>;
+/** host.jsx() with hostPipeline()'s options */
+export declare function hostPipelineJsx<Component extends AnyClassComponent = AnyClassComponent>(element: ContentNodeElement, options?: HostPipelineResolveOptions): Promise<HostedResolved<Component>>;
+export declare function hostPipelineJsx<Component extends AnyClassComponent = AnyClassComponent>(element: ContentNodeElement, options: HostPipelineDontResolveOptions): Promise<Hosted<Component>>;
+export declare function hostPipelineJsx<Component extends AnyClassComponent = AnyClassComponent>(element: ContentNodeElement, options?: HostPipelineOptions): Promise<Hosted<Component> | HostedResolved<Component>>;
+//# sourceMappingURL=hostPipeline.d.ts.map

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

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

package/dist/testing/pipeline/hostPipeline.js

@@ -0,0 +1,18 @@
+import { host, hostJsx } from '../host.js';
+// host()'s implementation signature, which its overloads hide
+const hostImplementation = host;
+// Implementation
+export async function hostPipeline(ComponentType, props, options) {
+  return hostImplementation(ComponentType, props, options);
+}
+// implementation
+export function hostPipelineGeneric(ComponentType, options) {
+  return async props => hostImplementation(ComponentType, props, options);
+}
+// implementation
+export async function hostPipelineJsx(element, options) {
+  return hostJsx(element, options); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- the overloads above type them
+}
+// the variants hang off hostPipeline() too, as host()'s do
+hostPipeline.generic = hostPipelineGeneric;
+hostPipeline.jsx = hostPipelineJsx;

package/dist/testing/{hydrateTestPipelineApp.d.ts → pipeline/hydrateTestPipelineApp.d.ts}

@@ -1,8 +1,8 @@
-import type { ConstructPackage, TungstenBaseComponent, TungstenComponentPropsBase } from '../Components.jsx';
-import type { ReqRes } from '../ReqRes.js';
-import type { PipelineApp } from '../pipeline/pipelineDefinition.js';
-import type { TestStoreOverride } from './createTestApp.js';
-import type { HydrateTestApp } from './hydrateTestApp.js';
+import type { ConstructPackage, TungstenBaseComponent, TungstenComponentPropsBase } from '../../Components.jsx';
+import type { ReqRes } from '../../ReqRes.js';
+import type { TestStoreOverride } from '../createTestApp.js';
+import type { AppCheck } from './createTestPipelineApp.js';
+import type { HydrateTestApp } from '../hydrateTestApp.js';
 export type HydrateTestPipelineAppOptions<Props extends object> = {
     document?: Document;
     props?: Props;
@@ -25,6 +25,6 @@ type HydrateTestPipelineAppArgs<Props extends object> = object extends Props ? [
  * hydrates the parsed HTML. So a component whose markup depends on a context only one side makes
  * shows up in `mismatches`, or throws on a structural difference.
  */
-export declare function hydrateTestPipelineApp<Props extends TungstenComponentPropsBase, Component extends TungstenBaseComponent<any, any>, RouteData = undefined>(app: PipelineApp<any>, RootComponent: new (pkg: ConstructPackage<Props, RouteData>) => Component, ...args: HydrateTestPipelineAppArgs<Props>): Promise<HydrateTestPipelineApp<Component>>;
+export declare function hydrateTestPipelineApp<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: HydrateTestPipelineAppArgs<Props>): Promise<HydrateTestPipelineApp<Component>>;
 export {};
 //# sourceMappingURL=hydrateTestPipelineApp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hydrateTestPipelineApp.d.ts","sourceRoot":"","sources":["../../../src/testing/pipeline/hydrateTestPipelineApp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,gBAAgB,EAAE,qBAAqB,EAAE,0BAA0B,EACtE,MAAM,sBAAsB,CAAA;AAI7B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAK7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AA0B1D,MAAM,MAAM,6BAA6B,CAAC,KAAK,SAAS,MAAM,IAAI;IAC9D,QAAQ,CAAC,EAAE,QAAQ,CAAA;IACnB,KAAK,CAAC,EAAE,KAAK,CAAA;IAEb,WAAW,CAAC,EAAE,KAAK,CAAA;IACnB,SAAS,CAAC,EAAE,WAAW,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;IAEjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,SAAS,iBAAiB,CAAC,GAAG,CAAC,EAAE,CAAA;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,GAAG,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,sBAAsB,CAAC,SAAS,SAAS,qBAAqB,IACpE,cAAc,CAAC,SAAS,CAAC,CAAA;AAE/B,KAAK,0BAA0B,CAAC,KAAK,SAAS,MAAM,IAAI,MAAM,SAAS,KAAK,GACtE,CAAC,OAAO,CAAC,EAAE,6BAA6B,CAAC,KAAK,CAAC,CAAC,GAChD,MAAM,KAAK,SAAS,KAAK,GACrB,CAAC,OAAO,CAAC,EAAE,6BAA6B,CAAC,KAAK,CAAC,CAAC,GAChD,CAAC,OAAO,EAAE,6BAA6B,CAAC,KAAK,CAAC,GAAG;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC,CAAA;AAiB5E;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CACxC,KAAK,SAAS,0BAA0B,EACxC,SAAS,SAAS,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,EAEjD,CAAC,SAAS,MAAM,EAChB,SAAS,GAAG,SAAS,EAErB,aAAa,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,EACzC,aAAa,EAAE,KAAK,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,SAAS,EACzE,GAAG,IAAI,EAAE,0BAA0B,CAAC,KAAK,CAAC,GAC3C,OAAO,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC,CAiJ5C"}

package/dist/testing/{hydrateTestPipelineApp.js → pipeline/hydrateTestPipelineApp.js}

@@ -1,18 +1,19 @@
-import { $props, $type } from '../contentNodeSymbols.js';
-import { DomPointer } from '../DomPointer.js';
-import { hydrateRootComponent, hydrationRouting, makeDefaultHydrateMeta } from "../hydrate/hydrate.js";
-import { Instance } from '../Instance/Instance.js';
-import { JSONstringify } from '../json.js';
-import { NetworkedTransport } from '../pipeline/networkedTransport.js';
-import { afterRoutingFor, pipelineRoutes, routingContext, routingNetworkedData, symmetricServer } from '../pipeline/runPipeline.js';
-import { clientRoute } from '../pipeline/pipelineDefinition.js';
-import { splitServer } from '../pipeline/runSplitPipeline.js';
-import { contentTreeToRenderingTree } from '../render/contentTreeToRenderingTree.js';
-import { renderingNodeToHtml } from '../render/renderingTreeToHtml.js';
-import { initStores } from '../Servers/initStores.js';
-import { UpdateScheduler } from '../update/UpdateScheduler.js';
-import { bridgeHappyDomGlobals, HydrateTestAppImplementation, requireClient } from './hydrateTestApp.js';
-import { waitForEnvIfLoading } from './loadEnv.js';
+import { $props, $type } from '../../contentNodeSymbols.js';
+import { DomPointer } from '../../DomPointer.js';
+import { hydrateRootComponent, hydrationRouting, makeDefaultHydrateMeta } from "../../hydrate/hydrate.js";
+import { Instance } from '../../Instance/Instance.js';
+import { JSONstringify } from '../../json.js';
+import { NetworkedTransport } from '../../pipeline/networkedTransport.js';
+import { afterRoutingFor, pipelineRoutes, routingContext, routingNetworkedData, symmetricServer } from '../../pipeline/runPipeline.js';
+import { clientRoute } from '../../pipeline/pipelineDefinition.js';
+import { splitServer } from '../../pipeline/runSplitPipeline.js';
+import { contentTreeToRenderingTree } from '../../render/contentTreeToRenderingTree.js';
+import { renderingNodeToHtml } from '../../render/renderingTreeToHtml.js';
+import { initStores } from '../../Servers/initStores.js';
+import { UpdateScheduler } from '../../update/UpdateScheduler.js';
+import { bridgeHappyDomGlobals, HydrateTestAppImplementation, requireClient } from '../hydrateTestApp.js';
+import { toApp } from './createTestPipelineApp.js';
+import { waitForEnvIfLoading } from '../loadEnv.js';
 // the framework brands what it builds
 // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
 const asGlobalData = data => data;
@@ -31,9 +32,10 @@ const appRoutesFor = (app, init) => reqRes => pipelineRoutes(app, reqRes, init,
  * hydrates the parsed HTML. So a component whose markup depends on a context only one side makes
  * shows up in `mismatches`, or throws on a structural difference.
  */
-export async function hydrateTestPipelineApp(app, RootComponent, ...args) {
+export async function hydrateTestPipelineApp(pipelineOrApp, RootComponent, ...args) {
   requireClient('hydrateTestPipelineApp()');
   await waitForEnvIfLoading();
+  const app = toApp(pipelineOrApp);
   const options = args[0];
   const suppliedDocument = options?.document ?? globalThis.document;
   if (suppliedDocument === undefined) {
@@ -131,7 +133,7 @@ export async function hydrateTestPipelineApp(app, RootComponent, ...args) {
   container.innerHTML = html;
   bridgeHappyDomGlobals(document);
   // Client pass: the app's own client run, with the page's data, as hydratePipeline() runs it
-  const ran = await app.client(app, serverGlobalData, fromPage);
+  const ran = await app.client(app, fromPage);
   const routes = pipelineRoutes(app, null, ran.init, true);
   const {
     key,
@@ -145,8 +147,9 @@ export async function hydrateTestPipelineApp(app, RootComponent, ...args) {
       data
     } : {})
   }, routes);
-  const afterRouting = afterRoutingFor(ran.afterRouting);
-  const context = afterRouting === undefined ? asContext(ran.context) : await afterRouting(clientRoute(matchedRouteInfo, location), serverGlobalData);
+  const posted = await ran.post(serverGlobalData);
+  const afterRouting = afterRoutingFor(posted.afterRouting);
+  const context = afterRouting === undefined ? asContext(posted.context) : await afterRouting(clientRoute(matchedRouteInfo, location), serverGlobalData);
   const networkedData = routingNetworkedData(ran.routingNetworkedData);
   const scheduler = new UpdateScheduler();
   const {

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"hydrateTestPipelineApp.types.test.d.ts","sourceRoot":"","sources":["../../../src/testing/pipeline/hydrateTestPipelineApp.types.test.ts"],"names":[],"mappings":"AAeA,wBAAsB,MAAM,kBAO3B"}

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

@@ -0,0 +1,27 @@
+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 { pipeline } from '../../pipeline/pipeline.js';
+import { hydrateTestPipelineApp } from './hydrateTestPipelineApp.js';
+// Type tests: tsc is the assertion - nothing here runs. The app or stage must make what the root
+// reads, as createTestPipelineApp()'s must
+const stage = pipeline.server('express').init(() => ({
+  api: 'client'
+}));
+class Reads extends stage.SimpleComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "content", () => this.tungsten.context.api);
+  }
+}
+const other = pipeline.server('express').init(() => ({
+  db: 1
+}));
+export async function checks() {
+  await hydrateTestPipelineApp(stage.routes(() => []), Reads);
+  await hydrateTestPipelineApp(stage, Reads);
+  // @ts-expect-error -- another pipeline's app
+  await hydrateTestPipelineApp(other.routes(() => []), Reads);
+  // @ts-expect-error -- another pipeline's stage
+  await hydrateTestPipelineApp(other, Reads);
+}

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

@@ -0,0 +1,5 @@
+export { type AppCheck, type CreateTestPipelineAppArgs, type TestPipelineApp, type TestPipelineAppOptions, createTestPipelineApp, } from './createTestPipelineApp.js';
+export { type CreateTestPacketAppArgs, type PacketForComponent, type TestPacketAppOptions, createTestPacketApp, } from './createTestPacketApp.js';
+export { type HydrateTestPipelineApp, type HydrateTestPipelineAppOptions, hydrateTestPipelineApp, } from './hydrateTestPipelineApp.js';
+export { type HostPipelineDontResolveOptions, type HostPipelineOptions, type HostPipelineResolveOptions, type HostStoreOptions, type Hosted, type HostedResolved, type HostedRoute, hostPipeline, hostPipelineGeneric, hostPipelineJsx, } from './hostPipeline.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/pipeline/index.ts"],"names":[],"mappings":"AACA,OAAO,EACH,KAAK,QAAQ,EAAE,KAAK,yBAAyB,EAAE,KAAK,eAAe,EACnE,KAAK,sBAAsB,EAC3B,qBAAqB,GACxB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACH,KAAK,uBAAuB,EAAE,KAAK,kBAAkB,EAAE,KAAK,oBAAoB,EAChF,mBAAmB,GACtB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACH,KAAK,sBAAsB,EAAE,KAAK,6BAA6B,EAC/D,sBAAsB,GACzB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EACH,KAAK,8BAA8B,EAAE,KAAK,mBAAmB,EAAE,KAAK,0BAA0B,EAC9F,KAAK,gBAAgB,EAAE,KAAK,MAAM,EAAE,KAAK,cAAc,EAAE,KAAK,WAAW,EACzE,YAAY,EAAE,mBAAmB,EAAE,eAAe,GACrD,MAAM,mBAAmB,CAAA"}

package/dist/testing/pipeline/index.js

@@ -0,0 +1,4 @@
+export { createTestPipelineApp } from './createTestPipelineApp.js';
+export { createTestPacketApp } from './createTestPacketApp.js';
+export { hydrateTestPipelineApp } from './hydrateTestPipelineApp.js';
+export { hostPipeline, hostPipelineGeneric, hostPipelineJsx } from './hostPipeline.js';

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

@@ -0,0 +1,34 @@
+import type { ConstructPackage, TungstenBaseComponent } from '../../Components.jsx';
+import type { AsGlobalData, BrandedContext, BrandedNetworkedData } from '../../Brands.js';
+import type { InstancePipeline } from '../../Instance/Instance.js';
+import type { AppRoutes } from '../../routing/AppRoutes.js';
+import type { MatchedRouteInfo } from '../../routing/MatchedRouteInfo.js';
+import type { RoutesWithSettings } from '../../routing/Routes.js';
+import { type TestApp, type TestStoreOverride } from '../createTestApp.js';
+export type PipelineTestAppOptions<Props extends object> = {
+    document?: Document;
+    props?: Props;
+    container?: HTMLElement;
+    location?: string;
+    stores?: readonly TestStoreOverride<any>[];
+    fileVersions?: Record<string, string>;
+};
+export type PipelineTestTarget = {
+    document: Document;
+    container: HTMLElement;
+    ownsContainer: boolean;
+};
+export type PipelineTestData = {
+    location: string;
+    routes: RoutesWithSettings<any>;
+    appRoutes: AppRoutes<any>;
+    matchedRouteInfo: MatchedRouteInfo;
+    allRoutesData: AsGlobalData;
+    context: BrandedContext;
+    networkedData: BrandedNetworkedData;
+    networked: object;
+    pipeline: InstancePipeline;
+};
+export declare function pipelineTestTarget(options: PipelineTestAppOptions<object> | undefined, name: string): PipelineTestTarget;
+export declare function mountPipelineTestApp<Props extends object, Component extends TungstenBaseComponent, RouteData>(target: PipelineTestTarget, data: PipelineTestData, RootComponent: new (pkg: ConstructPackage<Props, RouteData>) => Component, options: PipelineTestAppOptions<Props> | undefined): Promise<TestApp<Component>>;
+//# sourceMappingURL=pipelineTestApp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipelineTestApp.d.ts","sourceRoot":"","sources":["../../../src/testing/pipeline/pipelineTestApp.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAA;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AAEzF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAElE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAKjE,OAAO,EAAyB,KAAK,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAKjG,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;CACxC,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC7B,QAAQ,EAAE,QAAQ,CAAA;IAClB,SAAS,EAAE,WAAW,CAAA;IACtB,aAAa,EAAE,OAAO,CAAA;CACzB,CAAA;AAGD,MAAM,MAAM,gBAAgB,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAA;IAC/B,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAA;IACzB,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,aAAa,EAAE,YAAY,CAAA;IAC3B,OAAO,EAAE,cAAc,CAAA;IACvB,aAAa,EAAE,oBAAoB,CAAA;IAEnC,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,gBAAgB,CAAA;CAC7B,CAAA;AAGD,wBAAgB,kBAAkB,CAC9B,OAAO,EAAE,sBAAsB,CAAC,MAAM,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAClE,kBAAkB,CAqBpB;AAED,wBAAsB,oBAAoB,CACtC,KAAK,SAAS,MAAM,EAAE,SAAS,SAAS,qBAAqB,EAAE,SAAS,EAExE,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,gBAAgB,EACtB,aAAa,EAAE,KAAK,GAAG,EAAE,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,SAAS,EACzE,OAAO,EAAE,sBAAsB,CAAC,KAAK,CAAC,GAAG,SAAS,GACnD,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAkF7B"}

package/dist/testing/pipeline/pipelineTestApp.js

@@ -0,0 +1,100 @@
+import { Instance } from '../../Instance/Instance.js';
+import { initStores } from '../../Servers/initStores.js';
+import { createTungstenRootComponent } from '../../update/integrateUpdateVdom.js';
+import { UpdateScheduler } from '../../update/UpdateScheduler.js';
+import { TestAppImplementation } from '../createTestApp.js';
+// checked before anything runs
+export function pipelineTestTarget(options, name) {
+  const suppliedDocument = options?.document ?? globalThis.document;
+  if (suppliedDocument === undefined) {
+    // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+    throw new Error(`${name} 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.');
+  }
+  return {
+    document,
+    container,
+    ownsContainer
+  };
+}
+export async function mountPipelineTestApp(target, data, RootComponent, options) {
+  const {
+    document,
+    container,
+    ownsContainer
+  } = target;
+  const {
+    location,
+    allRoutesData,
+    matchedRouteInfo,
+    context,
+    networkedData
+  } = data;
+  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 instance = new Instance(location, instanceConfig, null, data.appRoutes, data.routes, internalStore, stores, storeSubscriptions, allRoutesData, matchedRouteInfo, runtimeContext);
+  instance.fileVersions = options?.fileVersions;
+  instance.context = context;
+  instance.networkedData = networkedData;
+  instance.pipelineNetworked = data.networked;
+  instance.pipeline = data.pipeline;
+  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/pipeline/testPipelineRoute.d.ts

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

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

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

package/dist/testing/pipeline/testPipelineRoute.js

@@ -0,0 +1 @@
+export {};

package/dist/testing/resolveContent.d.ts

@@ -12,5 +12,7 @@ import type { ContentNode } from '../ContentNode.js';
  * by name and by prop as well as by what it put on the page.
  */
 export declare function resolveContent(content: ContentNode, parentComponent: AnyComponent | null, instance: Instance, constructed?: Constructed): Promise<ContentNode>;
+/** On a component node resolveContent resolved: the children it was passed, its own now output */
+export declare const $passedChildren: unique symbol;
 export type Constructed = (component: object) => void;
 //# sourceMappingURL=resolveContent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"resolveContent.d.ts","sourceRoot":"","sources":["../../src/testing/resolveContent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAA4C,MAAM,mBAAmB,CAAA;AAa9F;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAChC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,GAAG,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAG9E,WAAW,CAAC,EAAE,WAAW,GAC1B,OAAO,CAAC,WAAW,CAAC,CAiBtB;AAED,MAAM,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA"}
+{"version":3,"file":"resolveContent.d.ts","sourceRoot":"","sources":["../../src/testing/resolveContent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAA4C,MAAM,mBAAmB,CAAA;AAa9F;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAChC,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,GAAG,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAG9E,WAAW,CAAC,EAAE,WAAW,GAC1B,OAAO,CAAC,WAAW,CAAC,CAqBtB;AAED,kGAAkG;AAClG,eAAO,MAAM,eAAe,eAA2B,CAAA;AAEvD,MAAM,MAAM,WAAW,GAAG,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAA"}

package/dist/testing/resolveContent.js

@@ -32,8 +32,16 @@ constructed) {
   if (!ContentNodeElementIsComponent(content)) {
     return withChildren(content, await resolveContent(content[$props].children, parentComponent, instance, constructed));
   }
-  return withChildren(content, await rendered(content, parentComponent, instance, constructed));
+  const output = await rendered(content, parentComponent, instance, constructed);
+  const resolved = withChildren(content, output);
+  // non-enumerable, so a resolved node still deep-equals one written by hand
+  Object.defineProperty(resolved, $passedChildren, {
+    value: content[$props].children
+  });
+  return resolved;
 }
+/** On a component node resolveContent resolved: the children it was passed, its own now output */
+export const $passedChildren = Symbol('passedChildren');
 // what the component put on the page, resolved in its turn.
 // As render/componentNodeToRenderingTree: a component the app renders on the client alone never
 // runs its content here, so its placeholder stands for it

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tungsten",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "",
   "type": "module",
   "bin": {
@@ -13,6 +13,7 @@
     "./library": "./dist/components/library/index.js",
     "./react-zone": "./dist/zones/react.js",
     "./testing": "./dist/testing/index.js",
+    "./testing/pipeline": "./dist/testing/pipeline/index.js",
     "./jsx-runtime": "./dist/jsx-runtime.js",
     "./*": "./dist/*",
     "./types/*": "./types/*"
@@ -51,6 +52,7 @@
     "chalk-extensions": "^2.0.24",
     "chokidar": "^3.6.0",
     "cjs-module-lexer": "^1.4.3",
+    "css-select": "^7.0.0",
     "csstype": "^3.2.3",
     "deep-eql": "^4.1.4",
     "dotenv": "^16.6.1",
@@ -120,8 +122,8 @@
   },
   "scripts": {
     "__build": "pnpm clean && pnpm build-prep && pnpm build-watch",
-    "build": "run-s -c clean build-prep build-watch",
-    "build-tscmon": "rimraf dist && tscmon --on-first-success \"pnpm build-babel\"",
+    "build-old": "run-s -c clean build-prep build-watch",
+    "build": "rimraf dist && tscmon --on-first-success \"pnpm build-babel\"",
     "clean": "rimraf intermed dist",
     "build-prep": "pnpm build-ts-once",
     "build-watch": "run-p build-ts build-babel",