tungsten 0.3.2 → 0.3.3

package/dist/defaultConfig.js

@@ -22,5 +22,6 @@ export const defaultConfig = {
   suppressNoHeadWarning: false,
   suppressOriginMismatchWarning: false,
   warnOnFrameworkChange: true,
-  hmr: true
+  hmr: true,
+  csr: false
 };

package/dist/env/Interfaces.d.ts

@@ -1,8 +1,9 @@
 import type { TungstenCorePrivateEnv } from '../Servers/tungstenCorePrivateEnvSchema.js';
+import type { TungstenCorePublicEnv } from '../Servers/tungstenCorePublicEnvSchema.js';
 declare global {
     interface TungstenPrivateEnv extends TungstenCorePrivateEnv {
     }
-    export interface TungstenPublicEnv {
+    export interface TungstenPublicEnv extends TungstenCorePublicEnv {
     }
 }
 //# sourceMappingURL=Interfaces.d.ts.map

package/dist/env/Interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Interfaces.d.ts","sourceRoot":"","sources":["../../src/env/Interfaces.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAA;AAExF,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,kBAAmB,SAAQ,sBAAsB;KAAG;IAC9D,MAAM,WAAW,iBAAiB;KAAG;CACxC"}
+{"version":3,"file":"Interfaces.d.ts","sourceRoot":"","sources":["../../src/env/Interfaces.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,4CAA4C,CAAA;AACxF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2CAA2C,CAAA;AAEtF,OAAO,CAAC,MAAM,CAAC;IACX,UAAU,kBAAmB,SAAQ,sBAAsB;KAAG;IAC9D,MAAM,WAAW,iBAAkB,SAAQ,qBAAqB;KAAG;CACtE"}

package/dist/env/getEnvSchemas.d.ts

@@ -3,7 +3,7 @@ import { ZodType } from 'zod';
 import { TungstenEnv } from './types.js';
 export type EnvSchemas = {
     privateEnvSchema?: ZodType<TungstenEnv & TungstenPrivateEnv>;
-    publicEnvSchema?: ZodType<TungstenEnv>;
+    publicEnvSchema?: ZodType<TungstenEnv & TungstenPublicEnv>;
 };
 export declare function getEnvSchemas(config: FrameworkConfigComplete, iteration: number, dev: 'dev'): Promise<EnvSchemas>;
 export declare function getEnvSchemas(config: FrameworkConfigComplete, iteration?: null, dev?: 'prod'): Promise<EnvSchemas>;

package/dist/env/getEnvSchemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getEnvSchemas.d.ts","sourceRoot":"","sources":["../../src/env/getEnvSchemas.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAEpE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAK7B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,MAAM,MAAM,UAAU,GAAG;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC,WAAW,GAAG,kBAAkB,CAAC,CAAC;IAC7D,eAAe,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1C,CAAA;AAKD,wBAAsB,aAAa,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAChG,OAAO,CAAC,UAAU,CAAC,CAAA;AACrB,wBAAsB,aAAa,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,GACjG,OAAO,CAAC,UAAU,CAAC,CAAA;AAoErB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,uBAGlF"}
+{"version":3,"file":"getEnvSchemas.d.ts","sourceRoot":"","sources":["../../src/env/getEnvSchemas.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAEpE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAK7B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,MAAM,MAAM,UAAU,GAAG;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC,WAAW,GAAG,kBAAkB,CAAC,CAAC;IAC7D,eAAe,CAAC,EAAE,OAAO,CAAC,WAAW,GAAG,iBAAiB,CAAC,CAAC;CAC9D,CAAA;AAKD,wBAAsB,aAAa,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAChG,OAAO,CAAC,UAAU,CAAC,CAAA;AACrB,wBAAsB,aAAa,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,GACjG,OAAO,CAAC,UAAU,CAAC,CAAA;AAoErB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,uBAGlF"}

package/dist/env/publicEnv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publicEnv.d.ts","sourceRoot":"","sources":["../../src/env/publicEnv.ts"],"names":[],"mappings":"AAGA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,iBAAiB,GAAG,OAAO,CAG/D"}
+{"version":3,"file":"publicEnv.d.ts","sourceRoot":"","sources":["../../src/env/publicEnv.ts"],"names":[],"mappings":"AAGA,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,iBAAiB,GAAG,OAAO,CAK/D"}

package/dist/env/publicEnv.js

@@ -1,5 +1,8 @@
 import { throwError } from "../throwError.js";
 export function publicEnv(key) {
-  if (tungstenPublicEnv === undefined) throwError('publicEnv', 'Tungsten Public Env is undefined - do you have a .env.public file?');
+  if (tungstenPublicEnv === undefined) {
+    // eslint-disable-line @typescript-eslint/no-unnecessary-condition
+    throwError('publicEnv', 'Tungsten Public Env is undefined - do you have a .env.public file?');
+  }
   return tungstenPublicEnv[key];
 }

package/dist/frameworkConfigSchema.d.ts

@@ -42,6 +42,7 @@ declare const frameworkConfigWithRootComponentValidator: import("arktype/interna
     serverMiddleware?: [string, string, string];
     apiRoutes?: string;
     apiPath?: string;
+    csr?: boolean;
     rootComponent: string;
     useRootComponent?: true;
 }, {}>;
@@ -87,6 +88,7 @@ declare const frameworkConfigWithoutRootComponentValidator: import("arktype/inte
     serverMiddleware?: [string, string, string];
     apiRoutes?: string;
     apiPath?: string;
+    csr?: boolean;
     useRootComponent: false;
 }, {}>;
 export declare const frameworkConfigValidator: import("arktype/internal/variants/object.ts").ObjectType<{
@@ -131,6 +133,7 @@ export declare const frameworkConfigValidator: import("arktype/internal/variants
     serverMiddleware?: [string, string, string];
     apiRoutes?: string;
     apiPath?: string;
+    csr?: boolean;
     rootComponent: string;
     useRootComponent?: true;
 } | {
@@ -175,6 +178,7 @@ export declare const frameworkConfigValidator: import("arktype/internal/variants
     serverMiddleware?: [string, string, string];
     apiRoutes?: string;
     apiPath?: string;
+    csr?: boolean;
     useRootComponent: false;
 }, {}>;
 type ArkFrameworkConfigWithRootComponent = typeof frameworkConfigWithRootComponentValidator.infer;

package/dist/frameworkConfigSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frameworkConfigSchema.d.ts","sourceRoot":"","sources":["../src/frameworkConfigSchema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAyDnD,QAAA,MAAM,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAK7C,CAAA;AAEF,QAAA,MAAM,4CAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAIhD,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAEoB,CAAA;AAEzD,KAAK,mCAAmC,GAAG,OAAO,yCAAyC,CAAC,KAAK,CAAA;AACjG,KAAK,sCAAsC,GAAG,OAAO,4CAA4C,CAAC,KAAK,CAAA;AAIvG,UAAU,gCACN,SAAQ,IAAI,CAAC,mCAAmC,EAAE,cAAc,GAAG,cAAc,CAAC;IAClF,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,YAAY,CAAC,EAAE,kBAAkB,CAAA;CACpC;AAED,UAAU,mCACN,SAAQ,IAAI,CAAC,sCAAsC,EAAE,cAAc,GAAG,cAAc,CAAC;IACrF,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,YAAY,CAAC,EAAE,kBAAkB,CAAA;CACpC;AAED,MAAM,MAAM,eAAe,GAAG,gCAAgC,GAAG,mCAAmC,CAAA"}
+{"version":3,"file":"frameworkConfigSchema.d.ts","sourceRoot":"","sources":["../src/frameworkConfigSchema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AA0DnD,QAAA,MAAM,yCAAyC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAK7C,CAAA;AAEF,QAAA,MAAM,4CAA4C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAIhD,CAAA;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAEoB,CAAA;AAEzD,KAAK,mCAAmC,GAAG,OAAO,yCAAyC,CAAC,KAAK,CAAA;AACjG,KAAK,sCAAsC,GAAG,OAAO,4CAA4C,CAAC,KAAK,CAAA;AAIvG,UAAU,gCACN,SAAQ,IAAI,CAAC,mCAAmC,EAAE,cAAc,GAAG,cAAc,CAAC;IAClF,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,YAAY,CAAC,EAAE,kBAAkB,CAAA;CACpC;AAED,UAAU,mCACN,SAAQ,IAAI,CAAC,sCAAsC,EAAE,cAAc,GAAG,cAAc,CAAC;IACrF,YAAY,CAAC,EAAE,YAAY,CAAA;IAC3B,YAAY,CAAC,EAAE,kBAAkB,CAAA;CACpC;AAED,MAAM,MAAM,eAAe,GAAG,gCAAgC,GAAG,mCAAmC,CAAA"}

package/dist/frameworkConfigSchema.js

@@ -50,7 +50,8 @@ const frameworkConfigBaseValidator = arkType({
   'skipPackageCompilation?': 'string | string[]',
   'serverMiddleware?': ['string', 'string', 'string'],
   'apiRoutes?': 'string',
-  'apiPath?': 'string'
+  'apiPath?': 'string',
+  'csr?': 'boolean'
 });
 const frameworkConfigWithRootComponentValidator = arkType({
   '...': frameworkConfigBaseValidator,

package/dist/hooks/index.d.ts

@@ -1,4 +1,5 @@
 export * from './useCallback.js';
+export * from './useInstance.js';
 export * from './useMemo.js';
 export * from './useRef.js';
 export * from './useState.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}

package/dist/hooks/index.js

@@ -1,4 +1,5 @@
 export * from "./useCallback.js";
+export * from "./useInstance.js";
 export * from "./useMemo.js";
 export * from "./useRef.js";
 export * from "./useState.js";

package/dist/hooks/useInstance.d.ts

@@ -0,0 +1,3 @@
+import type { Instance } from '../Instance/Instance.js';
+export declare function useInstance(): Instance;
+//# sourceMappingURL=useInstance.d.ts.map

package/dist/hooks/useInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useInstance.d.ts","sourceRoot":"","sources":["../../src/hooks/useInstance.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAEvD,wBAAgB,WAAW,IAAI,QAAQ,CAEtC"}

package/dist/hooks/useInstance.js

@@ -0,0 +1,4 @@
+import { getCurrentComponent } from "./getCurrentComponent.js";
+export function useInstance() {
+  return getCurrentComponent().__instance;
+}

package/dist/hydrate/hydrate.d.ts

@@ -1,13 +1,15 @@
 import type { InstanceConfig } from '../Instance/InstanceConfig.js';
 import type { AppRoutes } from '../routing/AppRoutes.js';
 import { DomPointer } from '../DomPointer.js';
-import { TungstenBaseComponentType, TungstenBaseComponent } from '../Components.jsx';
+import { TungstenBaseComponentType } from '../Components.jsx';
 import { Instance } from '../Instance/Instance.js';
+import { type TaggedAttributeMismatch } from './renderHydrationMismatchBanner.js';
 import '../hmr/applyHmrModule.js';
-type HydrateMeta = {
+export type HydrateMeta = {
     insideForm: boolean;
+    mismatches: TaggedAttributeMismatch[];
 };
 export declare function hydrate(appRoutes: AppRoutes, RootComponent: TungstenBaseComponentType | null, instanceConfig: InstanceConfig): Promise<void>;
-export declare function hydrateRootComponent(instance: Instance, RootComponent: TungstenBaseComponentType, domPointer: DomPointer, meta: HydrateMeta): Promise<TungstenBaseComponent<object, undefined>>;
-export {};
+export declare function hydrateRootComponent<ComponentType extends TungstenBaseComponentType<any, any>>(instance: Instance, RootComponent: ComponentType, domPointer: DomPointer, meta: HydrateMeta, props?: InstanceType<ComponentType>['props'], // eslint-disable-line no-type-assertion/no-type-assertion -- default only reached when Props is empty, same as the hardcoded {} this replaces
+routeParams?: Record<string, string>, routeData?: unknown): Promise<InstanceType<ComponentType>>;
 //# sourceMappingURL=hydrate.d.ts.map

package/dist/hydrate/hydrate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hydrate.d.ts","sourceRoot":"","sources":["../../src/hydrate/hydrate.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAQnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAoBxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAM7C,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAA6B,MAAM,mBAAmB,CAAA;AAE/G,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AA0BlD,OAAO,0BAA0B,CAAA;AASjC,KAAK,WAAW,GAAG;IACf,UAAU,EAAE,OAAO,CAAA;CACtB,CAAA;AAKD,wBAAsB,OAAO,CACzB,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,yBAAyB,GAAG,IAAI,EAC/C,cAAc,EAAE,cAAc,iBA0DjC;AAyBD,wBAAsB,oBAAoB,CACtC,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,yBAAyB,EACxC,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,WAAW,qDA4DpB"}
+{"version":3,"file":"hydrate.d.ts","sourceRoot":"","sources":["../../src/hydrate/hydrate.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAQnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAoBxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAM7C,OAAO,EAAE,yBAAyB,EAAoD,MAAM,mBAAmB,CAAA;AAE/G,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAmBlD,OAAO,EAC4B,KAAK,uBAAuB,EAC9D,MAAM,oCAAoC,CAAA;AAQ3C,OAAO,0BAA0B,CAAA;AASjC,MAAM,MAAM,WAAW,GAAG;IACtB,UAAU,EAAE,OAAO,CAAA;IACnB,UAAU,EAAE,uBAAuB,EAAE,CAAA;CACxC,CAAA;AAKD,wBAAsB,OAAO,CACzB,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,yBAAyB,GAAG,IAAI,EAC/C,cAAc,EAAE,cAAc,iBA2DjC;AAyBD,wBAAsB,oBAAoB,CACtC,aAAa,SAAS,yBAAyB,CAAC,GAAG,EAAE,GAAG,CAAC,EAEzD,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,WAAW,EAIjB,KAAK,GAAE,YAAY,CAAC,aAAa,CAAC,CAAC,OAAO,CAA8C,EAAE,8IAA8I;AACxO,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,SAAS,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CA6DtC"}

package/dist/hydrate/hydrate.js

@@ -1,4 +1,4 @@
-import { integrateElementUpdateVdom } from "../update/integrateUpdateVdom.js";
+import { applyUpdate, integrateElementUpdateVdom } from "../update/integrateUpdateVdom.js";
 //import type { RouteType } from '../routing/RouteType.js'
 import { $number, $string, makeRenderedContentNodeNonRendered, makeRenderedContentNodeClassComponent, makeRenderedContentNodeFunctionComponent } from "../RenderedContentNode.js";
 import { ContentNodeElementIsHtml, ContentNodeIsHtml, ContentNodeIsComponent, ContentNodeComponentIsClassComponent, ContentNodeIsElement } from "../ContentNode.js";
@@ -29,6 +29,7 @@ import { MatchedRoute } from "../routing/MatchedRoute.js";
 import { isDev } from "../isDev.js";
 import { warn } from "../appOutput.js";
 import { reconcileHydratedAttributes } from "./reconcileHydratedAttributes.js";
+import { renderHydrationMismatchBanner } from "./renderHydrationMismatchBanner.js";
 import { setCurrentInstance } from "../hmr/instanceRegistry.js";
 // side-effect only: pulls applyHmrModule.js (and its clean, non-dynamic-import dependencies)
 // into the framework's traced dependency graph so it gets copied to .packages/ and is servable
@@ -39,12 +40,13 @@ import { setCurrentInstance } from "../hmr/instanceRegistry.js";
 import "../hmr/applyHmrModule.js";
 import { jsx as _jsx } from "tungsten/jsxRuntime.js";
 function debug(...texts) {
-  console.log(...texts);
+  //console.log(...texts)
   //console.log(getStackTrace().split('\n')[2])
 }
 function makeDefaultHydrateMeta() {
   return {
-    insideForm: false
+    insideForm: false,
+    mismatches: []
   };
 } // can we opto this out in production?
 export async function hydrate(appRoutes, RootComponent, instanceConfig) {
@@ -89,6 +91,7 @@ export async function hydrate(appRoutes, RootComponent, instanceConfig) {
     // hydrateNode(content, null, domPointer, instance, meta)
   }
   instance.hydrationComplete = true;
+  if (isDev) renderHydrationMismatchBanner(meta.mismatches);
   //// Can components update while hydrating is still taking place
   //// -- probably yes
   //// Can we pause any further update until hydration completes, to retain coherency?
@@ -114,12 +117,20 @@ routes) {
     };
   }
 }
-export async function hydrateRootComponent(instance, RootComponent, domPointer, meta) {
+export async function hydrateRootComponent(instance, RootComponent, domPointer, meta,
+// Real app hydration (hydrate(), above) always hydrates a root with no props of its own -
+// route data comes through the store instead - so the default reproduces that. A test
+// harness hydrating an arbitrary component (see testing/hydrateTestApp.ts) passes its own.
+props = {},
+// eslint-disable-line no-type-assertion/no-type-assertion -- default only reached when Props is empty, same as the hardcoded {} this replaces
+routeParams, routeData) {
   debug('hydrateRootComponent');
+  // matches createTungstenRootComponent's identical cast, the create-path equivalent of this function
+  // eslint-disable-next-line no-type-assertion/no-type-assertion
   const element = new RootComponent({
-    props: {},
-    routeParams: undefined,
-    routeData: undefined,
+    props,
+    routeParams,
+    routeData,
     instance,
     parentElement: null
   });
@@ -489,7 +500,7 @@ async function hydrateNodeSingle(node, parentElement, domPointer, instance, meta
     //     node[$props].ref.current = domNode
     // }
     debug('hydarating atts');
-    hydrateAttributes(node, domNode);
+    hydrateAttributes(node, domNode, meta);
     //!!! node.domElement = domNode
     const props = node[$props];
     if (node[$type] === 'textarea') {
@@ -525,7 +536,22 @@ async function hydrateNodeSingle(node, parentElement, domPointer, instance, meta
     debug('valid children', validChildren(node[$props].children), node[$props].children);
     const children = node[$props].children;
     let renderedChildren = $contentNull;
-    if (node[$props].__opaque !== true && validChildren(children)) {
+    if (node[$type] === 'body' && instance.config.csr) {
+      // CSR: body shipped empty on purpose, nothing to hydrate against - create fresh.
+      if (parentElement === null) {
+        throwError('hydrateNodeSingle', 'CSR hydration reached <body> with no owning component');
+      }
+      const childDomPointer = new DomPointer(domNode);
+      renderedChildren = await applyUpdate({
+        tungstenElement: parentElement,
+        instance,
+        newNode: children,
+        oldNode: $contentNull,
+        domRegion: null,
+        domPointer: childDomPointer,
+        parentNode: null
+      });
+    } else if (node[$props].__opaque !== true && validChildren(children)) {
       debug('node.props.children', children);
       const childDomPointer = new DomPointer(domNode);
       renderedChildren = await hydrateNode(children, parentElement, childDomPointer, instance, meta);
@@ -570,17 +596,27 @@ async function hydrateNodeComponent(node, parentElement, domPointer, instance, m
 }
 // export type HTMLBindableElement = HTMLButtonElement | HTMLDataElement | HTMLInputElement | HTMLLIElement
 // | HTMLMeterElement | HTMLOptionElement | HTMLParamElement | HTMLProgressElement | HTMLSelectElement | HTMLTextAreaElement
-function hydrateAttributes(node, domNode) {
+function hydrateAttributes(node, domNode, meta) {
   // handle bind attributes and merge together event handlers
   processAttributes(node);
   // Bring the server's attributes into line with what this render produced.
   // Runs in production as well as development: leaving a known-wrong value in
   // place is not better in production, it is only quieter. Only genuine
   // differences are written, so a page that matches costs reads and no
-  // writes. The report is dev-only, because a mismatch is a bug in the
-  // application's rendering rather than something a user can act on.
+  // writes. Collection always runs (it is what a hydration-test harness reads
+  // to assert on - see testing/hydrateTestApp.ts); only the console report and
+  // the on-page banner (hydrate(), below) are dev-only, because a mismatch is
+  // a bug in the application's rendering rather than something a user can act on.
   if (ContentNodeElementIsHtml(node)) {
-    reconcileHydratedAttributes(node, domNode, isDev ? mismatch => warn(`hydration mismatch on <${node[$type]}>:` + ` ${mismatch.name} rendered as ${JSON.stringify(mismatch.expected)}` + ` but the server sent ${JSON.stringify(mismatch.actual)}.` + ` The rendered value has been applied.`) : undefined);
+    reconcileHydratedAttributes(node, domNode, mismatch => {
+      meta.mismatches.push({
+        tagName: node[$type],
+        ...mismatch
+      });
+      if (isDev) {
+        warn(`hydration mismatch on <${node[$type]}>:` + ` ${mismatch.name} rendered as ${JSON.stringify(mismatch.expected)}` + ` but the server sent ${JSON.stringify(mismatch.actual)}.` + ` The rendered value has been applied.`);
+      }
+    });
   }
   debug('--\nhydrateAttributes', domNode);
   for (const key in node[$props]) {
@@ -698,6 +734,8 @@ function hydrateAttributes(node, domNode) {
 function processAttributes(node) {
   const props = node[$props];
   debug('--\nprocessAttributes', node);
+  // set a button without specified type to button, so buttons don't submit forms unless instructed to
+  if (node[$type] === 'button' && !('type' in props)) props.type = 'button';
   for (const key in node[$props]) {
     if (key === 'bind' && ContentNodeElementIsHtml(node)) {
       const eventName = 'onInput';

package/dist/hydrate/reconcileHydratedAttributes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reconcileHydratedAttributes.d.ts","sourceRoot":"","sources":["../../src/hydrate/reconcileHydratedAttributes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAIxD,MAAM,MAAM,iBAAiB,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,gFAAgF;IAChF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,CAAA;AA6BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACvC,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,WAAW,EACpB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,GACnD,IAAI,CAuCN"}
+{"version":3,"file":"reconcileHydratedAttributes.d.ts","sourceRoot":"","sources":["../../src/hydrate/reconcileHydratedAttributes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAKxD,MAAM,MAAM,iBAAiB,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,gFAAgF;IAChF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,2EAA2E;IAC3E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACxB,CAAA;AA6BD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,2BAA2B,CACvC,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,WAAW,EACpB,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,iBAAiB,KAAK,IAAI,GACnD,IAAI,CAuCN"}

package/dist/hydrate/reconcileHydratedAttributes.js

@@ -1,5 +1,6 @@
 import { $props } from "../contentNodeSymbols.js";
 import { processProps } from "../render/processProps.js";
+import { booleanAttributeValue } from "../booleanAttributeValue.js";
 /**
  * The attribute value a render produces for a prop, or null for "no attribute".
  *
@@ -7,8 +8,8 @@ import { processProps } from "../render/processProps.js";
  * the server and `addAttributes()` on the client — so that a value which
  * round-trips unchanged compares equal here.
  */
-function attributeValue(value) {
-  if (typeof value === 'boolean') return value ? '' : null;
+function attributeValue(name, value) {
+  if (typeof value === 'boolean') return booleanAttributeValue(name, value);
   if (value === undefined || value === null) return null;
   return String(value);
 }
@@ -55,7 +56,7 @@ export function reconcileHydratedAttributes(node, domNode, onMismatch) {
   const handled = new Set();
   for (const name in expected) {
     handled.add(name.toLowerCase());
-    const value = attributeValue(expected[name]);
+    const value = attributeValue(name, expected[name]);
     const actual = domNode.getAttribute(name);
     if (value === actual) continue;
     if (value === null) removeAttribute(domNode, name);else setAttribute(domNode, name, value);

package/dist/hydrate/renderHydrationMismatchBanner.d.ts

@@ -0,0 +1,7 @@
+import type { AttributeMismatch } from './reconcileHydratedAttributes.js';
+export type TaggedAttributeMismatch = AttributeMismatch & {
+    tagName: string;
+};
+export declare const hydrationMismatchAttribute = "data-tungsten-hydration-mismatches";
+export declare function renderHydrationMismatchBanner(mismatches: readonly TaggedAttributeMismatch[], doc?: Document): void;
+//# sourceMappingURL=renderHydrationMismatchBanner.d.ts.map

package/dist/hydrate/renderHydrationMismatchBanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderHydrationMismatchBanner.d.ts","sourceRoot":"","sources":["../../src/hydrate/renderHydrationMismatchBanner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AAEzE,MAAM,MAAM,uBAAuB,GAAG,iBAAiB,GAAG;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAI7E,eAAO,MAAM,0BAA0B,uCAAuC,CAAA;AA2C9E,wBAAgB,6BAA6B,CACzC,UAAU,EAAE,SAAS,uBAAuB,EAAE,EAC9C,GAAG,GAAE,QAAmB,GACzB,IAAI,CA4BN"}

package/dist/hydrate/renderHydrationMismatchBanner.js

@@ -0,0 +1,69 @@
+// Read by the CSS rule below via attr() - not by Tungsten. Exported so an
+// application that wants different styling can target the same selector.
+export const hydrationMismatchAttribute = 'data-tungsten-hydration-mismatches';
+const styleId = 'tungsten-hydration-mismatches-style';
+// Reports hydration mismatches in the page, not only the console, without
+// adding a real DOM node to the hydrated tree.
+//
+// A real element - even one appended after hydration finishes and never
+// touched again by this code - is not actually safe here. Every container
+// Tungsten re-renders gets a fresh `new DomRegion(containerDomNode)` built
+// from whatever is *actually* in its childNodes at that moment, and every
+// position Tungsten writes to next is a raw index into that same list
+// (DomPointer.get/next/prev, and several inline `childNodes[domPointer.index]`
+// reads in integrateUpdateVdom.ts/hydrate.tsx). An extra, untracked child
+// shifts every index after it, so the next update touching that container
+// - body, in a typical app - would compare and write to the wrong nodes.
+// There is no flag on an element that makes the walker skip it; it would
+// have to be built into DomPointer/DomRegion and every direct childNodes
+// access alongside them, which is a core-framework change, not a banner.
+//
+// Attributes are a different story: reconcileHydratedAttributes only runs
+// once, during hydration, before this ever runs, and every later update
+// (updateAttributes) diffs against domNode.__tungsten_oldAttributes - its
+// own private record of what it last set - never the DOM's live attribute
+// list. A plain setAttribute() here is in neither its old props nor its new
+// props, so it is never visited, and never removed.
+//
+// So: set an attribute on <html> (outside Tungsten's own bookkeeping, so
+// permanently untouched by it) and let a `content: attr(...)` pseudo-element
+// display it. A pseudo-element is not a real node - never in .childNodes,
+// never visited by DomPointer or DomRegion - so this carries zero index risk
+// for the app's own reconciliation, at the cost of one small, deliberately
+// hacky wrinkle: a single <style> tag inserted into <head> once.
+//
+// head is not structurally exempt from diffing in general - it currently
+// just never gets diffed node-by-node during hydration (hydrateNodeSingle's
+// 'head' case skips it outright, a known hack, not a guarantee), and nothing
+// in a typical app changes head's vdom children after mount, so the general
+// update path never exercises it either. That could change. What head does
+// already have is a marker for exactly this situation - data--t-persist,
+// used by processHead.ts for framework-injected head content (the entry
+// script, the component CSS link) that isn't part of the app's own vdom and
+// must survive hydration - so this style tag carries it too, rather than
+// riding on the blanket skip alone.
+export function renderHydrationMismatchBanner(mismatches, doc = document) {
+  if (mismatches.length === 0) return;
+  if (doc.getElementById(styleId) === null) {
+    const style = doc.createElement('style');
+    style.id = styleId;
+    style.setAttribute('data--t-persist', 'true');
+    style.textContent = `
+            html[${hydrationMismatchAttribute}]::before {
+                content: attr(${hydrationMismatchAttribute});
+                display: block;
+                background: #7a1f1f;
+                color: #fff;
+                font: 13px/1.5 monospace;
+                padding: 8px 12px;
+                max-height: 33vh;
+                overflow: auto;
+                white-space: pre-wrap;
+            }
+        `;
+    doc.head.appendChild(style);
+  }
+  const heading = `Tungsten: ${mismatches.length} hydration mismatch${mismatches.length === 1 ? '' : 'es'} (dev only)`;
+  const lines = mismatches.map(mismatch => `<${mismatch.tagName}> ${mismatch.name}: ` + `rendered ${JSON.stringify(mismatch.expected)}, server sent ${JSON.stringify(mismatch.actual)}`);
+  doc.documentElement.setAttribute(hydrationMismatchAttribute, [heading, ...lines].join('\n'));
+}

package/dist/indexInner.d.ts

@@ -16,13 +16,18 @@ export * from './components/bindable/BindableTextarea.jsx';
 export * from './components/GoToComponent.jsx';
 export * from './components/Lazy.js';
 export * from './components/Link.jsx';
+export * from './components/PopMessages.jsx';
 export * from './components/RawHtml.jsx';
 export * from './components/RouteRedirectComponent.jsx';
 export { parseHtml, type ParseHtmlOptions } from './rawHtml/parseHtml.js';
 export { safeHtmlAllowList } from './rawHtml/safeHtmlAllowList.js';
 export type { HtmlAllowList } from './rawHtml/HtmlAllowList.js';
+export { sanitizeHtml, type SanitizeHtmlOptions } from './rawHtml/sanitizeHtml.js';
+export { filterContentNode } from './rawHtml/filterContentNode.js';
+export { contentNodeToHtml } from './render/contentNodeToHtml.js';
 export * from './components/WebRedirectComponent.jsx';
 export * from './nbsp.js';
+export { pop, dismissPop } from './pop.js';
 export * from './browserStorage.js';
 export { createElement } from './createElement.js';
 export * from './createRef.js';
@@ -64,12 +69,15 @@ export * from './ContentNode.js';
 export type { GenericObject } from './GenericObject.type.js';
 export type { Instance } from './Instance/Instance.js';
 export type { Key } from './Key.js';
+export type { PopMessage } from './PopMessage.type.js';
 export type { ReqRes, ReqResOrNull } from './ReqRes.js';
 export type { Params } from './routing/Params.js';
 export type { ParamsFromPath } from './routing/ParamsFromPath.js';
 export type { RouteType, Route } from './routing/RouteType.js';
 export { type RouteKey, type Path, type Path as RoutePath, StringIsPath, RouteKeyIsPath } from './routing/RouteTypes.js';
 export type { Routes, CustomRoutes } from './routing/Routes.js';
+export type { ErrorRouteType } from './routing/ErrorRouteType.js';
+export { type TungstenErrorInfo, makeTungstenErrorInfo } from './routing/TungstenErrorInfo.js';
 export type { RouteParams } from './routing/RouteParams.type.js';
 export type { RouteData } from './routing/RouteData.js';
 export type { RouteDataFunction } from './routing/RouteDataFunction.type.js';

package/dist/indexInner.d.ts.map

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

package/dist/indexInner.js

@@ -21,12 +21,17 @@ export * from "./components/bindable/BindableTextarea.js";
 export * from "./components/GoToComponent.js";
 export * from "./components/Lazy.js";
 export * from "./components/Link.js";
+export * from "./components/PopMessages.js";
 export * from "./components/RawHtml.js";
 export * from "./components/RouteRedirectComponent.js";
 export { parseHtml } from "./rawHtml/parseHtml.js";
 export { safeHtmlAllowList } from "./rawHtml/safeHtmlAllowList.js";
+export { sanitizeHtml } from "./rawHtml/sanitizeHtml.js";
+export { filterContentNode } from "./rawHtml/filterContentNode.js";
+export { contentNodeToHtml } from "./render/contentNodeToHtml.js";
 export * from "./components/WebRedirectComponent.js";
 export * from "./nbsp.js";
+export { pop, dismissPop } from "./pop.js";
 export * from "./browserStorage.js";
 export { createElement } from "./createElement.js";
 export * from "./createRef.js";
@@ -66,4 +71,5 @@ export * from "./components/Stylesheet.js";
 export { TungstenError } from "./TungstenError.js";
 export * from "./__deproxy.js";
 export * from "./ContentNode.js"; // types and type guards
-export { StringIsPath, RouteKeyIsPath } from "./routing/RouteTypes.js";
+export { StringIsPath, RouteKeyIsPath } from "./routing/RouteTypes.js";
+export { makeTungstenErrorInfo } from "./routing/TungstenErrorInfo.js";

package/dist/makeInstanceConfigFromFrameworkConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"makeInstanceConfigFromFrameworkConfig.d.ts","sourceRoot":"","sources":["../src/makeInstanceConfigFromFrameworkConfig.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAEnE,wBAAgB,qCAAqC,CACjD,eAAe,EAAE,uBAAuB,EAAE,GAAG,GAAE,OAAe,GAC/D,cAAc,CAUhB"}
+{"version":3,"file":"makeInstanceConfigFromFrameworkConfig.d.ts","sourceRoot":"","sources":["../src/makeInstanceConfigFromFrameworkConfig.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAEnE,wBAAgB,qCAAqC,CACjD,eAAe,EAAE,uBAAuB,EAAE,GAAG,GAAE,OAAe,GAC/D,cAAc,CAWhB"}

package/dist/makeInstanceConfigFromFrameworkConfig.js

@@ -5,7 +5,8 @@ export function makeInstanceConfigFromFrameworkConfig(frameworkConfig, dev = fal
     useRootComponent: frameworkConfig.useRootComponent,
     clientSideNav: frameworkConfig.clientSideNav,
     siteBasePath: dev ? '' : frameworkConfig.siteBasePath,
-    staticSite: frameworkConfig.staticSite
+    staticSite: frameworkConfig.staticSite,
+    csr: frameworkConfig.csr
   };
   if ('sourceDir' in frameworkConfig) c.sourceDir = frameworkConfig.sourceDir;
   return c;

package/dist/pop.d.ts

@@ -0,0 +1,10 @@
+import type { Instance } from './Instance/Instance.js';
+export declare function registerPopInstance(newInstance: Instance): void;
+export declare function dismissPop(id: number): void;
+export declare function pop(text: string): void;
+type PopFunction = typeof pop;
+declare global {
+    var pop: PopFunction;
+}
+export {};
+//# sourceMappingURL=pop.d.ts.map

package/dist/pop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pop.d.ts","sourceRoot":"","sources":["../src/pop.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAStD,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,QAAQ,GAAG,IAAI,CAE/D;AAQD,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAO3C;AAID,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAatC;AAMD,KAAK,WAAW,GAAG,OAAO,GAAG,CAAA;AAE7B,OAAO,CAAC,MAAM,CAAC;IAEX,IAAI,GAAG,EAAE,WAAW,CAAA;CACvB"}

package/dist/pop.js

@@ -0,0 +1,49 @@
+import { isServer } from "./isServer.js";
+import { log, warn } from "./appOutput.js";
+// Set once by PopMessages.clientInit, from this.__instance - one Instance per app, shared
+// across the whole client lifetime, so no per-component proxy/subscription is needed here.
+let instance = null;
+export function registerPopInstance(newInstance) {
+  instance = newInstance;
+}
+let nextId = 0;
+const AUTO_DISMISS_MS = 3000;
+const LEAVE_MS = 200; // match .pop-message.leaving's transition duration in PopMessages.tsx
+// Shared by pop()'s auto-dismiss and PopMessages' click-to-dismiss, so both leave the same way.
+export function dismissPop(id) {
+  if (instance === null) return;
+  const {
+    popMessages
+  } = instance.internalStore;
+  popMessages.set(popMessages.get().map(message => message.id === id ? {
+    ...message,
+    leaving: true
+  } : message));
+  setTimeout(() => {
+    popMessages.set(popMessages.get().filter(message => message.id !== id));
+  }, LEAVE_MS);
+}
+// Shows a dismissible banner via <PopMessages/> (an app mounts one in its Root). Also available
+// as global.pop / window.pop for ad-hoc use outside component code, on server and client alike.
+export function pop(text) {
+  if (isServer) {
+    log('pop: ' + text);
+    return;
+  }
+  if (instance === null) {
+    warn('pop() called before the app finished mounting; message dropped:', text);
+    return;
+  }
+  const message = {
+    id: nextId++,
+    text
+  };
+  const {
+    popMessages
+  } = instance.internalStore;
+  popMessages.set([...popMessages.get(), message]);
+  setTimeout(() => dismissPop(message.id), AUTO_DISMISS_MS);
+}
+// Assigned at module load in both environments, so a pre-mount browser call hits pop()'s
+// no-bridge branch instead of throwing.
+globalThis.pop = pop;

package/dist/rawHtml/filterContentNode.d.ts

@@ -0,0 +1,20 @@
+import type { ContentNode } from '../ContentNode.js';
+import type { HtmlAllowList } from './HtmlAllowList.js';
+/**
+ * Applies an allow list to a content tree that already exists, rather than
+ * one being built - the same decisions `parseHtml(html, { allowList })` makes
+ * while parsing, for a tree that did not come from parsing HTML at all (one
+ * rebuilt from storage, for instance) and so never had the chance to.
+ *
+ * A disallowed element is unwrapped, keeping its children in its place, so
+ * filtering a tag never costs the reader the words inside it - the same rule
+ * `parseHtml` applies. An element holding program text rather than prose
+ * (`<script>`, and anything on the same footing as `<script>` even under a
+ * permissive allow list) is dropped whole instead. `on*` props, `ref`, and
+ * `dangerouslySetInnerHTML` are always stripped - the tree-shape equivalent
+ * of what `parseHtml` refuses to produce in the first place - and a `href`/
+ * `src`/... value using an executable scheme (`javascript:`, `vbscript:`) or,
+ * on a navigating attribute, `data:` is dropped the same way.
+ */
+export declare function filterContentNode(node: ContentNode, allowList: HtmlAllowList): ContentNode;
+//# sourceMappingURL=filterContentNode.d.ts.map

package/dist/rawHtml/filterContentNode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filterContentNode.d.ts","sourceRoot":"","sources":["../../src/rawHtml/filterContentNode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,mBAAmB,CAAA;AAI/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAyFvD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,GAAG,WAAW,CAE1F"}