tungsten 0.4.14 → 0.5.1

package/dist/frameworkConfigSchema.d.ts

@@ -8,7 +8,6 @@ export declare const frameworkConfigValidator: v.VariantSchema<"useRootComponent
     readonly rootComponent: v.StringSchema<undefined>;
     readonly codeDir: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly copy: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly exclude: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly copyExclude: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly sourceDir: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly typescript: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
@@ -39,12 +38,16 @@ export declare const frameworkConfigValidator: v.VariantSchema<"useRootComponent
     readonly serverMiddleware: v.ExactOptionalSchema<v.TupleSchema<[v.StringSchema<undefined>, v.StringSchema<undefined>, v.StringSchema<undefined>], undefined>, undefined>;
     readonly apiRoutes: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly apiPath: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly suppressNoHeadWarning: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly suppressOriginMismatchWarning: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly suppressEnvOverwriteWarnings: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly warnOnFrameworkChange: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly hmr: v.ExactOptionalSchema<v.UnionSchema<[v.BooleanSchema<undefined>, v.LiteralSchema<"reload", undefined>], undefined>, undefined>;
     readonly csr: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
 }, undefined>, v.ObjectSchema<{
     readonly useRootComponent: v.LiteralSchema<false, undefined>;
     readonly codeDir: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly copy: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
-    readonly exclude: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly copyExclude: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly sourceDir: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly typescript: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
@@ -75,7 +78,13 @@ export declare const frameworkConfigValidator: v.VariantSchema<"useRootComponent
     readonly serverMiddleware: v.ExactOptionalSchema<v.TupleSchema<[v.StringSchema<undefined>, v.StringSchema<undefined>, v.StringSchema<undefined>], undefined>, undefined>;
     readonly apiRoutes: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
     readonly apiPath: v.ExactOptionalSchema<v.StringSchema<undefined>, undefined>;
+    readonly suppressNoHeadWarning: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly suppressOriginMismatchWarning: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly suppressEnvOverwriteWarnings: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly warnOnFrameworkChange: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
+    readonly hmr: v.ExactOptionalSchema<v.UnionSchema<[v.BooleanSchema<undefined>, v.LiteralSchema<"reload", undefined>], undefined>, undefined>;
     readonly csr: v.ExactOptionalSchema<v.BooleanSchema<undefined>, undefined>;
 }, undefined>], undefined>;
 export type FrameworkConfig = v.InferOutput<typeof frameworkConfigValidator>;
+export declare function unknownConfigKeys(config: unknown): string[];
 //# sourceMappingURL=frameworkConfigSchema.d.ts.map

