tungsten 0.3.1 → 0.3.2

package/dist/babelPlugins/BabelAddDevCacheBust.js

@@ -0,0 +1,68 @@
+// BabelAddDevCacheBust
+// exports MakeBabelAddDevCacheBust (function)
+//
+// Dev-only. Appends a `?v=<mtime>` query to every relative import/re-export
+// specifier, versioned off the imported file's own mtime as it sits in
+// codeLocation (the tsc-emitted, pre-final-babel intermediate directory).
+//
+// Without this, the client's HMR reload script only cache-busts the
+// top-level file(s) named in the SSE payload (`?t=<now>`); anything THAT
+// file statically imports by its plain URL still resolves against whatever
+// the browser had cached for that plain URL. On a rename that touches two
+// files in the same edit (e.g. `Button.tsx` renaming an export while
+// `Home.tsx` updates its import of it), the freshly re-fetched `Home.js`'s
+// own static `import ... from '../components/Button.js'` could resolve to a
+// stale cached `Button.js` that doesn't have the new export yet, throwing a
+// genuine browser SyntaxError before HMR ever gets a chance to run - see
+// docs/hmr.md's "stale-module-cache SyntaxError" finding. Stamping every
+// import with the target's current mtime means an edited dependency always
+// gets a URL the browser has never cached, regardless of which file in the
+// chain was named in the SSE event.
+//
+// Must run after BabelTransformJsxExtensionsToJs (registered later in the
+// dev plugin list) so it seess the corrected '.js' specifier - but resolution
+// tries both '.js' and '.jsx' on disk regardless, since codeLocation only
+// ever contains the pre-rename '.jsx' file, so this works whichever order
+// plugins actually end up running in.
+import { dirname, join } from 'path';
+import fs from 'fs';
+function resolveOnDiskMtime(fromDir, specifier) {
+  if (!specifier.startsWith('.')) return undefined;
+  const candidates = specifier.endsWith('.jsx') ? [specifier, specifier.slice(0, -1)] : specifier.endsWith('.js') ? [specifier, `${specifier.slice(0, -3)}.jsx`] : [];
+  for (const candidate of candidates) {
+    const abs = join(fromDir, candidate);
+    if (fs.existsSync(abs)) return fs.statSync(abs).mtimeMs;
+  }
+  return undefined;
+}
+function versionedSpecifier(fromDir, specifier) {
+  const mtimeMs = resolveOnDiskMtime(fromDir, specifier);
+  if (mtimeMs === undefined) return specifier;
+  const separator = specifier.includes('?') ? '&' : '?';
+  return `${specifier}${separator}v=${mtimeMs}`;
+}
+export function MakeBabelAddDevCacheBust() {
+  return function BabelAddDevCacheBust() {
+    let fileDir = '';
+    return {
+      pre(state) {
+        const stateFilename = state.opts.filename;
+        fileDir = typeof stateFilename === 'string' ? dirname(stateFilename) : '';
+      },
+      visitor: {
+        ImportDeclaration(path) {
+          if (fileDir === '') return;
+          path.node.source.value = versionedSpecifier(fileDir, path.node.source.value);
+        },
+        ExportNamedDeclaration(path) {
+          if (fileDir === '' || path.node.source == null) return;
+          path.node.source.value = versionedSpecifier(fileDir, path.node.source.value);
+        },
+        ExportAllDeclaration(path) {
+          if (fileDir === '') return;
+          path.node.source.value = versionedSpecifier(fileDir, path.node.source.value);
+        }
+      }
+    };
+  };
+}

package/dist/babelPlugins/BabelAddDevCacheBust.sxyt.d.ts

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

package/dist/babelPlugins/BabelAddDevCacheBust.sxyt.d.ts.map

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

package/dist/babelPlugins/BabelAddDevCacheBust.sxyt.js

