tungsten 0.3.1 → 0.3.3

package/dist/timeProfiler.js

@@ -0,0 +1,31 @@
+// Same shape as sxy-test-runner's createTimeProfiler (node_modules/sxy-test-runner/dist/packages/timeProfiler.js) -
+// a disabled profiler just runs the task, so callers never need to branch on whether profiling
+// is on. Framework.ts holds one instance per run (default disabled); tungsten dev/build enable
+// it via --profile and wrap their own top-level phases with it too.
+import chalk from 'chalk-extensions';
+import { cliOut } from "./cliOutput.js";
+function report(name, ms) {
+  cliOut(chalk.yellow`${name}` + ' - ' + chalk.orange`${ms.toLocaleString()}ms`);
+}
+export function createTimeProfiler(profiling = true) {
+  if (!profiling) {
+    return {
+      timeProfile: (_name, task) => task(),
+      timeProfileAsync: async (_name, task) => task()
+    };
+  }
+  return {
+    timeProfile(name, task) {
+      const start = Date.now();
+      const result = task();
+      report(name, Date.now() - start);
+      return result;
+    },
+    async timeProfileAsync(name, task) {
+      const start = Date.now();
+      const result = await task();
+      report(name, Date.now() - start);
+      return result;
+    }
+  };
+}

package/dist/update/integrateUpdateVdom.d.ts

@@ -1,17 +1,30 @@
+import { DomRegion } from '../DomRegion.js';
 import { DomPointer } from '../DomPointer.js';
 import { ContentNode, ContentNodeHtml, ContentNodeComponentAny } from '../ContentNode.js';
 import { Instance } from '../Instance/Instance.js';
+import { FunctionElement } from '../FunctionComponentStandIn.js';
 import { TungstenElement } from '../TungstenElement.js';
 import { AnyComponent } from '../AnyComponent.js';
 import { $ContentNull } from '../symbols.js';
 import { RenderedContentNode, RenderedContentNodeComponent } from '../RenderedContentNode.js';
 import { UpdateResult } from './UpdateResult.js';
-import type { TungstenBaseComponentType } from '../Components.jsx';
+import type { TungstenBaseComponent, TungstenBaseComponentType } from '../Components.jsx';
+import type { FunctionComponent } from '../FunctionComponent.js';
 export type TungstenHTMLElement = HTMLElement & {
     __tungsten_click_handler: (this: HTMLElement, ev: MouseEvent) => any;
     [key: string]: unknown;
 };
 export declare function integrateElementUpdateVdom(element: AnyComponent, newContent: ContentNode): Promise<UpdateResult>;
+export type ApplyUpdateArgs = {
+    tungstenElement: AnyComponent;
+    instance: Instance;
+    newNode: ContentNode;
+    oldNode: RenderedContentNode | $ContentNull;
+    domRegion: DomRegion | null;
+    domPointer: DomPointer;
+    parentNode: ContentNode;
+};
+export declare function applyUpdate({ tungstenElement, instance, newNode, oldNode, domRegion, domPointer, parentNode }: ApplyUpdateArgs): Promise<RenderedContentNode>;
 export declare function deleteNodeIfRendered(node: $ContentNull | RenderedContentNode): void;
 export declare function processHtmlNode(node: ContentNodeHtml, parentNode: ContentNode): void;
 type CreateTungstenComponentArgs = {
@@ -28,5 +41,7 @@ export type MountedTungstenRoot<ComponentType extends TungstenBaseComponentType<
 };
 export declare function createTungstenRootComponent<ComponentType extends TungstenBaseComponentType<any, any>>(RootComponent: ComponentType, props: InstanceType<ComponentType>['props'], routeParams: Record<string, string> | undefined, routeData: unknown, instance: Instance, container: HTMLElement): Promise<MountedTungstenRoot<ComponentType>>;
 export declare function deleteTungstenRoot(root: MountedTungstenRoot<TungstenBaseComponentType<any, any>>): void;
