tungsten 0.4.14 → 0.5.1

package/dist/render/addImportMap.js

@@ -11,6 +11,7 @@ export function addImportMap(head, importAliases, clientImportAliases) {
   head[$props].children.unshift({
     [$type]: 'script',
     [$props]: {
+      'data--t-internal': true,
       type: 'importmap',
       //noEscape: true,
       children: [`{

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

@@ -1 +1 @@
-{"version":3,"file":"contentNodeToHtml.d.ts","sourceRoot":"","sources":["../../src/render/contentNodeToHtml.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAapD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CA+C3D"}
+{"version":3,"file":"contentNodeToHtml.d.ts","sourceRoot":"","sources":["../../src/render/contentNodeToHtml.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAapD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAgD3D"}

package/dist/render/contentNodeToHtml.js

@@ -1,4 +1,4 @@
-import { ContentNodeIsComponent } from '../ContentNode.js';
+import { ContentNodeIsComponent, ContentNodeIsFragment } from '../ContentNode.js';
 import { booleanAttributeValue } from '../booleanAttributeValue.js';
 import { $props, $type } from '../contentNodeSymbols.js';
 import { htmlEntities } from '../htmlEntities.js';
@@ -28,6 +28,7 @@ export function contentNodeToHtml(node) {
   if (node === undefined || node === null || node === false || node === true) return '';
   if (Array.isArray(node)) return node.map(contentNodeToHtml).join('');
   if (typeof node === 'string' || typeof node === 'number') return htmlEntities(node.toString());
+  if (ContentNodeIsFragment(node)) return contentNodeToHtml(node[$props].children);
   if (ContentNodeIsComponent(node)) {
     throwError('contentNodeToHtml', `component nodes are not supported - encountered one of type ` + `${String(typeof node[$type] === 'string' ? node[$type] : node[$type].name)}.`);
   }

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

@@ -1 +1 @@
-{"version":3,"file":"contentToHtml.d.ts","sourceRoot":"","sources":["../../src/render/contentToHtml.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,KAAK,EAAY,YAAY,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAIvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAG9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAGrE,wBAAsB,aAAa,CAC/B,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,aAAa,EACpE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EACxC,MAAM,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,YAAY,EACnE,iBAAiB,GAAE,sBAAkC,EAAE,GAAG,UAAQ,GACnE,OAAO,CAAC,MAAM,CAAC,CAuDjB"}
+{"version":3,"file":"contentToHtml.d.ts","sourceRoot":"","sources":["../../src/render/contentToHtml.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,KAAK,EAAY,YAAY,EAAE,MAAM,eAAe,CAAA;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAIvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAI9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAA;AAGrE,wBAAsB,aAAa,CAC/B,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,aAAa,EACpE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EACxC,MAAM,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,YAAY,EACnE,iBAAiB,GAAE,sBAAkC,EAAE,GAAG,UAAQ,GACnE,OAAO,CAAC,MAAM,CAAC,CAwDjB"}

package/dist/render/contentToHtml.js

@@ -2,6 +2,7 @@ import { renderingNodeToHtml } from './renderingTreeToHtml.js';
 import { TungstenError } from '../TungstenError.js';
 import { RenderingNodeIsElement } from '../RenderingNode.js';
 import { contentTreeToRenderingTree } from './contentTreeToRenderingTree.js';
+import { readDocInitScript } from './readDocInitScript.js';
 import { cliWarn } from 'tungsten/cliOutput.js';
 export async function contentToHtml(compilationInfo, clientImportAliases, content, instance, config, siteBasePathOverride, tungstenPublicEnv = undefined, dev = false) {
   // const rootNode = { // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion 
@@ -25,7 +26,8 @@ export async function contentToHtml(compilationInfo, clientImportAliases, conten
     tungstenPublicEnv,
     siteBasePath: siteBasePathOverride,
     hmr: config.hmr,
-    csr: config.csr
+    csr: config.csr,
+    docInitScript: readDocInitScript(compilationInfo.buildLocation)
   };
   //console.log('rendering tree', inspect(tree, { depth: 99 } ))
   let html = await renderingNodeToHtml(tree, false, headData, null);

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

@@ -1 +1 @@
-{"version":3,"file":"contentTreeToRenderingTree.d.ts","sourceRoot":"","sources":["../../src/render/contentTreeToRenderingTree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EACH,KAAK,WAAW,EAEnB,MAAM,mBAAmB,CAAA;AAS1B,wBAAsB,0BAA0B,CAC5C,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,GAAG,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAC9F,OAAO,CAAC,aAAa,CAAC,CA2EzB"}
+{"version":3,"file":"contentTreeToRenderingTree.d.ts","sourceRoot":"","sources":["../../src/render/contentTreeToRenderingTree.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACxD,OAAO,EACH,KAAK,WAAW,EAEnB,MAAM,mBAAmB,CAAA;AAS1B,wBAAsB,0BAA0B,CAC5C,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE,YAAY,GAAG,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAC9F,OAAO,CAAC,aAAa,CAAC,CAgFzB"}

package/dist/render/contentTreeToRenderingTree.js

@@ -1,4 +1,4 @@
-import { ContentNodeIsLiteral, ContentNodeElementIsComponent, ContentNodeElementIsHtml } from '../ContentNode.js';
+import { ContentNodeIsLiteral, ContentNodeElementIsComponent, ContentNodeElementIsHtml, ContentNodeIsFragment } from '../ContentNode.js';
 import { validChildren } from '../validChildren.js';
 import { debug } from './debug.js';
 import { throwError } from '../throwError.js';
@@ -25,6 +25,10 @@ export async function contentTreeToRenderingTree(node, parentComponent, instance
   if (ContentNodeIsLiteral(node)) {
     return node.toString();
   }
+  // a fragment renders as its children; the rendering tree never holds one
+  if (ContentNodeIsFragment(node)) {
+    return contentTreeToRenderingTree(node[$props].children, parentComponent, instance, noEscape);
+  }
   debug('typeof type', typeof node[$type]);
   if (ContentNodeElementIsHtml(node)) {
     processHtmlNode(node);

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

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

package/dist/render/processHead.js

@@ -6,7 +6,11 @@ import { windowGlobalEnvStatement } from 'tungsten/env/windowGlobalEnvStatement.
 import { devErrorPageClearRetryScript } from '../Servers/devErrorPageAutoRetry.js';
 // process the tree returned by the root component
 // doing things like ensuring there is are html and head elements,
-// and adding necessary style and script tags
+// and adding necessary style and script tags.
+// Every node added here is unshifted in front of the app's own head children and carries
+// data--t-internal (a bare attribute: a true value renders as one), which is how hydration and
+// updates find where the app's children start (appHeadChildrenStart). data--t-persist marks the
+// ones a head re-created on the client keeps.
 export function processHead(headNode, headData) {
   const {
     instance,
@@ -22,7 +26,7 @@ export function processHead(headNode, headData) {
   headNode[$props].children.unshift({
     [$type]: 'link',
     [$props]: {
-      'data--t-internal': undefined,
+      'data--t-internal': true,
       'data--t-persist': true,
       rel: 'stylesheet',
       href: `${siteBasePath}/${componentCssFolder}/${componentCssFile}`
@@ -33,7 +37,7 @@ export function processHead(headNode, headData) {
     headNode[$props].children.unshift({
       [$type]: 'link',
       [$props]: {
-        'data--t-internal': undefined,
+        'data--t-internal': true,
         'data--t-persist': true,
         rel: 'stylesheet',
         href: `${siteBasePath}${frameworkCss}`
@@ -44,19 +48,29 @@ export function processHead(headNode, headData) {
   const scriptNode = {
     [$type]: 'script',
     [$props]: {
-      'data--t-internal': undefined,
+      'data--t-internal': true,
       src: dev ? `/${clientFolder}/client.js` : `${siteBasePath}/bundle/clientWithEnv.js`
     }
   };
   if (dev) scriptNode[$props].type = 'module';else scriptNode[$props].defer = true;
   headNode[$props].children.unshift(scriptNode);
+  // DocInit functions: a sync inline script, so they run before <body> and before the entry
+  if (headData.docInitScript !== undefined) {
+    headNode[$props].children.unshift({
+      [$type]: 'script',
+      [$props]: {
+        'data--t-internal': true,
+        children: headData.docInitScript
+      }
+    });
+  }
   // public env
   if (dev) {
     if (headData.tungstenPublicEnv !== undefined) {
       const envScriptNode = {
         [$type]: 'script',
         [$props]: {
-          'data--t-internal': undefined,
+          'data--t-internal': true,
           children: windowGlobalEnvStatement('tungstenPublicEnv', headData.tungstenPublicEnv)
         }
       };
@@ -68,7 +82,7 @@ export function processHead(headNode, headData) {
     const cjsHelpersScriptNode = {
       [$type]: 'script',
       [$props]: {
-        'data--t-internal': undefined,
+        'data--t-internal': true,
         src: `${siteBasePath}/${clientFolder}/cjsHelpers.js`
       }
     };
@@ -81,7 +95,7 @@ export function processHead(headNode, headData) {
     const clearErrorRetryScriptNode = {
       [$type]: 'script',
       [$props]: {
-        'data--t-internal': undefined,
+        'data--t-internal': true,
         children: devErrorPageClearRetryScript
       }
     };
@@ -93,7 +107,7 @@ export function processHead(headNode, headData) {
       const liveReloadScriptNode = {
         [$type]: 'script',
         [$props]: {
-          'data--t-internal': undefined,
+          'data--t-internal': true,
           type: 'module',
           src: `${siteBasePath}/${clientFolder}/${hmr === true ? 'hmr.js' : 'liveReload.js'}`
         }
@@ -117,6 +131,7 @@ export function processHead(headNode, headData) {
   const varsScriptNode = {
     [$type]: 'script',
     [$props]: {
+      'data--t-internal': true,
       children: varsScriptContent
     }
   };
@@ -124,14 +139,15 @@ export function processHead(headNode, headData) {
   const contentTypeMetaNode = {
     [$type]: 'meta',
     [$props]: {
-      'data--t-internal': undefined,
+      'data--t-internal': true,
       'data--t-persist': true,
       'http-equiv': 'Content-Type',
       content: 'text/html; charset=utf-8'
     }
   };
   headNode[$props].children.unshift(contentTypeMetaNode);
-  // we get in here and shift any elements marked with a "before" prop to the top,
-  // to let them run before others
+  // Idea, not built (2023): a "before" prop on an app head child would hoist it above the
+  // framework's nodes, so its script runs first. If built, appHeadChildrenStart's leading-run
+  // skip no longer holds: the app's children would then sit on both sides of the marked ones.
   if (dev) addImportMap(headNode, importAliases, clientImportAliases);
 }

package/dist/render/readDocInitScript.d.ts

@@ -0,0 +1,3 @@
+export declare function docInitFileLocation(buildLocation: string): string;
+export declare function readDocInitScript(buildLocation: string): string | undefined;
+//# sourceMappingURL=readDocInitScript.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"readDocInitScript.d.ts","sourceRoot":"","sources":["../../src/render/readDocInitScript.ts"],"names":[],"mappings":"AAKA,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEjE;AAID,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAM3E"}

package/dist/render/readDocInitScript.js

@@ -0,0 +1,15 @@
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { clientFolder, docInitFile } from '../settings.js';
+export function docInitFileLocation(buildLocation) {
+  return join(buildLocation, clientFolder, docInitFile);
+}
+// The generated head script, ready to inline; undefined when nothing uses DocInit. Read per render:
+// the dev compile rewrites the file on every change, and it is a few lines.
+export function readDocInitScript(buildLocation) {
+  const location = docInitFileLocation(buildLocation);
+  if (!existsSync(location)) return undefined;
+  const content = readFileSync(location, 'utf8').trim();
+  if (content === '') return undefined;
+  return content.replaceAll('</script', '<\\/script');
+}

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

@@ -1 +1 @@
-{"version":3,"file":"rootToHtmlDev.d.ts","sourceRoot":"","sources":["../../src/render/rootToHtmlDev.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,KAAI,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAI,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,KAAI,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAI,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAGpE,wBAAsB,aAAa,CAC/B,eAAe,EAAE,eAAe,EAAG,mBAAmB,EAAE,aAAa,EACrE,kBAAkB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EACzF,kBAAkB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,YAAY,mBAMjF"}
+{"version":3,"file":"rootToHtmlDev.d.ts","sourceRoot":"","sources":["../../src/render/rootToHtmlDev.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAC9D,OAAO,KAAI,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAC7D,OAAO,KAAI,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,KAAI,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,KAAI,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAA;AAC5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAGpE,wBAAsB,aAAa,CAC/B,eAAe,EAAE,eAAe,EAAG,mBAAmB,EAAE,aAAa,EACrE,kBAAkB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EACzF,kBAAkB,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,YAAY,mBAMjF"}

package/dist/routing/Group.d.ts

@@ -7,6 +7,6 @@ export type GroupProps = {
     data?: RouteDataFunction<any, any>;
 };
 export declare class Group extends TungstenSimpleComponent<GroupProps> {
-    content: () => string | number | boolean | import("../ContentNode.js").ContentNodeHtml | import("../ContentNode.js").ContentNodeClassComponent | import("../ContentNode.js").ContentNodeFunctionComponent | import("../ContentNode.js").ContentNodeArray | null;
+    content: () => string | number | boolean | import("../ContentNode.js").ContentNodeHtml | import("../ContentNode.js").ContentNodeClassComponent | import("../ContentNode.js").ContentNodeFunctionComponent | import("../ContentNode.js").ContentNodeFragment | import("../ContentNode.js").ContentNodeArray | null;
 }
 //# sourceMappingURL=Group.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Group.d.ts","sourceRoot":"","sources":["../../src/routing/Group.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAE/D,MAAM,MAAM,UAAU,GAAG;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,IAAI,CAAC,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CAErC,CAAA;AAED,qBAAa,KAAM,SAAQ,uBAAuB,CAAC,UAAU,CAAC;IAC1D,OAAO,yPAGN;CACJ"}
+{"version":3,"file":"Group.d.ts","sourceRoot":"","sources":["../../src/routing/Group.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAE/D,MAAM,MAAM,UAAU,GAAG;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,IAAI,CAAC,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;CAErC,CAAA;AAED,qBAAa,KAAM,SAAQ,uBAAuB,CAAC,UAAU,CAAC;IAC1D,OAAO,2SAGN;CACJ"}

package/dist/routing/MatchedRoute.d.ts

@@ -9,6 +9,6 @@ export type MatchedRouteProps = {
 };
 export declare class MatchedRoute extends TungstenSimpleInternalStoreComponent<MatchedRouteProps> {
     init: () => void;
-    content: () => string | number | boolean | import("../ContentNode.js").ContentNodeHtml | import("../ContentNode.js").ContentNodeClassComponent | import("../ContentNode.js").ContentNodeFunctionComponent | import("../ContentNode.js").ContentNodeArray | null | undefined;
+    content: () => string | number | boolean | import("../ContentNode.js").ContentNodeHtml | import("../ContentNode.js").ContentNodeClassComponent | import("../ContentNode.js").ContentNodeFunctionComponent | import("../ContentNode.js").ContentNodeFragment | import("../ContentNode.js").ContentNodeArray | null | undefined;
 }
 //# sourceMappingURL=MatchedRoute.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"MatchedRoute.d.ts","sourceRoot":"","sources":["../../src/routing/MatchedRoute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,oCAAoC,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,EAAE,WAAW,EAA0B,MAAM,mBAAmB,CAAA;AAIvE,MAAM,MAAM,iBAAiB,GAAG;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,KAAK,CAAC,EAAE,aAAa,CAAA;CACxB,CAAA;AACD,qBAAa,YAAa,SAAQ,oCAAoC,CAAC,iBAAiB,CAAC;IACrF,IAAI,aAA4C;IAChD,OAAO,qQAaN;CACJ"}
+{"version":3,"file":"MatchedRoute.d.ts","sourceRoot":"","sources":["../../src/routing/MatchedRoute.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,oCAAoC,EAAE,MAAM,mBAAmB,CAAA;AACxE,OAAO,EAAE,WAAW,EAA0B,MAAM,mBAAmB,CAAA;AAIvE,MAAM,MAAM,iBAAiB,GAAG;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,WAAW,CAAA;IACtB,KAAK,CAAC,EAAE,aAAa,CAAA;CACxB,CAAA;AACD,qBAAa,YAAa,SAAQ,oCAAoC,CAAC,iBAAiB,CAAC;IACrF,IAAI,aAA4C;IAChD,OAAO,uTAaN;CACJ"}

package/dist/settings.d.ts

@@ -21,6 +21,9 @@ 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 docInitFile = "docInit.js";
+export declare const docInitWindowKey = "__t_docInit";
+export declare const docInitErrorsWindowKey = "__t_docInitErrors";
 export declare const unusedStyleReporting: boolean;
 export declare const defaultBrowserTargets = "since 2020";
 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;AAG3E,eAAO,MAAM,iBAAiB,sBAA2B,CAAA;AACzD,eAAO,MAAM,kBAAkB,uBAA4B,CAAA;AAC3D,eAAO,MAAM,YAAY,2BAA+B,CAAA;AACxD,eAAO,MAAM,gBAAgB,yBAA8B,CAAA;AAC3D,eAAO,MAAM,mBAAmB,4BAAiC,CAAA;AACjE,eAAO,MAAM,qBAAqB,cAAc,CAAA;AAEhD,eAAO,MAAM,iBAAiB,0BAA+B,CAAA;AAC7D,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;AAIlD,eAAO,MAAM,qBAAqB,eAAe,CAAA;AAEjD,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;AAG3E,eAAO,MAAM,iBAAiB,sBAA2B,CAAA;AACzD,eAAO,MAAM,kBAAkB,uBAA4B,CAAA;AAC3D,eAAO,MAAM,YAAY,2BAA+B,CAAA;AACxD,eAAO,MAAM,gBAAgB,yBAA8B,CAAA;AAC3D,eAAO,MAAM,mBAAmB,4BAAiC,CAAA;AACjE,eAAO,MAAM,qBAAqB,cAAc,CAAA;AAEhD,eAAO,MAAM,iBAAiB,0BAA+B,CAAA;AAC7D,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,WAAW,eAAe,CAAA;AACvC,eAAO,MAAM,gBAAgB,gBAAgB,CAAA;AAC7C,eAAO,MAAM,sBAAsB,sBAAsB,CAAA;AAEzD,eAAO,MAAM,oBAAoB,EAAE,OAAe,CAAA;AAIlD,eAAO,MAAM,qBAAqB,eAAe,CAAA;AAEjD,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

@@ -26,6 +26,10 @@ export const componentCssFile = 'ccss.css';
 export const frameworkCssFolder = '.tungstenCss';
 export const frameworkCssFile = 'tungsten.css';
 export const packagesFolder = '.packages';
+// the head script BabelTransformDocInit generates, in clientFolder; the window key its entries live under
+export const docInitFile = 'docInit.js';
+export const docInitWindowKey = '__t_docInit';
+export const docInitErrorsWindowKey = '__t_docInitErrors';
 export const unusedStyleReporting = false;
 // the production bundle's browser floor when the config sets no `targets`: a browserslist query
 // for every browser version released since 2020. Dev applies no floor at all.

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

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

package/dist/style/styleContentSxy.js

@@ -1,5 +1,5 @@
 import { count } from 'sxy-lib/objects.js';
-import { ContentNodeElementIsHtml, ContentNodeElementIsComponent } from '../ContentNode.js';
+import { ContentNodeElementIsHtml, ContentNodeElementIsComponent, ContentNodeIsFragment } from '../ContentNode.js';
 import { warn } from '../output.js';
 import { TungstenError } from '../TungstenError.js';
 import { componentBumpClass } from '../componentClassName.js';
@@ -44,6 +44,11 @@ function processItem(element, styles, usage) {
     }
     return;
   }
+  // a fragment gets no class of its own; its children are styled as if they sat in its place
+  if (ContentNodeIsFragment(element)) {
+    processItem(element[$props].children, styles, usage);
+    return;
+  }
   debug('Element must be an element. Type: ', typeof element);
   // element is a ContentNodeElement
   let tagName;

package/dist/testing/installTestDocInit.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"installTestDocInit.d.ts","sourceRoot":"","sources":["../../src/testing/installTestDocInit.ts"],"names":[],"mappings":"AAGA,wBAAgB,kBAAkB,IAAI,IAAI,CAGzC"}

package/dist/testing/installTestDocInit.js

@@ -0,0 +1,6 @@
+// DocInit is compiled away by BabelTransformDocInit in an app build. Tests run tsc output, where
+// the global is the throwing stand-in docInit.ts installs. This makes the same split the compiled
+// form does: run the function where a document exists, else hand back the server value.
+export function installTestDocInit() {
+  globalThis.DocInit = (fn, serverValue) => typeof document !== 'undefined' ? fn() : serverValue; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- the void overload has no server value
+}

package/dist/throwError.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"throwError.d.ts","sourceRoot":"","sources":["../src/throwError.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAEnE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE"}
+{"version":3,"file":"throwError.d.ts","sourceRoot":"","sources":["../src/throwError.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAKnE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAErE"}

package/dist/throwError.js

@@ -1,7 +1,10 @@
 import { TungstenError } from './TungstenError.js';
 import { packageNameCapitalized } from './settings.js';
 export function throwError(location, message) {
-  throw new TungstenError(errorMessage(location, message));
+  const error = new TungstenError(errorMessage(location, message));
+  // V8 only (Chrome, Node): start the stack at the caller, not here. Elsewhere the frame stays.
+  Error.captureStackTrace?.(error, throwError); // eslint-disable-line @typescript-eslint/no-unnecessary-condition -- absent outside V8
+  throw error;
 }
 export function errorMessage(location, message) {
   return `${packageNameCapitalized} ${location} error: ${message}`;

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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"}

package/dist/update/integrateUpdateVdom.js

@@ -1,7 +1,8 @@
 import { IsHTMLElement } from '../DomNodes.js';
 import { DomRegion } from '../DomRegion.js';
 import { DomPointer } from '../DomPointer.js';
-import { ContentNodeComponentIsClassComponent, ContentNodeIsNonRendered, ContentNodeIsLiteral, ContentNodeIsHtml, ContentNodeIsComponent, ContentNodeIsArray, ContentNodeIsElement, ContentNodeElementHasValidKey } from '../ContentNode.js';
+import { appHeadChildrenStart } from '../headChildren.js';
+import { ContentNodeComponentIsClassComponent, ContentNodeIsNonRendered, ContentNodeIsLiteral, ContentNodeIsHtml, ContentNodeIsComponent, ContentNodeIsArray, ContentNodeIsFragment, ContentNodeIsElement, ContentNodeElementHasValidKey } from '../ContentNode.js';
 import { StringIsHtmlEvent, htmlEvents } from '../htmlEvents.js';
 import { out, warn } from '../appOutput.js';
 import { getStyledContentFromFunctionComponent } from '../getStyledContentFromFunctionComponent.js';
@@ -207,6 +208,17 @@ export async function applyUpdate({
     debug('DD delete node because current node is non rendered');
     deleteNodeIfRendered(oldNode);
     return makeRenderedContentNodeNonRendered();
+  } else if (ContentNodeIsFragment(newNode)) {
+    // a fragment is its children to the reconciler; the rendered side never holds one
+    return applyUpdate({
+      tungstenElement,
+      instance,
+      newNode: newNode[$props].children,
+      oldNode,
+      domRegion,
+      domPointer,
+      parentNode
+    });
   } else if (ContentNodeIsArray(newNode)) {
     //newNode
     debug('*** Content node is array');
@@ -417,7 +429,8 @@ export async function applyUpdate({
     if (WideRenderedContentNodeIsHtml(oldNode)) {
       debug('node types', newNode[$type].toLocaleLowerCase(), oldNode[$type].toLocaleLowerCase(), newNode[$type].toLocaleLowerCase() === oldNode[$type].toLocaleLowerCase());
     }
-    if (WideRenderedContentNodeIsHtml(oldNode) && newNode[$type].toLocaleLowerCase() === oldNode[$type].toLocaleLowerCase()) {
+    if (WideRenderedContentNodeIsHtml(oldNode) && newNode[$type].toLocaleLowerCase() === oldNode[$type].toLocaleLowerCase() && oldNode[$key] === newNode[$key] // a changed, gained or lost key is a new element
+    ) {
       return updateHtmlElement(tungstenElement, instance, newNode, oldNode, domPointer);
     } else {
       //console.log('deleting node and creating html', newNode[$type], oldNode)
@@ -429,7 +442,12 @@ export async function applyUpdate({
     }
   } else if (ContentNodeIsComponent(newNode)) {
     //console.log('Comp A', WideRenderedContentNodeIsComponent(oldNode))
-    if (WideRenderedContentNodeIsComponent(oldNode) && newNode[$type] === oldNode[$type] && (oldNode[$key] !== undefined && newNode[$key] !== undefined || oldNode[$key] === newNode[$key])) {
+    if (WideRenderedContentNodeIsComponent(oldNode) && newNode[$type] === oldNode[$type] &&
+    // this code survived for years without issue
+    // but probably the simple equality check below is right
+    // (oldNode[$key] !== undefined && newNode[$key] !== undefined)
+    // || oldNode[$key] === newNode[$key]
+    oldNode[$key] === newNode[$key]) {
       //console.log('updating tu el', newNode, oldNode[$key], newNode[$key])
       // update
       return updateComponent({
@@ -490,7 +508,8 @@ async function updateHtmlElement(tungstenElement, instance, newNode, oldNode, do
     newNode: newChildren,
     oldNode: oldChildren,
     domRegion: new DomRegion(domNode),
-    domPointer: new DomPointer(domNode, 0),
+    // the head's children start past what the server added to it
+    domPointer: new DomPointer(domNode, newNode[$type] === 'head' ? appHeadChildrenStart(domNode) : 0),
     parentNode: newNode
   });
   // Reapply the controlled value after reconciling the options. Updating the
@@ -639,6 +658,14 @@ async function createNode({
   if (ContentNodeIsNonRendered(newNode)) {
     debug('node is NonRendered');
     return makeRenderedContentNodeNonRendered();
+  } else if (ContentNodeIsFragment(newNode)) {
+    return createNode({
+      tungstenElement,
+      instance,
+      newNode: newNode[$props].children,
+      domPointer,
+      parentNode
+    });
   } else if (ContentNodeIsArray(newNode)) {
     debug('node is array');
     const renderedNodes = [];
@@ -1293,6 +1320,17 @@ async function updateClassComponent({
   // not fire: the component did not update.
   //console.log('old props', element.props)
   //console.log('new props', newNode[$props])
+  // an opaque class (static __opaque) renders once and then owns its dom: its parent never
+  // re-renders it, and its region is measured live because hand-added nodes change its length
+  if (element.constructor.__opaque === true) {
+    // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- the static declared on TungstenBaseComponent
+    markRendered(element);
+    const length = element.__domRegion?.length();
+    if (length !== undefined) {
+      domPointer.increment(length);
+      return oldNode;
+    }
+  }
   if (propsAreEqual(element.props, newNode[$props], renderedAt(element))) {
     if (tracing()) trace('SKIP', element.constructor.name, '(props unchanged since tick', renderedAt(element), ')');
     // the dom is current for these props, so the baseline moves with it -- otherwise a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tungsten",
-  "version": "0.4.14",
+  "version": "0.5.1",
   "description": "",
   "type": "module",
   "bin": {
@@ -38,6 +38,7 @@
     "@babel/preset-react": "^7.28.5",
     "@babel/preset-typescript": "^7.29.7",
     "@babel/types": "^7.29.0",
+    "@jridgewell/trace-mapping": "^0.3.31",
     "@rollup/plugin-babel": "^6.1.0",
     "@rollup/plugin-commonjs": "^28.0.9",
     "@rollup/plugin-json": "^6.1.0",

package/readme.md

@@ -2,139 +2,6 @@
 
 [Docs](https://robertsandiford.co.uk/tungsten)
 
-## Component testing
+## Agents
 
-Test-specific APIs are available from `tungsten/testing` and are not exported
-from Tungsten's main entry point. A test project supplies its own DOM
-implementation, such as happy-dom or jsdom:
-
-```tsx
-import { Window } from 'happy-dom'
-import { createTestApp } from 'tungsten/testing'
-
-describe('RootComponent', () => {
-    it('responds to a button click', async () => {
-        const window = new Window()
-        const testApp = await createTestApp(RootComponent, {
-            document: window.document as unknown as Document,
-            props: { initialName: 'Robert' },
-            location: '/',
-        })
-
-        try {
-            const button = testApp.container.querySelector('button')
-            expect(button).not.toBeNull()
-
-            button!.dispatchEvent(new window.Event('click') as unknown as Event)
-            await testApp.resolved()
-
-            expect(testApp.container.textContent).toContain('Robert')
-        } finally {
-            await testApp.unmount()
-        }
-    })
-})
-```
-
-The casts are only needed when a DOM package publishes types which are not
-structurally compatible with the TypeScript DOM library version used by the
-test project.
-
-`createTestApp()` completes the initial client render before returning.
-`resolved()` subsequently waits for Tungsten updates, DOM reconciliation,
-lifecycle-triggered updates, and promises returned by registered event
-handlers. It does not wait for unrelated timers, network requests, or promises
-which the application has not returned to Tungsten.
-
-An automatically created container is appended to the supplied document body
-and removed by `unmount()`. A caller-supplied container must be empty; it is
-emptied but retained during unmount.
-
-Registered stores are created independently for each test application. Use
-`testStore()` to initialize one before the root component starts:
-
-```ts
-import { createTestApp, testStore } from 'tungsten/testing'
-
-const testApp = await createTestApp(RootComponent, {
-    document,
-    stores: [testStore(userStore, store => {
-        store.user.set(mockUser)
-    })],
-})
-```
-
-Tests containing Tungsten JSX must be compiled through `tungsten compile` so
-they use Tungsten's JSX runtime and application transforms.
-
-## Preparing code for tests
-
-Run a one-shot development compilation without starting a server:
-
-```sh
-tungsten compile
-```
-
-By default this compiles JavaScript (including JSX and Tungsten's Babel
-transforms), stylesheets, client support files, assets, and public files into
-`.tungsten/dev`.
-Each selected target's existing generated output is cleaned before the initial
-compilation, including when watch mode is used. Pass `--no-clean` to preserve
-existing output.
-
-Use `--output` to select an independent output root. The layout below that root
-is the same as `.tungsten/dev`, including `code`, `.client`, `.static`,
-`.assets`, `.public`, `.componentCss`, and `.packages`:
-
-```sh
-tungsten compile --output .tungsten/test
-tungsten compile --output .tungsten/test --watch
-```
-
-Cleaning and generated package-cache data are scoped to the selected output.
-Limit the work with one or more options:
-
-```sh
-tungsten compile --js
-tungsten compile --css
-tungsten compile --client
-tungsten compile --assets
-tungsten compile --public
-tungsten compile --js --css
-```
-
-`--all` explicitly selects all five targets.
-
-Add `--watch` to keep the JavaScript, stylesheet, asset, and/or public-file
-compiler running after the initial pass. Client support files are still
-generated once:
-
-```sh
-tungsten compile --watch
-tungsten compile --js --watch
-```
-
-For process orchestration, `--ready-file <file>` writes a small JSON file only
-after the initial compilation succeeds. A failed JavaScript watch cycle removes
-the file, and a later successful cycle recreates it. `--quiet` suppresses
-per-file transformation messages while retaining errors and cycle status:
-
-```sh
-tungsten compile --watch --output .tungsten/test \
-  --ready-file .tungsten/test.ready --quiet
-```
-
-## Preserving package imports in selected files
-
-Use `skipPackageCompilation` in `tungsten.config.js` for files that should be
-transformed and emitted without Tungsten traversing or copying their package
-dependencies. Bare package imports in matching files are left unchanged:
-
-```js
-export default {
-    skipPackageCompilation: '**/*.domTest.js'
-}
-```
-
-The option accepts one glob or an array of globs. Patterns match the actual
-JavaScript files received by Tungsten; extensions are not translated.
+If you are an agent, read [AGENTS.md](AGENTS.md)