tungsten 0.3.1 → 0.3.3

package/dist/render/contentToHtml.js

@@ -22,7 +22,9 @@ export async function contentToHtml(compilationInfo, clientImportAliases, conten
     compilationLocation: compilationInfo.buildCodeLocation,
     dev,
     tungstenPublicEnv,
-    siteBasePath: siteBasePathOverride
+    siteBasePath: siteBasePathOverride,
+    hmr: config.hmr,
+    csr: config.csr
   };
   //console.log('rendering tree', inspect(tree, { depth: 99 } ))
   let html = await renderingNodeToHtml(tree, false, headData, null);

package/dist/render/processHead.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"processHead.d.ts","sourceRoot":"","sources":["../../src/render/processHead.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAK7C,OAAO,EAAE,oBAAoB,EAAqB,MAAM,qBAAqB,CAAA;AAO7E,wBAAgB,WAAW,CACvB,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,QAAQ,QAmHrB"}
+{"version":3,"file":"processHead.d.ts","sourceRoot":"","sources":["../../src/render/processHead.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAK7C,OAAO,EAAE,oBAAoB,EAAqB,MAAM,qBAAqB,CAAA;AAS7E,wBAAgB,WAAW,CACvB,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,QAAQ,QA6MrB"}

package/dist/render/processHead.js

@@ -3,6 +3,8 @@ import { clientFolder, componentCssFolder, componentCssFile } from "../settings.
 import { addImportMap } from "./addImportMap.js";
 import { $props, $type } from "../contentNodeSymbols.js";
 import { windowGlobalEnvStatement } from 'tungsten/env/windowGlobalEnvStatement.js';
+import { frameworkDestLocation } from "../build/frameworkDestLocation.js";
+import { devErrorPageClearRetryScript } from "../Servers/devErrorPageAutoRetry.js";
 // process the tree returned by the root component
 // doing things like ensuring there is are html and head elements,
 // and adding necessary style and script tags
@@ -12,7 +14,8 @@ export function processHead(headNode, headData) {
     importAliases,
     clientImportAliases,
     dev,
-    siteBasePath
+    siteBasePath,
+    hmr
   } = headData;
   //console.log('processing head. dev is', dev)
   if (headNode[$props].children === undefined) headNode[$props].children = [];else if (!Array.isArray(headNode[$props].children)) headNode[$props].children = [headNode[$props].children];
@@ -59,16 +62,60 @@ export function processHead(headNode, headData) {
     };
     cjsHelpersScriptNode[$props].type = 'module';
     headNode[$props].children.unshift(cjsHelpersScriptNode);
-    // auto-reload the page whenever the dev build finishes recompiling.
-    // this is a plain full-page reload signal, not module-level hot patching.
-    const liveReloadScriptNode = {
+    // A successful render means whatever the error page's auto-retry script (see
+    // devErrorPageAutoRetry.ts) may have been counting is over - clear it so a later,
+    // unrelated transient error gets its own full retry budget instead of inheriting a
+    // stale count.
+    const clearErrorRetryScriptNode = {
       [$type]: 'script',
       [$props]: {
         'data--t-internal': undefined,
-        children: `(function(){` + `var es=new EventSource('${siteBasePath}/__tungsten_live_reload__');` + `es.addEventListener('js',function(){location.reload()});` + `es.addEventListener('css',function(){location.reload()});` + `})();`
+        children: devErrorPageClearRetryScript
       }
     };
-    headNode[$props].children.unshift(liveReloadScriptNode);
+    headNode[$props].children.unshift(clearErrorRetryScriptNode);
+    // Auto-reload / HMR. This has to stay a raw inline script rather than a real imported
+    // module: it fetches whichever file just recompiled via a computed, cache-busted
+    // import() call, and any dynamic import() with a non-literal argument anywhere in the
+    // framework's traced dependency graph makes the package-copying step that serves
+    // framework code to the browser throw (it requires every import specifier to be
+    // statically known so it can be rewritten/copied). Keeping this logic as untraced text
+    // sidesteps that. applyHmrModule.js itself has no dynamic imports, so it's safely
+    // reachable via a normal static import elsewhere (see hydrate.tsx) and gets copied
+    // there, then loaded here by computed URL. See tungsten/docs/hmr.md.
+    // Tier 1 (hmr: 'reload', or nothing left for Tier 2 to do): always full-reload. A
+    // simple, independent branch from Tier 2's logic - restored as an explicit config value
+    // so it's available as a one-line escape hatch if Tier 2 itself is misbehaving.
+    // The server sends its bootId as the first event on every connection (see
+    // handleLiveReloadStream). If sessionStorage already holds a different one, this
+    // connection is a reconnect to a process that restarted since the page loaded (e.g. via
+    // tungsten devmon on a framework rebuild) - EventSource retries silently on its own, so
+    // this is the only reliable signal that the page is now stale and needs reloading.
+    const bootIdReloadSnippet = `es.addEventListener('boot',function(ev){` + `var bootId=JSON.parse(ev.data).bootId;` + `var key='__tungsten_boot_id__';` + `var prev=sessionStorage.getItem(key);` + `sessionStorage.setItem(key,bootId);` + `if(prev!==null&&prev!==bootId){location.reload()}` + `});`;
+    const tier1OnlyScript = `(function(){` + `var es=new EventSource('${siteBasePath}/__tungsten_live_reload__');` + bootIdReloadSnippet + `es.addEventListener('css',function(){location.reload()});` + `es.addEventListener('js',function(){location.reload()});` + `})();`;
+    // Tier 2: attempt an in-place component/CSS hot-swap before falling back to a full
+    // reload. See tungsten/docs/hmr.md.
+    const tier2Script = `(function(){` + `var es=new EventSource('${siteBasePath}/__tungsten_live_reload__');` + `function fullReload(reason){console.info('[tungsten-hmr] full reload:',reason);location.reload()}` + `es.addEventListener('boot',function(ev){` + `var bootId=JSON.parse(ev.data).bootId;` + `var key='__tungsten_boot_id__';` + `var prev=sessionStorage.getItem(key);` + `sessionStorage.setItem(key,bootId);` + `if(prev!==null&&prev!==bootId){fullReload('dev server restarted')}` + `});` + `function loadHmr(){return import('${frameworkDestLocation}/hmr/applyHmrModule.js')}`
+    // CSS has no state to preserve, so re-applying it is always safe: refreshStylesheets()
+    // inserts the new link and only removes the old one once it's loaded, so there's no
+    // gap where nothing is applied (a plain href swap can produce a visible flash).
+    + `es.addEventListener('css',function(){` + `console.info('[tungsten-hmr] css change, refreshing stylesheets');` + `loadHmr().then(function(hmr){return Promise.all(hmr.refreshStylesheets())})` + `.catch(function(e){console.error('[tungsten-hmr] stylesheet refresh failed',e)});` + `});` + `es.addEventListener('js',function(ev){` + `var payload;` + `try{payload=JSON.parse(ev.data)}catch(e){fullReload('bad payload');return}` + `var files=(payload&&payload.files)||[];` + `if(files.length===0){fullReload('no files in payload');return}` + `console.info('[tungsten-hmr] fetching',files);` + `loadHmr().then(function(hmr){`
+    // a component's own inline style block piggybacks on this same JS pipeline (it
+    // lives in the .tsx/.jsx source, not a separate .css file), so refresh stylesheets
+    // here too rather than only on a dedicated 'css' event - independently of the
+    // component swap below, so a stylesheet load error doesn't force a full reload.
+    + `Promise.all(hmr.refreshStylesheets())` + `.catch(function(e){console.error('[tungsten-hmr] stylesheet refresh failed',e)});` + `return Promise.all(files.map(function(f){return import(f+'?t='+Date.now())}))` + `.then(function(modules){` + `return Promise.all(modules.map(function(m,i){return hmr.applyHmrModule(m,files[i])}))` + `})` + `})` + `.then(function(results){` + `console.info('[tungsten-hmr] results',results);` + `if(results.some(function(r){return r&&r.orphaned})){fullReload('a component export was renamed or removed');return}` + `if(!results.some(function(r){return r&&r.matched}))fullReload('no matching live component found')` + `})` + `.catch(function(e){console.error('[tungsten-hmr] swap failed',e);fullReload('error during swap')});` + `});` + `})();`;
+    // hmr === false: no live-reload script at all (auto-refresh fully disabled).
+    if (hmr !== false) {
+      const liveReloadScriptNode = {
+        [$type]: 'script',
+        [$props]: {
+          'data--t-internal': undefined,
+          children: hmr === true ? tier2Script : tier1OnlyScript
+        }
+      };
+      headNode[$props].children.unshift(liveReloadScriptNode);
+    }
   }
   const {
     content: _,

package/dist/render/renderingTreeToHtml.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"renderingTreeToHtml.d.ts","sourceRoot":"","sources":["../../src/render/renderingTreeToHtml.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAY7C,OAAO,EACH,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAG7C,MAAM,qBAAqB,CAAA;AAU5B,wBAAsB,mBAAmB,CACrC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAC1D,UAAU,EAAE,iBAAiB,GAAG,IAAI,GACrC,OAAO,CAAC,MAAM,CAAC,CAwJjB"}
+{"version":3,"file":"renderingTreeToHtml.d.ts","sourceRoot":"","sources":["../../src/render/renderingTreeToHtml.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAY7C,OAAO,EACH,KAAK,aAAa,EAAE,KAAK,iBAAiB,EAG7C,MAAM,qBAAqB,CAAA;AAU5B,wBAAsB,mBAAmB,CACrC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAC1D,UAAU,EAAE,iBAAiB,GAAG,IAAI,GACrC,OAAO,CAAC,MAAM,CAAC,CA8JjB"}

package/dist/render/renderingTreeToHtml.js

@@ -1,4 +1,5 @@
 import { reduce as objectReduce } from 'sxy-lib/objects.js';
+import { booleanAttributeValue } from "../booleanAttributeValue.js";
 import { processProps } from "./processProps.js";
 import { htmlVoidTags } from "./htmlVoidTags.js";
 import { validRenderingChildren } from "../validChildren.js";
@@ -77,7 +78,9 @@ export async function renderingNodeToHtml(node, noEscape, headData, lastSelect)
     const attribs = objectReduce(processProps(attribProps), (string, key, value) => {
       //debug('reducing attr', key, value)
       if (typeof value === 'boolean') {
-        if (value) return string + ` ${key}`;else return string;
+        const attrValue = booleanAttributeValue(key, value);
+        if (attrValue === null) return string;
+        return attrValue === '' ? string + ` ${key}` : string + ` ${key}="${attrValue}"`;
       } else if (value === undefined || value === null) {
         return string;
       } else {
@@ -86,6 +89,10 @@ export async function renderingNodeToHtml(node, noEscape, headData, lastSelect)
     }, '');
     //   : ''
     debug('attribs', attribs);
+    // CSR: body's own attributes render, its children don't - see FrameworkConfig.ts.
+    if (type === 'body' && headData.csr) {
+      return html + `<${type}${attribs}></${type}>`;
+    }
     if (typeof node[$props].__zoneHtml === 'string') {
       return html + `<${type}${attribs}>${node[$props].__zoneHtml}</${type}>`;
     }

package/dist/routing/ErrorRouteType.d.ts

@@ -0,0 +1,6 @@
+import type { RouteContentFunction } from './RouteContentFunction.js';
+import type { TungstenErrorInfo } from './TungstenErrorInfo.js';
+export type ErrorRouteType = {
+    content: RouteContentFunction<object, TungstenErrorInfo>;
+};
+//# sourceMappingURL=ErrorRouteType.d.ts.map

package/dist/routing/ErrorRouteType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorRouteType.d.ts","sourceRoot":"","sources":["../../src/routing/ErrorRouteType.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAA;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAM/D,MAAM,MAAM,cAAc,GAAG;IACzB,OAAO,EAAE,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;CAC3D,CAAA"}

package/dist/routing/ErrorRouteType.js

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

package/dist/routing/RouteTypes.d.ts

@@ -1,6 +1,7 @@
 import type { Routes } from './Routes.js';
 export type Path = `/${string}`;
-export type RouteKey = Path | 'default' | '404' | 'error';
+export type SpecialRoute = 'default' | '404' | 'error';
+export type RouteKey = Path | SpecialRoute;
 export declare function StringIsValidRouteKey(string: string, routes: Routes): string is RouteKey;
 export declare function StringIsPath(string: string): string is Path;
 export declare function RouteKeyIsPath(path: RouteKey): path is Path;

package/dist/routing/RouteTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RouteTypes.d.ts","sourceRoot":"","sources":["../../src/routing/RouteTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,MAAM,IAAI,GAAG,IAAI,MAAM,EAAE,CAAA;AAC/B,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAA;AACzD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,QAAQ,CAExF;AACD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,IAAI,CAE3D;AACD,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,IAAI,IAAI,CAE3D"}
+{"version":3,"file":"RouteTypes.d.ts","sourceRoot":"","sources":["../../src/routing/RouteTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzC,MAAM,MAAM,IAAI,GAAG,IAAI,MAAM,EAAE,CAAA;AAC/B,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,KAAK,GAAG,OAAO,CAAA;AACtD,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,YAAY,CAAA;AAE1C,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,QAAQ,CAExF;AACD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,IAAI,CAE3D;AACD,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,IAAI,IAAI,CAE3D"}

package/dist/routing/Routes.d.ts

@@ -1,5 +1,6 @@
 import type { Path } from './RouteTypes.js';
 import type { RouteType } from './RouteType.js';
+import type { ErrorRouteType } from './ErrorRouteType.js';
 export type MinimumRoutes = {
     default: RouteType<any, any>;
 } | {
@@ -7,6 +8,8 @@ export type MinimumRoutes = {
 };
 export type Routes = {
     [key in Path]: RouteType<any, any>;
+} & {
+    'error'?: ErrorRouteType;
 } & ({
     'default': RouteType<any, any>;
 } | {
@@ -14,6 +17,8 @@ export type Routes = {
 });
 export type CustomRoutes<Route extends RouteType<any, any>> = {
     [key in Path]: Route;
+} & {
+    error: ErrorRouteType;
 } & ({
     'default': Route;
 } | {

package/dist/routing/Routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Routes.d.ts","sourceRoot":"","sources":["../../src/routing/Routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAY,MAAM,iBAAiB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,MAAM,MAAM,aAAa,GACnB;IAAE,OAAO,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CAAE,GAChC;IAAE,KAAK,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CAAE,CAAA;AAEpC,MAAM,MAAM,MAAM,GAAG;KAAG,GAAG,IAAI,IAAI,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;CAAE,GACzD,CACE;IAAE,SAAS,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CAAE,GAChC;IAAE,KAAK,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CAAE,CACnC,CAAA;AAED,MAAM,MAAM,YAAY,CAAC,KAAK,SAAS,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI;KAAG,GAAG,IAAI,IAAI,GAAG,KAAK;CAAE,GACpF,CACE;IAAE,SAAS,EAAE,KAAK,CAAA;CAAE,GAClB;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CACrB,CAAA"}
+{"version":3,"file":"Routes.d.ts","sourceRoot":"","sources":["../../src/routing/Routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD,MAAM,MAAM,aAAa,GACnB;IAAE,OAAO,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CAAE,GAChC;IAAE,KAAK,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CAAE,CAAA;AAEpC,MAAM,MAAM,MAAM,GAAG;KAAG,GAAG,IAAI,IAAI,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC;CAAE,GACzD;IAAE,OAAO,CAAC,EAAE,cAAc,CAAA;CAAE,GAC5B,CACE;IAAE,SAAS,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CAAE,GAChC;IAAE,KAAK,EAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CAAE,CACnC,CAAA;AAED,MAAM,MAAM,YAAY,CAAC,KAAK,SAAS,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI;KAAG,GAAG,IAAI,IAAI,GAAG,KAAK;CAAE,GACpF;IAAE,KAAK,EAAE,cAAc,CAAA;CAAE,GACzB,CACE;IAAE,SAAS,EAAE,KAAK,CAAA;CAAE,GAClB;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CACrB,CAAA"}

package/dist/routing/TungstenErrorInfo.d.ts

@@ -0,0 +1,6 @@
+export type TungstenErrorInfo = {
+    error: unknown;
+    message: string;
+};
+export declare function makeTungstenErrorInfo(error: unknown): TungstenErrorInfo;
+//# sourceMappingURL=TungstenErrorInfo.d.ts.map

package/dist/routing/TungstenErrorInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TungstenErrorInfo.d.ts","sourceRoot":"","sources":["../../src/routing/TungstenErrorInfo.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,iBAAiB,GAAG;IAC5B,KAAK,EAAE,OAAO,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAEvE"}

package/dist/routing/TungstenErrorInfo.js

@@ -0,0 +1,6 @@
+export function makeTungstenErrorInfo(error) {
+  return {
+    error,
+    message: error instanceof Error ? error.message : String(error)
+  };
+}

package/dist/style/styleContentSxy.js

@@ -121,6 +121,27 @@ function processItem(element, styles, usage) {
   }
   newClassName = newClassName.trim();
   if (newClassName !== '') element[$props].className = newClassName;
+  // Any other *ClassName prop (e.g. messageClassName, handed to a child component to apply
+  // to one of its own elements) gets the same local-stylesheet lookup applied in place, so a
+  // classname threaded down through props can still be scoped against this component's own
+  // stylesheet, even though the child's own render tree is outside this walk - see
+  // styleContentSxy() above.
+  for (const key in element[$props]) {
+    if (key === 'className' || !key.endsWith('ClassName')) continue;
+    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}`);
+    }
+    let newValue = value;
+    for (const cn of value.split(' ')) {
+      if (cn in styles.classes) {
+        newValue += ` ${styles.classes[cn]}`;
+        usage?.usedClasses.add(cn);
+      }
+    }
+    if (newValue !== value) element[$props][key] = newValue;
+  }
   debug('element after mods', tagName, element);
   // apply this to both fragment and elements
   if (element[$props].children !== undefined) {

package/dist/testing/hydrateTestApp.d.ts

@@ -0,0 +1,38 @@
+import type { ConstructPackage, TungstenBaseComponent, TungstenComponentPropsBase } from '../Components.jsx';
+import type { TaggedAttributeMismatch } from '../hydrate/renderHydrationMismatchBanner.js';
+import type { TestAppOptions } from './index.js';
+export type HydrateTestAppOptions<Props extends object> = TestAppOptions<Props> & {
+    serverProps?: Props;
+    csr?: boolean;
+};
+type HydrateTestAppArgs<Props extends object> = object extends Props ? [options?: HydrateTestAppOptions<Props>] : keyof Props extends never ? [options?: HydrateTestAppOptions<Props>] : [options: HydrateTestAppOptions<Props> & {
+    props: Props;
+}];
+export type HydrateTestApp<Component extends TungstenBaseComponent> = {
+    readonly document: Document;
+    readonly container: HTMLElement;
+    readonly component: Component;
+    readonly html: string;
+    readonly mismatches: readonly TaggedAttributeMismatch[];
+    resolved(): Promise<void>;
+    setProps(props: Component['props']): Promise<void>;
+    unmount(): Promise<void>;
+};
+/**
+ * The hydration round trip createTestApp() deliberately doesn't cover: render a component to
+ * HTML the way a real server would, parse it with a real HTML parser, hydrate a fresh client
+ * instance against the result, and hand back the live, hydrated component - still fully usable
+ * via setProps()/resolved(), exactly like createTestApp()'s result.
+ *
+ * By default `props` renders on both sides, so a passing test proves an ordinary page hydrates
+ * clean (`mismatches` empty). Pass `serverProps` to diverge the two passes on purpose and assert
+ * on the resulting `mismatches` - the case a one-off "does the reconciler still agree with real
+ * served pages" script never could, because nothing fed it markup that didn't already match.
+ *
+ * A structural mismatch (a different tag, a different number of children) is not something
+ * reconcileHydratedAttributes() can fix - hydrateRootComponent() throws, exactly as the real
+ * client hydrator does, so a caller reproducing that class of bug should assert on the rejection.
+ */
+export declare function hydrateTestApp<Props extends TungstenComponentPropsBase, Component extends TungstenBaseComponent<any, any>, RouteData = undefined>(RootComponent: new (pkg: ConstructPackage<NoInfer<Props>, RouteData>) => Component, ...args: HydrateTestAppArgs<Props>): Promise<HydrateTestApp<Component>>;
+export {};
+//# sourceMappingURL=hydrateTestApp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hydrateTestApp.d.ts","sourceRoot":"","sources":["../../src/testing/hydrateTestApp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACR,gBAAgB,EAChB,qBAAqB,EACrB,0BAA0B,EAC7B,MAAM,mBAAmB,CAAA;AAO1B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6CAA6C,CAAA;AAa1F,OAAO,KAAK,EAAE,cAAc,EAAqB,MAAM,YAAY,CAAA;AAEnE,MAAM,MAAM,qBAAqB,CAAC,KAAK,SAAS,MAAM,IAAI,cAAc,CAAC,KAAK,CAAC,GAAG;IAM9E,WAAW,CAAC,EAAE,KAAK,CAAA;IAEnB,GAAG,CAAC,EAAE,OAAO,CAAA;CAChB,CAAA;AAED,KAAK,kBAAkB,CAAC,KAAK,SAAS,MAAM,IAAI,MAAM,SAAS,KAAK,GAC9D,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC,GACxC,MAAM,KAAK,SAAS,KAAK,GACrB,CAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC,GACxC,CAAC,OAAO,EAAE,qBAAqB,CAAC,KAAK,CAAC,GAAG;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC,CAAA;AAEpE,MAAM,MAAM,cAAc,CAAC,SAAS,SAAS,qBAAqB,IAAI;IAClE,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAA;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAG7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IAIrB,QAAQ,CAAC,UAAU,EAAE,SAAS,uBAAuB,EAAE,CAAA;IAEvD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAClD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B,CAAA;AAkGD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAChC,KAAK,SAAS,0BAA0B,EACxC,SAAS,SAAS,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,EACjD,SAAS,GAAG,SAAS,EAErB,aAAa,EAAE,KAAK,GAAG,EAAE,gBAAgB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,SAAS,CAAC,KAAK,SAAS,EAClF,GAAG,IAAI,EAAE,kBAAkB,CAAC,KAAK,CAAC,GACnC,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CA6HpC"}

package/dist/testing/hydrateTestApp.js

@@ -0,0 +1,242 @@
+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 { $props, $type } from "../contentNodeSymbols.js";
+import { Instance } from "../Instance/Instance.js";
+import { hydrateRootComponent } from "../hydrate/hydrate.js";
+import { contentTreeToRenderingTree } from "../render/contentTreeToRenderingTree.js";
+import { renderingNodeToHtml } from "../render/renderingTreeToHtml.js";
+import { initStores } from "../Servers/initStores.js";
+import { deleteNodeIfRendered } from "../update/integrateUpdateVdom.js";
+import { UpdateScheduler } from "../update/UpdateScheduler.js";
+import { DomPointer } from "../DomPointer.js";
+import { ensureTestEnvLoaded } from "./ensureTestEnvLoaded.js";
+// hydrate.tsx references several DOM globals directly (Node.COMMENT_NODE, `instanceof Text`, the
+// bare `document`) the way real browser code always can - happy-dom only puts these on its own
+// Window, not on Node.js's global scope. Every hand-written hydration test before this harness
+// bridged them manually; a caller of hydrateTestApp() shouldn't need to know that hydrate() was
+// written assuming a real browser to begin with.
+function bridgeHappyDomGlobals(document) {
+  const window = document.defaultView;
+  if (window === null) return;
+  const globals = globalThis; // eslint-disable-line no-type-assertion/no-type-assertion -- bridging happy-dom's globals onto the global scope
+  globals.Node = window.Node;
+  globals.Text = window.Text;
+  globals.Comment = window.Comment;
+  globals.Element = window.Element;
+  globals.HTMLElement = window.HTMLElement;
+  globals.Document = window.Document;
+  globals.document = document;
+  globals.window = window;
+}
+var _instance = /*#__PURE__*/new WeakMap();
+var _scheduler = /*#__PURE__*/new WeakMap();
+var _ownsContainer = /*#__PURE__*/new WeakMap();
+var _unmounted = /*#__PURE__*/new WeakMap();
+class HydrateTestAppImplementation {
+  constructor(document, container, component, instance, scheduler, ownsContainer, html, mismatches) {
+    _defineProperty(this, "document", void 0);
+    _defineProperty(this, "container", void 0);
+    _defineProperty(this, "component", void 0);
+    _defineProperty(this, "html", void 0);
+    _defineProperty(this, "mismatches", void 0);
+    _classPrivateFieldInitSpec(this, _instance, void 0);
+    _classPrivateFieldInitSpec(this, _scheduler, 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 HydrateTestApp.');
+      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 {
+        this.component.__delete();
+        deleteNodeIfRendered(this.component.__currentContent);
+        this.component.__deleted();
+        _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(_ownsContainer, this, ownsContainer);
+    this.html = html;
+    this.mismatches = mismatches;
+  }
+}
+/**
+ * The hydration round trip createTestApp() deliberately doesn't cover: render a component to
+ * HTML the way a real server would, parse it with a real HTML parser, hydrate a fresh client
+ * instance against the result, and hand back the live, hydrated component - still fully usable
+ * via setProps()/resolved(), exactly like createTestApp()'s result.
+ *
+ * By default `props` renders on both sides, so a passing test proves an ordinary page hydrates
+ * clean (`mismatches` empty). Pass `serverProps` to diverge the two passes on purpose and assert
+ * on the resulting `mismatches` - the case a one-off "does the reconciler still agree with real
+ * served pages" script never could, because nothing fed it markup that didn't already match.
+ *
+ * A structural mismatch (a different tag, a different number of children) is not something
+ * reconcileHydratedAttributes() can fix - hydrateRootComponent() throws, exactly as the real
+ * client hydrator does, so a caller reproducing that class of bug should assert on the rejection.
+ */
+export async function hydrateTestApp(RootComponent, ...args) {
+  await ensureTestEnvLoaded();
+  const options = args[0]; // eslint-disable-line no-type-assertion/no-type-assertion
+  const suppliedDocument = options?.document ?? globalThis.document; // eslint-disable-line no-type-assertion/no-type-assertion
+  if (suppliedDocument === undefined) {
+    // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+    throw new Error('hydrateTestApp() 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.');
+  }
+  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 clientProps = options?.props ?? {}; // eslint-disable-line no-type-assertion/no-type-assertion
+  const serverProps = options?.serverProps ?? clientProps;
+  const location = options?.location ?? '/';
+  const globalData = options?.globalData ?? {}; // eslint-disable-line no-type-assertion/no-type-assertion
+  const matchedRouteInfo = {
+    key: null,
+    params: options?.routeParams ?? {},
+    content: null,
+    ...(options !== undefined && 'routeData' in options ? {
+      data: options.routeData
+    } : {})
+  };
+  const instanceConfig = {
+    prod: false,
+    useRootComponent: true,
+    clientSideNav: false,
+    siteBasePath: '/',
+    staticSite: false,
+    csr: options?.csr ?? false
+  };
+  const emptyRoutes = {}; // eslint-disable-line no-type-assertion/no-type-assertion -- not exercised by hydration tests
+  // eslint-disable-next-line no-type-assertion/no-type-assertion -- rootToHtml.ts builds a root content node the same way
+  const componentNode = {
+    [$type]: RootComponent,
+    [$props]: serverProps
+  };
+  // Server pass: a throwaway Instance whose only job is producing the HTML a real server would
+  // have sent for `serverProps`. Never returned, never touched again once `html` is captured.
+  const ssrScheduler = new UpdateScheduler();
+  let html;
+  try {
+    const {
+      internalStore,
+      stores,
+      storeSubscriptions
+    } = initStores(location, null, globalData, matchedRouteInfo);
+    const ssrInstance = new Instance(location, instanceConfig, null, emptyRoutes, emptyRoutes,
+    // eslint-disable-line no-type-assertion/no-type-assertion
+    internalStore, stores, storeSubscriptions, globalData, matchedRouteInfo, {
+      document,
+      window: document.defaultView,
+      scheduler: ssrScheduler,
+      navigation: false
+    });
+    for (const override of options?.stores ?? []) {
+      const store = override.registration.getStore(ssrInstance.stores);
+      await override.initialize(store);
+    }
+    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();
+  }
+  // A real HTML parser - the same algorithm a browser runs before hydrate() ever sees the page
+  // - not a comparison against the string above, so browser parsing quirks (an auto-closed <p>,
+  // an inserted <tbody>) surface exactly as they would in production.
+  container.innerHTML = html;
+  bridgeHappyDomGlobals(document);
+  const scheduler = new UpdateScheduler();
+  const {
+    internalStore,
+    stores,
+    storeSubscriptions
+  } = initStores(location, null, globalData, matchedRouteInfo);
+  const runtimeContext = {
+    document,
+    window: document.defaultView,
+    scheduler,
+    navigation: false
+  };
+  const instance = new Instance(location, instanceConfig, null, emptyRoutes, emptyRoutes,
+  // eslint-disable-line no-type-assertion/no-type-assertion
+  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 meta = {
+      insideForm: false,
+      mismatches: []
+    };
+    const domPointer = new DomPointer(container, 0);
+    const component = await hydrateRootComponent(instance, RootComponent, domPointer, meta, clientProps, options?.routeParams, options?.routeData);
+    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/index.d.ts

@@ -1,5 +1,6 @@
-import type { TungstenBaseComponent, TungstenBaseComponentType } from '../Components.jsx';
+import type { ConstructPackage, TungstenBaseComponent, TungstenBaseComponentType, TungstenComponentPropsBase } from '../Components.jsx';
 export { ensureTestEnvLoaded, testEnvVariableName } from './ensureTestEnvLoaded.js';
+export { hydrateTestApp, type HydrateTestApp, type HydrateTestAppOptions } from './hydrateTestApp.js';
 import type { TrueStore } from '../Store/makeStore.js';
 export type ComponentProps<ComponentType extends TungstenBaseComponentType<any, any>> = InstanceType<ComponentType>['props'];
 export type TestStoreRegistration<Schema extends object> = {
@@ -29,8 +30,8 @@ export type TestApp<Component extends TungstenBaseComponent> = {
     setProps(props: Component['props']): Promise<void>;
     unmount(): Promise<void>;
 };
-type CreateTestAppArgs<Props extends object> = object extends Props ? [options?: TestAppOptions<Props>] : keyof Props extends never ? [options?: TestAppOptions<Props>] : [options: TestAppOptions<Props> & {
+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<ComponentType extends TungstenBaseComponentType<any, any>>(RootComponent: ComponentType, ...args: CreateTestAppArgs<ComponentProps<ComponentType>>): Promise<TestApp<InstanceType<ComponentType>>>;
+export declare function createTestApp<Props extends TungstenComponentPropsBase, Component extends TungstenBaseComponent<any, any>, RouteData = undefined>(RootComponent: new (pkg: ConstructPackage<NoInfer<Props>, RouteData>) => Component, ...args: CreateTestAppArgs<Props>): Promise<TestApp<Component>>;
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/testing/index.js

@@ -10,6 +10,7 @@ import { Instance } from "../Instance/Instance.js";
 import { initStores } from "../Servers/initStores.js";
 import { ensureTestEnvLoaded } from "./ensureTestEnvLoaded.js";
 export { ensureTestEnvLoaded, testEnvVariableName } from "./ensureTestEnvLoaded.js";
+export { hydrateTestApp } from "./hydrateTestApp.js";
 import { createTungstenRootComponent, deleteTungstenRoot } from "../update/integrateUpdateVdom.js";
 import { UpdateScheduler } from "../update/UpdateScheduler.js";
 export function testStore(registration, initialize) {
@@ -73,7 +74,19 @@ class TestAppImplementation {
     _classPrivateFieldSet(_ownsContainer, this, ownsContainer);
   }
 }
-export async function createTestApp(RootComponent, ...args) {
+export async function createTestApp(
+// NoInfer applies to Props only inside the constructor parameter, not to
+// RootComponent as a whole - so Props is inferred from `props` alone
+// (a generic component's own type parameters can then be inferred from a
+// typed props value, the same way `const x: TungstenBaseComponentType<
+// BoundProps<Form, 'value'>> = BoundValue` already type-checks), while
+// Component is still inferred from the constructor's return type, so
+// `.component` on the result keeps the concrete class (state, methods),
+// not the erased TungstenBaseComponent base. Without the NoInfer, Props
+// is inferred from RootComponent first - a bare class reference with no
+// type arguments - so a generic component's own parameters collapse to
+// their constraints before `props` is ever considered.
+RootComponent, ...args) {
   await ensureTestEnvLoaded();
   const options = args[0];
   const suppliedDocument = options?.document ?? globalThis.document;
@@ -124,7 +137,8 @@ export async function createTestApp(RootComponent, ...args) {
     useRootComponent: true,
     clientSideNav: false,
     siteBasePath: '/',
-    staticSite: false
+    staticSite: false,
+    csr: false
   };
   const emptyRoutes = {};
   const instance = new Instance(location, instanceConfig, null, emptyRoutes, emptyRoutes, internalStore, stores, storeSubscriptions, globalData, matchedRouteInfo, runtimeContext);

package/dist/timeProfiler.d.ts

@@ -0,0 +1,6 @@
+export type TimeProfiler = {
+    timeProfile: <T>(name: string, task: () => T) => T;
+    timeProfileAsync: <T>(name: string, task: () => T | Promise<T>) => Promise<T>;
+};
+export declare function createTimeProfiler(profiling?: boolean): TimeProfiler;
+//# sourceMappingURL=timeProfiler.d.ts.map

package/dist/timeProfiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeProfiler.d.ts","sourceRoot":"","sources":["../src/timeProfiler.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,YAAY,GAAG;IACvB,WAAW,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;IAClD,gBAAgB,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAA;CAChF,CAAA;AAMD,wBAAgB,kBAAkB,CAAC,SAAS,UAAO,GAAG,YAAY,CAqBjE"}