tungsten 0.3.1 → 0.3.2

package/dist/render/processHead.sxyt.js

@@ -0,0 +1,93 @@
+import { expect } from 'chai';
+import { Window } from 'happy-dom';
+import { describe } from 'sxy-test-runner';
+import { processHead } from "./processHead.js";
+import { $props, $type } from "../contentNodeSymbols.js";
+import { Instance } from "../Instance/Instance.js";
+import { initStores } from "../Servers/initStores.js";
+import { UpdateScheduler } from "../update/UpdateScheduler.js";
+function makeHeadData(hmr) {
+  const location = '/';
+  const globalData = {};
+  const matchedRouteInfo = {
+    key: null,
+    params: {},
+    content: null
+  };
+  const {
+    internalStore,
+    stores,
+    storeSubscriptions
+  } = initStores(location, null, globalData, matchedRouteInfo);
+  const instanceConfig = {
+    prod: false,
+    useRootComponent: true,
+    clientSideNav: false,
+    siteBasePath: '/',
+    staticSite: false
+  };
+  const emptyRoutes = {}; // eslint-disable-line no-type-assertion/no-type-assertion -- not exercised by this test
+  const window = new Window();
+  const document = window.document; // eslint-disable-line no-type-assertion/no-type-assertion -- happy-dom's Document is structurally compatible
+  const scheduler = new UpdateScheduler();
+  // navigation: false sidesteps Instance's popstate listener setup, which reaches for the
+  // process-wide `window` global when no runtimeContext is given at all - see hydrate.sxyt.tsx
+  const instance = new Instance(location, instanceConfig, null, emptyRoutes, emptyRoutes,
+  // eslint-disable-line no-type-assertion/no-type-assertion
+  internalStore, stores, storeSubscriptions, globalData, matchedRouteInfo, {
+    document,
+    window: document.defaultView,
+    scheduler,
+    navigation: false
+  });
+  return {
+    found: false,
+    instance,
+    clientImportAliases: {},
+    importAliases: {},
+    compilationLocation: '',
+    dev: true,
+    tungstenPublicEnv: undefined,
+    siteBasePath: '',
+    hmr
+  };
+}
+function reloadScriptText(headNode) {
+  const children = headNode[$props].children ?? [];
+  const scripts = children.filter(node => node[$type] === 'script');
+  const reloadScript = scripts.find(node => typeof node[$props].children === 'string' && node[$props].children.includes('__tungsten_live_reload__'));
+  return reloadScript?.[$props].children; // eslint-disable-line no-type-assertion/no-type-assertion -- narrowed by the find() predicate above
+}
+describe('processHead() - hmr config option', ({
+  it
+}) => {
+  it('injects the full Tier 2 hot-swap script when hmr is true', () => {
+    const headNode = {
+      [$type]: 'head',
+      [$props]: {}
+    };
+    processHead(headNode, makeHeadData(true));
+    const script = reloadScriptText(headNode);
+    expect(script).to.contain('applyHmrModule');
+    expect(script).to.contain('refreshStylesheets');
+  });
+  it(`injects only the Tier 1 always-full-reload script when hmr is 'reload'`, () => {
+    const headNode = {
+      [$type]: 'head',
+      [$props]: {}
+    };
+    processHead(headNode, makeHeadData('reload'));
+    const script = reloadScriptText(headNode);
+    expect(script).to.not.contain('applyHmrModule');
+    expect(script).to.not.contain('refreshStylesheets');
+    expect(script).to.contain('location.reload()');
+  });
+  it('injects no live-reload script at all when hmr is false', () => {
+    const headNode = {
+      [$type]: 'head',
+      [$props]: {}
+    };
+    processHead(headNode, makeHeadData(false));
+    expect(reloadScriptText(headNode)).to.equal(undefined);
+  });
+});

package/dist/update/hotSwap.sxyt.d.ts

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

package/dist/update/hotSwap.sxyt.d.ts.map

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

package/dist/update/hotSwap.sxyt.js

