tungsten 0.3.2 → 0.3.3

package/dist/Servers/hono/TungstenServerHono.js

@@ -1,51 +1,34 @@
-//import type { Response as ExpressResponse } from 'express'
-import { Hono } from 'hono';
 import { ContentNodeIsClassComponent } from "../../ContentNode.js";
 import { RoutingRedirect } from "../../routing/RoutingRedirect.js";
 import { cliTodo } from "../../cliOutput.js";
 import { RouteRedirectComponent } from "../../components/RouteRedirectComponent.js";
+import { WebRedirectComponent } from "../../components/WebRedirectComponent.js";
 import { $props, $type } from "../../contentNodeSymbols.js";
 import { WebRedirect } from "../../routing/WebRedirect.js";
-import { throwError } from "../../throwError.js";
-const app = new Hono();
-app.get(async c => {
-  const id = c.req.param('id');
-  c.res;
-  // ...
-});
-function debug(...texts) {
-  // console.log(...texts)
-}
 export class TungstenServerHono {
+  // Hono's c.redirect() builds a Response but doesn't send it - unlike Express's res.redirect()
+  // (which sends immediately), the caller here must return the Response itself for Hono to
+  // actually deliver it. Returns false when there's no redirect to make.
   handleRedirects(c /* any */, matchedRouteInfo) {
     // handle any redirect issued during routing
     if (matchedRouteInfo.data instanceof RoutingRedirect) {
       const redirect = matchedRouteInfo.data;
-      c.redirect(redirect.to, redirect.code);
-      return true;
+      return c.redirect(redirect.to, redirect.code);
     } else if (matchedRouteInfo.data instanceof WebRedirect) {
       const redirect = matchedRouteInfo.data;
-      c.redirect(redirect.to, redirect.code);
-      return true;
+      return c.redirect(redirect.to, redirect.code);
     }
-    // console.log('content', matchedRouteInfo.content)
-    // console.log('is func', typeof matchedRouteInfo.content !== 'function')
-    // console.log('ContentNodeIsClassComponent', ContentNodeIsClassComponent(matchedRouteInfo.content as any))
-    // console.log('instanceof', (matchedRouteInfo as any).content[$type] instanceof RedirectComponent)
-    // console.log('prototype instanceof', (matchedRouteInfo as any).content[$type].prototype instanceof RedirectComponent)
-    // console.log('__tungstenRedirect', (matchedRouteInfo as any).content[$type].__tungstenRedirect)
-    // console.log('$type', (matchedRouteInfo as any).content[$type])
-    //console.log('content[$type]', matchedRouteInfo.content[$type])
-    //console.log('instanceof', matchedRouteInfo.content instanceof RedirectComponent)
     if (typeof matchedRouteInfo.content !== 'function' && ContentNodeIsClassComponent(matchedRouteInfo.content)) {
       if (matchedRouteInfo.content[$type] === RouteRedirectComponent || matchedRouteInfo.content[$type].prototype instanceof RouteRedirectComponent) {
         cliTodo('consider type of RedirectComponent props');
         const code = matchedRouteInfo.content[$props].code || 302;
         const to = matchedRouteInfo.content[$props].to;
-        c.redirect(to, code);
-        return true;
-      } else {
-        throwError('TungstenServerHono', 'Need to check for WebRedirectComponent here');
+        return c.redirect(to, code);
+      } else if (matchedRouteInfo.content[$type] === WebRedirectComponent || matchedRouteInfo.content[$type].prototype instanceof WebRedirectComponent) {
+        cliTodo('consider type of RedirectComponent props');
+        const code = matchedRouteInfo.content[$props].code || 302;
+        const to = matchedRouteInfo.content[$props].to;
+        return c.redirect(to, code);
       }
     }
     return false;

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

@@ -1 +1 @@
-{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/Servers/routing.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAGlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAGjE,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAE,iBAAiB,GAAG,IAAW,GAC5G,OAAO,CAAC,gBAAgB,CAAC,CA0D9B"}
+{"version":3,"file":"routing.d.ts","sourceRoot":"","sources":["../../src/Servers/routing.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE7D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAA;AAGlD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AAIjE,wBAAsB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAE,iBAAiB,GAAG,IAAW,GAC5G,OAAO,CAAC,gBAAgB,CAAC,CA+D9B"}

package/dist/Servers/routing.js

@@ -1,5 +1,6 @@
 import { Default404 } from "../routing/Default404.js";
 import { matchPath } from "../routing/matchPath.js";
+import { makeTungstenErrorInfo } from "../routing/TungstenErrorInfo.js";
 import { jsx as _jsx } from "tungsten/jsxRuntime.js";
 export async function routing(location, routes, serverDataLoading = null) {
   let defaultRoute, _404Route, errorRoute;
@@ -25,7 +26,7 @@ export async function routing(location, routes, serverDataLoading = null) {
     if (match !== null) {
       const params = match.params;
       let data = undefined;
-      if (route.data) {
+      if ('data' in route) {
         if (serverDataLoading) serverDataLoading.value = true;
         data = await route.data(params, location, match.query);
         if (serverDataLoading) serverDataLoading.value = false;
@@ -50,11 +51,14 @@ export async function routing(location, routes, serverDataLoading = null) {
     params: {},
     content: _404Route.content
   };
-  if (errorRoute) return {
-    key: 'error',
-    params: {},
-    content: errorRoute.content
-  };
+  if (errorRoute) {
+    return {
+      key: 'error',
+      params: {},
+      content: errorRoute.content,
+      data: makeTungstenErrorInfo(new Error(`No route matched '${location}'`))
+    };
+  }
   return {
     key: null,
     params: {},

package/dist/Servers/tungstenCorePrivateEnvSchema.d.ts

@@ -1,9 +1,6 @@
 import { z } from 'zod';
 export declare const tungstenCorePrivateEnvSchema: z.ZodObject<{
     TUNGSTEN_SERVER_PORT: z.ZodOptional<z.ZodNumber>;
-    FRONTEND_PROTO: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"http">, z.ZodLiteral<"https">]>>;
-    FRONTEND_HOST: z.ZodOptional<z.ZodString>;
-    FRONTEND_PORT: z.ZodOptional<z.ZodNumber>;
     DEBUG: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$loose>;
 export type TungstenCorePrivateEnv = typeof tungstenCorePrivateEnvSchema._output;

package/dist/Servers/tungstenCorePrivateEnvSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tungstenCorePrivateEnvSchema.d.ts","sourceRoot":"","sources":["../../src/Servers/tungstenCorePrivateEnvSchema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAkBvB,eAAO,MAAM,4BAA4B;;;;;;iBASvC,CAAA;AAGF,MAAM,MAAM,sBAAsB,GAAG,OAAO,4BAA4B,CAAC,OAAO,CAAA"}
+{"version":3,"file":"tungstenCorePrivateEnvSchema.d.ts","sourceRoot":"","sources":["../../src/Servers/tungstenCorePrivateEnvSchema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAkBvB,eAAO,MAAM,4BAA4B;;;iBASvC,CAAA;AAGF,MAAM,MAAM,sBAAsB,GAAG,OAAO,4BAA4B,CAAC,OAAO,CAAA"}

package/dist/Servers/tungstenCorePrivateEnvSchema.js

@@ -14,9 +14,9 @@ const protoSchema = z.union([z.literal('http'), z.literal('https')]);
 const portSchema = z.number().gt(0);
 export const tungstenCorePrivateEnvSchema = z.looseObject({
   TUNGSTEN_SERVER_PORT: z.optional(portSchema),
-  FRONTEND_PROTO: z.optional(protoSchema),
-  FRONTEND_HOST: z.optional(z.string()),
-  FRONTEND_PORT: z.optional(portSchema),
+  // FRONTEND_PROTO: z.optional(protoSchema),
+  // FRONTEND_HOST: z.optional(z.string()),
+  // FRONTEND_PORT: z.optional(portSchema),
   DEBUG: z.optional(z.boolean())
   // SUPPRESS: z.optional(z.object({
   //     ORIGIN_MISMATCH_WARNING: z.optional(z.boolean())

package/dist/Servers/tungstenCorePublicEnvSchema.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const tungstenCorePublicEnvSchema: z.ZodObject<{
+    FRONTEND_PROTO: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"http">, z.ZodLiteral<"https">]>>;
+    FRONTEND_HOST: z.ZodOptional<z.ZodString>;
+    FRONTEND_PORT: z.ZodOptional<z.ZodNumber>;
+}, z.core.$loose>;
+export type TungstenCorePublicEnv = typeof tungstenCorePublicEnvSchema._output;
+//# sourceMappingURL=tungstenCorePublicEnvSchema.d.ts.map

package/dist/Servers/tungstenCorePublicEnvSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tungstenCorePublicEnvSchema.d.ts","sourceRoot":"","sources":["../../src/Servers/tungstenCorePublicEnvSchema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAWvB,eAAO,MAAM,2BAA2B;;;;iBAItC,CAAA;AAEF,MAAM,MAAM,qBAAqB,GAAG,OAAO,2BAA2B,CAAC,OAAO,CAAA"}

package/dist/Servers/tungstenCorePublicEnvSchema.js

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+// FRONTEND_PROTO/FRONTEND_HOST/FRONTEND_PORT are tungsten's own fields (used to
+// report the dev/prod server's own location - see DevServer.ts/ProdServer.ts).
+// Optional here because most apps keep them in the private env instead - see
+// tungstenCorePrivateEnvSchema.ts, which declares the same three fields. An
+// app is free to declare either or both; the servers check private first,
+// then public.
+const protoSchema = z.union([z.literal('http'), z.literal('https')]);
+const portSchema = z.number().gt(0);
+export const tungstenCorePublicEnvSchema = z.looseObject({
+  FRONTEND_PROTO: z.optional(protoSchema),
+  FRONTEND_HOST: z.optional(z.string()),
+  FRONTEND_PORT: z.optional(portSchema)
+});

package/dist/Store/InternalStoreSchema.d.ts

@@ -1,7 +1,9 @@
 import type { MatchedRouteInfo } from '../Servers/MatchedRouteInfo.js';
+import type { PopMessage } from '../PopMessage.type.js';
 export declare class InternalStoreSchema {
     location: string;
     matchedRouteInfo: MatchedRouteInfo;
+    popMessages: PopMessage[];
     constructor(location: string, matchedRouteInfo: MatchedRouteInfo);
 }
 //# sourceMappingURL=InternalStoreSchema.d.ts.map

package/dist/Store/InternalStoreSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InternalStoreSchema.d.ts","sourceRoot":"","sources":["../../src/Store/InternalStoreSchema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,qBAAa,mBAAmB;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,gBAAgB,CAAA;gBACtB,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB;CAInE"}
+{"version":3,"file":"InternalStoreSchema.d.ts","sourceRoot":"","sources":["../../src/Store/InternalStoreSchema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvD,qBAAa,mBAAmB;IAC5B,QAAQ,EAAE,MAAM,CAAA;IAChB,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,WAAW,EAAE,UAAU,EAAE,CAAK;gBAClB,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,gBAAgB;CAInE"}

package/dist/Store/InternalStoreSchema.js

@@ -5,6 +5,7 @@ export class InternalStoreSchema {
   constructor(location, matchedRouteInfo) {
     _defineProperty(this, "location", void 0);
     _defineProperty(this, "matchedRouteInfo", void 0);
+    _defineProperty(this, "popMessages", []);
     this.location = location;
     this.matchedRouteInfo = matchedRouteInfo;
   }

package/dist/api/Request.d.ts

@@ -1,2 +1,2 @@
-export { Request } from 'express';
+export type { Request } from 'express';
 //# sourceMappingURL=Request.d.ts.map

package/dist/api/Request.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Request.d.ts","sourceRoot":"","sources":["../../src/api/Request.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"Request.d.ts","sourceRoot":"","sources":["../../src/api/Request.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA"}

package/dist/api/Response.d.ts

@@ -1,2 +1,2 @@
-export { Response } from 'express';
+export type { Response } from 'express';
 //# sourceMappingURL=Response.d.ts.map

package/dist/api/Response.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Response.d.ts","sourceRoot":"","sources":["../../src/api/Response.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"Response.d.ts","sourceRoot":"","sources":["../../src/api/Response.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA"}

package/dist/babelPlugins/BabelTypes.d.ts

@@ -1,6 +1,6 @@
 import type * as BabelCore from '@babel/core';
-export { BabelCore };
-export { NodePath, PluginPass } from '@babel/core';
+export type { BabelCore };
+export type { NodePath, PluginPass } from '@babel/core';
 export type Babel = typeof BabelCore;
 export * as BabelTypes from '@babel/types';
 //# sourceMappingURL=BabelTypes.d.ts.map

package/dist/babelPlugins/BabelTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BabelTypes.d.ts","sourceRoot":"","sources":["../../src/babelPlugins/BabelTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,SAAS,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,CAAA;AACpB,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAClD,MAAM,MAAM,KAAK,GAAG,OAAO,SAAS,CAAC;AAErC,OAAO,KAAK,UAAU,MAAM,cAAc,CAAA"}
+{"version":3,"file":"BabelTypes.d.ts","sourceRoot":"","sources":["../../src/babelPlugins/BabelTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,SAAS,MAAM,aAAa,CAAA;AAC7C,YAAY,EAAE,SAAS,EAAE,CAAA;AACzB,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACvD,MAAM,MAAM,KAAK,GAAG,OAAO,SAAS,CAAC;AAErC,OAAO,KAAK,UAAU,MAAM,cAAc,CAAA"}

package/dist/babelPlugins/BabelTypes.js

@@ -1,3 +1,2 @@
-export { NodePath } from '@babel/core';
 //import type { types as Types } from '@babel/core';
 export * as BabelTypes from '@babel/types';

package/dist/bin/commands/build.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/build.ts"],"names":[],"mappings":"AAyCA,OAAO,EAAE,CAAA"}
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/build.ts"],"names":[],"mappings":"AA6CA,OAAO,EAAE,CAAA"}

package/dist/bin/commands/build.js

@@ -3,8 +3,11 @@ import chalk from 'chalk-extensions';
 import { Framework } from "../../Framework.js";
 import { cliOut, cliNews } from "../../cliOutput.js";
 import { staticSiteFolder } from "../../settings.js";
+import { createTimeProfiler } from "../../timeProfiler.js";
+const profile = process.argv.slice(3).includes('--profile');
 //// prep the app
 const sxyFramework = new Framework();
+sxyFramework.profiler = createTimeProfiler(profile);
 await sxyFramework.init();
 await sxyFramework.clean('prod');
 await sxyFramework.build('prod');

package/dist/bin/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/dev.ts"],"names":[],"mappings":"AA2CA,OAAO,EAAE,CAAA"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/dev.ts"],"names":[],"mappings":"AAqDA,OAAO,EAAE,CAAA"}

package/dist/bin/commands/dev.js

@@ -2,11 +2,16 @@ import open from 'open';
 import { cliOut } from "../../cliOutput.js";
 import { Framework } from "../../Framework.js";
 import { warnOnFrameworkChange } from "../../warnOnFrameworkChange.js";
+import { createTimeProfiler } from "../../timeProfiler.js";
 //import dotenv from 'dotenv'
 //dotenv.config({ path: '.private.env' })
+const args = process.argv.slice(3);
+const boot = !args.includes('--no-boot');
+const profile = args.includes('--profile');
 cliOut(`Starting dev mode`);
 //// prep the app
 const sxyFramework = new Framework();
+sxyFramework.profiler = createTimeProfiler(profile);
 await sxyFramework.init();
 //console.log('framework ready')
 // build for dev
@@ -17,9 +22,15 @@ await sxyFramework.build('dev');
 // start a dev server
 const devServer = await sxyFramework.createDevServer();
 //cliOut('Dev server ready')
-const devServerLocation = await devServer.start();
-if (sxyFramework.config?.warnOnFrameworkChange) warnOnFrameworkChange();
+const devServerLocation = await sxyFramework.profiler.timeProfileAsync('start dev server', () => devServer.start());
+// devmon already restarts this process itself on a framework rebuild, so the warning
+// (which just tells you to restart manually) would be redundant noise under it - see devmon.ts.
+if (sxyFramework.config?.warnOnFrameworkChange && process.env.__TUNGSTEN_DEVMON !== 'true') {
+  warnOnFrameworkChange();
+}
 // do a dummy request to trigger any error immediately during dev
 //axios.get(sxyFramework.devServer.location)
-cliOut('Booting to the dev site in your browser');
-open(devServerLocation);
+if (boot) {
+  cliOut('Booting to the dev site in your browser');
+  open(devServerLocation);
+}

package/dist/bin/commands/devmon.d.ts

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

package/dist/bin/commands/devmon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devmon.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/devmon.ts"],"names":[],"mappings":"AAqEA,OAAO,EAAE,CAAA"}

package/dist/bin/commands/devmon.js

@@ -0,0 +1,66 @@
+// Master process for `tungsten dev`: runs it as a child process and watches the same
+// build-notification marker file as warnOnFrameworkChange.ts (dist/.build-complete in the
+// framework package). When a framework rebuild touches it, kills and respawns the dev child
+// instead of just warning that a restart is needed.
+import { spawn } from 'node:child_process';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import chokidar from 'chokidar';
+import { cliError } from "../../cliOutput.js";
+import { getFrameworkDir } from "../../getFrameworkDir.js";
+const binIndexPath = fileURLToPath(new URL('../index.js', import.meta.url));
+const initialArgs = process.argv.slice(3);
+// Restarts always force --no-boot (no reopening the browser tab each time), but otherwise
+// keep whatever else devmon itself was passed - e.g. --profile.
+const restartArgs = [...initialArgs.filter(arg => arg !== '--no-boot'), '--no-boot'];
+const buildMarkerPath = join(getFrameworkDir(), 'dist', '.build-complete');
+let child = null;
+let restarting = false;
+function startDev(args) {
+  // __TUNGSTEN_DEVMON tells dev.ts to skip warnOnFrameworkChange() - devmon is already
+  // restarting it, so that warning would just be confusing noise here.
+  child = spawn(process.execPath, [binIndexPath, 'dev', ...args], {
+    stdio: 'inherit',
+    env: {
+      ...process.env,
+      __TUNGSTEN_DEVMON: 'true'
+    }
+  });
+  child.on('exit', code => {
+    child = null;
+    // not one of our own restarts, so the dev process ended on its own (crash, or the
+    // user quit it directly) - nothing left for devmon to supervise
+    if (!restarting) process.exit(code ?? 0);
+  });
+}
+function restartDev() {
+  if (restarting) return;
+  restarting = true;
+  cliError('tungsten framework rebuilt - restarting tungsten dev');
+  if (child === null) {
+    restarting = false;
+    startDev(restartArgs);
+    return;
+  }
+  child.once('exit', () => {
+    restarting = false;
+    startDev(restartArgs);
+  });
+  child.kill();
+}
+startDev(initialArgs);
+const watcher = chokidar.watch(buildMarkerPath, {
+  ignoreInitial: true,
+  awaitWriteFinish: {
+    stabilityThreshold: 200,
+    pollInterval: 20
+  }
+});
+watcher.on('all', restartDev);
+function shutdown() {
+  void watcher.close();
+  if (child !== null) child.kill();
+  process.exit(0);
+}
+process.on('SIGINT', shutdown);
+process.on('SIGTERM', shutdown);

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bin/index.ts"],"names":[],"mappings":"AAmDA,OAAO,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bin/index.ts"],"names":[],"mappings":"AAwDA,OAAO,EAAE,CAAA"}

package/dist/bin/index.js

@@ -10,6 +10,12 @@ switch (command) {
       await import("./commands/dev.js");
       break;
     }
+  case 'devmon':
+    {
+      process.env.__TUNGSTEN_ENV = 'development';
+      await import("./commands/devmon.js");
+      break;
+    }
   case 'build':
     {
       process.env.__TUNGSTEN_ENV = 'production';

package/dist/booleanAttributeValue.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The attribute string value for a boolean prop, or `null` when the attribute
+ * should be omitted entirely.
+ *
+ * The general rule is an ordinary HTML boolean attribute - `disabled`,
+ * `checked`, `hidden` and the rest: present (conventionally with an empty
+ * value) means true, absent means false. `contentEditable` looks like one of
+ * these in JSX but is not: `contenteditable` is a three-state enumerated
+ * attribute (true/false/inherit) where an absent attribute means *inherit*,
+ * not false. Representing `contentEditable={false}` by omitting the
+ * attribute therefore does nothing under an editable ancestor - the element
+ * silently stays editable. It gets explicit `"true"`/`"false"` strings
+ * instead; every other boolean prop keeps the ordinary rule.
+ *
+ * Shared by every place that turns a boolean prop into HTML - the server
+ * renderer, the client create/update paths, hydration's attribute
+ * reconciliation, and `contentNodeToHtml()` - so they cannot disagree with
+ * each other and produce a false hydration mismatch.
+ */
+export declare function booleanAttributeValue(name: string, value: boolean): string | null;
+//# sourceMappingURL=booleanAttributeValue.d.ts.map

package/dist/booleanAttributeValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"booleanAttributeValue.d.ts","sourceRoot":"","sources":["../src/booleanAttributeValue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAGjF"}

package/dist/booleanAttributeValue.js

@@ -0,0 +1,23 @@
+/**
+ * The attribute string value for a boolean prop, or `null` when the attribute
+ * should be omitted entirely.
+ *
+ * The general rule is an ordinary HTML boolean attribute - `disabled`,
+ * `checked`, `hidden` and the rest: present (conventionally with an empty
+ * value) means true, absent means false. `contentEditable` looks like one of
+ * these in JSX but is not: `contenteditable` is a three-state enumerated
+ * attribute (true/false/inherit) where an absent attribute means *inherit*,
+ * not false. Representing `contentEditable={false}` by omitting the
+ * attribute therefore does nothing under an editable ancestor - the element
+ * silently stays editable. It gets explicit `"true"`/`"false"` strings
+ * instead; every other boolean prop keeps the ordinary rule.
+ *
+ * Shared by every place that turns a boolean prop into HTML - the server
+ * renderer, the client create/update paths, hydration's attribute
+ * reconciliation, and `contentNodeToHtml()` - so they cannot disagree with
+ * each other and produce a false hydration mismatch.
+ */
+export function booleanAttributeValue(name, value) {
+  if (name.toLowerCase() === 'contenteditable') return value ? 'true' : 'false';
+  return value ? '' : null;
+}

package/dist/build/compileJavascript.js

@@ -52,7 +52,7 @@ export async function compileJavascript(projectDir, appConfig, codeLocation, sou
   const pendingExportWipes = new Map();
   const exportWipeGraceMs = 5000;
   async function transformFile(file) {
-    if (options.quiet !== true) console.log('transforming file', file);
+    //if (options.quiet !== true) console.log('transforming file', file)
     try {
       let rel = file.slice(codeLocationLength);
       if (rel.endsWith('.jsx')) rel = rel.slice(0, -1);

package/dist/build/compileUserApp.d.ts

@@ -1,5 +1,6 @@
 import type { CompilationInfo } from './CompilationInfo.js';
 import type { FrameworkConfigComplete } from '../FrameworkConfig.js';
 import type { Mode } from '../Mode.js';
-export declare function compileUserApp(projectDir: string, appConfig: FrameworkConfigComplete, mode: Mode): Promise<CompilationInfo>;
+import { type TimeProfiler } from '../timeProfiler.js';
+export declare function compileUserApp(projectDir: string, appConfig: FrameworkConfigComplete, mode: Mode, profiler?: TimeProfiler): Promise<CompilationInfo>;
 //# sourceMappingURL=compileUserApp.d.ts.map

package/dist/build/compileUserApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compileUserApp.d.ts","sourceRoot":"","sources":["../../src/build/compileUserApp.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAWtC,wBAAsB,cAAc,CAChC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,uBAAuB,EAAE,IAAI,EAAE,IAAI,GACnE,OAAO,CAAC,eAAe,CAAC,CAoD1B"}
+{"version":3,"file":"compileUserApp.d.ts","sourceRoot":"","sources":["../../src/build/compileUserApp.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AACpE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAQtC,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAI1E,wBAAsB,cAAc,CAChC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,uBAAuB,EAAE,IAAI,EAAE,IAAI,EAClE,QAAQ,GAAE,YAAwC,GACnD,OAAO,CAAC,eAAe,CAAC,CAwD1B"}

package/dist/build/compileUserApp.js

@@ -6,8 +6,9 @@ import { copyPublicFiles } from "./copyPublicFiles.js";
 import { buildCodeSubPath, bundleFolder, devBuildOuterFolder, prodBuildFolder } from "../settings.js";
 import { combineComponentCss } from "./combineComponentCss.js";
 import { emitReloadEvent } from "../hmr/liveReloadHub.js";
+import { createTimeProfiler } from "../timeProfiler.js";
 //import { compileEnv } from './compileEnv.js'
-export async function compileUserApp(projectDir, appConfig, mode) {
+export async function compileUserApp(projectDir, appConfig, mode, profiler = createTimeProfiler(false)) {
   const codeLocation = join(projectDir, appConfig.codeDir);
   const relSourceDir = appConfig.sourceDir !== undefined && appConfig.sourceDir !== '' ? appConfig.sourceDir : appConfig.codeDir;
   const sourceLocation = join(projectDir, relSourceDir);
@@ -15,15 +16,15 @@ export async function compileUserApp(projectDir, appConfig, mode) {
   const buildLocation = mode === 'dev' ? join(projectDir, devBuildOuterFolder) : join(projectDir, prodBuildFolder);
   const codeSubPath = buildCodeSubPath;
   const buildCodeLocation = join(buildLocation, codeSubPath);
-  const compileJavascriptPromise = compileJavascript(projectDir, appConfig, codeLocation, sourceLocation, styleImportBase, buildLocation, buildCodeLocation, mode, true, mode === 'dev' ? {
+  const compileJavascriptPromise = profiler.timeProfileAsync('compile javascript', () => compileJavascript(projectDir, appConfig, codeLocation, sourceLocation, styleImportBase, buildLocation, buildCodeLocation, mode, true, mode === 'dev' ? {
     onCycleComplete: cycle => {
       if (cycle.success) emitReloadEvent('js', cycle.file);
     }
-  } : {});
+  } : {}));
   //const compileEnvPromise = compileEnv(projectDir, appConfig, codeLocation, buildLocation, mode)
-  const compileStylesPromise = compileStyles(projectDir, appConfig, styleImportBase, buildLocation, true, mode === 'dev' ? () => emitReloadEvent('css') : undefined);
-  const copyAssetsPromise = copyAssets(projectDir, appConfig, buildLocation);
-  const copyPublicFilesPromise = copyPublicFiles(projectDir, appConfig, buildLocation);
+  const compileStylesPromise = profiler.timeProfileAsync('compile styles', () => compileStyles(projectDir, appConfig, styleImportBase, buildLocation, true, mode === 'dev' ? () => emitReloadEvent('css') : undefined));
+  const copyAssetsPromise = profiler.timeProfileAsync('copy assets', () => copyAssets(projectDir, appConfig, buildLocation));
+  const copyPublicFilesPromise = profiler.timeProfileAsync('copy public files', () => copyPublicFiles(projectDir, appConfig, buildLocation));
   const {
     importAliases
   } = await compileJavascriptPromise;
@@ -31,7 +32,7 @@ export async function compileUserApp(projectDir, appConfig, mode) {
   await compileStylesPromise;
   await copyAssetsPromise;
   await copyPublicFilesPromise;
-  if (mode === 'prod') await combineComponentCss(buildLocation);
+  if (mode === 'prod') await profiler.timeProfileAsync('combine component css', () => combineComponentCss(buildLocation));
   const compilationInfo = {
     type: 'success',
     projectDir,

package/dist/build/createInstanceConfigFile.js

@@ -20,7 +20,7 @@ export async function createInstanceConfigFile(config, mode, buildLocation) {
     });
     await fsPromises.writeFile(appConfigLocation,
     // to
-    `export default { prod: ${(mode === 'prod').toString()}, useRootComponent: ${config.useRootComponent.toString()}, siteBasePath: "${siteBasePath}", clientSideNav: ${config.clientSideNav.toString()}, staticSite: ${config.staticSite.toString()} };` // eslint-disable-line max-len
+    `export default { prod: ${(mode === 'prod').toString()}, useRootComponent: ${config.useRootComponent.toString()}, siteBasePath: "${siteBasePath}", clientSideNav: ${config.clientSideNav.toString()}, staticSite: ${config.staticSite.toString()}, csr: ${config.csr.toString()} };` // eslint-disable-line max-len
     );
   } catch (e) {
     throw new TungstenError(`createAppConfig() Error: error creating app config file`);

package/dist/compat/types.d.ts

@@ -1,6 +1,6 @@
 import { TungstenStatefulComponent } from 'tungsten/Components.jsx';
 import { ContentNode, ContentNodeElement } from '../ContentNode.js';
-export { ContentNode as ReactNode, ContentNodeElement as ReactElement };
+export type { ContentNode as ReactNode, ContentNodeElement as ReactElement };
 export type PropsWithChildren<P> = P & {
     children?: ContentNode | undefined;
 };

package/dist/compat/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/compat/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,yBAAyB,EAAiC,MAAM,yBAAyB,CAAA;AACzH,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEnE,OAAO,EAAE,WAAW,IAAI,SAAS,EAAE,kBAAkB,IAAI,YAAY,EAAE,CAAA;AAEvE,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE,CAAC;AAwJ9E,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAgC9G,OAAO,KAAK,KAAK,SAAS,MAAM,YAAY,CAAA;AAC5C,KAAK,aAAa,CAAC,CAAC,IAAI,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;AACnD,KAAK,iBAAiB,CAAC,CAAC,IAAI,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAS3D,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,EAAE;IACrC,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAC9D,SAAS,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAC7C,YAAY,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/compat/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,yBAAyB,EAAiC,MAAM,yBAAyB,CAAA;AACzH,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAEnE,YAAY,EAAE,WAAW,IAAI,SAAS,EAAE,kBAAkB,IAAI,YAAY,EAAE,CAAA;AAE5E,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,SAAS,CAAA;CAAE,CAAC;AAwJ9E,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,IAAI,yBAAyB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAgC9G,OAAO,KAAK,KAAK,SAAS,MAAM,YAAY,CAAA;AAC5C,KAAK,aAAa,CAAC,CAAC,IAAI,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;AACnD,KAAK,iBAAiB,CAAC,CAAC,IAAI,SAAS,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;AAS3D,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,EAAE;IACrC,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,CAAC,EAAE,GAAG,GAAG,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAC9D,SAAS,CAAC,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAC7C,YAAY,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;IAC9C,YAAY,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACpC"}

package/dist/components/PopMessages.d.ts

@@ -0,0 +1,12 @@
+import { TungstenSimpleInternalStoreComponent } from '../Components.jsx';
+type Props = {
+    className?: string;
+    messageClassName?: string;
+    unstyled?: boolean;
+};
+export declare class PopMessages extends TungstenSimpleInternalStoreComponent<Props> {
+    clientInit: () => void;
+    content: () => import("../ContentNode.js").ContentNode;
+}
+export {};
+//# sourceMappingURL=PopMessages.d.ts.map

package/dist/components/PopMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PopMessages.d.ts","sourceRoot":"","sources":["../../src/components/PopMessages.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,oCAAoC,EAAE,MAAM,mBAAmB,CAAA;AAGxE,KAAK,KAAK,GAAG;IACT,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IAIzB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAkBD,qBAAa,WAAY,SAAQ,oCAAoC,CAAC,KAAK,CAAC;IACxE,UAAU,aAET;IAED,OAAO,gDAsBN;CACJ"}

package/dist/components/PopMessages.js

@@ -0,0 +1,45 @@
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { combineClassNames } from "../helpers/combineClassNames.js";
+import { TungstenSimpleInternalStoreComponent } from "../Components.js";
+import { dismissPop, registerPopInstance } from "../pop.js";
+import { jsx as _jsx } from "tungsten/jsxRuntime.js";
+const messageCss = 'padding: 0.3rem 0.75rem; font-size: 0.85rem; max-height: 3rem; background: #1f3a5f;' + ' color: #eaf2ff; border-bottom: 1px solid #16283f; text-align: center; cursor: pointer; overflow: hidden;' + ' transition: max-height 0.2s ease, padding 0.2s ease;';
+const leavingCss = 'max-height: 0; padding-top: 0; padding-bottom: 0; border-bottom-width: 0;';
+// An app mounts this once in its Root, above <MatchedRoute />, so it can push
+// the page down rather than overlay it. clientInit wires the pop() bridge -
+// see pop.ts. Carries its own default look via the css prop: a component
+// shipped as a framework dependency can't rely on Tungsten's Sass/style-
+// scoping build step, which only runs over an app's own source and never
+// node_modules (the same exclude pattern BabelTransformRemoveServerBlocks
+// relies on elsewhere - see rollup.user.prod.config.ts). Override the look
+// with className, style the PopMessages component selector from your own
+// Root (which reaches this.props.className the same way Link does), or pass
+// unstyled to drop the built-in css entirely.
+export class PopMessages extends TungstenSimpleInternalStoreComponent {
+  constructor(...args) {
+    super(...args);
+    _defineProperty(this, "clientInit", () => {
+      registerPopInstance(this.__instance);
+    });
+    _defineProperty(this, "content", () => {
+      const popMessages = this.store.popMessages.sync();
+      if (popMessages.length === 0) return null;
+      const {
+        className,
+        messageClassName,
+        unstyled = false
+      } = this.props;
+      return _jsx("div", {
+        className: combineClassNames('pop-messages', className),
+        children: popMessages.map(message => _jsx("div", {
+          className: combineClassNames('pop-message', message.leaving === true && 'leaving', messageClassName),
+          css: unstyled ? undefined : messageCss + (message.leaving === true ? leavingCss : ''),
+          onClick: () => dismissPop(message.id),
+          children: message.text
+        }, message.id))
+      });
+    });
+  }
+}

package/dist/defaultConfig.d.ts

@@ -17,6 +17,7 @@ export declare const defaultConfig: {
     suppressOriginMismatchWarning: false;
     warnOnFrameworkChange: true;
     hmr: true;
+    csr: false;
 };
 export type FrameworkConfigDefault = typeof defaultConfig;
 //# sourceMappingURL=defaultConfig.d.ts.map

package/dist/defaultConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaultConfig.d.ts","sourceRoot":"","sources":["../src/defaultConfig.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;CAuBS,CAAA;AAEnC,MAAM,MAAM,sBAAsB,GAAG,OAAO,aAAa,CAAA"}
+{"version":3,"file":"defaultConfig.d.ts","sourceRoot":"","sources":["../src/defaultConfig.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;CAwBS,CAAA;AAEnC,MAAM,MAAM,sBAAsB,GAAG,OAAO,aAAa,CAAA"}