tungsten 0.6.3 → 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/pipeline/hydrateTestPipelineApp.d.ts

@@ -0,0 +1,30 @@
+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;
+    serverProps?: Props;
+    container?: HTMLElement;
+    location?: string;
+    reqRes?: ReqRes;
+    stores?: readonly TestStoreOverride<any>[];
+    fileVersions?: Record<string, string>;
+    csr?: boolean;
+};
+export type HydrateTestPipelineApp<Component extends TungstenBaseComponent> = HydrateTestApp<Component>;
+type HydrateTestPipelineAppArgs<Props extends object> = object extends Props ? [options?: HydrateTestPipelineAppOptions<Props>] : keyof Props extends never ? [options?: HydrateTestPipelineAppOptions<Props>] : [options: HydrateTestPipelineAppOptions<Props> & {
+    props: Props;
+}];
+/**
+ * hydrateTestApp() for an app built with pipeline() or splitPipeline(): the server pass runs the
+ * app's server stages, as a request does, and renders; the page carries the all-routes data and
+ * the networked data; the client pass runs the app's client stages, as hydratePipeline() does, and
+ * 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>, 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/pipeline/hydrateTestPipelineApp.js

@@ -0,0 +1,193 @@
+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;
+// eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion
+const asContext = context => context;
+const applyStores = async (instance, overrides) => {
+  for (const override of overrides) {
+    await override.initialize(override.registration.getStore(instance.stores));
+  }
+};
+const appRoutesFor = (app, init) => reqRes => pipelineRoutes(app, reqRes, init, true);
+/**
+ * hydrateTestApp() for an app built with pipeline() or splitPipeline(): the server pass runs the
+ * app's server stages, as a request does, and renders; the page carries the all-routes data and
+ * the networked data; the client pass runs the app's client stages, as hydratePipeline() does, and
+ * 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(pipelineOrApp, RootComponent, ...args) {
+  requireClient('hydrateTestPipelineApp()');
+  await waitForEnvIfLoading();
+  const app = toApp(pipelineOrApp);
+  const options = args[0];
+  const suppliedDocument = options?.document ?? globalThis.document;
+  if (suppliedDocument === undefined) {
+    // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+    throw new Error('hydrateTestPipelineApp() 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 HydrateTestApp container must belong to options.document.');
+  }
+  if (container.childNodes.length > 0) {
+    throw new Error('The HydrateTestApp container must be empty before hydrating.');
+  }
+  const clientProps = options?.props ?? {}; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
+  const serverProps = options?.serverProps ?? clientProps;
+  const location = options?.location ?? '/';
+  const overrides = options?.stores ?? [];
+  const instanceConfig = {
+    prod: false,
+    useRootComponent: true,
+    clientSideNav: true,
+    siteBasePath: '/',
+    staticSite: false,
+    csr: options?.csr ?? false
+  };
+  // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- a stand-in request
+  const reqRes = options?.reqRes ?? {
+    req: {
+      url: location,
+      headers: {}
+    },
+    res: {}
+  };
+  // Server pass: the app's server stages, as PipelineRequestHandler runs them, then the render
+  const runner = app.split === true ? splitServer : symmetricServer;
+  const serverDataLoading = {
+    value: false
+  };
+  const routed = await runner.route(app, reqRes, location, serverDataLoading, true);
+  const post = await runner.post(app, reqRes, routed.init, routed.allRoutesData);
+  const served = runner.networked(routed.init, post);
+  const transport = new NetworkedTransport(served);
+  transport.snapshotAfterRouting();
+  const serverGlobalData = asGlobalData(routed.allRoutesData);
+  const ssrScheduler = new UpdateScheduler();
+  let html;
+  try {
+    const serverContext = asContext(runner.context(routed.init, post));
+    const serverNetworked = transport; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- as the request handler hands it
+    const ssrStores = initStores(location, reqRes, serverGlobalData, routed.matchedRouteInfo, serverDataLoading, serverContext, serverNetworked);
+    const ssrInstance = new Instance(location, instanceConfig, reqRes, appRoutesFor(app, routed.init), routed.routes, ssrStores.internalStore, ssrStores.stores, ssrStores.storeSubscriptions, serverGlobalData, routed.matchedRouteInfo, {
+      document,
+      window: document.defaultView,
+      scheduler: ssrScheduler,
+      navigation: false
+    });
+    ssrInstance.fileVersions = options?.fileVersions;
+    ssrInstance.context = serverContext;
+    ssrInstance.networkedData = serverNetworked;
+    ssrInstance.pipelineNetworked = served ?? {};
+    await applyStores(ssrInstance, overrides);
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- rootToHtml.ts builds a root content node the same way
+    const componentNode = {
+      [$type]: RootComponent,
+      [$props]: serverProps
+    };
+    const renderingTree = await contentTreeToRenderingTree(componentNode, null, ssrInstance, false);
+    const headData = {
+      found: false,
+      instance: ssrInstance,
+      clientImportAliases: {},
+      importAliases: {},
+      compilationLocation: '',
+      dev: false,
+      tungstenPublicEnv: undefined,
+      siteBasePath: '',
+      hmr: true,
+      csr: instanceConfig.csr
+    };
+    html = await renderingNodeToHtml(renderingTree, false, headData, null);
+  } finally {
+    ssrScheduler.dispose();
+  }
+  // what the page carries: processHead writes the transport after the render
+  const fromPage = JSON.parse(JSONstringify(transport));
+  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);
+  }
+  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, fromPage);
+  const routes = pipelineRoutes(app, null, ran.init, true);
+  const {
+    key,
+    params,
+    data
+  } = routed.matchedRouteInfo;
+  const matchedRouteInfo = hydrationRouting({
+    key,
+    params,
+    ...('data' in routed.matchedRouteInfo ? {
+      data
+    } : {})
+  }, routes);
+  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 {
+    internalStore,
+    stores,
+    storeSubscriptions
+  } = initStores(location, null, serverGlobalData, matchedRouteInfo, null, context, networkedData);
+  const instance = new Instance(location, instanceConfig, null, appRoutesFor(app, ran.init), routes, internalStore, stores, storeSubscriptions, serverGlobalData, matchedRouteInfo, {
+    document,
+    window: document.defaultView,
+    scheduler,
+    navigation: false
+  });
+  instance.fileVersions = options?.fileVersions;
+  instance.context = context;
+  instance.networkedData = networkedData;
+  instance.pipelineNetworked = ran.networked;
+  const rerun = ran.allRoutesData;
+  instance.pipeline = {
+    routingContext: routingContext(ran.routingContext),
+    routingNetworkedData: networkedData,
+    allRoutesData: rerun && (async () => asGlobalData(await rerun())),
+    afterRouting
+  };
+  try {
+    await applyStores(instance, overrides);
+    const meta = makeDefaultHydrateMeta();
+    const component = await hydrateRootComponent(instance, RootComponent, new DomPointer(container, 0), meta, clientProps, matchedRouteInfo.params, matchedRouteInfo.data);
+    return new HydrateTestAppImplementation(document, container, component, instance, scheduler, ownsContainer, html, meta.mismatches);
+  } 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/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 {};