@@ -0,0 +1,252 @@
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { expect } from 'chai';
+import { Window } from 'happy-dom';
+import { describe } from 'sxy-test-runner';
+import { TungstenSimpleComponent } from "../Components.js";
+import { createTestApp } from "../testing/index.js";
+import { hotSwapFunctionComponent, hotSwapClassComponent } from "./integrateUpdateVdom.js";
+import { TungstenStatefulComponent } from "../Components.js";
+import { WideRenderedContentNodeIsComponent } from "../RenderedContentNode.js";
+import { AnyComponentIsFunctionComponentStandIn } from "../AnyComponent.js";
+import { jsxs as _jsxs, jsx as _jsx } from "tungsten/jsxRuntime.js";
+const Greeting = ({
+  name
+}) => {
+  return _jsxs("div", {
+    className: "greeting",
+    children: ["Hello ", name]
+  });
+};
+describe('hotSwapFunctionComponent', ({
+  it
+}) => {
+  it('produces the same markup a normal render does - no leaked "children" attribute', async () => {
+    const window = new Window();
+    const document = window.document; // eslint-disable-line no-type-assertion/no-type-assertion -- happy-dom's Document is structurally compatible
+    class Root extends TungstenSimpleComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "content", () => _jsx(Greeting, {
+          name: "Ada"
+        }));
+      }
+    }
+    const testApp = await createTestApp(Root, {
+      document
+    });
+    const before = testApp.container.innerHTML;
+    const wrapper = testApp.component.__currentContent;
+    if (!WideRenderedContentNodeIsComponent(wrapper) || !AnyComponentIsFunctionComponentStandIn(wrapper.element)) {
+      throw new Error('expected the root to directly render a single function component');
+    }
+    const oldElement = wrapper.element;
+    // a second, distinct function reference standing in for "the recompiled version"
+    const NewGreeting = ({
+      name
+    }) => {
+      return _jsxs("div", {
+        className: "greeting",
+        children: ["Hello ", name]
+      });
+    };
+    const swapped = await hotSwapFunctionComponent(oldElement, NewGreeting);
+    expect(swapped).to.not.equal(null);
+    const after = testApp.container.innerHTML;
+    expect(before).to.not.contain('children=');
+    expect(after).to.not.contain('children=');
+    expect(after).to.equal(before);
+    await testApp.unmount();
+  });
+  it('actually renders the NEW function\'s output, not the old one', async () => {
+    const window = new Window();
+    const document = window.document; // eslint-disable-line no-type-assertion/no-type-assertion -- happy-dom's Document is structurally compatible
+    class Root extends TungstenSimpleComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "content", () => _jsx(Greeting, {
+          name: "Ada"
+        }));
+      }
+    }
+    const testApp = await createTestApp(Root, {
+      document
+    });
+    const wrapper = testApp.component.__currentContent;
+    if (!WideRenderedContentNodeIsComponent(wrapper) || !AnyComponentIsFunctionComponentStandIn(wrapper.element)) {
+      throw new Error('expected the root to directly render a single function component');
+    }
+    const oldElement = wrapper.element;
+    // deliberately DIFFERENT markup - simulating an actual source edit
+    const NewGreeting = ({
+      name
+    }) => {
+      return _jsxs("div", {
+        className: "greeting",
+        children: ["Hi there ", name]
+      });
+    };
+    const swapped = await hotSwapFunctionComponent(oldElement, NewGreeting);
+    expect(swapped).to.not.equal(null);
+    expect(testApp.container.innerHTML).to.contain('Hi there Ada');
+    expect(testApp.container.innerHTML).to.not.contain('Hello Ada');
+    await testApp.unmount();
+  });
+});
+describe('hotSwapClassComponent', ({
+  it
+}) => {
+  it('hot-swaps a page-level component with several top-level children (h1, select/option, button)', async () => {
+    class Page extends TungstenStatefulComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "state", {
+          value: 5
+        });
+        _defineProperty(this, "content", () => _jsxs("div", {
+          children: [_jsx("h1", {
+            children: "Welcome"
+          }), _jsx("p", {
+            children: "one"
+          }), _jsx("p", {
+            children: "two"
+          }), _jsxs("select", {
+            value: this.state.value,
+            children: [_jsx("option", {
+              children: " 2 "
+            }), _jsx("option", {
+              children: " 4 "
+            }), _jsx("option", {
+              children: _jsx("span", {
+                children: "5"
+              })
+            }), _jsx("option", {
+              children: " 8 "
+            })]
+          }), _jsx("button", {
+            onClick: () => {
+              this.state.value = 8;
+            },
+            children: "set"
+          })]
+        }));
+      }
+    }
+    const window = new Window();
+    const document = window.document; // eslint-disable-line no-type-assertion/no-type-assertion -- happy-dom's Document is structurally compatible
+    class Root extends TungstenSimpleComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "content", () => _jsx(Page, {}));
+      }
+    }
+    const testApp = await createTestApp(Root, {
+      document
+    });
+    const wrapper = testApp.component.__currentContent;
+    if (!WideRenderedContentNodeIsComponent(wrapper) || AnyComponentIsFunctionComponentStandIn(wrapper.element)) {
+      throw new Error('expected the root to directly render a single class component');
+    }
+    const oldElement = wrapper.element;
+    class NewPage extends TungstenStatefulComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "state", {
+          value: 5
+        });
+        _defineProperty(this, "content", () => _jsxs("div", {
+          children: [_jsx("h1", {
+            children: "Welcome (edited)"
+          }), _jsx("p", {
+            children: "one"
+          }), _jsx("p", {
+            children: "two"
+          }), _jsxs("select", {
+            value: this.state.value,
+            children: [_jsx("option", {
+              children: " 2 "
+            }), _jsx("option", {
+              children: " 4 "
+            }), _jsx("option", {
+              children: _jsx("span", {
+                children: "5"
+              })
+            }), _jsx("option", {
+              children: " 8 "
+            })]
+          }), _jsx("button", {
+            onClick: () => {
+              this.state.value = 8;
+            },
+            children: "set"
+          })]
+        }));
+      }
+    }
+    const swapped = await hotSwapClassComponent(oldElement, NewPage);
+    expect(swapped).to.not.equal(null);
+    expect(testApp.container.innerHTML).to.contain('Welcome (edited)');
+    await testApp.unmount();
+  });
+  it('surfaces a clear error when swapped-in content references an undefined component', async () => {
+    // Investigating a "TungstenError: new DomRegion() error: first child is undefined" crash
+    // seen while live-testing HMR (hot-swapping Home, playground's page-level component, a
+    // moment after Home.tsx's import of `Orphan` became a dangling reference to a just-removed
+    // export). The previous test proves a clean multi-child page-level swap works fine, so
+    // that wasn't a general page-level-swap bug. This test rules out the other suspect: an
+    // undefined component reference does NOT reach DomRegion at all - it's caught much
+    // earlier, with a clear JSX runtime error. So the live DomRegion crash's exact trigger
+    // remains unconfirmed; what's confirmed is that the outer .catch() in applyHmrModule's
+    // caller safely falls back to a full reload either way (verified live), so it isn't a
+    // silent failure - just an unclear error message for a rare, transient mid-edit state.
+    const UndefinedComponent = undefined; // eslint-disable-line no-type-assertion/no-type-assertion -- simulating an import resolving to undefined, exactly like a removed export would
+    const window = new Window();
+    const document = window.document; // eslint-disable-line no-type-assertion/no-type-assertion -- happy-dom's Document is structurally compatible
+    class Page extends TungstenStatefulComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "state", {});
+        _defineProperty(this, "content", () => _jsx("div", {
+          children: _jsx("h1", {
+            children: "Welcome"
+          })
+        }));
+      }
+    }
+    class Root extends TungstenSimpleComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "content", () => _jsx(Page, {}));
+      }
+    }
+    const testApp = await createTestApp(Root, {
+      document
+    });
+    const wrapper = testApp.component.__currentContent;
+    if (!WideRenderedContentNodeIsComponent(wrapper) || AnyComponentIsFunctionComponentStandIn(wrapper.element)) {
+      throw new Error('expected the root to directly render a single class component');
+    }
+    const oldElement = wrapper.element;
+    class NewPage extends TungstenStatefulComponent {
+      constructor(...args) {
+        super(...args);
+        _defineProperty(this, "state", {});
+        _defineProperty(this, "content", () => _jsxs("div", {
+          children: [_jsx("h1", {
+            children: "Welcome (edited)"
+          }), _jsx(UndefinedComponent, {})]
+        }));
+      }
+    }
+    let caught;
+    try {
+      await hotSwapClassComponent(oldElement, NewPage);
+    } catch (error) {
+      caught = error;
+    }
+    expect(caught).to.not.equal(undefined);
+    expect(String(caught)).to.contain('did not recognize element');
+    await testApp.unmount();
+  });
+});