+export declare function hotSwapFunctionComponent(oldElement: FunctionElement<any, any>, NewType: FunctionComponent<any, any>): Promise<FunctionElement<any, any> | null>;
+export declare function hotSwapClassComponent(oldElement: TungstenBaseComponent<any, any>, NewType: TungstenBaseComponentType<any, any>): Promise<TungstenBaseComponent<any, any> | null>;
 export {};
 //# sourceMappingURL=integrateUpdateVdom.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"integrateUpdateVdom.d.ts","sourceRoot":"","sources":["../../src/update/integrateUpdateVdom.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EACH,WAAW,EAAwC,eAAe,EAElE,uBAAuB,EAG1B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAKlD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAGjD,OAAO,EAAE,YAAY,EAAgB,MAAM,eAAe,CAAA;AAE1D,OAAO,EACe,mBAAmB,EAIT,4BAA4B,EAI3D,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAYhD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAA;AAGlE,MAAM,MAAM,mBAAmB,GAAG,WAAW,GAAG;IAC5C,wBAAwB,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE,UAAU,KAAK,GAAG,CAAA;IACpE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACzB,CAAA;AAYD,wBAAsB,0BAA0B,CAC5C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,GAC/C,OAAO,CAAC,YAAY,CAAC,CA0GvB;AA8gBD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,mBAAmB,QAuC5E;AAgED,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,UAAU,EAAE,WAAW,QAkK7E;AA0WD,KAAK,2BAA2B,GAAG;IAC/B,MAAM,EAAE,eAAe,CAAA;IACvB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,uBAAuB,CAAC;IAE9B,UAAU,EAAE,UAAU,CAAA;CACzB,CAAA;AACD,wBAAsB,uBAAuB,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,2BAA2B,GAC3G,OAAO,CAAC,4BAA4B,CAAC,CAU1C;AAED,MAAM,MAAM,mBAAmB,CAC3B,aAAa,SAAS,yBAAyB,CAAC,GAAG,EAAE,GAAG,CAAC,IACzD;IACA,SAAS,EAAE,YAAY,CAAC,aAAa,CAAC,CAAA;IACtC,cAAc,EAAE,OAAO,CAAA;IACvB,cAAc,EAAE,OAAO,CAAA;CAC1B,CAAA;AAED,wBAAsB,2BAA2B,CAC7C,aAAa,SAAS,yBAAyB,CAAC,GAAG,EAAE,GAAG,CAAC,EAEzD,aAAa,EAAE,aAAa,EAC5B,KAAK,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC,OAAO,CAAC,EAC3C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC/C,SAAS,EAAE,OAAO,EAClB,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,WAAW,GACvB,OAAO,CAAC,mBAAmB,CAAC,aAAa,CAAC,CAAC,CAgD7C;AAED,wBAAgB,kBAAkB,CAC9B,IAAI,EAAE,mBAAmB,CAAC,yBAAyB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAC/D,IAAI,CAON"}
+{"version":3,"file":"integrateUpdateVdom.d.ts","sourceRoot":"","sources":["../../src/update/integrateUpdateVdom.ts"],"names":[],"mappings":"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"}

package/dist/update/integrateUpdateVdom.js

@@ -22,6 +22,8 @@ import { validChildren } from "../validChildren.js";
 import { setCurrentComponent } from 'tungsten/hooks/setCurrentComponent.js';
 import { clearCurrentComponent } from 'tungsten/hooks/clearCurrentComponent.js';
 import { isDev } from "../isDev.js";
+import { $original } from "../componentProxyHandlers.js";
+import { booleanAttributeValue } from "../booleanAttributeValue.js";
 function debug(...texts) {
   //console.log(...texts)
   //console.log(getStackTrace().split('\n')[2])
@@ -117,7 +119,9 @@ function getKeyedOldChildren(array) {
   }
   return keyedChildren;
 }
