tungsten 0.5.5 → 0.5.7

package/dist/staticGen/getAppRoutes.js

@@ -6,28 +6,23 @@ import { cliLog } from '../cliOutput.js';
 // this file is outdated and may not work correctly
 // should compare this to the functions used by Servers
 export async function getAppRoutes(compilationInfo, config, quiet = false) {
-  //const fullBuildLocation = 'file://' + compilationInfo.location
-  const routesLocation = config.routesLocation;
-  //if (routesLocation === null) return routesLocation // hopefully we are validating
+  const [routesFile, routeExport] = config.routesLocation;
   try {
-    if (Array.isArray(routesLocation)) {
-      const routesFile = fixExtension(join(compilationInfo.buildCodeLocation, routesLocation[0]));
-      if (!quiet) {
-        cliLog('[1] fullBuildLocation', compilationInfo.location);
-        cliLog('[1] routesLocation[0]', routesLocation[0]);
-        cliLog('joined', join(compilationInfo.location, routesLocation[0]));
-        cliLog('[1] routesFile', routesFile);
-      }
-      const target = 'file://' + routesFile;
-      if (!quiet) cliLog('[1] target', target);
-      return (await import(target))[routesLocation[1]];
-    } else {
-      const target = 'file://' + join(compilationInfo.buildCodeLocation, routesLocation);
-      if (!quiet) cliLog('[2] location', target);
-      const module = await import(target);
-      if ('routes' in module) return module.routes;else if ('default' in module) return module.default;else throw new TungstenError(`Err, no 'routes' or 'default' export found in routes file ${routesLocation}`);
+    const filePath = fixExtension(join(compilationInfo.buildCodeLocation, routesFile));
+    if (!quiet) {
+      cliLog('[1] fullBuildLocation', compilationInfo.location);
+      cliLog('[1] routesLocation[0]', routesFile);
+      cliLog('joined', join(compilationInfo.location, routesFile));
+      cliLog('[1] routesFile', filePath);
     }
+    const target = 'file://' + filePath;
+    if (!quiet) cliLog('[1] target', target);
+    const module = await import(target);
+    if (!(routeExport in module)) {
+      throw new TungstenError(`Could not find an export named ${routeExport} in routes file ${routesFile}.` + ` These settings are set in config.routesLocation.`);
+    }
+    return module[routeExport];
   } catch (e) {
-    throw new TungstenError(`Error loading app routes. You can specify the location of your routes object in tungsten.config.js,` + ` e.g. routesLocation: ['Routes.jsx', 'routes'] (file, exportName)` + `\n${e}`);
+    throw new TungstenError(`Error loading app routes.` + ` You can specify the location of your routes object in tungsten.config.js,` + ` e.g. routesLocation: ['Routes.jsx', 'routes'] (file, exportName)` + `\n${e}`);
   }
 }

package/dist/staticGen/staticGen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"staticGen.d.ts","sourceRoot":"","sources":["../../src/staticGen/staticGen.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAgBhD,wBAAsB,SAAS,CAAC,SAAS,EAAE,SAAS,iBA+MnD"}
+{"version":3,"file":"staticGen.d.ts","sourceRoot":"","sources":["../../src/staticGen/staticGen.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAehD,wBAAsB,SAAS,CAAC,SAAS,EAAE,SAAS,iBAoNnD"}

package/dist/staticGen/staticGen.js

@@ -3,6 +3,7 @@ import { join, dirname } from 'path';
 const copy = (from, to) => fsPromises.cp(from, to, {
   recursive: true
 });
+import { filter as objectFilter, count } from 'sxy-lib/objects.js';
 //import type { SxyFrameworkConfigComplete } from '../FrameworkConfig.js'
 import { staticSiteFolder, staticFolder, assetsFolder, publicFolder, bundleFolder, componentCssFolder, frameworkCssFolder } from '../settings.js';
 import { getAppRoutes } from './getAppRoutes.js';
@@ -11,7 +12,6 @@ import { matchPath } from '../routing/matchPath.js';
 import { throwError } from '../throwError.js';
 import { RouteKeyIsPath, StringIsPath } from '../routing/RouteTypes.js';
 import { findLinks, pathToLink, pathToFileName, rewriteLinks } from './staticGenFunctions.js';
-import { filter as objectFilter, count } from 'sxy-lib/objects.js';
 export async function staticGen(framework) {
   if (framework.compilationInfo === undefined) {
     throwError('staticGen()', `framework.compilationInfo is undefined`);
@@ -96,7 +96,9 @@ export async function staticGen(framework) {
         const response = await fetch(url);
         // fetch, unlike axios, resolves on non-2xx - so check explicitly, or we'd
         // write error pages out as static HTML
-        if (!response.ok) throwError('renderPath', `Get request to ${url} returned an invalid status: ${response.status}`);
+        if (!response.ok) {
+          throwError('renderPath', `Get request to ${url} returned an invalid status: ${response.status}`);
+        }
         let result = await response.text();
         links = findLinks(result);
         const newPaths = [];
@@ -142,7 +144,7 @@ export async function staticGen(framework) {
         }
       } catch (e) {
         const stack = typeof e === 'object' && e !== null && 'stack' in e ? e.stack : '';
-        cliError(`Static site gen - error generating path ${path} (full location ${url}): ${String(e)} ${String(stack)}`);
+        cliError(`Static site gen - error generating path ${path} (full location ${url}): ` + `${String(e)} ${String(stack)}`);
       }
     };
     for (const [path, route] of Object.entries(finalRoutes)) {

package/dist/staticGen/staticGenFunctions.d.ts

@@ -1,4 +1,4 @@
-import { SiteBasePath as SiteBasePath } from '../render/HeadData.js';
+import type { SiteBasePath as SiteBasePath } from '../render/HeadData.js';
 export declare function pathToFileName(path: string): string;
 export declare function pathToLink(path: string, siteBasePath: SiteBasePath): string;
 export declare function findLinks(content: string): string[];

package/dist/staticGen/staticGenFunctions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"staticGenFunctions.d.ts","sourceRoot":"","sources":["../../src/staticGen/staticGenFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAGpE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,UAM1C;AACD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,UAMlE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQnD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAM/E"}
+{"version":3,"file":"staticGenFunctions.d.ts","sourceRoot":"","sources":["../../src/staticGen/staticGenFunctions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAGzE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,UAM1C;AACD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY,UAMlE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQnD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,UAM/E"}

package/dist/style/jssToCss.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jssToCss.d.ts","sourceRoot":"","sources":["../../src/style/jssToCss.ts"],"names":[],"mappings":"AAoBA,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,UAqBpC"}
+{"version":3,"file":"jssToCss.d.ts","sourceRoot":"","sources":["../../src/style/jssToCss.ts"],"names":[],"mappings":"AAqBA,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,UAqBpC"}

package/dist/style/styleContent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styleContent.d.ts","sourceRoot":"","sources":["../../src/style/styleContent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAEtD,eAAO,MAAM,YAAY,wBAAkB,CAAA"}
+{"version":3,"file":"styleContent.d.ts","sourceRoot":"","sources":["../../src/style/styleContent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAGtD,eAAO,MAAM,YAAY,wBAAkB,CAAA"}

package/dist/style/styleContentSxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styleContentSxy.d.ts","sourceRoot":"","sources":["../../src/style/styleContentSxy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EACH,KAAK,WAAW,EAEnB,MAAM,mBAAmB,CAAA;AAc1B,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,eAIrE"}
+{"version":3,"file":"styleContentSxy.d.ts","sourceRoot":"","sources":["../../src/style/styleContentSxy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAC9C,OAAO,EAIH,KAAK,WAAW,EAEnB,MAAM,mBAAmB,CAAA;AAe1B,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,eAIrE"}

package/dist/style/styleContentSxy.js

@@ -113,7 +113,7 @@ function processItem(element, styles, usage) {
   //console.log(element.props.className)
   if (element[$props].className !== undefined && element[$props].className !== null) {
     if (typeof element[$props].className !== 'string') {
-      throw new TungstenError(`styleContentSxy() error: ${ContentNodeElementIsHtml(element) ? element[$type] : getComponentName(element)}` + ` className prop should be a string. Received ${typeof element[$props].className}`);
+      throw new TungstenError(`styleContentSxy() error: ` + `${ContentNodeElementIsHtml(element) ? element[$type] : getComponentName(element)}` + ` className prop should be a string. Received ${typeof element[$props].className}`);
     }
     newClassName += ' ' + element[$props].className;
     const classNames = element[$props].className.split(' ');
@@ -136,7 +136,7 @@ function processItem(element, styles, usage) {
     const value = element[$props][key];
     if (value === undefined || value === null) continue;
     if (typeof value !== 'string') {
-      throw new TungstenError(`styleContentSxy() error: ${ContentNodeElementIsHtml(element) ? element[$type] : getComponentName(element)}` + ` ${key} prop should be a string. Received ${typeof value}`);
+      throw new TungstenError(`styleContentSxy() error: ` + `${ContentNodeElementIsHtml(element) ? element[$type] : getComponentName(element)}` + ` ${key} prop should be a string. Received ${typeof value}`);
     }
     let newValue = value;
     for (const cn of value.split(' ')) {

package/dist/style/unusedStyles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unusedStyles.d.ts","sourceRoot":"","sources":["../../src/style/unusedStyles.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAY9C,MAAM,MAAM,UAAU,GAAG;IACrB,MAAM,EAAE,QAAQ,CAAA;IAChB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACrB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAC3B,CAAA;AAUD,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,cAQ7C;AA2BD,wBAAsB,kBAAkB,kBAgBvC"}
+{"version":3,"file":"unusedStyles.d.ts","sourceRoot":"","sources":["../../src/style/unusedStyles.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAa9C,MAAM,MAAM,UAAU,GAAG;IACrB,MAAM,EAAE,QAAQ,CAAA;IAChB,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACrB,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;CAC3B,CAAA;AAUD,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,cAQ7C;AA2BD,wBAAsB,kBAAkB,kBAgBvC"}

package/dist/styleProcessors.js

@@ -1,3 +1,4 @@
+export {};
 /*
 
 
@@ -18,5 +19,4 @@ export const Sass: StyleProcessor = ((style) => cssNamesCompleteSample)
 export const Scss: StyleProcessor = ((style) => cssNamesCompleteSample)
 //export const Less: StyleProcessor = ((style) => cssNamesCompleteSample)
 
-*/
-export {};
+*/

package/dist/sync/index.d.ts

@@ -1,4 +1,4 @@
-import { ExportsVar, ModuleVar, RequireFunc } from '../CjsTypes.js';
+import type { ExportsVar, ModuleVar, RequireFunc } from '../CjsTypes.js';
 export declare const deps: never[];
 export default function cjsModule(module: ModuleVar, exports: ExportsVar, require: RequireFunc): void;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAGnE,eAAO,MAAM,IAAI,SAAK,CAAA;AAEtB,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,QAM7F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAIxE,eAAO,MAAM,IAAI,SAAK,CAAA;AAEtB,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,QAM7F"}

package/dist/testing/createTestApp.d.ts

@@ -0,0 +1,35 @@
+import type { ConstructPackage, TungstenBaseComponent, TungstenBaseComponentType, TungstenComponentPropsBase } from '../Components.jsx';
+import type { TrueStore } from '../Store/makeStore.js';
+export type ComponentProps<ComponentType extends TungstenBaseComponentType<any, any>> = InstanceType<ComponentType>['props'];
+export type TestStoreRegistration<Schema extends object> = {
+    getStore: (stores: TrueStore<unknown>[]) => TrueStore<Schema>;
+};
+export type TestStore<Schema extends object> = TrueStore<Schema>;
+export type TestStoreOverride<Schema extends object = object> = {
+    registration: TestStoreRegistration<Schema>;
+    initialize: (store: TrueStore<Schema>) => void | Promise<void>;
+};
+export declare function testStore<Schema extends object>(registration: TestStoreRegistration<Schema>, initialize: (store: TestStore<Schema>) => void | Promise<void>): TestStoreOverride<Schema>;
+export type TestAppOptions<Props extends object> = {
+    document?: Document;
+    props?: Props;
+    container?: HTMLElement;
+    location?: string;
+    routeParams?: Record<string, string>;
+    routeData?: unknown;
+    globalData?: Record<string, unknown>;
+    stores?: readonly TestStoreOverride<any>[];
+};
+export type TestApp<Component extends TungstenBaseComponent> = {
+    readonly document: Document;
+    readonly container: HTMLElement;
+    readonly component: Component;
+    resolved(): Promise<void>;
+    setProps(props: Component['props']): Promise<void>;
+    unmount(): Promise<void>;
+};
+export type CreateTestAppArgs<Props extends object> = object extends Props ? [options?: TestAppOptions<Props>] : keyof Props extends never ? [options?: TestAppOptions<Props>] : [options: TestAppOptions<Props> & {
+    props: Props;
+}];
+export declare function createTestApp<Props extends TungstenComponentPropsBase, Component extends TungstenBaseComponent<any, any>, RouteData = undefined>(RootComponent: new (pkg: ConstructPackage<Props, RouteData>) => Component, ...args: CreateTestAppArgs<Props>): Promise<TestApp<Component>>;
+//# sourceMappingURL=createTestApp.d.ts.map

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

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

package/dist/testing/createTestApp.js

@@ -0,0 +1,159 @@
+function _classPrivateFieldInitSpec(e, t, a) { _checkPrivateRedeclaration(e, t), t.set(e, a); }
+function _checkPrivateRedeclaration(e, t) { if (t.has(e)) throw new TypeError("Cannot initialize the same private elements twice on an object"); }
+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); }
+function _classPrivateFieldGet(s, a) { return s.get(_assertClassBrand(s, a)); }
+function _classPrivateFieldSet(s, a, r) { return s.set(_assertClassBrand(s, a), r), r; }
+function _assertClassBrand(e, t, n) { if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n; throw new TypeError("Private element is not present on this object"); }
+import { Instance } from '../Instance/Instance.js';
+import { initStores } from '../Servers/initStores.js';
+import { createTungstenRootComponent, deleteTungstenRoot } from '../update/integrateUpdateVdom.js';
+import { UpdateScheduler } from '../update/UpdateScheduler.js';
+import { waitForEnvIfLoading } from './loadEnv.js';
+export function testStore(registration, initialize) {
+  return {
+    registration,
+    initialize
+  };
+}
+var _instance = /*#__PURE__*/new WeakMap();
+var _scheduler = /*#__PURE__*/new WeakMap();
+var _root = /*#__PURE__*/new WeakMap();
+var _ownsContainer = /*#__PURE__*/new WeakMap();
+var _unmounted = /*#__PURE__*/new WeakMap();
+class TestAppImplementation {
+  constructor(document, container, component, instance, scheduler, root, ownsContainer) {
+    _defineProperty(this, "document", void 0);
+    _defineProperty(this, "container", void 0);
+    _defineProperty(this, "component", void 0);
+    _classPrivateFieldInitSpec(this, _instance, void 0);
+    _classPrivateFieldInitSpec(this, _scheduler, void 0);
+    _classPrivateFieldInitSpec(this, _root, void 0);
+    _classPrivateFieldInitSpec(this, _ownsContainer, void 0);
+    _classPrivateFieldInitSpec(this, _unmounted, false);
+    _defineProperty(this, "resolved", async () => {
+      await _classPrivateFieldGet(_scheduler, this).resolved();
+    });
+    _defineProperty(this, "setProps", async props => {
+      if (_classPrivateFieldGet(_unmounted, this)) throw new Error('Cannot set props on an unmounted Tungsten TestApp.');
+      this.component.props = props;
+      _classPrivateFieldGet(_instance, this).queueUpdate(this.component);
+      await this.resolved();
+    });
+    _defineProperty(this, "unmount", async () => {
+      if (_classPrivateFieldGet(_unmounted, this)) return;
+      _classPrivateFieldSet(_unmounted, this, true);
+      _classPrivateFieldGet(_scheduler, this).cancelPending();
+      let cleanupError;
+      try {
+        deleteTungstenRoot(_classPrivateFieldGet(_root, this));
+        _classPrivateFieldGet(_instance, this).disposeRegisteredComponents();
+        await _classPrivateFieldGet(_scheduler, this).resolved();
+      } catch (error) {
+        cleanupError = error;
+        try {
+          _classPrivateFieldGet(_instance, this).disposeRegisteredComponents();
+        } catch {
+          // Preserve the first cleanup failure.
+        }
+      } finally {
+        _classPrivateFieldGet(_scheduler, this).dispose();
+        if (_classPrivateFieldGet(_ownsContainer, this)) this.container.remove();else while (this.container.firstChild !== null) this.container.removeChild(this.container.firstChild);
+      }
+      if (cleanupError !== undefined) throw cleanupError;
+    });
+    this.document = document;
+    this.container = container;
+    this.component = component;
+    _classPrivateFieldSet(_instance, this, instance);
+    _classPrivateFieldSet(_scheduler, this, scheduler);
+    _classPrivateFieldSet(_root, this, root);
+    _classPrivateFieldSet(_ownsContainer, this, ownsContainer);
+  }
+}
+export async function createTestApp(
+// Props is inferred from both the class and `props`, so literal props are typed by the component
+RootComponent, ...args) {
+  await waitForEnvIfLoading();
+  const options = args[0];
+  const suppliedDocument = options?.document ?? globalThis.document;
+  if (suppliedDocument === undefined) {
+    // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+    throw new Error('createTestApp() 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.');
+  }
+  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 location = options?.location ?? '/';
+  const globalData = options?.globalData ?? {};
+  const matchedRouteInfo = {
+    key: null,
+    params: options?.routeParams ?? {},
+    content: null,
+    ...(options !== undefined && 'routeData' in options ? {
+      data: options.routeData
+    } : {})
+  };
+  const scheduler = new UpdateScheduler();
+  const runtimeContext = {
+    document,
+    window: document.defaultView,
+    scheduler,
+    navigation: false
+  };
+  const {
+    internalStore,
+    stores,
+    storeSubscriptions
+  } = initStores(location, null, globalData, matchedRouteInfo);
+  const instanceConfig = {
+    prod: false,
+    useRootComponent: true,
+    clientSideNav: false,
+    siteBasePath: '/',
+    staticSite: false,
+    csr: false
+  };
+  const emptyRoutes = {};
+  const instance = new Instance(location, instanceConfig, null, emptyRoutes, emptyRoutes, internalStore, stores, storeSubscriptions, globalData, matchedRouteInfo, runtimeContext);
+  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, options?.routeParams, options?.routeData, 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/helpers/contentHtmlElements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contentHtmlElements.d.ts","sourceRoot":"","sources":["../../../src/testing/helpers/contentHtmlElements.ts"],"names":[],"mappings":"AAEA,OAAO,EAGH,KAAK,WAAW,EAChB,KAAK,eAAe,EACvB,MAAM,sBAAsB,CAAA;AAG7B,eAAO,MAAM,mBAAmB,GAAI,SAAS,WAAW,KAAG,eAAe,EAUzE,CAAA"}

package/dist/testing/host.d.ts

@@ -1,6 +1,10 @@
-import { TungstenBaseComponent, TungstenSimpleComponent, type ConstructPackage, type TungstenComponent, type TungstenComponentPropsBase, type TungstenStatefulComponent } from '../Components.jsx';
 import type { ContentNode } from '../ContentNode.js';
-import { type MockEnvironment } from './temp/componentPackageMock.js';
+import type { InternalStoreSchema } from '../Store/InternalStoreSchema.js';
+import type { TrueStore } from '../Store/makeStore.js';
+import type { Routes } from '../routing/Routes.js';
+import type { RoutesFunction } from '../routing/RoutesFunction.js';
+import type { Path, RouteKey } from '../routing/RouteTypes.js';
+import { TungstenBaseComponent, TungstenSimpleComponent, type ComponentStore, type TungstenComponent, type TungstenComponentClass, type TungstenComponentPropsBase, type TungstenStatefulComponent } from '../Components.jsx';
 type StateOf<Component> = Component extends {
     state?: infer State;
 } ? State : never;
@@ -10,10 +14,6 @@ type ReservedMember = keyof HostedCore<TungstenBaseComponent<any, any>>;
 export type ComponentApi<Component extends TungstenBaseComponent<any, any>> = {
     [Key in keyof Component as Key extends FrameworkMember | ReservedMember ? never : NonNullable<Component[Key]> extends (...args: any[]) => any ? Key : never]: Component[Key];
 };
-export type HostOptions = {
-    environment?: MockEnvironment;
-};
-export type HostArgs<Props extends TungstenComponentPropsBase> = object extends Props ? [props?: Props, options?: HostOptions] : keyof Props extends never ? [props?: Props, options?: HostOptions] : [props: Props, options?: HostOptions];
 export type Navigation = {
     kind: 'goto' | 'redirect';
     to: string;
@@ -30,6 +30,64 @@ type HostedCore<Component extends TungstenBaseComponent<any, any>> = {
     updateState: (setter: StateSetter<Component>) => Promise<Awaited<ContentOf<Component>>>;
 };
 export type Hosted<Component extends TungstenBaseComponent<any, any>> = HostedCore<Component> & ComponentApi<Component>;
+type StoreSchemaOf<Component> = Component extends {
+    store: ComponentStore<infer Schema extends object>;
+} ? Schema : never;
+type StoreOf<Component> = [StoreSchemaOf<Component>] extends [never] ? never : [StoreSchemaOf<Component>] extends [InternalStoreSchema] ? never : StoreSchemaOf<Component>;
+export type HostedRoute = {
+    key: RouteKey | null;
+    params?: Record<string, string>;
+    data?: unknown;
+};
+type RouteOptions = {
+    routing: true;
+    location: Path;
+    routes: Routes | RoutesFunction;
+    matchedRoute?: never;
+} | {
+    routing?: false;
+    location?: Path;
+    routes?: Routes;
+    matchedRoute?: HostedRoute;
+};
+type NoStore = {
+    store?: never;
+    partialStore?: never;
+    storeData?: never;
+    partialStoreData?: never;
+};
+type StoreOptionsFor<Schema extends object> = {
+    /** A real store (makeStore), used as-is: its cells keep state, so one can be shared between hosts. */
+    store: TrueStore<Schema>;
+    partialStore?: never;
+    storeData?: never;
+    partialStoreData?: never;
+} | {
+    /** Some real cells. A key not given is missing, not defaulted: reading it throws, naming it. */
+    partialStore: Partial<TrueStore<Schema>>;
+    store?: never;
+    storeData?: never;
+    partialStoreData?: never;
+} | {
+    /** Values for every key, each wrapped in a cell of its own. */
+    storeData: Schema;
+    store?: never;
+    partialStore?: never;
+    partialStoreData?: never;
+} | {
+    /** Values for some keys. A key not given is missing, not defaulted: reading it throws, naming it. */
+    partialStoreData: Partial<Schema>;
+    store?: never;
+    partialStore?: never;
+    storeData?: never;
+};
+export type HostStoreOptions<Schema extends object> = (RouteOptions & StoreOptionsFor<Schema>) extends infer Options ? Options extends unknown ? {
+    [K in keyof Options]: Options[K];
+} : never : never;
+export type HostOptions<Component> = [StoreOf<Component>] extends [never] ? (RouteOptions & NoStore) extends infer Options ? Options extends unknown ? {
+    [K in keyof Options]: Options[K];
+} : never : never : HostStoreOptions<StoreOf<Component>>;
+type HostArgs<Props, Component> = [StoreOf<Component>] extends [never] ? object extends Props ? [props?: Props, options?: HostOptions<Component>] : [props: Props, options?: HostOptions<Component>] : object extends Props ? [props: Props | undefined, options: HostOptions<Component>] : [props: Props, options: HostOptions<Component>];
 /**
  * Constructs a component outside of any app and drives it the way the framework
  * does - init, then the mount lifecycles - calling its content function with
@@ -43,7 +101,17 @@ export type Hosted<Component extends TungstenBaseComponent<any, any>> = HostedCo
  *
  * State is not proxied (the construct package is marked `hosted`), so nothing
  * re-renders on its own: updateProps() and updateState() are the renders.
+ *
+ * Store components have a structural overload: Schema is its own parameter, inferred from
+ * the class, so a generic wrapper (`Component extends { store: ComponentStore<S> }`) can
+ * call through without a cast. HostArgs is a conditional on Component, and a conditional
+ * on a type parameter is deferred, so nothing is assignable to it inside such a wrapper.
  */
-export declare function host<Props extends TungstenComponentPropsBase, Component extends TungstenBaseComponent<any, any>>(ComponentType: new (pkg: ConstructPackage<Props, undefined>) => Component, ...args: HostArgs<Props>): Promise<Hosted<Component>>;
+export declare function host<Props extends TungstenComponentPropsBase, Schema extends object, Component extends TungstenBaseComponent<any, any> & {
+    store: ComponentStore<Schema>;
+}>(ComponentType: TungstenComponentClass<Props, Component> & (new (...args: any) => {
+    store: ComponentStore<Schema>;
+}), props: Props, options: NoInfer<[Schema] extends [InternalStoreSchema] ? never : HostStoreOptions<Schema>>): Promise<Hosted<Component>>;
+export declare function host<Props extends TungstenComponentPropsBase, Component extends TungstenBaseComponent<any, any>>(ComponentType: TungstenComponentClass<Props, Component>, ...[props, options]: HostArgs<Props, Component>): Promise<Hosted<Component>>;
 export {};
 //# sourceMappingURL=host.d.ts.map

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

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

package/dist/testing/host.js

@@ -1,28 +1,58 @@
-import { TungstenBaseComponent, TungstenSimpleComponent } from "../Components.js";
-import { componentPackageMock } from './temp/componentPackageMock.js';
+import { TungstenBaseComponent, TungstenBaseSimpleStoreComponent, TungstenBaseStatefulStoreComponent, TungstenBaseStoreComponent, TungstenSimpleComponent } from "../Components.js";
+import { objectMap } from '../objectMap.js';
+import { routing } from "../Servers/routing.js";
+import { missingStoreValue, storeValue, testingComponentPackage } from './testingComponentPackage.js';
 const isPromise = value => value instanceof Promise || typeof value === 'object' && value !== null && 'then' in value;
 // The same list at runtime. Underscore-prefixed members are excluded by rule
 // (the framework's naming scheme), so only the plain-named ones are listed, and
 // frameworkMembersAreComplete below fails to compile if one is ever missed.
 const frameworkMemberNames = ['props', 'routeParams', 'routeData', 'parentComponent', 'childComponents', 'globalData', 'state', 'storeData', 'style', 'title', 'content', 'render', 'init', 'clientInit', 'serverInit', 'componentDidMount', 'componentDidHydrate', 'componentDidUpdate', 'componentDidRender', 'componentWillUnmount', 'componentDidUnmount', 'shouldStoreComponentUpdate', 'setState', 'triggerUpdate', 'pickProps', 'pickState', 'using', 'reactive', 'setTimeout', 'setInterval', 'clearTimeout', 'clearInterval'];
 const frameworkMembers = new Set(frameworkMemberNames);
-/**
- * Constructs a component outside of any app and drives it the way the framework
- * does - init, then the mount lifecycles - calling its content function with
- * whatever arguments its flavour takes, so tests don't have to match the
- * (props) / (props, state) signature themselves.
- *
- * No DOM: content is returned as a content node tree, unstyled, and never
- * reconciled. createTestApp() is the harness for anything that needs a document
- * or app state. Lifecycle failures are thrown rather than only reported, so a
- * test can't pass over one.
- *
- * State is not proxied (the construct package is marked `hosted`), so nothing
- * re-renders on its own: updateProps() and updateState() are the renders.
- */
-export async function host(ComponentType, ...args) {
-  // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- the conditional tuple isn't destructurable as written
-  const [props, options] = args;
+const isStoreComponent = component => component instanceof TungstenBaseStoreComponent || component instanceof TungstenBaseSimpleStoreComponent || component instanceof TungstenBaseStatefulStoreComponent;
+// Runs routing only when asked: a unit test otherwise states the route itself.
+async function hostedRouting(options) {
+  if (options.routing === true) {
+    const routes = typeof options.routes === 'function' ? options.routes(null) : options.routes;
+    return {
+      routes,
+      internalStore: {
+        location: options.location,
+        matchedRouteInfo: await routing(options.location, routes),
+        popMessages: []
+      }
+    };
+  }
+  const {
+    location,
+    matchedRoute
+  } = options;
+  const matchedRouteInfo = matchedRoute === undefined ? undefined : {
+    key: matchedRoute.key,
+    params: matchedRoute.params ?? {},
+    content: null,
+    ...('data' in matchedRoute ? {
+      data: matchedRoute.data
+    } : {})
+  };
+  return {
+    routes: options.routes,
+    internalStore: {
+      location: location ?? '/',
+      ...(matchedRouteInfo !== undefined ? {
+        matchedRouteInfo
+      } : {}),
+      popMessages: []
+    }
+  };
+}
+export async function host(ComponentType, props,
+// unknown, not a loose object type: the general overload's rest tuple can't be related to one
+options) {
+  const stored = options ?? {};
+  const storeData = stored.storeData ?? stored.partialStoreData;
+  const store = stored.store ?? stored.partialStore ?? (storeData === undefined ? undefined : objectMap(storeData, (_, value) => storeValue(value)));
+  const partial = stored.partialStore !== undefined || stored.partialStoreData !== undefined;
+  const route = await hostedRouting(stored);
   const pending = [];
   const failures = [];
   // Instance.trackWork's no-scheduler path, except the work is kept so host
@@ -48,9 +78,16 @@ export async function host(ComponentType, ...args) {
   };
   let title;
   const navigations = [];
-  const component = new ComponentType(componentPackageMock(
+  const component = new ComponentType(testingComponentPackage(
   // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- an absent props object is only reachable when Props allows {}
   props ?? {}, {
+    ...(store !== undefined ? {
+      store
+    } : {}),
+    ...(route.routes !== undefined ? {
+      routes: route.routes
+    } : {}),
+    internalStore: route.internalStore,
     trackWork,
     // setState's work, run and awaited here rather than left to a timer
     queueTask: (task, description) => {
@@ -72,11 +109,14 @@ export async function host(ComponentType, ...args) {
         kind: 'redirect',
         to
       });
-    },
-    ...(options?.environment !== undefined ? {
-      environment: options.environment
-    } : {})
+    }
   }));
+  // a partial store only has the keys supplied, so name any other it reads
+  if (partial && isStoreComponent(component)) {
+    component.store = new Proxy(component.store, {
+      get: (target, key) => typeof key === 'symbol' || key in target ? Reflect.get(target, key) : missingStoreValue(`store.${key}`)
+    });
+  }
   // eslint-disable-next-line @typescript-eslint/no-unsafe-type-assertion -- state isn't on the base class, see StateOf
   const stateful = component;
   const simple = component instanceof TungstenSimpleComponent;

package/dist/testing/hydrateTestApp.d.ts

@@ -1,6 +1,6 @@
 import type { ConstructPackage, TungstenBaseComponent, TungstenComponentPropsBase } from '../Components.jsx';
 import type { TaggedAttributeMismatch } from '../hydrate/renderHydrationMismatchBanner.js';
-import type { TestAppOptions } from './index.js';
+import type { TestAppOptions } from './createTestApp.js';
 export type HydrateTestAppOptions<Props extends object> = TestAppOptions<Props> & {
     serverProps?: Props;
     csr?: boolean;