package/dist/update/integrateUpdateVdom.d.ts

@@ -1,12 +1,14 @@
 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;
@@ -28,5 +30,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,7 @@ 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";
 function debug(...texts) {
   //console.log(...texts)
   //console.log(getStackTrace().split('\n')[2])
@@ -1135,12 +1136,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 +1189,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 +1214,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 +1234,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":"AASA,wBAAgB,qBAAqB,IAAI,IAAI,CAmB5C"}

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.
+export function warnOnFrameworkChange() {
+  const frameworkDistDir = join(getFrameworkDir(), 'dist');
+  // debounced so one rebuild (many files touched at once) produces one warning, not one per file
+  let debounceTimer = null;
+  const watcher = chokidar.watch(frameworkDistDir, {
+    ignoreInitial: true,
+    awaitWriteFinish: {
+      stabilityThreshold: 200,
+      pollInterval: 20
+    }
+  });
+  watcher.on('all', () => {
+    if (debounceTimer !== null) clearTimeout(debounceTimer);
+    debounceTimer = setTimeout(() => {
+      debounceTimer = null;
+      cliWarn(`tungsten framework files changed (${frameworkDistDir}) - restart the dev server` + ` to pick up the change.`);
+    }, 300);
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tungsten",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "",
   "type": "module",
   "bin": {

package/dist/dev/liveReloadHub.d.ts

@@ -1,6 +0,0 @@
-export type ReloadEventKind = 'js' | 'css';
-type ReloadListener = (kind: ReloadEventKind) => void;
-export declare function onReloadEvent(listener: ReloadListener): () => void;
-export declare function emitReloadEvent(kind: ReloadEventKind): void;
-export {};
-//# sourceMappingURL=liveReloadHub.d.ts.map

package/dist/dev/liveReloadHub.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"liveReloadHub.d.ts","sourceRoot":"","sources":["../../src/dev/liveReloadHub.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,KAAK,CAAA;AAE1C,KAAK,cAAc,GAAG,CAAC,IAAI,EAAE,eAAe,KAAK,IAAI,CAAA;AAIrD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,IAAI,CAGlE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAE3D"}