tungsten 0.3.3 → 0.3.5

package/dist/render/processHead.js

@@ -15,7 +15,8 @@ export function processHead(headNode, headData) {
     clientImportAliases,
     dev,
     siteBasePath,
-    hmr
+    hmr,
+    frameworkCss
   } = 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];
@@ -28,6 +29,18 @@ export function processHead(headNode, headData) {
       href: `${siteBasePath}/${componentCssFolder}/${componentCssFile}`
     }
   });
+  // unshifted after the app's, so it lands before it and app rules win on equal specificity
+  if (frameworkCss !== undefined) {
+    headNode[$props].children.unshift({
+      [$type]: 'link',
+      [$props]: {
+        'data--t-internal': undefined,
+        'data--t-persist': true,
+        rel: 'stylesheet',
+        href: `${siteBasePath}${frameworkCss}`
+      }
+    });
+  }
   // entry script
   const scriptNode = {
     [$type]: 'script',

package/dist/settings.d.ts

@@ -15,6 +15,8 @@ export declare const publicFolder = ".public";
 export declare const assetsFolder = ".assets";
 export declare const componentCssFolder = ".componentCss";
 export declare const componentCssFile = "ccss.css";
+export declare const frameworkCssFolder = ".tungstenCss";
+export declare const frameworkCssFile = "tungsten.css";
 export declare const packagesFolder = ".packages";
 export declare const unusedStyleReporting: boolean;
 export declare const packageName = "tungsten";

package/dist/settings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,cAAc,CAAA;AACtC,eAAO,MAAM,gBAAgB,SAAS,CAAA;AACtC,eAAO,MAAM,mBAAmB,kBAAuB,CAAA;AACvD,eAAO,MAAM,cAAc,uBAA+C,CAAA;AAC1E,eAAO,MAAM,eAAe,mBAAwB,CAAA;AACpD,eAAO,MAAM,mBAAmB,wBAA2C,CAAA;AAC3E,eAAO,MAAM,YAAY,2BAA+B,CAAA;AACxD,eAAO,MAAM,gBAAgB,yBAA8B,CAAA;AAC3D,eAAO,MAAM,mBAAmB,4BAAiC,CAAA;AACjE,eAAO,MAAM,qBAAqB,cAAc,CAAA;AAChD,eAAO,MAAM,YAAY,WAAW,CAAA;AAEpC,eAAO,MAAM,YAAY,YAAY,CAAA;AACrC,eAAO,MAAM,YAAY,YAAY,CAAA;AACrC,eAAO,MAAM,YAAY,YAAY,CAAA;AACrC,eAAO,MAAM,YAAY,YAAY,CAAA;AACrC,eAAO,MAAM,kBAAkB,kBAAkB,CAAA;AACjD,eAAO,MAAM,gBAAgB,aAAa,CAAA;AAC1C,eAAO,MAAM,cAAc,cAAc,CAAA;AAEzC,eAAO,MAAM,oBAAoB,EAAE,OAAe,CAAA;AAElD,eAAO,MAAM,WAAW,aAAa,CAAA;AACrC,eAAO,MAAM,sBAAsB,aAAa,CAAA;AAChD,eAAO,MAAM,qBAAqB,YAAY,CAAA;AAC9C,eAAO,MAAM,mBAAmB,SAAS,CAAA"}
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,WAAW,cAAc,CAAA;AACtC,eAAO,MAAM,gBAAgB,SAAS,CAAA;AACtC,eAAO,MAAM,mBAAmB,kBAAuB,CAAA;AACvD,eAAO,MAAM,cAAc,uBAA+C,CAAA;AAC1E,eAAO,MAAM,eAAe,mBAAwB,CAAA;AACpD,eAAO,MAAM,mBAAmB,wBAA2C,CAAA;AAC3E,eAAO,MAAM,YAAY,2BAA+B,CAAA;AACxD,eAAO,MAAM,gBAAgB,yBAA8B,CAAA;AAC3D,eAAO,MAAM,mBAAmB,4BAAiC,CAAA;AACjE,eAAO,MAAM,qBAAqB,cAAc,CAAA;AAChD,eAAO,MAAM,YAAY,WAAW,CAAA;AAEpC,eAAO,MAAM,YAAY,YAAY,CAAA;AACrC,eAAO,MAAM,YAAY,YAAY,CAAA;AACrC,eAAO,MAAM,YAAY,YAAY,CAAA;AACrC,eAAO,MAAM,YAAY,YAAY,CAAA;AACrC,eAAO,MAAM,kBAAkB,kBAAkB,CAAA;AACjD,eAAO,MAAM,gBAAgB,aAAa,CAAA;AAE1C,eAAO,MAAM,kBAAkB,iBAAiB,CAAA;AAChD,eAAO,MAAM,gBAAgB,iBAAiB,CAAA;AAC9C,eAAO,MAAM,cAAc,cAAc,CAAA;AAEzC,eAAO,MAAM,oBAAoB,EAAE,OAAe,CAAA;AAElD,eAAO,MAAM,WAAW,aAAa,CAAA;AACrC,eAAO,MAAM,sBAAsB,aAAa,CAAA;AAChD,eAAO,MAAM,qBAAqB,YAAY,CAAA;AAC9C,eAAO,MAAM,mBAAmB,SAAS,CAAA"}

package/dist/settings.js

@@ -16,6 +16,9 @@ export const publicFolder = '.public';
 export const assetsFolder = '.assets';
 export const componentCssFolder = '.componentCss';
 export const componentCssFile = 'ccss.css';
+// framework component css, kept separate from the app's so devtools names the origin
+export const frameworkCssFolder = '.tungstenCss';
+export const frameworkCssFile = 'tungsten.css';
 export const packagesFolder = '.packages';
 export const unusedStyleReporting = false;
 export const packageName = 'tungsten';

package/dist/stateTracking.d.ts

@@ -0,0 +1,47 @@
+/**
+ * A monotonic clock for state writes, so a component can ask "has anything inside this
+ * object changed since I last rendered?".
+ *
+ * Needed because deep state is mutated in place: when a child's prop is the same array
+ * the parent already had, comparing before against after tells you nothing -- both sides
+ * are the one mutated object. Each proxy stamps the object it mutated with the current
+ * tick, and the props comparison walks down looking for a stamp newer than the child's
+ * last render.
+ *
+ * The stamp is stored under $changed on the object itself rather than in a side table
+ * keyed by identity, so it can be read straight back through the proxy -- the raw target
+ * is not always the object a caller holds, since adoption copies state shallowly.
+ * Symbols are invisible to Object.keys and JSON, so the stamp does not leak into user data.
+ *
+ * Stamps are deliberately not propagated to ancestors: a write would then have to touch
+ * every object above it. The cost is moved to update time, where the walk can stop at the
+ * first changed node it finds.
+ *
+ * No imports here on purpose -- the proxy handlers depend on this, so it must stay a leaf.
+ */
+export declare const $changed: unique symbol;
+/**
+ * Re-reads the global. Called once per update rather than per node: the global lookup is
+ * cheap in isolation but showed up as 12% of a 50k-row update when it ran for every dom
+ * node, which is the instrumentation distorting what it measures. Toggling __TW_TRACE from
+ * a console therefore takes effect on the next update rather than immediately.
+ */
+export declare function refreshTracing(): boolean;
+export declare function tracing(): boolean;
+/**
+ * Each line carries the time since page load and the time since the previous traced event,
+ * so a stall shows up as a large `+delta` on the line that follows it -- no need to diff
+ * timestamps by hand. The delta is reset whenever tracing is switched back on.
+ */
+export declare function trace(...args: unknown[]): void;
+/** current tick; read when recording a render */
+export declare function stateClock(): number;
+/** called by the state proxies whenever the given object is mutated */
+export declare function markChanged(target: object): void;
+/** tick at which this object was last mutated; 0 means never */
+export declare function changedAt(value: object): number;
+/** record that a component has rendered with the state as it currently stands */
+export declare function markRendered(element: object): void;
+/** tick at which this component last rendered, or undefined if it never has */
+export declare function renderedAt(element: object): number | undefined;
+//# sourceMappingURL=stateTracking.d.ts.map

package/dist/stateTracking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stateTracking.d.ts","sourceRoot":"","sources":["../src/stateTracking.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,eAAO,MAAM,QAAQ,eAAoB,CAAA;AAQzC;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAGxC;AAED,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAID;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAM9C;AAMD,iDAAiD;AACjD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAIhD;AAED,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAIlD;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE9D"}

package/dist/stateTracking.js

@@ -0,0 +1,83 @@
+/**
+ * A monotonic clock for state writes, so a component can ask "has anything inside this
+ * object changed since I last rendered?".
+ *
+ * Needed because deep state is mutated in place: when a child's prop is the same array
+ * the parent already had, comparing before against after tells you nothing -- both sides
+ * are the one mutated object. Each proxy stamps the object it mutated with the current
+ * tick, and the props comparison walks down looking for a stamp newer than the child's
+ * last render.
+ *
+ * The stamp is stored under $changed on the object itself rather than in a side table
+ * keyed by identity, so it can be read straight back through the proxy -- the raw target
+ * is not always the object a caller holds, since adoption copies state shallowly.
+ * Symbols are invisible to Object.keys and JSON, so the stamp does not leak into user data.
+ *
+ * Stamps are deliberately not propagated to ancestors: a write would then have to touch
+ * every object above it. The cost is moved to update time, where the walk can stop at the
+ * first changed node it finds.
+ *
+ * No imports here on purpose -- the proxy handlers depend on this, so it must stay a leaf.
+ */
+export const $changed = Symbol('changed');
+/**
+ * Set `__TW_TRACE = true` in a console (or before load) to log the props-skip decisions.
+ * Off by default and cheap when off -- one global read per event.
+ */
+let tracingCached = null;
+/**
+ * Re-reads the global. Called once per update rather than per node: the global lookup is
+ * cheap in isolation but showed up as 12% of a 50k-row update when it ran for every dom
+ * node, which is the instrumentation distorting what it measures. Toggling __TW_TRACE from
+ * a console therefore takes effect on the next update rather than immediately.
+ */
+export function refreshTracing() {
+  tracingCached = Reflect.get(globalThis, '__TW_TRACE') === true;
+  return tracingCached;
+}
+export function tracing() {
+  return tracingCached ?? refreshTracing();
+}
+let lastTraceAt = null;
+/**
+ * Each line carries the time since page load and the time since the previous traced event,
+ * so a stall shows up as a large `+delta` on the line that follows it -- no need to diff
+ * timestamps by hand. The delta is reset whenever tracing is switched back on.
+ */
+export function trace(...args) {
+  if (!tracing()) {
+    lastTraceAt = null;
+    return;
+  }
+  const now = performance.now();
+  const delta = lastTraceAt === null ? 0 : now - lastTraceAt;
+  lastTraceAt = now;
+  console.log(`[tungsten ${now.toFixed(1)}ms +${delta.toFixed(1)}]`, ...args);
+}
+let clock = 0;
+const lastRender = new WeakMap();
+/** current tick; read when recording a render */
+export function stateClock() {
+  return clock;
+}
+/** called by the state proxies whenever the given object is mutated */
+export function markChanged(target) {
+  Reflect.set(target, $changed, ++clock);
+  // commented out: args are built on every state write even when tracing is off
+  //trace('changed', Array.isArray(target) ? `array(len ${target.length})` : 'object', '-> tick', clock)
+}
+/** tick at which this object was last mutated; 0 means never */
+export function changedAt(value) {
+  const stamp = Reflect.get(value, $changed);
+  return typeof stamp === 'number' ? stamp : 0;
+}
+/** record that a component has rendered with the state as it currently stands */
+export function markRendered(element) {
+  lastRender.set(element, clock);
+  // commented out: args are built on every render even when tracing is off
+  //trace('rendered', element.constructor.name, 'baseline tick', clock)
+}
+/** tick at which this component last rendered, or undefined if it never has */
+export function renderedAt(element) {
+  return lastRender.get(element);
+}

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

@@ -1 +1 @@
-{"version":3,"file":"staticGen.d.ts","sourceRoot":"","sources":["../../src/staticGen/staticGen.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAiBhD,wBAAsB,SAAS,CAAC,SAAS,EAAE,SAAS,iBA2LnD"}
+{"version":3,"file":"staticGen.d.ts","sourceRoot":"","sources":["../../src/staticGen/staticGen.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAiBhD,wBAAsB,SAAS,CAAC,SAAS,EAAE,SAAS,iBA6MnD"}

package/dist/staticGen/staticGen.js

@@ -2,7 +2,7 @@ import { existsSync, promises as fsPromises } from 'fs';
 import { join, dirname } from 'path';
 import fsExtra from 'fs-extra';
 //import type { SxyFrameworkConfigComplete } from '../FrameworkConfig.js'
-import { staticSiteFolder, staticFolder, assetsFolder, publicFolder, bundleFolder, componentCssFolder } from "../settings.js";
+import { staticSiteFolder, staticFolder, assetsFolder, publicFolder, bundleFolder, componentCssFolder, frameworkCssFolder } from "../settings.js";
 import { getAppRoutes } from "./getAppRoutes.js";
 import { cliError, cliWarn } from "../cliOutput.js";
 import { matchPath } from "../routing/matchPath.js";
@@ -36,119 +36,129 @@ export async function staticGen(framework) {
   const buildLocation = framework.compilationInfo.location;
   const server = await framework.createProdServer();
   const serverLocation = await server.start(null, true); // port, mute
-  // ensure the target folder exists
-  await fsPromises.mkdir(join(projectDir, staticSiteFolder), {
-    recursive: true
-  });
-  const rewriteMap = {};
-  // if ( ! Array.isArray(appRoutes) ) {
-  //     appRoutes = Object.entries(appRoutes).map( ([path, route]) => { 
-  //         route.path = path as keyof typeof appRoutes
-  //         return route
-  //     } )
-  // }
-  // for default and 404 routes we need to identify which one is in use, and then make sure the app renders it
-  // appRoutes = appRoutes.map( route => {
-  //     if (route.path === 'default') {
-  //         route.path === '/__default'
-  //         cliWarn(`Static site gen turning default route into __default.html. It is possible that this could conflict with a real route.`)
-  //     } else if (route.path === '404') {
-  //         route.path === '/404'
-  //         cliWarn(`Static site gen turning 404 route into __404.html. It is possible that this could conflict with a real route.`)
-  //     } 
-  //     return route
-  // })
-  const dynamicRoutes = [];
-  const finalRoutes = objectFilter(appRoutes, (path, route) => {
-    if (!path.startsWith('/')) {
-      //cliWarn(`Static gen skipping route ${route.path}, because it does not start with /, and is not default or 404`)
-      cliWarn(`Static gen skipping route ${path}, because it does not start with /`);
-      return false;
+  // the server is only here to render the pages from - leaving it up holds the event loop
+  // open, which is what forced the caller to hard-exit (and abort mid-teardown) instead
+  try {
+    // ensure the target folder exists
+    await fsPromises.mkdir(join(projectDir, staticSiteFolder), {
+      recursive: true
+    });
+    const rewriteMap = {};
+    // if ( ! Array.isArray(appRoutes) ) {
+    //     appRoutes = Object.entries(appRoutes).map( ([path, route]) => {
+    //         route.path = path as keyof typeof appRoutes
+    //         return route
+    //     } )
+    // }
+    // for default and 404 routes we need to identify which one is in use, and then make sure the app renders it
+    // appRoutes = appRoutes.map( route => {
+    //     if (route.path === 'default') {
+    //         route.path === '/__default'
+    //         cliWarn(`Static site gen turning default route into __default.html. It is possible that this could conflict with a real route.`)
+    //     } else if (route.path === '404') {
+    //         route.path === '/404'
+    //         cliWarn(`Static site gen turning 404 route into __404.html. It is possible that this could conflict with a real route.`)
+    //     }
+    //     return route
+    // })
+    const dynamicRoutes = [];
+    const finalRoutes = objectFilter(appRoutes, (path, route) => {
+      if (!path.startsWith('/')) {
+        //cliWarn(`Static gen skipping route ${route.path}, because it does not start with /, and is not default or 404`)
+        cliWarn(`Static gen skipping route ${path}, because it does not start with /`);
+        return false;
+      }
+      if (path.includes(':')) {
+        // separate these out
+        dynamicRoutes.push([path, route]);
+        return false;
+      }
+      return true;
+    });
+    if (count(finalRoutes) === 0) {
+      cliWarn('Found no valid route!');
     }
-    if (path.includes(':')) {
-      // separate these out
-      dynamicRoutes.push([path, route]);
-      return false;
+    for (const [path, route] of Object.entries(finalRoutes)) {
+      // we need to develop the rewrite map over time, because we discover links during processing
+      rewriteMap[path] = pathToLink(path, siteBasePath);
     }
-    return true;
-  });
-  if (count(finalRoutes) === 0) {
-    cliWarn('Found no valid route!');
-  }
-  for (const [path, route] of Object.entries(finalRoutes)) {
-    // we need to develop the rewrite map over time, because we discover links during processing
-    rewriteMap[path] = pathToLink(path, siteBasePath);
-  }
-  //console.log('rewriteMap', rewriteMap)
-  async function renderPath(path, siteBasePath) {
-    const url = serverLocation + path;
-    let links;
-    try {
-      console.log('get URL', url);
-      const response = await fetch(url);
-      // fetch, unlike axios, resolves on non-2xx - so check explicitly, or we'd
-      // write error pages out as static HTML
-      if (!response.ok) throwError('renderPath', `Get request to ${url} returned an invalid status: ${response.status}`);
-      let result = await response.text();
-      links = findLinks(result);
-      const newPaths = [];
-      for (const link of links) {
-        if (!StringIsPath(link)) throwError('renderRoute', `Found a link '${link}' that did not start with /`);
-        if (!(link in rewriteMap)) {
-          for (const [path, dynamicRoute] of dynamicRoutes) {
-            if (RouteKeyIsPath(path)) {
-              if (matchPath(path, link)) {
-                //console.log('link', link)
-                //console.log('in?', link in rewriteMap)
-                //console.log(`link ${link} matched dynamic route ${dynamicRoute.path}`)
-                newPaths.push(link);
-                rewriteMap[link] = pathToLink(link, siteBasePath);
+    //console.log('rewriteMap', rewriteMap)
+    const renderPath = async (path, siteBasePath) => {
+      const url = serverLocation + path;
+      let links;
+      try {
+        console.log('get URL', url);
+        const response = await fetch(url);
+        // fetch, unlike axios, resolves on non-2xx - so check explicitly, or we'd
+        // write error pages out as static HTML
+        if (!response.ok) throwError('renderPath', `Get request to ${url} returned an invalid status: ${response.status}`);
+        let result = await response.text();
+        links = findLinks(result);
+        const newPaths = [];
+        for (const link of links) {
+          if (link.startsWith('#')) continue; // ignore anchors/hash links
+          if (!StringIsPath(link)) {
+            throwError('renderRoute', `Found a link '${link}' that did not start with /`);
+          }
+          if (!(link in rewriteMap)) {
+            for (const [path, dynamicRoute] of dynamicRoutes) {
+              if (RouteKeyIsPath(path)) {
+                if (matchPath(path, link)) {
+                  //console.log('link', link)
+                  //console.log('in?', link in rewriteMap)
+                  //console.log(`link ${link} matched dynamic route ${dynamicRoute.path}`)
+                  newPaths.push(link);
+                  rewriteMap[link] = pathToLink(link, siteBasePath);
+                }
+              } else {
+                // default
+                // 404
               }
-            } else {
-              // default
-              // 404
             }
           }
         }
+        result = rewriteLinks(result, rewriteMap);
+        //const pageFileName = rewriteMap[path]
+        const pageFileName = pathToFileName(path);
+        const dest = join(projectDir, staticSiteFolder, pageFileName);
+        const dir = dirname(dest);
+        // ensure the target folder exists
+        // some duplication of effort here - oh well
+        await fsPromises.mkdir(dir, {
+          recursive: true
+        });
+        await fsPromises.writeFile(join(projectDir, staticSiteFolder, pageFileName), result);
+        // we can update the rewrite map here
+        // for (const route of appRoutes) { // we need to develop the rewrite map over time, because we discover links during processing
+        //     const path = route.path
+        //     rewriteMap[path] = pathToFileName(path)
+        // }
+        // awaited - otherwise staticGen() can return before these pages are written
+        for (const link of newPaths) {
+          await renderPath(link, siteBasePath);
+        }
+      } catch (e) {
+        const stack = typeof e === 'object' && e !== null && 'stack' in e ? e.stack : '';
+        cliError(`Static site gen - error generating path ${path} (full location ${url}): ${String(e)} ${String(stack)}`);
       }
-      result = rewriteLinks(result, rewriteMap);
-      //const pageFileName = rewriteMap[path]
-      const pageFileName = pathToFileName(path);
-      const dest = join(projectDir, staticSiteFolder, pageFileName);
-      const dir = dirname(dest);
-      // ensure the target folder exists
-      // some duplication of effort here - oh well
-      await fsPromises.mkdir(dir, {
-        recursive: true
-      });
-      await fsPromises.writeFile(join(projectDir, staticSiteFolder, pageFileName), result);
-      // we can update the rewrite map here
-      // for (const route of appRoutes) { // we need to develop the rewrite map over time, because we discover links during processing
-      //     const path = route.path
-      //     rewriteMap[path] = pathToFileName(path)
-      // }
-      for (const link of newPaths) {
-        renderPath(link, siteBasePath);
-      }
-    } catch (e) {
-      const stack = typeof e === 'object' && e !== null && 'stack' in e ? e.stack : '';
-      cliError(`Static site gen - error generating path ${path} (full location ${url}): ${String(e)} ${String(stack)}`);
+    };
+    for (const [path, route] of Object.entries(finalRoutes)) {
+      await renderPath(path, siteBasePath);
     }
+    console.log('rewriteMap', rewriteMap);
+    const copyPromises = [fsExtra.copy(join(buildLocation, staticFolder), join(projectDir, staticSiteFolder)),
+    // assets folder
+    existsSync(join(buildLocation, assetsFolder)) ? fsExtra.copy(join(buildLocation, assetsFolder), join(projectDir, staticSiteFolder, 'assets')) : null,
+    // public files
+    existsSync(join(buildLocation, publicFolder)) ? fsExtra.copy(join(buildLocation, publicFolder), join(projectDir, staticSiteFolder)) : null,
+    // copy in the bundle
+    fsExtra.copy(join(projectDir, bundleFolder), join(projectDir, staticSiteFolder, 'bundle')),
+    // copy the client.js to clientWithEnv.js, because the framework looks for this file instead.
+    //fsExtra.copy(join(projectDir, bundleFolder, 'client.js'), join(projectDir, bundleFolder, 'clientWithEnv.js')),
+    // copy in the css
+    fsExtra.copy(join(buildLocation, componentCssFolder), join(projectDir, staticSiteFolder, componentCssFolder)), ...(existsSync(join(buildLocation, frameworkCssFolder)) ? [fsExtra.copy(join(buildLocation, frameworkCssFolder), join(projectDir, staticSiteFolder, frameworkCssFolder))] : [])];
+    await Promise.all(copyPromises);
+  } finally {
+    await server.stop();
   }
-  for (const [path, route] of Object.entries(finalRoutes)) {
-    await renderPath(path, siteBasePath);
-  }
-  console.log('rewriteMap', rewriteMap);
-  const copyPromises = [fsExtra.copy(join(buildLocation, staticFolder), join(projectDir, staticSiteFolder)),
-  // assets folder
-  existsSync(join(buildLocation, assetsFolder)) ? fsExtra.copy(join(buildLocation, assetsFolder), join(projectDir, staticSiteFolder, 'assets')) : null,
-  // public files
-  existsSync(join(buildLocation, publicFolder)) ? fsExtra.copy(join(buildLocation, publicFolder), join(projectDir, staticSiteFolder)) : null,
-  // copy in the bundle
-  fsExtra.copy(join(projectDir, bundleFolder), join(projectDir, staticSiteFolder, 'bundle')),
-  // copy the client.js to clientWithEnv.js, because the framework looks for this file instead.
-  //fsExtra.copy(join(projectDir, bundleFolder, 'client.js'), join(projectDir, bundleFolder, 'clientWithEnv.js')),
-  // copy in the css
-  fsExtra.copy(join(buildLocation, componentCssFolder), join(projectDir, staticSiteFolder, componentCssFolder))];
-  await Promise.all(copyPromises);
 }

package/dist/testing/installTestStyleProcessors.d.ts

@@ -0,0 +1,2 @@
+export declare function installTestStyleProcessors(moduleName?: string): void;
+//# sourceMappingURL=installTestStyleProcessors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"installTestStyleProcessors.d.ts","sourceRoot":"","sources":["../../src/testing/installTestStyleProcessors.ts"],"names":[],"mappings":"AAeA,wBAAgB,0BAA0B,CAAC,UAAU,SAAS,GAAG,IAAI,CAMpE"}

package/dist/testing/installTestStyleProcessors.js

@@ -0,0 +1,21 @@
+import { CssNames } from "../CssNames.js";
+// The style processors are compiled away by babel-plugin-css-to-js in an app
+// build. Tungsten's own build deliberately leaves them alone — transforming
+// here would emit the stylesheet into the framework's output instead of the
+// consuming app's — so the globals are absent when tungsten tests its own
+// components, and constructing one throws `Sass is not defined`.
+//
+// Empty name maps make this a no-op rather than a partial implementation:
+// styleContentSxy only rewrites a class it holds a scoped name for, so markup
+// renders with the class names exactly as authored. Tests asserting on
+// `.surface` or `.toolbar` therefore see what the component wrote.
+//
+// Styles themselves are not applied. Asserting on computed style needs the
+// compiled stylesheet in the test document, which this does not provide.
+export function installTestStyleProcessors(moduleName = 'test') {
+  const processor = () => new CssNames(moduleName);
+  globalThis.Css = processor;
+  globalThis.Sass = processor;
+  globalThis.Scss = processor;
+  globalThis.ReactZoneScss = processor;
+}

package/dist/testing/temp/componentPackageMock.d.ts

@@ -0,0 +1,18 @@
+import type { ConstructPackage } from '../../Components.jsx';
+import type { GlobalData } from '../../routing/registerGlobalData.js';
+type Options = {
+    stores?: unknown[];
+    routes?: object;
+    globalData?: GlobalData;
+    location?: string;
+};
+export declare const storeValue: <Value>(initialValue: Value) => {
+    get: () => Value;
+    set: (newValue: Value) => void;
+    subscribe: () => undefined;
+    unsubscribe: () => undefined;
+    sync: () => Value;
+};
+export declare const componentPackageMock: <Props extends object>(props: Props, options?: Options) => ConstructPackage<Props, undefined>;
+export {};
+//# sourceMappingURL=componentPackageMock.d.ts.map

package/dist/testing/temp/componentPackageMock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentPackageMock.d.ts","sourceRoot":"","sources":["../../../src/testing/temp/componentPackageMock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAE5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAA;AAGrE,KAAK,OAAO,GAAG;IAGX,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;IAGlB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,KAAK,EAAE,cAAc,KAAK;;oBAI7B,KAAK;;;;CAK5B,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAI,KAAK,SAAS,MAAM,EACrD,OAAO,KAAK,EACZ,UAAS,OAAY,KACtB,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAsBlC,CAAA"}

package/dist/testing/temp/componentPackageMock.js

@@ -0,0 +1,37 @@
+export const storeValue = initialValue => {
+  let value = initialValue;
+  return {
+    get: () => value,
+    set: newValue => {
+      value = newValue;
+    },
+    subscribe: () => undefined,
+    unsubscribe: () => undefined,
+    sync: () => value
+  };
+};
+export const componentPackageMock = (props, options = {}) => ({
+  props,
+  routeParams: undefined,
+  routeData: undefined,
+  // Framework boundary: tests supply only the Instance fields components
+  // read. `satisfies Partial<Instance>` checks those we do supply against
+  // the real Instance types (catching drift), while the assertion backfills
+  // the rest.
+  // eslint-disable-next-line no-type-assertion/no-type-assertion
+  instance: {
+    //stores: options.stores ?? [],
+    // eslint-disable-next-line no-type-assertion/no-type-assertion -- test boundary supplies the reactive location field read by layouts.
+    internalStore: {
+      location: storeValue(options.location ?? '/')
+    },
+    // Route passthrough: tests supply loosely-typed route maps, narrowed
+    // to Routes here (assertion confined to this boundary).
+    // eslint-disable-next-line no-type-assertion/no-type-assertion
+    getRoutes: () => options.routes ?? {},
+    globalData: options.globalData ?? {},
+    setTitle: () => undefined,
+    storeSubscriptions: new Map()
+  },
+  parentElement: null
+});

package/dist/testing/temp/contentHtmlElements.d.ts

@@ -0,0 +1,3 @@
+import { type ContentNode, type ContentNodeHtml } from '../../ContentNode.js';
+export declare const contentHtmlElements: (content: ContentNode) => ContentNodeHtml[];
+//# sourceMappingURL=contentHtmlElements.d.ts.map

package/dist/testing/temp/contentHtmlElements.d.ts.map

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

package/dist/testing/temp/contentHtmlElements.js

@@ -0,0 +1,12 @@
+import { $props } from "../../contentNodeSymbols.js";
+import { ContentNodeIsElement, ContentNodeIsHtml } from "../../ContentNode.js";
+export const contentHtmlElements = content => {
+  if (Array.isArray(content)) {
+    return content.flatMap(contentHtmlElements);
+  }
+  if (!ContentNodeIsElement(content)) {
+    return [];
+  }
+  const descendants = contentHtmlElements(content[$props].children);
+  return ContentNodeIsHtml(content) ? [content, ...descendants] : descendants;
+};

package/dist/update/integrateUpdateVdom.d.ts.map

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