-async function applyUpdate({
+// oldNode: $contentNull reconciles as a pure create (falls through to createNode()) - used by
+// hydrate.tsx's CSR branch for <body>.
+export async function applyUpdate({
   tungstenElement,
   instance,
   newNode,
@@ -848,7 +852,8 @@ function addAttributes(tungstenElement, instance, node, domNode) {
       //console.log('add attr', key, attributes[key])
       if (typeof attributes[key] === 'boolean') {
         //console.log('bool attr', attributes[key])
-        if (attributes[key]) domNode.setAttribute(key, '');
+        const attrValue = booleanAttributeValue(key, attributes[key]);
+        if (attrValue !== null) domNode.setAttribute(key, attrValue);
       } else if (attributes[key] !== undefined && attributes[key] !== null) {
         //console.log('string attr', String(attributes[key]))
         domNode.setAttribute(key, String(attributes[key]));
@@ -912,7 +917,8 @@ function updateAttributes(tungstenElement, instance, node, oldNode, domNodeHTMLE
         domNode.value = String(newAttributes[key]);
       } else {
         if (typeof newAttributes[key] === 'boolean') {
-          if (newAttributes[key]) domNode.setAttribute(key, '');else removeAttribute(domNode, key);
+          const attrValue = booleanAttributeValue(key, newAttributes[key]);
+          if (attrValue !== null) domNode.setAttribute(key, attrValue);else removeAttribute(domNode, key);
         } else if (newAttributes[key] === undefined || newAttributes[key] === null) {
           removeAttribute(domNode, key);
         } else {
@@ -1003,6 +1009,7 @@ function processAttributes(node) {
     } else {
       attributes.style = attributes.css;
     }
+    delete attributes.css;
   }
   return attributes;
 }
@@ -1135,12 +1142,14 @@ async function createTungstenClassComponent(parent, instance, node, domPointer)
   //console.log('created dom region', element.__domRegion)
   element.__currentContent = renderedContent;
   element.__didMount();
-  return {
+  const wrapper = {
     ...node,
     element,
     openingComment,
     closingComment
   };
+  element.__renderedNode = wrapper;
+  return wrapper;
 }
 let xx = 0;
 async function createTungstenFunctionComponent(parent, instance, node, domPointer) {
@@ -1186,12 +1195,14 @@ async function createTungstenFunctionComponent(parent, instance, node, domPointe
   //console.log('&& dom region first element', element.__domRegion.firstElement)
   //console.log('&& dom region last element', element.__domRegion.lastElement)
   element.__currentContent = renderedContent;
-  return {
+  const wrapper = {
     ...node,
     element,
     openingComment,
     closingComment
   };
+  element.__renderedNode = wrapper;
+  return wrapper;
 }
 async function updateClassComponent({
   newNode,
@@ -1209,12 +1220,14 @@ async function updateClassComponent({
   //throwError('','')
   const updateResult = await element.__update();
   domPointer.increment(updateResult.nodesLength); // bump the dom pointer index forward by the number of nodes within that element's content
-  return {
+  const wrapper = {
     ...newNode,
     element,
     openingComment: oldNode.openingComment,
     closingComment: oldNode.closingComment
   };
+  element.__renderedNode = wrapper;
+  return wrapper;
 }
 async function updateFunctionComponent({
   newNode,
@@ -1227,10 +1240,106 @@ async function updateFunctionComponent({
   standIn.props = newNode[$props];
   const updateResult = await standIn.update();
   domPointer.increment(updateResult.nodesLength); // bump the dom pointer index forward by the number of nodes within that element's content
-  return {
+  const wrapper = {
     ...newNode,
     element: standIn,
     openingComment: oldNode.openingComment,
     closingComment: oldNode.closingComment
   };
+  standIn.__renderedNode = wrapper;
+  return wrapper;
+}
+function hotSwapPrepare(oldElement) {
+  const wrapper = oldElement.__renderedNode;
+  if (wrapper === undefined || oldElement.__domRegion === undefined) return null;
+  const parent = oldElement.__domRegion.parent;
+  const openingCommentIndex = Array.prototype.indexOf.call(parent.childNodes, wrapper.openingComment);
+  if (openingCommentIndex < 0) return null;
+  const domStartIndex = openingCommentIndex + 1;
+  // tear down everything between the comments, keep the comments themselves
+  oldElement.__delete();
+  deleteNodeIfRendered(oldElement.__currentContent);
+  oldElement.__deleted();
+  return {
+    parent,
+    domPointer: new DomPointer(parent, domStartIndex),
+    domStartIndex
+  };
+}
+export async function hotSwapFunctionComponent(oldElement, NewType) {
+  const prep = hotSwapPrepare(oldElement);
+  if (prep === null) return null;
+  const {
+    parent,
+    domPointer,
+    domStartIndex
+  } = prep;
+  const wrapper = oldElement.__renderedNode; // present - checked in hotSwapPrepare
+  if (wrapper === undefined) return null;
+  const standIn = new FunctionElement(NewType, oldElement.props, oldElement.routeParams, oldElement.routeData, oldElement.__instance, oldElement.parentComponent);
+  // carry the old slot-indexed hook state across - see tungsten/docs/hmr.md for the
+  // (unverifiable, accepted) risk this carries when hook shape changed between edits
+  standIn.state = oldElement.state;
+  standIn.effects = oldElement.effects;
+  standIn.memos = oldElement.memos;
+  standIn.callbacks = oldElement.callbacks;
+  setCurrentComponent(standIn);
+  const content = await getStyledContentFromFunctionComponent(standIn);
+  clearCurrentComponent();
+  const renderedContent = await createNode({
+    tungstenElement: standIn,
+    instance: oldElement.__instance,
+    newNode: content,
+    domPointer,
+    parentNode: null
+  });
+  standIn.__domRegion = new DomRegion(parent, domStartIndex, domPointer.index - domStartIndex);
+  standIn.__currentContent = renderedContent;
+  wrapper.element = standIn;
+  wrapper[$props] = standIn.props;
+  standIn.__renderedNode = wrapper;
+  return standIn;
+}
+export async function hotSwapClassComponent(oldElement, NewType) {
+  const prep = hotSwapPrepare(oldElement);
+  if (prep === null) return null;
+  const {
+    parent,
+    domPointer,
+    domStartIndex
+  } = prep;
+  const wrapper = oldElement.__renderedNode; // present - checked in hotSwapPrepare
+  if (wrapper === undefined) return null;
+  const newElement = new NewType({
+    props: oldElement.props,
+    routeParams: oldElement.routeParams,
+    routeData: oldElement.routeData,
+    instance: oldElement.__instance,
+    parentElement: oldElement.parentComponent
+  });
+  // carry the old state across, unwrapping the old proxy so the new instance's own
+  // constructor-created proxy (bound to itself) is what ends up owning it
+  if ('state' in oldElement && oldElement.state !== undefined && 'state' in newElement) {
+    const oldState = oldElement.state; // eslint-disable-line no-type-assertion/no-type-assertion -- state shape is unknown to this generic dev-only code path
+    const rawOldState = $original in oldState ? oldState[$original] // eslint-disable-line no-type-assertion/no-type-assertion -- $original always yields the raw backing object
+    : oldState;
+    const newState = newElement.state; // eslint-disable-line no-type-assertion/no-type-assertion -- state shape is unknown to this generic dev-only code path
+    for (const key in rawOldState) newState[key] = rawOldState[key];
+  }
+  await newElement.__init();
+  const content = await newElement.__initialContent();
+  const renderedContent = await createNode({
+    tungstenElement: newElement,
+    instance: oldElement.__instance,
+    newNode: content,
+    domPointer,
+    parentNode: null
+  });
+  newElement.__domRegion = new DomRegion(parent, domStartIndex, domPointer.index - domStartIndex);
+  newElement.__currentContent = renderedContent;
+  newElement.__didMount();
+  wrapper.element = newElement;
+  wrapper[$props] = newElement.props;
+  newElement.__renderedNode = wrapper;
+  return newElement;
 }

package/dist/warnOnFrameworkChange.d.ts

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

package/dist/warnOnFrameworkChange.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"warnOnFrameworkChange.d.ts","sourceRoot":"","sources":["../src/warnOnFrameworkChange.ts"],"names":[],"mappings":"AAcA,wBAAgB,qBAAqB,IAAI,IAAI,CAc5C"}

package/dist/warnOnFrameworkChange.js

@@ -0,0 +1,27 @@
+import { join } from 'path';
+import chokidar from 'chokidar';
+import { getFrameworkDir } from "./getFrameworkDir.js";
+import { cliWarn } from "./cliOutput.js";
+// Dev mode only, opt-in via warnOnFrameworkChange in tungsten.config.js. Node's ESM module
+// cache can't be invalidated at runtime, so an already-running dev server can't pick up a
+// change to the tungsten package itself (e.g. a linked/workspace copy being rebuilt) without a
+// full process restart - this just tells the developer that's needed, rather than attempting it.
+//
+// Watches a single marker file (dist/.build-complete) rather than all of dist - tungsten's own
+// build scripts touch it as their last step (see scripts/writeBuildMarker.mjs), so one file
+// covers every file a build could have changed without chokidar scanning the whole tree. Watch
+// mode (build-babel --watch) does not yet write it on each cycle, only the one-shot builds do.
+export function warnOnFrameworkChange() {
+  const frameworkDistDir = join(getFrameworkDir(), 'dist');
+  const buildMarkerPath = join(frameworkDistDir, '.build-complete');
+  const watcher = chokidar.watch(buildMarkerPath, {
+    ignoreInitial: true,
+    awaitWriteFinish: {
+      stabilityThreshold: 200,
+      pollInterval: 20
+    }
+  });
+  watcher.on('all', () => {
+    cliWarn(`tungsten framework files changed (${frameworkDistDir}) - restart the dev server` + ` to pick up the change.`);
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tungsten",
-  "version": "0.3.1",
+  "version": "0.3.3",
   "description": "",
   "type": "module",
   "bin": {
@@ -17,6 +17,7 @@
   },
   "files": [
     "dist",
+    "!dist/**/*.sxyt.*",
     "types",
     "sxy-loader.config.js",
     "readme.md"
@@ -28,7 +29,7 @@
     "@babel/cli": "^7.28.6",
     "@babel/core": "^7.29.0",
     "@babel/parser": "^7.29.2",
-    "@babel/plugin-syntax-import-assertions": "^7.28.6",
+    "@babel/plugin-syntax-import-assertions": "^7.29.7",
     "@babel/plugin-transform-class-properties": "^7.28.6",
     "@babel/preset-react": "^7.28.5",
     "@hono/node-server": "^1.19.11",
@@ -37,11 +38,11 @@
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^14.1.0",
     "@rollup/plugin-terser": "^1.0.0",
-    "arktype": "^2.2.0",
+    "arktype": "^2.2.3",
     "babel-plugin-css-to-js": "^0.0.4",
     "babel-plugin-sxy-module-resolver": "^4.1.9",
     "babel-plugin-sxy-transform-cjs-to-esm": "^0.2.6",
-    "bcryptjs": "^2.4.3",
+    "bcryptjs": "^3.0.3",
     "chalk": "^5.6.2",
     "chalk-extensions": "^2.0.24",
     "chokidar": "^3.6.0",
@@ -56,29 +57,29 @@
     "find-package-json": "^1.2.0",
     "fs-extra": "^10.1.0",
     "globby": "^13.2.2",
-    "hono": "^4.12.8",
-    "import-meta-resolve": "^2.2.2",
+    "hono": "^4.12.32",
+    "import-meta-resolve": "^4.2.0",
     "ini": "^4.1.3",
     "lodash.clonedeep": "^4.5.0",
     "npm-run-all": "^4.1.5",
     "open": "^8.4.2",
-    "path-to-regexp": "^6.3.0",
-    "postcss": "^8.5.8",
+    "path-to-regexp": "^8.4.2",
+    "postcss": "^8.5.24",
     "precinct": "^12.2.0",
     "react-router": "^6.30.3",
     "require-resolve-hook": "^1.1.0",
     "rollup": "^2.80.0",
     "rollup-plugin-gzip": "^3.1.2",
-    "sass": "^1.98.0",
+    "sass": "^1.102.0",
     "serialize-javascript": "^6.0.2",
     "slash": "^4.0.0",
     "sxy-dependency-tree": "^8.1.11",
     "sxy-filing-cabinet": "^3.4.2",
-    "sxy-lib": "^3.0.4",
+    "sxy-lib": "^3.0.5",
     "sxy-lib-object-copy": "^2.0.5",
     "sxy-loader": "^3.1.0",
     "sxy-package-investigator": "^1.0.0",
-    "zod": "^4.3.6"
+    "zod": "^4.4.3"
   },
   "devDependencies": {
     "@babel/generator": "^7.29.1",
@@ -86,7 +87,6 @@
     "@types/babel-types": "^7.0.16",
     "@types/babel__core": "^7.20.5",
     "@types/babel__generator": "^7.27.0",
-    "@types/bcryptjs": "^2.4.6",
     "@types/chai": "^4.3.20",
     "@types/cookie-parser": "^1.4.10",
     "@types/express": "^4.17.25",
@@ -110,11 +110,11 @@
     "eslint-import-resolver-typescript": "^2.7.1",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-no-type-assertion": "^1.3.0",
-    "happy-dom": "^20.10.6",
+    "happy-dom": "^20.11.1",
     "prop-types": "^15.8.1",
     "rimraf": "^5.0.10",
     "rollup-plugin-visualizer": "^5.14.0",
-    "sxy-test-runner": "^2.2.2",
+    "sxy-test-runner": "^2.3.12",
     "sxy-types": "^1.0.23",
     "typescript": "^6.0.3"
   },
@@ -136,13 +136,15 @@
     "build": "run-s -c clean build-prep build-watch",
     "clean": "rimraf intermed dist",
     "build-once": "rimraf intermed dist && pnpm build-ts-once && pnpm build-babel-once",
+    "build-once-nd": "rimraf intermed dist.building && pnpm build-ts-once && pnpm build-babel-staged && node scripts/syncDist.mjs && node scripts/writeBuildMarker.mjs",
     "build-quick": "pnpm build-watch",
     "build-prep": "pnpm build-ts-once",
     "build-watch": "run-p build-ts build-babel",
     "build-ts": "tsc --watch",
     "build-ts-once": "tsc",
-    "build-babel": "babel intermed --out-dir dist --ignore \"**/*.cjs\" --copy-files --config-file ./babel.framework.config.js --watch",
-    "build-babel-once": "babel intermed --out-dir dist --ignore \"**/*.cjs\" --copy-files --config-file ./babel.framework.config.js",
+    "build-babel": "node scripts/watchBabelAndMark.mjs",
+    "build-babel-once": "babel intermed --out-dir dist --ignore \"**/*.cjs\" --copy-files --config-file ./babel.framework.config.js && node scripts/writeBuildMarker.mjs",
+    "build-babel-staged": "babel intermed --out-dir dist.building --ignore \"**/*.cjs\" --copy-files --config-file ./babel.framework.config.js",
     "test": "sxy-test-runner",
     "test-once": "sxy-test-runner once"
   }

package/dist/Instance/gotoRedirect.sxyt.d.ts

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

package/dist/Instance/gotoRedirect.sxyt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"gotoRedirect.sxyt.d.ts","sourceRoot":"","sources":["../../src/Instance/gotoRedirect.sxyt.ts"],"names":[],"mappings":""}

package/dist/Instance/gotoRedirect.sxyt.js

@@ -1,148 +0,0 @@
-import { describe } from 'sxy-test-runner';
-import { expect } from 'chai';
-// aliased: an unaliased `Window` would shadow the DOM Window type the
-// runtime context is declared with
-import { Window as HappyWindow } from 'happy-dom';
-import { Instance } from "./Instance.js";
-import { WebRedirect } from "../routing/WebRedirect.js";
-import { RoutingRedirect } from "../routing/RoutingRedirect.js";
-import { initStores } from "../Servers/initStores.js";
-import { UpdateScheduler } from "../update/UpdateScheduler.js";
-// A client-side Instance whose hard redirects are recorded rather than
-// performed. Only the routing and redirect paths are exercised, so the rest of
-// the runtime is left at its defaults.
-const makeInstance = routes => {
-  const replaced = [];
-  const pushed = [];
-  const happyWindow = new HappyWindow();
-  // Only the two things goto() reaches for: a hard redirect leaves through
-  // location.replace, and an in-app navigation records history.
-  const fakeWindow = {
-    location: {
-      replace: url => {
-        replaced.push(url);
-      }
-    },
-    history: {
-      pushState: (_state, _title, url) => {
-        pushed.push(url);
-      }
-    }
-  };
-  const runtimeContext = {
-    // eslint-disable-next-line no-type-assertion/no-type-assertion
-    document: happyWindow.document,
-    // eslint-disable-next-line no-type-assertion/no-type-assertion
-    window: fakeWindow,
-    scheduler: new UpdateScheduler(),
-    navigation: false
-  };
-  const matchedRouteInfo = {
-    key: null,
-    params: {},
-    content: null
-  };
-  const globalData = {}; // eslint-disable-line no-type-assertion/no-type-assertion
-  const {
-    internalStore,
-    stores,
-    storeSubscriptions
-  } = initStores('/', null, globalData, matchedRouteInfo);
-  const config = {
-    prod: false,
-    useRootComponent: true,
-    clientSideNav: false,
-    siteBasePath: '/',
-    staticSite: false
-  };
-  const instance = new Instance('/', config, null,
-  // eslint-disable-next-line no-type-assertion/no-type-assertion
-  routes, routes,
-  // eslint-disable-line no-type-assertion/no-type-assertion
-  internalStore, stores, storeSubscriptions, globalData, matchedRouteInfo, runtimeContext);
-  return {
-    instance,
-    replaced,
-    pushed
-  };
-};
-const legacyUrl = 'http://legacy.test/';
-describe('Instance.goto() redirects', ({
-  it
-}) => {
-  // A WebRedirect names a URL, not a route, so it has to leave the
-  // application. Client-side navigation used to throw here, which meant a
-  // session that expired between page load and a Link click hit an error
-  // instead of the log in page.
-  it('leaves the application for a WebRedirect returned by route data', async () => {
-    const {
-      instance,
-      replaced
-    } = makeInstance({
-      '/gone': {
-        content: null,
-        data: async () => new WebRedirect(legacyUrl)
-      },
-      '404': {
-        content: null
-      }
-    });
-    await instance.goto('/gone');
-    expect(replaced).to.deep.equal([legacyUrl]);
-  });
-  it('does not adopt the redirect as the current route', async () => {
-    const {
-      instance
-    } = makeInstance({
-      '/gone': {
-        content: null,
-        data: async () => new WebRedirect(legacyUrl)
-      },
-      '404': {
-        content: null
-      }
-    });
-    await instance.goto('/gone');
-    // it left the app; the route it was heading for never became current
-    expect(instance.matchedRouteInfo.key).to.not.equal('/gone');
-  });
-  it('still routes within the application for a RoutingRedirect', async () => {
-    const {
-      instance,
-      replaced
-    } = makeInstance({
-      '/old': {
-        content: null,
-        data: async () => new RoutingRedirect('/new')
-      },
-      '/new': {
-        content: null
-      },
-      '404': {
-        content: null
-      }
-    });
-    await instance.goto('/old');
-    expect(replaced).to.deep.equal([]);
-    expect(instance.matchedRouteInfo.key).to.equal('/new');
-  });
-  it('does not redirect for an ordinary data result', async () => {
-    const {
-      instance,
-      replaced
-    } = makeInstance({
-      '/ok': {
-        content: null,
-        data: async () => ({
-          value: 1
-        })
-      },
-      '404': {
-        content: null
-      }
-    });
-    await instance.goto('/ok');
-    expect(replaced).to.deep.equal([]);
-    expect(instance.matchedRouteInfo.key).to.equal('/ok');
-  });
-});

package/dist/Instance/runTrackedWork.sxyt.d.ts

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

package/dist/Instance/runTrackedWork.sxyt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"runTrackedWork.sxyt.d.ts","sourceRoot":"","sources":["../../src/Instance/runTrackedWork.sxyt.ts"],"names":[],"mappings":""}

package/dist/Instance/runTrackedWork.sxyt.js

@@ -1,35 +0,0 @@
-import { expect } from 'chai';
-import { describe } from 'sxy-test-runner';
-import { runTrackedWork } from "./Instance.js";
-describe('runTrackedWork() (no-scheduler tracked work fallback)', ({
-  it
-}) => {
-  it('reports a synchronous throw with its description', () => {
-    const reports = [];
-    runTrackedWork(() => {
-      throw new Error('sync fail');
-    }, 'Comp componentDidUpdate lifecycle', (error, description) => reports.push([error, description]));
-    expect(reports).to.have.length(1);
-    expect((reports[0]?.[0]).message).to.equal('sync fail');
-    expect(reports[0]?.[1]).to.equal('Comp componentDidUpdate lifecycle');
-  });
-  it('reports an async rejection instead of leaving it unhandled', async () => {
-    const reports = [];
-    runTrackedWork(async () => {
-      await Promise.resolve();
-      throw new Error('async fail');
-    }, 'Comp componentDidUpdate lifecycle', (error, description) => reports.push([error, description]));
-    await new Promise(resolve => setTimeout(resolve, 0));
-    expect(reports).to.have.length(1);
-    expect((reports[0]?.[0]).message).to.equal('async fail');
-    expect(reports[0]?.[1]).to.equal('Comp componentDidUpdate lifecycle');
-  });
-  it('reports nothing for successful sync and async work', async () => {
-    const reports = [];
-    const report = error => reports.push(error);
-    runTrackedWork(() => 'ok', 'sync work', report);
-    runTrackedWork(async () => 'ok', 'async work', report);
-    await new Promise(resolve => setTimeout(resolve, 0));
-    expect(reports).to.have.length(0);
-  });
-});

package/dist/_client/cjsHelpers.sxyt.d.ts

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

package/dist/_client/cjsHelpers.sxyt.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cjsHelpers.sxyt.d.ts","sourceRoot":"","sources":["../../src/_client/cjsHelpers.sxyt.ts"],"names":[],"mappings":""}