package/dist/frameworkConfigSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frameworkConfigSchema.d.ts","sourceRoot":"","sources":["../src/frameworkConfigSchema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGnD,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAI5B,MAAM,WAAW,YAAa,SAAQ,kBAAkB;CAAG;AAwE3D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAGnC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA"}
+{"version":3,"file":"frameworkConfigSchema.d.ts","sourceRoot":"","sources":["../src/frameworkConfigSchema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,IAAI,kBAAkB,EAAE,MAAM,eAAe,CAAA;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAGnD,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAI5B,MAAM,WAAW,YAAa,SAAQ,kBAAkB;CAAG;AA6E3D,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAGnC,CAAA;AAEF,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAO5E,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,EAAE,CAG3D"}

package/dist/frameworkConfigSchema.js

@@ -9,7 +9,6 @@ const stringOrStrings = v.union([v.string(), v.array(v.string())]);
 const frameworkConfigBaseEntries = {
   codeDir: v.exactOptional(v.string()),
   copy: v.exactOptional(v.string()),
-  exclude: v.exactOptional(v.string()),
   copyExclude: v.exactOptional(v.string()),
   sourceDir: v.exactOptional(v.string()),
   // compile .ts/.tsx in codeDir directly (babel strips types); the app keeps only a type checker
@@ -50,6 +49,12 @@ const frameworkConfigBaseEntries = {
   serverMiddleware: v.exactOptional(v.tuple([v.string(), v.string(), v.string()])),
   apiRoutes: v.exactOptional(v.string()),
   apiPath: v.exactOptional(v.string()),
+  suppressNoHeadWarning: v.exactOptional(v.boolean()),
+  suppressOriginMismatchWarning: v.exactOptional(v.boolean()),
+  suppressEnvOverwriteWarnings: v.exactOptional(v.boolean()),
+  // accepted but not on the public config type: a framework developer's switch
+  warnOnFrameworkChange: v.exactOptional(v.boolean()),
+  hmr: v.exactOptional(v.union([v.boolean(), v.literal('reload')])),
   csr: v.exactOptional(v.boolean())
 };
 const frameworkConfigWithRootComponentSchema = v.object({
@@ -63,4 +68,11 @@ const frameworkConfigWithoutRootComponentSchema = v.object({
 });
 // variant, not union: a plain union reports one issue at the union itself ("Expected Object but
 // received Object"), where this picks the branch by useRootComponent and reports its actual fields
-export const frameworkConfigValidator = v.variant('useRootComponent', [frameworkConfigWithRootComponentSchema, frameworkConfigWithoutRootComponentSchema]);
+export const frameworkConfigValidator = v.variant('useRootComponent', [frameworkConfigWithRootComponentSchema, frameworkConfigWithoutRootComponentSchema]);
+// v.object drops keys it does not list rather than rejecting them - right for a config that may
+// carry another tool's entries, but a typo or a removed key then vanishes silently, so name them
+const knownConfigKeys = new Set([...Object.keys(frameworkConfigBaseEntries), 'useRootComponent', 'rootComponent']);
+export function unknownConfigKeys(config) {
+  if (typeof config !== 'object' || config === null) return [];
+  return Object.keys(config).filter(key => !knownConfigKeys.has(key));
+}

package/dist/getUserConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getUserConfig.d.ts","sourceRoot":"","sources":["../src/getUserConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAOxF,wBAAsB,aAAa,CAC/B,SAAS,GAAE,wBAAwB,GAAG,IAAW,EACjD,MAAM,GAAE,QAAQ,GAAG,OAAiB,GACrC,OAAO,CAAC,uBAAuB,CAAC,CAsBlC"}
+{"version":3,"file":"getUserConfig.d.ts","sourceRoot":"","sources":["../src/getUserConfig.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAA;AAOxF,wBAAsB,aAAa,CAC/B,SAAS,GAAE,wBAAwB,GAAG,IAAW,EACjD,MAAM,GAAE,QAAQ,GAAG,OAAiB,GACrC,OAAO,CAAC,uBAAuB,CAAC,CA2BlC"}

package/dist/getUserConfig.js

@@ -1,9 +1,9 @@
 import { defaultConfig } from './defaultConfig.js';
 import { findUserConfig } from './findUserConfig.js';
-import { frameworkConfigValidator } from './frameworkConfigSchema.js';
+import { frameworkConfigValidator, unknownConfigKeys } from './frameworkConfigSchema.js';
 import { makeFinalConfig } from './makeFinalConfig.js';
 import { throwError } from './throwError.js';
-import { cliOut } from './cliOutput.js';
+import { cliOut, cliWarn } from './cliOutput.js';
 import { validate } from './standardSchema.js';
 export async function getUserConfig(overrides = null, volume = 'noisy') {
   const userConfigOrNull = await findUserConfig(process.cwd(), volume);
@@ -15,6 +15,11 @@ export async function getUserConfig(overrides = null, volume = 'noisy') {
       cliOut('Config', userConfig);
       throwError('Your tungsten config did not match the required format', '\n' + result.problems);
     }
+    // the validator drops what it does not list: say so, as a typo would otherwise vanish
+    const unknownKeys = unknownConfigKeys(userConfig.data);
+    if (unknownKeys.length > 0 && volume !== 'silent') {
+      cliWarn(`tungsten config: ignoring unknown ${unknownKeys.length === 1 ? 'key' : 'keys'} ${unknownKeys.join(', ')}`);
+    }
     const finalConfig = makeFinalConfig(result.value, overrides);
     //console.log('finalConfig', finalConfig)
     return finalConfig;

package/dist/headChildren.d.ts

@@ -0,0 +1,2 @@
+export declare function appHeadChildrenStart(head: HTMLElement): number;
+//# sourceMappingURL=headChildren.d.ts.map

package/dist/headChildren.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headChildren.d.ts","sourceRoot":"","sources":["../src/headChildren.ts"],"names":[],"mappings":"AAKA,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAW9D"}

package/dist/headChildren.js

@@ -0,0 +1,16 @@
+// processHead unshifts everything the framework adds to the head in front of the app's own
+// children, each marked data--t-internal (or data--t-persist, for what a re-created head keeps);
+// dev banners are appended after them. The app's children are the contiguous run in between,
+// and this is its start - where hydration matches them and where an update's pointer begins
+export function appHeadChildrenStart(head) {
+  const children = head.childNodes;
+  let index = 0;
+  while (index < children.length) {
+    const child = children[index];
+    if (child.nodeType !== 1) break;
+    const element = child; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- nodeType 1 is an element
+    if (!element.hasAttribute('data--t-internal') && !element.hasAttribute('data--t-persist')) break;
+    index++;
+  }
+  return index;
+}

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

@@ -1 +1 @@
-{"version":3,"file":"hydrate.d.ts","sourceRoot":"","sources":["../../src/hydrate/hydrate.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAQnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAmBxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAM7C,OAAO,EACH,yBAAyB,EAC5B,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAmBlD,OAAO,EAC4B,KAAK,uBAAuB,EAC9D,MAAM,oCAAoC,CAAA;AAQ3C,OAAO,0BAA0B,CAAA;AASjC,MAAM,MAAM,WAAW,GAAG;IACtB,UAAU,EAAE,OAAO,CAAA;IACnB,UAAU,EAAE,uBAAuB,EAAE,CAAA;IAGrC,WAAW,EAAE,OAAO,CAAA;CACvB,CAAA;AACD,wBAAgB,sBAAsB,IAAI,WAAW,CAEpD;AAID,wBAAsB,OAAO,CACzB,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,yBAAyB,GAAG,IAAI,EAC/C,cAAc,EAAE,cAAc,iBA2DjC;AAyBD,wBAAsB,oBAAoB,CACtC,aAAa,SAAS,yBAAyB,CAAC,GAAG,EAAE,GAAG,CAAC,EAEzD,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,WAAW,EAIjB,KAAK,GAAE,YAAY,CAAC,aAAa,CAAC,CAAC,OAAO,CAAM,EAAE,sJAAsJ;AACxM,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,SAAS,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CA6DtC"}
+{"version":3,"file":"hydrate.d.ts","sourceRoot":"","sources":["../../src/hydrate/hydrate.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAQnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAmBxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAO7C,OAAO,EACH,yBAAyB,EAC5B,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAmBlD,OAAO,EAC4B,KAAK,uBAAuB,EAC9D,MAAM,oCAAoC,CAAA;AAS3C,OAAO,0BAA0B,CAAA;AASjC,MAAM,MAAM,WAAW,GAAG;IACtB,UAAU,EAAE,OAAO,CAAA;IACnB,UAAU,EAAE,uBAAuB,EAAE,CAAA;IAGrC,WAAW,EAAE,OAAO,CAAA;CACvB,CAAA;AACD,wBAAgB,sBAAsB,IAAI,WAAW,CAEpD;AAID,wBAAsB,OAAO,CACzB,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,yBAAyB,GAAG,IAAI,EAC/C,cAAc,EAAE,cAAc,iBAgEjC;AAyBD,wBAAsB,oBAAoB,CACtC,aAAa,SAAS,yBAAyB,CAAC,GAAG,EAAE,GAAG,CAAC,EAEzD,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,WAAW,EAIjB,KAAK,GAAE,YAAY,CAAC,aAAa,CAAC,CAAC,OAAO,CAAM,EAAE,sJAAsJ;AACxM,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,SAAS,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CA6DtC"}

package/dist/hydrate/hydrate.js

@@ -1,9 +1,10 @@
 import { applyUpdate, integrateElementUpdateVdom } from '../update/integrateUpdateVdom.js';
 //import type { RouteType } from '../routing/RouteType.js'
 import { $number, $string, makeRenderedContentNodeNonRendered, makeRenderedContentNodeClassComponent, makeRenderedContentNodeFunctionComponent } from '../RenderedContentNode.js';
-import { ContentNodeElementIsHtml, ContentNodeIsHtml, ContentNodeIsComponent, ContentNodeComponentIsClassComponent, ContentNodeIsElement } from '../ContentNode.js';
+import { ContentNodeElementIsHtml, ContentNodeIsHtml, ContentNodeIsComponent, ContentNodeComponentIsClassComponent, ContentNodeIsFragment, ContentNodeIsElement } from '../ContentNode.js';
 import { IsHTMLElement } from '../DomNodes.js';
 import { DomPointer } from '../DomPointer.js';
+import { appHeadChildrenStart } from '../headChildren.js';
 import { DomRegion } from '../DomRegion.js';
 //import { FunctionComponent } from '../FunctionComponent.js'
 import { FunctionElement } from '../FunctionComponentStandIn.js';
@@ -31,6 +32,7 @@ import { reconcileHydratedAttributes } from './reconcileHydratedAttributes.js';
 import { markOptionSelected } from '../markOptionSelected.js';
 import { renderHydrationMismatchBanner } from './renderHydrationMismatchBanner.js';
 import { setCurrentInstance } from '../hmr/instanceRegistry.js';
+import { renderDocInitErrorBanner } from '../docInit.js';
 // side-effect only: pulls applyHmrModule.js (and its clean, non-dynamic-import dependencies)
 // into the framework's traced dependency graph so it gets copied to .packages/ and is servable
 // to the browser. It is invoked from a raw, untraced inline script (processHead.ts) instead of
@@ -52,6 +54,9 @@ export function makeDefaultHydrateMeta() {
 }
 export async function hydrate(appRoutes, RootComponent, instanceConfig) {
   debug('hydrate start');
+  // first, before any component is built: a DocInit that threw in the head is on screen whatever
+  // happens next (a read of its value throws below). Rendered again at the end, for the count.
+  if (isDev) renderDocInitErrorBanner();
   //console.log('hydration global data ', __tungsten_global_data__)
   const location = window.location.pathname;
   const routes = typeof appRoutes === 'function' ? appRoutes(null) : appRoutes;
@@ -93,6 +98,7 @@ export async function hydrate(appRoutes, RootComponent, instanceConfig) {
   }
   instance.hydrationComplete = true;
   if (isDev) renderHydrationMismatchBanner(meta.mismatches);
+  if (isDev) renderDocInitErrorBanner();
   //// Can components update while hydrating is still taking place
   //// -- probably yes
   //// Can we pause any further update until hydration completes, to retain coherency?
@@ -371,6 +377,8 @@ async function hydrateFunctionComponent(node, parentElement, domPointer, instanc
 //// why don't we have html, nodes in here?
 async function hydrateNode(node, parentElement, domPointer, instance, meta) {
   debug('hydrateNode');
+  // a fragment hydrates as its children; the rendered side never holds one
+  if (ContentNodeIsFragment(node)) return hydrateNode(node[$props].children, parentElement, domPointer, instance, meta);
   if (Array.isArray(node)) {
     const renderedChildren = [];
     for (const arrayNode of node) {
@@ -384,7 +392,9 @@ async function hydrateNode(node, parentElement, domPointer, instance, meta) {
   }
 }
 //// why don't we have html, nodes in here?
-async function hydrateNodeSingle(node, parentElement, domPointer, instance, meta) {
+async function hydrateNodeSingle(node,
+// hydrateNode unwrapped any fragment
+parentElement, domPointer, instance, meta) {
   debug('----hydrateNodeSingle');
   debug('node', `(${typeof node})`, typeof node === 'string' ? `"${node}"` : node);
   if (ContentNodeIsElement(node)) {
@@ -444,31 +454,25 @@ async function hydrateNodeSingle(node, parentElement, domPointer, instance, meta
     }
   }
   debug(node, node[$type], typeof node[$type], node[$type] === 'head');
+  // the head hydrates like any element below, its children matched from appHeadChildrenStart
+  // (past what the server added). Hydration used to skip the children, and the record with no
+  // children then made the first root update re-create them all, duplicating the title and metas
   if (node[$type] === 'head') {
-    const node = domPointer.get();
-    if (node.nodeType !== 1 || node.nodeName.toLocaleLowerCase() !== 'head') {
-      throwError('hydrateNodeSingle', `expected to find a head node, instead found nodeType ${node.nodeType}, nodeName ${node.nodeName}`);
+    const headDomNode = domPointer.get();
+    if (headDomNode.nodeType !== 1 || headDomNode.nodeName.toLocaleLowerCase() !== 'head') {
+      throwError('hydrateNodeSingle', `expected to find a head node, instead found nodeType ${headDomNode.nodeType}, nodeName ${headDomNode.nodeName}`);
     }
-    // collect persistent head nodes
+    // collect the head children a head re-created on the client keeps (createHtmlElement)
     const persistentHeadChildren = [];
-    const domChildren = node.childNodes;
-    for (const child of domChildren) {
+    for (const child of headDomNode.childNodes) {
       if (child.nodeType === 1) {
-        const el = child;
+        const el = child; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- nodeType 1 is an element
         if (el.hasAttribute('data--t-persist')) {
-          persistentHeadChildren.push(el.cloneNode(true));
+          persistentHeadChildren.push(el.cloneNode(true)); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- a clone of an element is an element
         }
       }
     }
-    //const domChildrenPointer = new DomPointer(node as HTMLHeadElement)
     instance.persistentHeadChildren = persistentHeadChildren;
-    debug('head node - skipping, because we add a lot to this during initial render, breaking matching');
-    domPointer.increment();
-    //return { [$type]: $head, domNode: node as HTMLElement } // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
-    return {
-      [$type]: 'head',
-      domNode: node
-    }; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion
   }
   if (ContentNodeIsHtml(node)) {
     // HTML el
@@ -534,7 +538,7 @@ async function hydrateNodeSingle(node, parentElement, domPointer, instance, meta
       });
     } else if (node[$props].__opaque !== true && validChildren(children)) {
       debug('node.props.children', children);
-      const childDomPointer = new DomPointer(domNode);
+      const childDomPointer = new DomPointer(domNode, node[$type] === 'head' ? appHeadChildrenStart(domNode) : 0);
       renderedChildren = await hydrateNode(children, parentElement, childDomPointer, instance, meta);
     }
     meta.selectValue = outerSelectValue;

package/dist/hydrate/renderHydrationMismatchBanner.d.ts

@@ -3,5 +3,6 @@ export type TaggedAttributeMismatch = AttributeMismatch & {
     tagName: string;
 };
 export declare const hydrationMismatchAttribute = "data-tungsten-hydration-mismatches";
+export declare const hydrationMismatchBannerId = "tungsten-hydration-mismatches";
 export declare function renderHydrationMismatchBanner(mismatches: readonly TaggedAttributeMismatch[], doc?: Document): void;
 //# sourceMappingURL=renderHydrationMismatchBanner.d.ts.map

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

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

package/dist/hydrate/renderHydrationMismatchBanner.js

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

package/dist/indexInner.d.ts

@@ -16,8 +16,10 @@ export * from './components/bindable/BindableTextarea.jsx';
 export * from './components/GoToComponent.jsx';
 export * from './components/Lazy.js';
 export * from './components/Link.jsx';
+export * from './components/NativeHtml.jsx';
 export * from './components/PopMessages.jsx';
-export * from './components/RawHtml.jsx';
+export * from './components/Protected.jsx';
+export { RawHtml, type RawHtmlProps, RawHtml as ParseHtml, type RawHtmlProps as ParseHtmlProps } from './components/RawHtml.jsx';
 export * from './components/RouteRedirectComponent.jsx';
 export { parseHtml, type ParseHtmlOptions } from './rawHtml/parseHtml.js';
 export { safeHtmlAllowList } from './rawHtml/safeHtmlAllowList.js';
@@ -31,6 +33,7 @@ export { pop, dismissPop } from './pop.js';
 export * from './browserStorage.js';
 export { createElement } from './createElement.js';
 export * from './createRef.js';
+export { docInit } from './docInit.js';
 export { foreach } from './foreach.js';
 export * from './helpers/index.js';
 export * from './hooks/index.js';
@@ -45,6 +48,7 @@ export { isProd } from './isProd.js';
 export { logAndReturn } from './logAndReturn.js';
 export * from './requests/index.js';
 export { registerGlobalData, type GlobalData, type GlobalDataFunction } from './routing/registerGlobalData.js';
+export { registerPrivateEnvSchema, registerPublicEnvSchema, type PrivateEnvSchema, type PublicEnvSchema, } from './env/registerEnvSchemas.js';
 export * from './routing/MatchedRoute.js';
 export * from './routing/RedirectCode.js';
 export * from './routing/Route.jsx';

package/dist/indexInner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"indexInner.d.ts","sourceRoot":"","sources":["../src/indexInner.ts"],"names":[],"mappings":"AAEA,cAAc,qBAAqB,CAAA;AACnC,OAAO,EACH,uBAAuB,EAAE,uBAAuB,IAAI,eAAe,EAAE,mBAAmB;AACxF,yBAAyB,EAAE,yBAAyB,IAAI,iBAAiB,EAAE,qBAAqB;AAChG,wBAAwB,IAAI,0BAA0B,EAAE,wBAAwB,IAAI,kBAAkB,EAEtG,gCAAgC,EAAE,gCAAgC,IAAI,wBAAwB,EAC9F,kCAAkC,EAAE,kCAAkC,IAAI,0BAA0B,GACvG,MAAM,kBAAkB,CAAA;AAEzB,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,uBAAuB,CAAA;AACrC,cAAc,4CAA4C,CAAA;AAC1D,cAAc,yCAAyC,CAAA;AACvD,cAAc,8CAA8C,CAAA;AAC5D,cAAc,yCAAyC,CAAA;AACvD,cAAc,0CAA0C,CAAA;AACxD,cAAc,4CAA4C,CAAA;AAC1D,cAAc,gCAAgC,CAAA;AAC9C,cAAc,sBAAsB,CAAA;AACpC,cAAc,uBAAuB,CAAA;AACrC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,0BAA0B,CAAA;AACxC,cAAc,yCAAyC,CAAA;AACvD,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,YAAY,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAA;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAA;AACjE,cAAc,uCAAuC,CAAA;AACrD,cAAc,YAAY,CAAA;AAC1B,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,cAAc,gBAAgB,CAAA;AAG9B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,uBAAuB,CAAA;AACrC,cAAc,iBAAiB,CAAA;AAG/B,cAAc,oBAAoB,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD,cAAc,qBAAqB,CAAA;AAEnC,OAAO,EAAE,kBAAkB,EAAE,KAAK,UAAU,EAAE,KAAK,kBAAkB,EAAE,MAAM,iCAAiC,CAAA;AAC9G,cAAc,2BAA2B,CAAA;AACzC,cAAc,2BAA2B,CAAA;AACzC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mCAAmC,CAAA;AACjD,cAAc,8BAA8B,CAAA;AAC5C,cAAc,0BAA0B,CAAA;AACxC,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,0BAA0B,CAAA;AACxC,cAAc,6BAA6B,CAAA;AAC3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,cAAc,gBAAgB,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAIvD,YAAY,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAC/C,YAAY,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAA;AAC5F,YAAY,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAA;AACnF,cAAc,kBAAkB,CAAA;AAEhC,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAC5D,YAAY,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACtD,YAAY,EAAE,GAAG,EAAE,MAAM,UAAU,CAAA;AACnC,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACvD,YAAY,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACjE,YAAY,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,IAAI,EAAE,KAAK,IAAI,IAAI,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AACxH,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAC/D,YAAY,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,EAAE,KAAK,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AAC9F,YAAY,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAChE,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qCAAqC,CAAA;AAC5E,YAAY,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAA;AAC3E,YAAY,EAAE,eAAe,EAAE,eAAe,IAAI,MAAM,EAAE,MAAM,sBAAsB,CAAA;AACtF,YAAY,EACR,0BAA0B,EAAE,0BAA0B,IAAI,SAAS,EACnE,gCAAgC,EAAE,gCAAgC,IAAI,eAAe,EACrF,cAAc,EACjB,MAAM,kBAAkB,CAAA;AACzB,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAG7C,mBAAmB,mBAAmB,CAAA"}
+{"version":3,"file":"indexInner.d.ts","sourceRoot":"","sources":["../src/indexInner.ts"],"names":[],"mappings":"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"}

package/dist/indexInner.js

@@ -22,8 +22,10 @@ export * from "./components/bindable/BindableTextarea.js";
 export * from "./components/GoToComponent.js";
 export * from './components/Lazy.js';
 export * from "./components/Link.js";
+export * from "./components/NativeHtml.js";
 export * from "./components/PopMessages.js";
-export * from "./components/RawHtml.js";
+export * from "./components/Protected.js";
+export { RawHtml, RawHtml as ParseHtml } from "./components/RawHtml.js";
 export * from "./components/RouteRedirectComponent.js";
 export { parseHtml } from './rawHtml/parseHtml.js';
 export { safeHtmlAllowList } from './rawHtml/safeHtmlAllowList.js';
@@ -36,6 +38,7 @@ export { pop, dismissPop } from './pop.js';
 export * from './browserStorage.js';
 export { createElement } from './createElement.js';
 export * from './createRef.js';
+export { docInit } from './docInit.js'; // what BabelTransformDocInit rewrites DocInit() calls into; installs the DocInit global
 //export * from './env/funcs.js'
 //export * from './env/index.js'
 export { foreach } from './foreach.js';
@@ -56,6 +59,7 @@ export { logAndReturn } from './logAndReturn.js';
 export * from './requests/index.js';
 //export * from './zones/react.jsx'
 export { registerGlobalData } from './routing/registerGlobalData.js';
+export { registerPrivateEnvSchema, registerPublicEnvSchema } from './env/registerEnvSchemas.js';
 export * from './routing/MatchedRoute.js';
 export * from './routing/RedirectCode.js';
 export * from "./routing/Route.js";

package/dist/jsxRuntime.d.ts

@@ -3,7 +3,7 @@ import type { KeyAttr } from './KeyAttr.js';
 import { type TungstenComponentGenericProps } from './Components.jsx';
 import { ContentNode } from './ContentNode.js';
 export * from './contentNodeSymbols.js';
-export declare const Fragment: 60107;
+export declare const Fragment: symbol;
 export type JsxNodeType = string | AnyComponentType | typeof Fragment;
 export declare function jsx(type: JsxNodeType | string | number | boolean | null | undefined, props: TungstenComponentGenericProps, key: KeyAttr): ContentNode;
 export declare const jsxs: (...args: Parameters<typeof jsx>) => ContentNode;

package/dist/jsxRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsxRuntime.d.ts","sourceRoot":"","sources":["../src/jsxRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,KAAK,6BAA6B,EAAoD,MAAM,kBAAkB,CAAA;AACvH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAM9C,cAAc,yBAAyB,CAAA;AAGvC,eAAO,MAAM,QAAQ,EAAG,KAAe,CAAA;AAGvC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,gBAAgB,GAAG,OAAO,QAAQ,CAAA;AAkBrE,wBAAgB,GAAG,CACf,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAChE,KAAK,EAAE,6BAA6B,EACpC,GAAG,EAAE,OAAO,GACb,WAAW,CAiFb;AAID,eAAO,MAAM,IAAI,GAAY,GAAG,MAAM,UAAU,CAAC,OAAO,GAAG,CAAC,gBAG3D,CAAA"}
+{"version":3,"file":"jsxRuntime.d.ts","sourceRoot":"","sources":["../src/jsxRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,EAAE,KAAK,6BAA6B,EAAoD,MAAM,kBAAkB,CAAA;AACvH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAM9C,cAAc,yBAAyB,CAAA;AAIvC,eAAO,MAAM,QAAQ,QAAY,CAAA;AAGjC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,gBAAgB,GAAG,OAAO,QAAQ,CAAA;AAkBrE,wBAAgB,GAAG,CACf,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAChE,KAAK,EAAE,6BAA6B,EACpC,GAAG,EAAE,OAAO,GACb,WAAW,CAoFb;AAID,eAAO,MAAM,IAAI,GAAY,GAAG,MAAM,UAAU,CAAC,OAAO,GAAG,CAAC,gBAG3D,CAAA"}

package/dist/jsxRuntime.js

@@ -1,11 +1,12 @@
 import { TungstenBaseComponent } from "./Components.js";
 import { TungstenError } from './TungstenError.js';
-import { $key, $props, $type } from './contentNodeSymbols.js';
+import { $fragment, $key, $props, $type } from './contentNodeSymbols.js';
 import { packageNameCapitalized } from './settings.js';
 import { throwError } from './throwError.js';
 export * from './contentNodeSymbols.js';
 //import { inspect } from 'util'
-export const Fragment = 0xeacb; // code taken from react for fragments
+// what the babel automatic runtime imports for `<>…</>`; the node it makes is unwrapped by the renderers
+export const Fragment = $fragment;
 // (?outdated?) this doesn't seem to handle string/number/undefined correctly
 function classNameArrayToString(array) {
   let result = '';
@@ -47,10 +48,11 @@ export function jsx(type, props, key) {
   }
   //const { children, ...filteredProps } = props
   if (type === Fragment) {
-    const {
-      children
-    } = props;
-    return children;
+    return {
+      [$type]: $fragment,
+      [$props]: props,
+      [$key]: key
+    };
   }
   if (typeof type === 'function') {
     // element
@@ -88,7 +90,7 @@ export function jsx(type, props, key) {
   if (typeof type === 'number') {
     return String(type);
   }
-  throw new TungstenError(`${packageNameCapitalized} JSX Runtime error: did not recognize element` + `, expected a string, function, class (type function), or fragment.` + ` Received type ${typeof type}: ${type}`);
+  throw new TungstenError(`${packageNameCapitalized} JSX Runtime error: did not recognize element` + `, expected a string, function, class (type function), or fragment.` + ` Received type ${typeof type}: ${String(type)}`);
 }
 // jsxs is used when children is an array instead of a single object
 // just use the same function for both

package/dist/jsxRuntimeSignals.d.ts

@@ -2,17 +2,21 @@ import type { AnyComponentType } from './AnyComponentType.js';
 import type { TungstenComponentGenericProps } from './Components.jsx';
 import type { KeyAttr } from './KeyAttr.js';
 export * from './contentNodeSymbols.js';
-export declare const Fragment: 60107;
+export declare const Fragment: symbol;
 export type JsxNodeType = string | AnyComponentType | typeof Fragment;
 export declare const TypeSymbol: unique symbol;
-export declare function jsx(type: JsxNodeType | string | number | boolean | null | undefined, props: TungstenComponentGenericProps, key: KeyAttr): string | number | boolean | import("./ContentNode.js").ContentNodeHtml | import("./ContentNode.js").ContentNodeClassComponent | import("./ContentNode.js").ContentNodeFunctionComponent | import("./ContentNode.js").ContentNodeArray | {
-    type: import("./Components.jsx").TungstenBaseComponentType<any, any> | import("./FunctionComponent.js").FunctionComponent<any, any>;
+export declare function jsx(type: JsxNodeType | string | number | boolean | null | undefined, props: TungstenComponentGenericProps, key: KeyAttr): string | {
+    type: symbol;
+    props: TungstenComponentGenericProps;
+    key: KeyAttr;
+} | {
+    type: AnyComponentType;
     props: TungstenComponentGenericProps;
     key: KeyAttr;
 } | {
     type: string;
     props: TungstenComponentGenericProps;
     key: KeyAttr;
-} | null | undefined;
+} | null;
 export declare const jsxs: typeof jsx;
 //# sourceMappingURL=jsxRuntimeSignals.d.ts.map

package/dist/jsxRuntimeSignals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsxRuntimeSignals.d.ts","sourceRoot":"","sources":["../src/jsxRuntimeSignals.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAI3C,cAAc,yBAAyB,CAAA;AAEvC,eAAO,MAAM,QAAQ,EAAG,KAAe,CAAA;AAEvC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,gBAAgB,GAAG,OAAO,QAAQ,CAAA;AAGrE,eAAO,MAAM,UAAU,eAAiB,CAAA;AAcxC,wBAAgB,GAAG,CACf,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAChE,KAAK,EAAE,6BAA6B,EACpC,GAAG,EAAE,OAAO;;;;;;;;qBA+Df;AAID,eAAO,MAAM,IAAI,YAAM,CAAA"}
+{"version":3,"file":"jsxRuntimeSignals.d.ts","sourceRoot":"","sources":["../src/jsxRuntimeSignals.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC7D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAK3C,cAAc,yBAAyB,CAAA;AAEvC,eAAO,MAAM,QAAQ,QAAY,CAAA;AAEjC,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,gBAAgB,GAAG,OAAO,QAAQ,CAAA;AAGrE,eAAO,MAAM,UAAU,eAAiB,CAAA;AAcxC,wBAAgB,GAAG,CACf,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,EAChE,KAAK,EAAE,6BAA6B,EACpC,GAAG,EAAE,OAAO;;;;;;;;;;;;SAkEf;AAID,eAAO,MAAM,IAAI,YAAM,CAAA"}

package/dist/jsxRuntimeSignals.js

@@ -1,8 +1,9 @@
 import { TungstenError } from './TungstenError.js';
 import { packageNameCapitalized } from './settings.js';
 import { throwError } from './throwError.js';
+import { $fragment } from './contentNodeSymbols.js';
 export * from './contentNodeSymbols.js';
-export const Fragment = 0xeacb; // code taken from react for fragments
+export const Fragment = $fragment;
 //// TODO use this symbol for type
 export const TypeSymbol = Symbol('type');
 // (?outdated?) this doesn't seem to handle string/number/undefined correctly
@@ -35,10 +36,11 @@ export function jsx(type, props, key) {
   }
   //const { children, ...filteredProps } = props
   if (type === Fragment) {
-    const {
-      children
-    } = props;
-    return children;
+    return {
+      type,
+      props,
+      key
+    };
   }
   if (typeof type === 'function') {
     return {
@@ -65,7 +67,7 @@ export function jsx(type, props, key) {
   if (typeof type === 'number') {
     return String(type);
   }
-  throw new TungstenError(`${packageNameCapitalized} JSX Runtime error: did not recognize element` + `, expected a string, function, class (type function), or fragment.` + ` Received type ${typeof type}: ${type}`);
+  throw new TungstenError(`${packageNameCapitalized} JSX Runtime error: did not recognize element` + `, expected a string, function, class (type function), or fragment.` + ` Received type ${typeof type}: ${String(type)}`);
 }
 // jsx func for static elements
 // not sure exactly what this is, just use the same func for now

package/dist/nbsp.d.ts

@@ -1,3 +1,3 @@
-export declare const nbsp: import("./ContentNode.js").ContentNode;
-export declare const space: import("./ContentNode.js").ContentNode;
+export declare const nbsp: import("./ContentNode.js").ContentNodeElement;
+export declare const space: import("./ContentNode.js").ContentNodeElement;
 //# sourceMappingURL=nbsp.d.ts.map

package/dist/nbsp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nbsp.d.ts","sourceRoot":"","sources":["../src/nbsp.tsx"],"names":[],"mappings":"AAGA,eAAO,MAAM,IAAI,wCAAc,CAAA;AAC/B,eAAO,MAAM,KAAK,wCAAc,CAAA"}
+{"version":3,"file":"nbsp.d.ts","sourceRoot":"","sources":["../src/nbsp.tsx"],"names":[],"mappings":"AAGA,eAAO,MAAM,IAAI,+CAAc,CAAA;AAC/B,eAAO,MAAM,KAAK,+CAAc,CAAA"}

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

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

package/dist/rawHtml/filterContentNode.js

@@ -1,4 +1,4 @@
-import { ContentNodeIsComponent } from '../ContentNode.js';
+import { ContentNodeIsComponent, ContentNodeIsFragment } from '../ContentNode.js';
 import { $props, $type } from '../contentNodeSymbols.js';
 import { StringIsHtmlEvent } from '../htmlEvents.js';
 import { blockedUrl, makeAllowCheck, removalFor, urlAttributes } from './parseHtml.js';
@@ -60,6 +60,8 @@ function filter(node, allow) {
   // rather than reachable: nothing that round-trips through storage (JSON)
   // can carry a class or function reference.
   if (ContentNodeIsComponent(node)) return node;
+  // parseHtml never produces a fragment either; one from JSX is just its children
+  if (ContentNodeIsFragment(node)) return filter(node[$props].children ?? null, allow);
   const tag = node[$type];
   const removal = removalFor(tag, true, allow);
   if (removal === 'drop') return null;

package/dist/render/HeadData.d.ts

@@ -14,5 +14,6 @@ export type HeadData = {
     siteBasePath: SiteBasePath;
     hmr: boolean | 'reload';
     csr: boolean;
+    docInitScript?: string | undefined;
 };
 //# sourceMappingURL=HeadData.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"HeadData.d.ts","sourceRoot":"","sources":["../../src/render/HeadData.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D,MAAM,MAAM,YAAY,GAAG,EAAE,GAAG,IAAI,MAAM,EAAE,CAAA;AAE5C,MAAM,MAAM,QAAQ,GAAG;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,mBAAmB,EAAE,aAAa,CAAC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,GAAG,EAAE,OAAO,CAAC;IACb,iBAAiB,EAAE,sBAAsB,CAAC;IAC1C,YAAY,EAAE,YAAY,CAAC;IAC3B,GAAG,EAAE,OAAO,GAAG,QAAQ,CAAA;IACvB,GAAG,EAAE,OAAO,CAAA;CACf,CAAA"}
+{"version":3,"file":"HeadData.d.ts","sourceRoot":"","sources":["../../src/render/HeadData.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAC9D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAE9D,MAAM,MAAM,YAAY,GAAG,EAAE,GAAG,IAAI,MAAM,EAAE,CAAA;AAE5C,MAAM,MAAM,QAAQ,GAAG;IACnB,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,mBAAmB,EAAE,aAAa,CAAC;IACnC,aAAa,EAAE,aAAa,CAAC;IAC7B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,GAAG,EAAE,OAAO,CAAC;IACb,iBAAiB,EAAE,sBAAsB,CAAC;IAC1C,YAAY,EAAE,YAAY,CAAC;IAC3B,GAAG,EAAE,OAAO,GAAG,QAAQ,CAAA;IACvB,GAAG,EAAE,OAAO,CAAA;IAEZ,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACrC,CAAA"}

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

@@ -1 +1 @@
-{"version":3,"file":"addImportMap.d.ts","sourceRoot":"","sources":["../../src/render/addImportMap.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,mBAAmB,CAAA;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAQ9D,wBAAgB,YAAY,CAAC,IAAI,EAAE,mCAAmC,EAAE,aAAa,EAAE,aAAa,EAChG,mBAAmB,EAAE,aAAa,QAgCrC"}
+{"version":3,"file":"addImportMap.d.ts","sourceRoot":"","sources":["../../src/render/addImportMap.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,mBAAmB,CAAA;AAC5E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAA;AAQ9D,wBAAgB,YAAY,CAAC,IAAI,EAAE,mCAAmC,EAAE,aAAa,EAAE,aAAa,EAChG,mBAAmB,EAAE,aAAa,QAiCrC"}