@@ -0,0 +1,138 @@
+import { expect } from 'chai';
+import { describe } from 'sxy-test-runner';
+import { transformSync } from '@babel/core';
+import { mkdir, mkdtemp, rm, writeFile, utimes } from 'fs/promises';
+import { statSync, readFileSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { MakeBabelAddDevCacheBust } from "./BabelAddDevCacheBust.js";
+async function makeFixture() {
+  const dir = await mkdtemp(join(tmpdir(), 'tungsten-add-dev-cache-bust-'));
+  const components = join(dir, 'components');
+  const pages = join(dir, 'pages');
+  await mkdir(components, {
+    recursive: true
+  });
+  await mkdir(pages, {
+    recursive: true
+  });
+  const buttonPath = join(components, 'Button.jsx');
+  await writeFile(buttonPath, `export function Button() { return null }\n`);
+  const homePath = join(pages, 'Home.jsx');
+  await writeFile(homePath, `import { Button } from '../components/Button.jsx'\nexport const x = Button\n`);
+  return {
+    dir,
+    buttonPath,
+    homePath,
+    components,
+    pages
+  };
+}
+function transform(filename) {
+  const result = transformSync(readFileSync(filename, 'utf8'), {
+    filename,
+    babelrc: false,
+    configFile: false,
+    plugins: [MakeBabelAddDevCacheBust()]
+  });
+  if (result === null || typeof result.code !== 'string') throw new Error('babel transform returned no code');
+  return result.code;
+}
+describe('BabelAddDevCacheBust', ({
+  it
+}) => {
+  it(`appends the imported file's on-disk mtime as a '?v=' query to a relative import`, async () => {
+    const {
+      dir,
+      buttonPath,
+      homePath
+    } = await makeFixture();
+    try {
+      const code = transform(homePath);
+      const mtimeMs = statSync(buttonPath).mtimeMs;
+      expect(code).to.contain(`../components/Button.jsx?v=${mtimeMs}`);
+    } finally {
+      await rm(dir, {
+        recursive: true,
+        force: true
+      });
+    }
+  });
+  it(`produces a different '?v=' value once the imported file is edited - so a fresh dependent refetch resolves a URL the browser has never cached`, async () => {
+    const {
+      dir,
+      buttonPath,
+      homePath
+    } = await makeFixture();
+    try {
+      const before = transform(homePath);
+      const beforeMatch = before.match(/\?v=([0-9.]+)["']/);
+      expect(beforeMatch).to.not.equal(null);
+      // simulate the developer editing Button.jsx a moment later
+      const future = new Date(Date.now() + 5000);
+      await utimes(buttonPath, future, future);
+      const after = transform(homePath);
+      const afterMatch = after.match(/\?v=([0-9.]+)["']/);
+      expect(afterMatch).to.not.equal(null);
+      expect(afterMatch[1]).to.not.equal(beforeMatch[1]);
+    } finally {
+      await rm(dir, {
+        recursive: true,
+        force: true
+      });
+    }
+  });
+  it(`resolves correctly even when the specifier's extension has already been rewritten from .jsx to .js by an earlier plugin`, async () => {
+    const {
+      dir,
+      buttonPath,
+      pages
+    } = await makeFixture();
+    try {
+      const homeAlreadyJsPath = join(pages, 'HomeAlreadyJs.jsx');
+      await writeFile(homeAlreadyJsPath, `import { Button } from '../components/Button.js'\nexport const x = Button\n`);
+      const code = transform(homeAlreadyJsPath);
+      const mtimeMs = statSync(buttonPath).mtimeMs;
+      expect(code).to.contain(`../components/Button.js?v=${mtimeMs}`);
+    } finally {
+      await rm(dir, {
+        recursive: true,
+        force: true
+      });
+    }
+  });
+  it(`leaves a bare (package) import untouched`, async () => {
+    const {
+      dir,
+      homePath
+    } = await makeFixture();
+    try {
+      await writeFile(homePath, `import { StatefulComponent } from 'tungsten'\nexport const x = StatefulComponent\n`);
+      const code = transform(homePath);
+      expect(code).to.contain(`tungsten`);
+      expect(code).to.not.contain(`?v=`);
+    } finally {
+      await rm(dir, {
+        recursive: true,
+        force: true
+      });
+    }
+  });
+  it(`leaves a relative import untouched when the target file cannot be found on disk`, async () => {
+    const {
+      dir,
+      homePath
+    } = await makeFixture();
+    try {
+      await writeFile(homePath, `import { Ghost } from '../components/Ghost.jsx'\nexport const x = Ghost\n`);
+      const code = transform(homePath);
+      expect(code).to.contain(`../components/Ghost.jsx`);
+      expect(code).to.not.contain(`?v=`);
+    } finally {
+      await rm(dir, {
+        recursive: true,
+        force: true
+      });
+    }
+  });
+});

package/dist/bin/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/dev.ts"],"names":[],"mappings":"AAwCA,OAAO,EAAE,CAAA"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/dev.ts"],"names":[],"mappings":"AA2CA,OAAO,EAAE,CAAA"}

package/dist/bin/commands/dev.js

@@ -1,6 +1,7 @@
 import open from 'open';
 import { cliOut } from "../../cliOutput.js";
 import { Framework } from "../../Framework.js";
+import { warnOnFrameworkChange } from "../../warnOnFrameworkChange.js";
 //import dotenv from 'dotenv'
 //dotenv.config({ path: '.private.env' })
 cliOut(`Starting dev mode`);
@@ -17,6 +18,7 @@ await sxyFramework.build('dev');
 const devServer = await sxyFramework.createDevServer();
 //cliOut('Dev server ready')
 const devServerLocation = await devServer.start();
+if (sxyFramework.config?.warnOnFrameworkChange) warnOnFrameworkChange();
 // do a dummy request to trigger any error immediately during dev
 //axios.get(sxyFramework.devServer.location)
 cliOut('Booting to the dev site in your browser');

package/dist/build/compileUserApp.js

@@ -5,7 +5,7 @@ import { copyAssets } from "./copyAssets.js";
 import { copyPublicFiles } from "./copyPublicFiles.js";
 import { buildCodeSubPath, bundleFolder, devBuildOuterFolder, prodBuildFolder } from "../settings.js";
 import { combineComponentCss } from "./combineComponentCss.js";
-import { emitReloadEvent } from "../dev/liveReloadHub.js";
+import { emitReloadEvent } from "../hmr/liveReloadHub.js";
 //import { compileEnv } from './compileEnv.js'
 export async function compileUserApp(projectDir, appConfig, mode) {
   const codeLocation = join(projectDir, appConfig.codeDir);
@@ -17,7 +17,7 @@ export async function compileUserApp(projectDir, appConfig, mode) {
   const buildCodeLocation = join(buildLocation, codeSubPath);
   const compileJavascriptPromise = compileJavascript(projectDir, appConfig, codeLocation, sourceLocation, styleImportBase, buildLocation, buildCodeLocation, mode, true, mode === 'dev' ? {
     onCycleComplete: cycle => {
-      if (cycle.success) emitReloadEvent('js');
+      if (cycle.success) emitReloadEvent('js', cycle.file);
     }
   } : {});
   //const compileEnvPromise = compileEnv(projectDir, appConfig, codeLocation, buildLocation, mode)

package/dist/build/makeBabelUserDevConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"makeBabelUserDevConfig.d.ts","sourceRoot":"","sources":["../../src/build/makeBabelUserDevConfig.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAKnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,EAAoC,eAAe,EAAE,MAAM,iDAAiD,CAAA;AAMnH,wBAAgB,sBAAsB,CAClC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,kBAAkB,EAAE,MAAM,EAC1B,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,qBAAqB,EAAE,MAAM,EAC7B,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAAC,EAChD,kBAAkB,EAAE,eAAe,EACnC,eAAe,EAAE,eAAe,EAChC,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,GACzB,gBAAgB,CA4BlB"}
+{"version":3,"file":"makeBabelUserDevConfig.d.ts","sourceRoot":"","sources":["../../src/build/makeBabelUserDevConfig.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAKnD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAEvD,OAAO,EAAoC,eAAe,EAAE,MAAM,iDAAiD,CAAA;AAOnH,wBAAgB,sBAAsB,CAClC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,kBAAkB,EAAE,MAAM,EAC1B,aAAa,EAAE,MAAM,EACrB,iBAAiB,EAAE,MAAM,EACzB,qBAAqB,EAAE,MAAM,EAC7B,2BAA2B,EAAE,WAAW,CAAC,MAAM,CAAC,EAChD,kBAAkB,EAAE,eAAe,EACnC,eAAe,EAAE,eAAe,EAChC,aAAa,EAAE,aAAa,EAC5B,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE,GACzB,gBAAgB,CAgClB"}

package/dist/build/makeBabelUserDevConfig.js

@@ -6,6 +6,7 @@ import { MakeBabelTransformPackageImports } from "../babelPlugins/BabelTransform
 import { componentCssFolder, componentCssFile } from "../settings.js";
 import userCommonConfig from "./babel.user.common.config.js";
 import { MakeBabelTransformCssImports } from "../babelPlugins/BabelTransformCssImports.js";
+import { MakeBabelAddDevCacheBust } from "../babelPlugins/BabelAddDevCacheBust.js";
 export function makeBabelUserDevConfig(projectDir, absCodeDir, absSourceDir, absStyleImportBase, buildLocation, buildCodeLocation, packagesCacheLocation, skipPackageCompilationFiles, oldDependencyGraph, dependencyGraph, importAliases, promises) {
   const userDevConfig = objectCopy(userCommonConfig);
   userDevConfig.plugins.push(MakeBabelTransformPackageImports({
@@ -29,6 +30,10 @@ export function makeBabelUserDevConfig(projectDir, absCodeDir, absSourceDir, abs
     projectAbsStyleImportDir: absStyleImportBase,
     classNameFormat: '[folder]-[name]_[local]',
     cssOutputFile: join(buildLocation, componentCssFolder, componentCssFile)
-  }));
+  }),
+  // Dev-only: keeps every relative import's browser-cached URL in sync with the
+  // imported file's own on-disk mtime - see BabelAddDevCacheBust.ts and
+  // docs/hmr.md's "stale-module-cache SyntaxError" finding.
+  MakeBabelAddDevCacheBust());
   return userDevConfig;
 }

package/dist/defaultConfig.d.ts

@@ -15,6 +15,8 @@ export declare const defaultConfig: {
     apiPath: string;
     suppressNoHeadWarning: false;
     suppressOriginMismatchWarning: false;
+    warnOnFrameworkChange: true;
+    hmr: true;
 };
 export type FrameworkConfigDefault = typeof defaultConfig;
 //# sourceMappingURL=defaultConfig.d.ts.map

package/dist/defaultConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaultConfig.d.ts","sourceRoot":"","sources":["../src/defaultConfig.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;CAqBS,CAAA;AAEnC,MAAM,MAAM,sBAAsB,GAAG,OAAO,aAAa,CAAA"}
+{"version":3,"file":"defaultConfig.d.ts","sourceRoot":"","sources":["../src/defaultConfig.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;CAuBS,CAAA;AAEnC,MAAM,MAAM,sBAAsB,GAAG,OAAO,aAAa,CAAA"}

package/dist/defaultConfig.js

@@ -20,5 +20,7 @@ export const defaultConfig = {
   apiPath: '/api',
   //debug: false // moved to env
   suppressNoHeadWarning: false,
-  suppressOriginMismatchWarning: false
+  suppressOriginMismatchWarning: false,
+  warnOnFrameworkChange: true,
+  hmr: true
 };

package/dist/env/getEnvSchemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getEnvSchemas.d.ts","sourceRoot":"","sources":["../../src/env/getEnvSchemas.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAEpE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAI7B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,MAAM,MAAM,UAAU,GAAG;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC,WAAW,GAAG,kBAAkB,CAAC,CAAC;IAC7D,eAAe,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1C,CAAA;AAKD,wBAAsB,aAAa,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAChG,OAAO,CAAC,UAAU,CAAC,CAAA;AACrB,wBAAsB,aAAa,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,GACjG,OAAO,CAAC,UAAU,CAAC,CAAA;AAoErB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,uBAGlF"}
+{"version":3,"file":"getEnvSchemas.d.ts","sourceRoot":"","sources":["../../src/env/getEnvSchemas.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAA;AAEpE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,CAAA;AAK7B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAGxC,MAAM,MAAM,UAAU,GAAG;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC,WAAW,GAAG,kBAAkB,CAAC,CAAC;IAC7D,eAAe,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;CAC1C,CAAA;AAKD,wBAAsB,aAAa,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAChG,OAAO,CAAC,UAAU,CAAC,CAAA;AACrB,wBAAsB,aAAa,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,GACjG,OAAO,CAAC,UAAU,CAAC,CAAA;AAoErB,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,uBAGlF"}

package/dist/env/getEnvSchemas.js

@@ -2,6 +2,7 @@ import { join } from 'path';
 import { fixExtension } from "../fixExtension.js";
 import { throwError } from "../throwError.js";
 import { iterationQueryString } from "../iterationQueryString.js";
+import { importDevModuleWithRetry } from "../importDevModuleWithRetry.js";
 export async function getEnvSchemas(config, iteration = null, mode = 'prod') {
   const {
     envSchemasLocation
@@ -16,7 +17,7 @@ export async function getEnvSchemas(config, iteration = null, mode = 'prod') {
       if (iteration === null) throwError('getEnvSchemas()', 'iteration is null');
       //if (!load) throwError('getEnvSchemas()', 'load is null')
       //module = await load(fullFilePath)
-      module = await import(iterationQueryString(fullFilePath, iteration));
+      module = await importDevModuleWithRetry(iterationQueryString(fullFilePath, iteration));
     } else {
       module = await import(fullFilePath);
     }

package/dist/getComponent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getComponent.d.ts","sourceRoot":"","sources":["../src/getComponent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAG7D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAMhC,wBAAsB,YAAY,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAEhB,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,IAAI,GAAE,IAAa,GACpB,OAAO,CAAC,gBAAgB,CAAC,CA6B3B"}
+{"version":3,"file":"getComponent.d.ts","sourceRoot":"","sources":["../src/getComponent.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAG7D,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAOhC,wBAAsB,YAAY,CAC9B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAEhB,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,IAAI,GAAE,IAAa,GACpB,OAAO,CAAC,gBAAgB,CAAC,CA6B3B"}

package/dist/getComponent.js

@@ -2,6 +2,7 @@ import { fixExtension } from "./fixExtension.js";
 import { TungstenError } from "./TungstenError.js";
 import { throwError } from "./throwError.js";
 import { iterationQueryString } from "./iterationQueryString.js";
+import { importDevModuleWithRetry } from "./importDevModuleWithRetry.js";
 //let load //// !! future improvement
 export async function getComponent(filePath, filename,
 //load: Load | null = null,
@@ -16,7 +17,7 @@ iteration = null, mode = 'prod') {
     //const load = await createLoad(import.meta.url, sxyLoaderConfig)
     //console.log('load', filePath)
     //module = await load(filePath)
-    module = await import(iterationQueryString(filePath, iteration));
+    module = await importDevModuleWithRetry(iterationQueryString(filePath, iteration));
   } else {
     //console.log('import', filePath)
     module = await import(filePath); // import the module

package/dist/getRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"getRoutes.d.ts","sourceRoot":"","sources":["../src/getRoutes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGrC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAK5D,wBAAsB,SAAS,CAC3B,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,uBAAuB,EAE/B,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,IAAI,GAAE,IAAa,GACnB,OAAO,CAAC,SAAS,CAAC,CAmCrB"}
+{"version":3,"file":"getRoutes.d.ts","sourceRoot":"","sources":["../src/getRoutes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGrC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAE9D,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAM5D,wBAAsB,SAAS,CAC3B,eAAe,EAAE,eAAe,EAChC,MAAM,EAAE,uBAAuB,EAE/B,SAAS,GAAE,MAAM,GAAG,IAAW,EAC/B,IAAI,GAAE,IAAa,GACnB,OAAO,CAAC,SAAS,CAAC,CAmCrB"}

package/dist/getRoutes.js

@@ -3,6 +3,7 @@ import { fixExtension } from "./fixExtension.js";
 import { TungstenError } from "./TungstenError.js";
 import { iterationQueryString } from "./iterationQueryString.js";
 import { throwError } from "./throwError.js";
+import { importDevModuleWithRetry } from "./importDevModuleWithRetry.js";
 export async function getRoutes(compilationInfo, config,
 //load: Load | null = null,
 iteration = null, mode = 'prod') {
@@ -22,7 +23,7 @@ iteration = null, mode = 'prod') {
       // can we share load across the render?
       //const load = await createLoad(import.meta.url, sxyLoaderConfig)
       //module = await load(filePath)
-      module = await import(iterationQueryString(filePath, iteration));
+      module = await importDevModuleWithRetry(iterationQueryString(filePath, iteration));
     } else {
       module = await import(filePath); // import the module
     }

package/dist/hmr/applyHmrModule.d.ts

@@ -0,0 +1,11 @@
+export { refreshStylesheets } from './refreshStylesheets.js';
+export type ApplyHmrModuleResult = {
+    matched: true;
+    count: number;
+    orphaned: boolean;
+} | {
+    matched: false;
+    orphaned: boolean;
+};
+export declare function applyHmrModule(moduleExports: Record<string, unknown>, file?: string): Promise<ApplyHmrModuleResult>;
+//# sourceMappingURL=applyHmrModule.d.ts.map

package/dist/hmr/applyHmrModule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"applyHmrModule.d.ts","sourceRoot":"","sources":["../../src/hmr/applyHmrModule.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAE5D,MAAM,MAAM,oBAAoB,GAC1B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GACnD;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAA;AAsB3C,wBAAsB,cAAc,CAChC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,MAAM,GACtD,OAAO,CAAC,oBAAoB,CAAC,CAkD/B"}

package/dist/hmr/applyHmrModule.js

@@ -0,0 +1,78 @@
+import { AnyComponentIsFunctionComponentStandIn } from "../AnyComponent.js";
+import { hotSwapClassComponent, hotSwapFunctionComponent } from "../update/integrateUpdateVdom.js";
+import { componentTypeIdentityKey, componentTypeKind, liveComponentIdentityKey, liveComponentKind } from "./componentIdentity.js";
+import { getCurrentInstance } from "./instanceRegistry.js";
+export { refreshStylesheets } from "./refreshStylesheets.js";
+function identityToken(kind, key) {
+  return `${kind}:${key}`;
+}
+function tokenKind(token) {
+  return token.startsWith('function:') ? 'function' : 'class';
+}
+function tokenKey(token) {
+  return token.slice(token.indexOf(':') + 1);
+}
+// Per source file, the set of component identity tokens ('kind:key') it exported the last time
+// this ran. Lets a later edit to the same file detect "this used to export a component that's
+// still live, and doesn't anymore" (a rename or delete) - see tungsten/docs/hmr.md's "orphaned
+// components" note. Cleared naturally on a real page load, since this module state doesn't
+// survive a full reload.
+const previousFileExportIdentities = new Map();
+// Given the freshly re-imported exports of one recompiled file, find every live component
+// instance that came from a same-named, same-kind definition and rebuild it in place. See
+// tungsten/docs/hmr.md for the full design and the reasoning behind the identity key.
+export async function applyHmrModule(moduleExports, file) {
+  const instance = getCurrentInstance();
+  if (instance === undefined) return {
+    matched: false,
+    orphaned: false
+  };
+  let matchedCount = 0;
+  const currentIdentities = new Set();
+  for (const exportName in moduleExports) {
+    const exported = moduleExports[exportName];
+    if (typeof exported !== 'function') continue;
+    const NewType = exported; // eslint-disable-line no-type-assertion/no-type-assertion -- narrowed by typeof above, definitively a function/class value
+    const newKind = componentTypeKind(NewType);
+    const newKey = componentTypeIdentityKey(NewType);
+    currentIdentities.add(identityToken(newKind, newKey));
+    // snapshot: hot-swapping unregisters the old instance and registers its replacement,
+    // mutating registeredComponents mid-loop otherwise
+    for (const component of [...instance.registeredComponents]) {
+      const anyComponent = component; // eslint-disable-line no-type-assertion/no-type-assertion -- every registered component is actually a class instance or FunctionElement stand-in
+      if (liveComponentKind(anyComponent) !== newKind) continue;
+      if (liveComponentIdentityKey(anyComponent) !== newKey) continue;
+      const swapped = AnyComponentIsFunctionComponentStandIn(anyComponent) ? await hotSwapFunctionComponent(anyComponent, NewType) // eslint-disable-line no-type-assertion/no-type-assertion -- newKind === 'function' guaranteed by the kind check above
+      : await hotSwapClassComponent(anyComponent, NewType); // eslint-disable-line no-type-assertion/no-type-assertion -- newKind === 'class' guaranteed by the kind check above
+      if (swapped !== null) matchedCount++;
+    }
+  }
+  let orphaned = false;
+  if (file !== undefined) {
+    const previousIdentities = previousFileExportIdentities.get(file);
+    if (previousIdentities !== undefined) {
+      for (const previousToken of previousIdentities) {
+        if (currentIdentities.has(previousToken)) continue;
+        const kind = tokenKind(previousToken);
+        const key = tokenKey(previousToken);
+        const stillLive = [...instance.registeredComponents].some(component => {
+          const anyComponent = component; // eslint-disable-line no-type-assertion/no-type-assertion -- every registered component is actually a class instance or FunctionElement stand-in
+          return liveComponentKind(anyComponent) === kind && liveComponentIdentityKey(anyComponent) === key;
+        });
+        if (stillLive) {
+          orphaned = true;
+          break;
+        }
+      }
+    }
+    previousFileExportIdentities.set(file, currentIdentities);
+  }
+  return matchedCount > 0 ? {
+    matched: true,
+    count: matchedCount,
+    orphaned
+  } : {
+    matched: false,
+    orphaned
+  };
+}

package/dist/hmr/applyHmrModule.sxyt.d.ts

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

package/dist/hmr/applyHmrModule.sxyt.d.ts.map

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