tungsten 0.4.11 → 0.4.13

package/dist/babelPlugins/fixImportsInSassErrorMessage.js

@@ -1,4 +1,4 @@
-import { throwError } from "../throwError.js";
+import { throwError } from '../throwError.js';
 // RegEx: @use or @import, 0 or spaces or tabs, followed by an import target in single or double quotes
 const useOrImportRegex = /@(?:use|import)[ \t]*(?:'([^']+)'|"([^']+)")/g;
 // the line optionally starts with digits, spaces then pipe |, and after has 1 or more ^, and to the left and the right is only spaces or more carets

package/dist/babelPlugins/test.js

@@ -1,4 +1,4 @@
-import { fixImportsInSassErrorMessage } from "./fixImportsInSassErrorMessage.js";
+import { fixImportsInSassErrorMessage } from './fixImportsInSassErrorMessage.js';
 const input = `
   @import '../foo'
   ^^^^^^^^^^^^^^^^

package/dist/babelPlugins/transformPackageImports/BabelTransformDependencyImportsCjs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BabelTransformDependencyImportsCjs.d.ts","sourceRoot":"","sources":["../../../src/babelPlugins/transformPackageImports/BabelTransformDependencyImportsCjs.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,KAAK,SAAS,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAc,MAAM,aAAa,CAAA;AAC7D,KAAK,KAAK,GAAG,OAAO,SAAS,CAAC;AAM9B,OAAO,EACH,oBAAoB,EAAE,sBAAsB,EAC5C,KAAK,cAAc,EAAmB,KAAK,iBAAiB,EAC/D,MAAM,cAAc,CAAA;AAIrB,OAAO,KAAK,EACR,oBAAoB,EAAE,qBAAqB,EAAE,oCAAoC,EACjF,uCAAuC,EAAE,oBAAoB,EAChE,MAAM,oCAAoC,CAAA;AAU3C,KAAK,IAAI,GAAG;IACR,UAAU,EAAE,MAAM,EAAE,CAAA;CACvB,CAAA;AAED,KAAK,KAAK,GAAG;IACT,oBAAoB,EAAE,oBAAoB,CAAA;IAC1C,qBAAqB,EAAE,qBAAqB,CAAA;IAC5C,oCAAoC,EAAE,oCAAoC,CAAA;IAC1E,uCAAuC,EAAE,uCAAuC,CAAA;IAChF,oBAAoB,EAAE,oBAAoB,CAAA;CAC7C,CAAA;AAED,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,IACxB,OAAO,KAAK;eAoC5C,SAAS;;kCAcmB,QAAQ,CAAC,iBAAiB,CAAC;uCAKtB,QAAQ,CAAC,sBAAsB,CAAC;qCAOlC,QAAQ,CAAC,oBAAoB,CAAC;6BAO/C,QAAQ,CAAC,cAAc,CAAC;;EAiE5D"}
+{"version":3,"file":"BabelTransformDependencyImportsCjs.d.ts","sourceRoot":"","sources":["../../../src/babelPlugins/transformPackageImports/BabelTransformDependencyImportsCjs.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,KAAK,SAAS,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACjD,KAAK,KAAK,GAAG,OAAO,SAAS,CAAC;AAK9B,OAAO,EACH,oBAAoB,EAAE,sBAAsB,EAC5C,KAAK,cAAc,EAAmB,KAAK,iBAAiB,EAC/D,MAAM,cAAc,CAAA;AAIrB,OAAO,KAAK,EACR,oBAAoB,EAAE,qBAAqB,EAAE,oCAAoC,EACjF,uCAAuC,EAAE,oBAAoB,EAChE,MAAM,oCAAoC,CAAA;AAU3C,KAAK,IAAI,GAAG;IACR,UAAU,EAAE,MAAM,EAAE,CAAA;CACvB,CAAA;AAED,KAAK,KAAK,GAAG;IACT,oBAAoB,EAAE,oBAAoB,CAAA;IAC1C,qBAAqB,EAAE,qBAAqB,CAAA;IAC5C,oCAAoC,EAAE,oCAAoC,CAAA;IAC1E,uCAAuC,EAAE,uCAAuC,CAAA;IAChF,oBAAoB,EAAE,oBAAoB,CAAA;CAC7C,CAAA;AAED,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,IACxB,OAAO,KAAK;eAoC5C,SAAS;;kCAcmB,QAAQ,CAAC,iBAAiB,CAAC;uCAKtB,QAAQ,CAAC,sBAAsB,CAAC;qCAOlC,QAAQ,CAAC,oBAAoB,CAAC;6BAO/C,QAAQ,CAAC,cAAc,CAAC;;EAiE5D"}

package/dist/babelPlugins/transformPackageImports/BabelTransformDependencyImportsCjs.js

@@ -7,11 +7,12 @@
 //    funcs from the parent to do various things.
 //    passed in from the parent because this allows them to use a central cache
 // }
+//import type { types as Types } from '@babel/core';
 import { dirname, relative } from 'path';
-import slash from 'slash';
-import { isBareImport } from "../isBareImport.js";
-import { cliWarn } from "../../cliOutput.js";
-import { warn } from "../../output.js";
+import slash from '../../slash.js';
+import { isBareImport } from '../isBareImport.js';
+import { cliWarn } from '../../cliOutput.js';
+import { warn } from '../../output.js';
 import { TungstenError } from 'tungsten/TungstenError.js';
 export function MakeBabelTransformDependencyImportsCjs(opts, funcs) {
   return function BabelTransformDependencyImportsCjs(babel) {

package/dist/babelPlugins/transformPackageImports/BabelTransformDependencyImportsEsm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BabelTransformDependencyImportsEsm.d.ts","sourceRoot":"","sources":["../../../src/babelPlugins/transformPackageImports/BabelTransformDependencyImportsEsm.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,KAAK,SAAS,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAc,MAAM,aAAa,CAAA;AAC7D,KAAK,KAAK,GAAG,OAAO,SAAS,CAAC;AAO9B,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAI9G,OAAO,KAAK,EACR,oBAAoB,EAAE,qBAAqB,EAAE,oCAAoC,EACjF,oBAAoB,EAAE,gBAAgB,EACzC,MAAM,oCAAoC,CAAA;AAM3C,KAAK,IAAI,GAAG;IACR,UAAU,EAAE,MAAM,EAAE,CAAA;CACvB,CAAA;AAED,KAAK,KAAK,GAAG;IACT,oBAAoB,EAAE,oBAAoB,CAAA;IAC1C,qBAAqB,EAAE,qBAAqB,CAAA;IAC5C,oCAAoC,EAAE,oCAAoC,CAAA;IAC1E,oBAAoB,EAAE,oBAAoB,CAAA;IAC1C,gBAAgB,EAAE,gBAAgB,CAAA;CACrC,CAAA;AAED,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,IACxB,OAAO,KAAK;eA0B5C,SAAS;;gCAWQ,QAAQ,CAAC,iBAAiB,CAAC;uCAYX,QAAQ,CAAC,sBAAsB,CAAC;qCAalC,QAAQ,CAAC,oBAAoB,CAAC;6BAa/C,QAAQ,CAAC,cAAc,CAAC;;EAiC5D"}
+{"version":3,"file":"BabelTransformDependencyImportsEsm.d.ts","sourceRoot":"","sources":["../../../src/babelPlugins/transformPackageImports/BabelTransformDependencyImportsEsm.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,KAAK,SAAS,MAAM,aAAa,CAAA;AAC7C,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACjD,KAAK,KAAK,GAAG,OAAO,SAAS,CAAC;AAM9B,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAI9G,OAAO,KAAK,EACR,oBAAoB,EAAE,qBAAqB,EAAE,oCAAoC,EACjF,oBAAoB,EAAE,gBAAgB,EACzC,MAAM,oCAAoC,CAAA;AAM3C,KAAK,IAAI,GAAG;IACR,UAAU,EAAE,MAAM,EAAE,CAAA;CACvB,CAAA;AAED,KAAK,KAAK,GAAG;IACT,oBAAoB,EAAE,oBAAoB,CAAA;IAC1C,qBAAqB,EAAE,qBAAqB,CAAA;IAC5C,oCAAoC,EAAE,oCAAoC,CAAA;IAC1E,oBAAoB,EAAE,oBAAoB,CAAA;IAC1C,gBAAgB,EAAE,gBAAgB,CAAA;CACrC,CAAA;AAED,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,IACxB,OAAO,KAAK;eA0B5C,SAAS;;gCAWQ,QAAQ,CAAC,iBAAiB,CAAC;uCAYX,QAAQ,CAAC,sBAAsB,CAAC;qCAalC,QAAQ,CAAC,oBAAoB,CAAC;6BAa/C,QAAQ,CAAC,cAAc,CAAC;;EAiC5D"}

package/dist/babelPlugins/transformPackageImports/BabelTransformDependencyImportsEsm.js

@@ -7,9 +7,10 @@
 //    funcs from the parent to do various things.
 //    passed in from the parent because this allows them to use a central cache
 // }
+//import type { types as Types } from '@babel/core';
 import { dirname, relative } from 'path';
-import slash from 'slash';
-import { isBareImport } from "../isBareImport.js";
+import slash from '../../slash.js';
+import { isBareImport } from '../isBareImport.js';
 import { throwError } from 'tungsten/throwError.js';
 import { cliError, cliOut } from 'tungsten/cliOutput.js';
 export function MakeBabelTransformDependencyImportsEsm(opts, funcs) {

package/dist/babelPlugins/transformPackageImports/getWebLocationOfPackageFile.js

@@ -1,6 +1,6 @@
 import { dirname } from 'path';
-import { TungstenError } from "../../TungstenError.js";
-import { findProjectDir } from "../../findProjectDir.js";
+import { TungstenError } from '../../TungstenError.js';
+import { findProjectDir } from '../../findProjectDir.js';
 const getPackageDirForDirCache = {};
 function getPackageDirForDir(dir) {
   if (dir in getPackageDirForDirCache) {

package/dist/bin/args.js

@@ -1,4 +1,4 @@
-import { cliError, cliOut } from "../cliOutput.js";
+import { cliError, cliOut } from '../cliOutput.js';
 export function cliArgs(specs, options = {}) {
   // after node and the script come the command word and its arguments
   const [command = '', ...given] = process.argv.slice(2);
@@ -59,7 +59,7 @@ export function cliArgs(specs, options = {}) {
       parsed[name] = flag.startsWith('--no-') ? !on : on;
     }
   }
-  return parsed; // eslint-disable-line no-type-assertion/no-type-assertion -- built from specs' own keys
+  return parsed; // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- built from specs' own keys
 }
 // '--ignore-dirs <dir>...' -> its flag, that it takes a value, and that it may be given more than once
 function shapeOf(spec) {

package/dist/bin/commands/build.js

@@ -1,10 +1,10 @@
 // build
 import chalk from 'chalk-extensions';
-import { Framework } from "../../Framework.js";
-import { cliOut, cliNews, cliWarn } from "../../cliOutput.js";
-import { staticSiteFolder } from "../../settings.js";
-import { createTimeProfiler, reportRunTotal, reportStartupPhase } from "../../timeProfiler.js";
-import { cliArgs } from "../args.js";
+import { Framework } from '../../Framework.js';
+import { cliOut, cliNews, cliWarn } from '../../cliOutput.js';
+import { staticSiteFolder } from '../../settings.js';
+import { createTimeProfiler, reportRunTotal, reportStartupPhase } from '../../timeProfiler.js';
+import { cliArgs } from '../args.js';
 // first statement in the body, so it closes off the import evaluation above
 reportStartupPhase('load build modules');
 // --help never reaches here - bin/index.ts routes it to buildHelp.ts before this module loads
@@ -34,7 +34,7 @@ await sxyFramework.build('prod');
 // }
 // //// end dev
 if (sxyFramework.config.staticSite) {
-  // eslint-disable-line @typescript-eslint/no-non-null-assertion, no-type-assertion/no-type-assertion -- config better be set
+  // eslint-disable-line @typescript-eslint/no-non-null-assertion, @typescript-eslint/no-unsafe-type-assertion -- config better be set
   if (!quiet) cliOut(`Building static site`);
   await sxyFramework.clean('staticSite');
   await sxyFramework.staticGen();

package/dist/bin/commands/buildHelp.js

@@ -1,5 +1,5 @@
 // kept out of build.ts so --help does not pay for resolving the build's import tree
-import { cliOut } from "../../cliOutput.js";
+import { cliOut } from '../../cliOutput.js';
 cliOut(`Usage: tungsten build [--profile] [--profile-modules] [--quiet]
 
 Options:

package/dist/bin/commands/clean.js

@@ -1,9 +1,9 @@
 // build
 import chalk from 'chalk-extensions';
-import { Framework } from "../../Framework.js";
-import { cliOut } from "../../cliOutput.js";
-import { packageNameCapitalized } from "../../settings.js";
-import { cliArgs } from "../args.js";
+import { Framework } from '../../Framework.js';
+import { cliOut } from '../../cliOutput.js';
+import { packageNameCapitalized } from '../../settings.js';
+import { cliArgs } from '../args.js';
 cliArgs({}); // accepts nothing but --help
 //// prep the app
 const sxyFramework = new Framework();

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

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

package/dist/bin/commands/compile.js

@@ -1,18 +1,18 @@
 import { dirname, join, resolve } from 'path';
 import { promises as fsPromises } from 'fs';
-import { removeRecursive } from "../../removeRecursive.js";
-import { compileJavascript } from "../../build/compileJavascript.js";
-import { compileStyles } from "../../build/compileStyles.js";
-import { writeFrameworkCss } from "../../build/frameworkStylesheets.js";
-import { copyAssets } from "../../build/copyAssets.js";
-import { copyPublicFiles } from "../../build/copyPublicFiles.js";
-import { createClientFiles } from "../../build/createClientFiles.js";
-import { createInstanceConfigFile } from "../../build/createInstanceConfigFile.js";
-import { getUserConfig } from "../../getUserConfig.js";
-import { buildCodeSubPath, assetsFolder, clientFolder, componentCssFolder, devBuildOuterFolder, frameworkCssFolder, packagesCacheFolder, packagesFolder, publicFolder, staticFolder } from "../../settings.js";
-import { cliError, cliNews, cliOut } from "../../cliOutput.js";
-import { createTimeProfiler, reportRunTotal, reportStartupPhase } from "../../timeProfiler.js";
-import { cliArgs } from "../args.js";
+import { removeRecursive } from '../../removeRecursive.js';
+import { compileJavascript } from '../../build/compileJavascript.js';
+import { compileStyles } from '../../build/compileStyles.js';
+import { writeFrameworkCss } from '../../build/frameworkStylesheets.js';
+import { copyAssets } from '../../build/copyAssets.js';
+import { copyPublicFiles } from '../../build/copyPublicFiles.js';
+import { createClientFiles } from '../../build/createClientFiles.js';
+import { createInstanceConfigFile } from '../../build/createInstanceConfigFile.js';
+import { getUserConfig } from '../../getUserConfig.js';
+import { buildCodeSubPath, assetsFolder, clientFolder, componentCssFolder, devBuildOuterFolder, devRawBuildFolder, frameworkCssFolder, packagesCacheFolder, stylesCacheFolder, packagesFolder, publicFolder, staticFolder } from '../../settings.js';
+import { cliError, cliNews, cliOut } from '../../cliOutput.js';
+import { createTimeProfiler, reportRunTotal, reportStartupPhase } from '../../timeProfiler.js';
+import { cliArgs } from '../args.js';
 // first statement in the body, so it closes off the import evaluation above
 reportStartupPhase('load compile modules');
 const {
@@ -31,7 +31,8 @@ const {
   readyFile: readyFileOption,
   ignoreDirs,
   ignorePatterns,
-  tests
+  tests,
+  fresh
 } = cliArgs({
   js: '--js',
   css: '--css',
@@ -48,10 +49,11 @@ const {
   readyFile: '--ready-file <file>',
   ignoreDirs: '--ignore-dirs <dir>...',
   ignorePatterns: '--ignore-patterns <pattern>...',
-  tests: '--tests'
+  tests: '--tests',
+  fresh: '--fresh'
 }, {
   handledElsewhere: ['--profile-modules'],
-  help: ['With no target option (--js, --css, --client, --assets, --public), all targets are compiled.', '  --profile reports the time taken by each compile phase', '  --profile-modules[=<path substring>] reports where module load time goes,', '    splitting each import into what only it needs and what it shares', '  --packages compiles imported packages into the build\'s .packages tree', '    for the dev server to serve. Off by default: compiled code left to', '    node\'s own resolution, as tests use, needs none of it.', '  --ignore-dirs and --ignore-patterns override the config entries of the same name.', '    Repeat either to give several values, or pass an empty value to ignore nothing.', '  --tests also compiles the files the config\'s testPatterns match, which every', '    other compile leaves out.']
+  help: ['With no target option (--js, --css, --client, --assets, --public), all targets are compiled.', '  --profile reports the time taken by each compile phase', '  --profile-modules[=<path substring>] reports where module load time goes,', '    splitting each import into what only it needs and what it shares', '  --packages compiles imported packages into the build\'s .packages tree', '    for the dev server to serve. Off by default: compiled code left to', '    node\'s own resolution, as tests use, needs none of it.', '  --ignore-dirs and --ignore-patterns override the config entries of the same name.', '    Repeat either to give several values, or pass an empty value to ignore nothing.', '  --tests also compiles the files the config\'s testPatterns match, which every', '    other compile leaves out.', '  --fresh compiles everything from source, ignoring the packages and styles caches.', '    Both are rewritten, so the next compile starts from a cache this one made.']
 });
 const allTargets = ['js', 'css', 'client', 'assets', 'public'];
 const targetGiven = {
@@ -92,6 +94,8 @@ const styleImportBase = config.styleImportBase !== undefined ? join(sourceLocati
 const buildLocation = outputOption !== undefined ? resolve(projectDir, outputOption) : join(projectDir, devBuildOuterFolder);
 const buildCodeLocation = join(buildLocation, buildCodeSubPath);
 const packagesCacheLocation = outputOption !== undefined ? join(buildLocation, '.packagesCache') : join(projectDir, packagesCacheFolder);
+const stylesCacheLocation = outputOption !== undefined ? join(buildLocation, '.stylesCache') : join(projectDir, stylesCacheFolder);
+const rawBuildLocation = outputOption !== undefined ? `${buildLocation}-raw` : join(projectDir, devRawBuildFolder);
 const readyFileLocation = readyFileOption !== undefined ? resolve(projectDir, readyFileOption) : undefined;
 if (buildLocation.toLowerCase() === resolve(projectDir).toLowerCase()) {
   cliError('Compile output cannot be the project root');
@@ -120,7 +124,7 @@ const cleanTasks = [];
 if (clean && targets.has('js')) {
   cleanTasks.push(removeRecursive(buildCodeLocation), removeRecursive(join(buildLocation, componentCssFolder)),
   // else a component the app no longer imports keeps its stale stylesheet linked
-  removeRecursive(join(buildLocation, frameworkCssFolder)), removeRecursive(join(buildLocation, packagesFolder)), removeRecursive(packagesCacheLocation));
+  removeRecursive(join(buildLocation, frameworkCssFolder)), removeRecursive(join(buildLocation, packagesFolder)), removeRecursive(packagesCacheLocation), removeRecursive(stylesCacheLocation), removeRecursive(rawBuildLocation));
 }
 if (clean && targets.has('css')) {
   cleanTasks.push(removeRecursive(join(buildLocation, staticFolder)));
@@ -141,7 +145,10 @@ if (targets.has('js')) {
     quiet,
     packages,
     tests,
+    fresh,
     packagesCacheLocation,
+    stylesCacheLocation,
+    rawBuildLocation,
     onCycleComplete: watch ? async cycle => {
       if (cycle.success) {
         await markReady();

package/dist/bin/commands/compileSimplePackage.js

@@ -1,5 +1,6 @@
-import { findProjectDir } from "../../findProjectDir.js";
-import { cliInfo, cliLog } from "../../cliOutput.js";
+// build
+import { findProjectDir } from '../../findProjectDir.js';
+import { cliInfo, cliLog } from '../../cliOutput.js';
 cliInfo('tungsten compile-simple-package is not ready yet');
 process.exit(2);
 const projectDir = process.cwd();

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":"AAuEA,OAAO,EAAE,CAAA"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../../src/bin/commands/dev.ts"],"names":[],"mappings":"AA4EA,OAAO,EAAE,CAAA"}

package/dist/bin/commands/dev.js

@@ -1,9 +1,9 @@
 import open from 'open';
-import { cliOut } from "../../cliOutput.js";
-import { Framework } from "../../Framework.js";
-import { warnOnFrameworkChange } from "../../warnOnFrameworkChange.js";
-import { createTimeProfiler, reportRunTotal, reportStartupPhase } from "../../timeProfiler.js";
-import { cliArgs } from "../args.js";
+import { cliOut } from '../../cliOutput.js';
+import { Framework } from '../../Framework.js';
+import { warnOnFrameworkChange } from '../../warnOnFrameworkChange.js';
+import { createTimeProfiler, reportRunTotal, reportStartupPhase } from '../../timeProfiler.js';
+import { cliArgs } from '../args.js';
 //import dotenv from 'dotenv'
 //dotenv.config({ path: '.private.env' })
 // first statement in the body, so it closes off the import evaluation above
@@ -11,12 +11,18 @@ reportStartupPhase('load dev modules');
 const {
   boot,
   profile,
-  tests
+  tests,
+  fresh,
+  clean
 } = cliArgs({
   boot: '--no-boot',
   profile: '--profile',
+  // also delete the packages and styles caches, not only the dev build
+  clean: '--clean',
   // also compile the files config.testDirs/testPatterns match - normally only a test compile does
-  tests: '--tests'
+  tests: '--tests',
+  // compile everything from source, ignoring the packages and styles caches (they are rewritten)
+  fresh: '--fresh'
 }, {
   handledElsewhere: ['--profile-modules']
 });
@@ -24,11 +30,12 @@ const {
 const sxyFramework = new Framework();
 sxyFramework.profiler = createTimeProfiler(profile);
 sxyFramework.tests = tests;
+sxyFramework.fresh = fresh;
 const config = await sxyFramework.init();
 //console.log('framework ready')
 // build for dev
-cliOut('Removing old builds');
-await sxyFramework.clean('dev');
+cliOut(clean ? 'Removing the dev build and its caches' : 'Removing old builds');
+await sxyFramework.clean(clean ? 'dev-full' : 'dev');
 //cliOut('cleaned')
 cliOut('Building');
 await sxyFramework.build('dev');

package/dist/bin/commands/devmon.js

@@ -5,12 +5,12 @@ import { spawn } from 'node:child_process';
 import { join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import chokidar from 'chokidar';
-import { cliError } from "../../cliOutput.js";
-import { getFrameworkDir } from "../../getFrameworkDir.js";
-import { cliArgs } from "../args.js";
+import { cliError } from '../../cliOutput.js';
+import { getFrameworkDir } from '../../getFrameworkDir.js';
+import { cliArgs } from '../args.js';
 // devmon reads none of its arguments itself - it passes them straight through to the dev child
 cliArgs({}, {
-  handledElsewhere: ['--no-boot', '--profile', '--profile-modules']
+  handledElsewhere: ['--no-boot', '--clean', '--fresh', '--tests', '--profile', '--profile-modules']
 });
 const initialArgs = process.argv.slice(3);
 // a restart must not reopen the browser tab, so it always carries --no-boot

package/dist/bin/commands/help.js

@@ -1,9 +1,9 @@
-import { cliOut } from "../../cliOutput.js";
+import { cliOut } from '../../cliOutput.js';
 const command = process.argv[2];
 cliOut(`Usage: tungsten <command> [options]
 
 Commands:
-  dev                   Start dev mode [--no-boot] [--profile] [--profile-modules]
+  dev                   Start dev mode [--no-boot] [--clean] [--fresh] [--tests] [--profile] [--profile-modules]
   devmon                Dev mode, auto-restarts on framework rebuilds (same options as dev)
   build                 Production build [--profile] [--profile-modules] [--quiet]
   start                 Start production server

package/dist/bin/commands/start.js

@@ -1,5 +1,5 @@
-import { Framework } from "../../Framework.js";
-import { cliArgs } from "../args.js";
+import { Framework } from '../../Framework.js';
+import { cliArgs } from '../args.js';
 //import dotenv from 'dotenv'
 //dotenv.config({ path: '.private.env' })
 cliArgs({}); // accepts nothing but --help

package/dist/bin/commands/static.js

@@ -1,7 +1,7 @@
 import open from 'open';
-import { getUserConfig } from "../../getUserConfig.js";
-import { StaticSiteServer } from "../../Servers/StaticSiteServer.js";
-import { cliArgs } from "../args.js";
+import { getUserConfig } from '../../getUserConfig.js';
+import { StaticSiteServer } from '../../Servers/StaticSiteServer.js';
+import { cliArgs } from '../args.js';
 cliArgs({}); // accepts nothing but --help
 const staticServer = new StaticSiteServer(await getUserConfig());
 const staticServerLocation = await staticServer.start();

package/dist/bin/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bin/index.ts"],"names":[],"mappings":"AA6GA,OAAO,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bin/index.ts"],"names":[],"mappings":"AAoHA,OAAO,EAAE,CAAA"}

package/dist/bin/index.js

@@ -1,6 +1,6 @@
 import { enableCompileCache, flushCompileCache } from 'node:module';
-import { cliOut, cliWarn } from "../cliOutput.js";
-import { beginStartupProfiling } from "../timeProfiler.js";
+import { cliOut, cliWarn } from '../cliOutput.js';
+import { beginStartupProfiling } from '../timeProfiler.js';
 // get command line args
 const args = process.argv.slice(2);
 const command = args[0];
@@ -10,18 +10,26 @@ const profile = args.includes('--profile');
 // while it populates, so a single run straight after a rebuild looks like a regression.
 // NODE_DISABLE_COMPILE_CACHE=1 turns it off (NODE_COMPILE_CACHE does not - it names the cache
 // directory, so a value of 0 makes a folder called 0).
-const compileCache = enableCompileCache();
+// OFF for a trial (2026-09-07): Robert is checking whether occasional slow starts persist without
+// it. Measured worth ~200ms warm. Set TUNGSTEN_COMPILE_CACHE=1 to turn it back on meanwhile.
+const compileCacheWanted = process.env.TUNGSTEN_COMPILE_CACHE === '1';
+const compileCache = compileCacheWanted ? enableCompileCache() : undefined;
 // reported under --profile because "is it even on?" is otherwise only answerable by inspecting
 // the cache directory's timestamps - status 1 is enabled, 2 already enabled, 3 disabled
 if (profile) {
-  cliOut(`compile cache: status ${compileCache.status}` + ` ${compileCache.directory ?? compileCache.message ?? ''}`);
+  cliOut(compileCache === undefined ? `compile cache: off (trial - TUNGSTEN_COMPILE_CACHE=1 enables)` : `compile cache: status ${compileCache.status} ${compileCache.directory ?? compileCache.message ?? ''}`);
 }
 // hooks have to be registered before the command module - and so its import tree - is loaded
+const {
+  registerVendorHook
+} = await import('./vendorHook.js');
+const vendorStatus = registerVendorHook();
+if (profile) cliOut(`vendor bundle: ${vendorStatus}`);
 const profileModulesArg = args.find(arg => arg === '--profile-modules' || arg.startsWith('--profile-modules='));
 if (profileModulesArg !== undefined) {
   const {
     registerModuleLoadAnalysis
-  } = await import("./moduleLoadAnalysis.js");
+  } = await import('./moduleLoadAnalysis.js');
   registerModuleLoadAnalysis(profileModulesArg.split('=')[1]);
 }
 switch (command) {
@@ -31,7 +39,7 @@ switch (command) {
   case '--help':
   case '-h':
     {
-      await import("./commands/help.js");
+      await import('./commands/help.js');
       break;
     }
   case 'dev':
@@ -40,20 +48,20 @@ switch (command) {
       beginStartupProfiling(profile);
       // set env before loading the next file, to set the env before file imports
       process.env.__TUNGSTEN_ENV = 'development';
-      await import("./commands/dev.js");
+      await import('./commands/dev.js');
       break;
     }
   case 'devmon':
     {
       cliOut(`Starting Tungsten auto-restart dev mode`);
       process.env.__TUNGSTEN_ENV = 'development';
-      await import("./commands/devmon.js");
+      await import('./commands/devmon.js');
       break;
     }
   case 'build':
     {
       if (args.includes('--help') || args.includes('-h')) {
-        await import("./commands/buildHelp.js");
+        await import('./commands/buildHelp.js');
         break;
       }
       // announce before the import: resolving the build's dependencies is a long silent wait
@@ -61,38 +69,38 @@ switch (command) {
       beginStartupProfiling(profile);
       process.env.__TUNGSTEN_ENV = 'production';
       process.env.__TUNGSTEN_DEBUG = 'true';
-      await import("./commands/build.js");
+      await import('./commands/build.js');
       break;
     }
   case 'start':
     {
       cliOut(`Starting Tungsten server`);
       process.env.__TUNGSTEN_ENV = 'production';
-      await import("./commands/start.js");
+      await import('./commands/start.js');
       break;
     }
   case 'static':
     {
       cliOut(`Starting Tungsten static site preview`);
       //process.env.__TUNGSTEN_ENV = 'production'
-      await import("./commands/static.js");
+      await import('./commands/static.js');
       break;
     }
   case 'clean':
     {
-      await import("./commands/clean.js");
+      await import('./commands/clean.js');
       break;
     }
   case 'compile':
     {
       beginStartupProfiling(profile);
       process.env.__TUNGSTEN_ENV = 'development';
-      await import("./commands/compile.js");
+      await import('./commands/compile.js');
       break;
     }
   case 'compile-simple-package':
     {
-      await import("./commands/compileSimplePackage.js");
+      await import('./commands/compileSimplePackage.js');
       break;
     }
   default:
@@ -105,7 +113,7 @@ switch (command) {
 // exited - signals skip exit handling - so they would populate the cache and then throw it away,
 // paying the cold cost on every run forever. The import above has returned by here, which for a
 // server command means it has finished starting, so this persists what that startup compiled.
-flushCompileCache();
+if (compileCacheWanted) flushCompileCache();
 // A profiled dev run has measured everything it will measure once the server is up and the report
 // has printed. Exit rather than leave a server to be killed - after the flush above, which a kill
 // would have skipped. (dev.ts itself must not exit: its import returning is what reaches here.)

package/dist/bin/moduleLoadAnalysis.js

@@ -5,8 +5,8 @@
 import { registerHooks } from 'node:module';
 import { performance } from 'node:perf_hooks';
 import chalk from 'chalk-extensions';
-import { cliOut } from "../cliOutput.js";
-import { addEndOfRunReport } from "../timeProfiler.js";
+import { cliOut } from '../cliOutput.js';
+import { addEndOfRunReport } from '../timeProfiler.js';
 const records = new Map();
 // The user's app enters the graph through an iterationQueryString() import, so its first module
 // arrives as an explicitly tagged specifier - and recording stops there. Past that point the cost

package/dist/bin/vendorHook.d.ts

@@ -0,0 +1,3 @@
+export type VendorHookStatus = 'active' | 'none' | 'stale';
+export declare function registerVendorHook(): VendorHookStatus;
+//# sourceMappingURL=vendorHook.d.ts.map

package/dist/bin/vendorHook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendorHook.d.ts","sourceRoot":"","sources":["../../src/bin/vendorHook.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAA;AAE1D,wBAAgB,kBAAkB,IAAI,gBAAgB,CA2BrD"}

package/dist/bin/vendorHook.js

@@ -0,0 +1,34 @@
+import { registerHooks } from 'node:module';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+import { cliWarn } from '../cliOutput.js';
+export function registerVendorHook() {
+  const packageDir = dirname(dirname(dirname(fileURLToPath(import.meta.url))));
+  const vendorDir = join(packageDir, 'vendor');
+  const manifestPath = join(vendorDir, 'manifest.json');
+  if (!existsSync(manifestPath)) return 'none';
+  const manifest = JSON.parse(readFileSync(manifestPath, 'utf8')); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- our own file
+  const lockfile = join(packageDir, 'pnpm-lock.yaml');
+  // a linked checkout whose dependencies moved on: fall back rather than run a stale bundle
+  if (manifest.lockfile !== undefined && existsSync(lockfile)) {
+    const stat = statSync(lockfile);
+    if (stat.size !== manifest.lockfile.size || stat.mtimeMs !== manifest.lockfile.mtimeMs) {
+      cliWarn('vendor bundle is older than pnpm-lock.yaml - loading dependencies from node_modules (pnpm build-vendor)');
+      return 'stale';
+    }
+  }
+  const entries = new Map(Object.entries(manifest.specifiers).map(([specifier, name]) => [specifier, pathToFileURL(join(vendorDir, `${name}.js`)).href]));
+  registerHooks({
+    resolve(specifier, context, next) {
+      const url = entries.get(specifier);
+      // require() callers want module.exports, which the ESM wrappers do not hand back the same way
+      if (url === undefined || context.conditions.includes('require')) return next(specifier, context);
+      return {
+        url,
+        shortCircuit: true
+      };
+    }
+  });
+  return 'active';
+}

package/dist/browserStorage.js

@@ -5,8 +5,8 @@ function _assertClassBrand(e, t, n) { if ("function" == typeof e ? e === t : e.h
 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 { isBrowser } from "./isBrowser.js";
-import { throwError } from "./throwError.js";
+import { isBrowser } from './isBrowser.js';
+import { throwError } from './throwError.js';
 class ServerStorage {
   constructor() {
     _defineProperty(this, "get", () => throwError('Browser Storage', 'Browser storage was accessed on the server'));
@@ -38,7 +38,7 @@ export class TungstenLocalStorage {
     _defineProperty(this, "clear", () => {
       localStorage.clear();
       for (const key in _classPrivateFieldGet(_subscribers, this)) {
-        _classPrivateFieldGet(_push, this).call(this, key, undefined); // eslint-disable-line no-type-assertion/no-type-assertion -- TS is being a wanker about keys of object
+        _classPrivateFieldGet(_push, this).call(this, key, undefined); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- TS is being a wanker about keys of object
       }
     });
     _defineProperty(this, "key", index => localStorage.key(index));
@@ -60,6 +60,7 @@ export class TungstenLocalStorage {
       if (subs) {
         for (const element of subs) {
           if ('shouldStoreComponentUpdate' in element && element.shouldStoreComponentUpdate !== undefined) {
+            // eslint-disable-line @typescript-eslint/no-unnecessary-condition -- the field can be declared yet unset
             if (!element.shouldStoreComponentUpdate(key, value)) {
               continue;
             }
@@ -95,7 +96,7 @@ export class TungstenSessionStorage {
     _defineProperty(this, "clear", () => {
       sessionStorage.clear();
       for (const key in _classPrivateFieldGet(_subscribers2, this)) {
-        _classPrivateFieldGet(_push2, this).call(this, key, undefined); // eslint-disable-line no-type-assertion/no-type-assertion -- TS is being a wanker about keys of object
+        _classPrivateFieldGet(_push2, this).call(this, key, undefined); // eslint-disable-line @typescript-eslint/no-unsafe-type-assertion -- TS is being a wanker about keys of object
       }
     });
     _defineProperty(this, "key", index => sessionStorage.key(index));
@@ -117,6 +118,7 @@ export class TungstenSessionStorage {
       if (subs) {
         for (const element of subs) {
           if ('shouldStoreComponentUpdate' in element && element.shouldStoreComponentUpdate !== undefined) {
+            // eslint-disable-line @typescript-eslint/no-unnecessary-condition -- the field can be declared yet unset
             if (!element.shouldStoreComponentUpdate(key, value)) {
               continue;
             }

package/dist/build/babel.user.common.config.d.ts

@@ -1,4 +1,11 @@
-import type { TransformOptions } from "@babel/core";
-declare const userCommonConfig: TransformOptions;
+import type { PluginItem } from "@babel/core";
+export declare function typescriptPreset(): PluginItem;
+declare const userCommonConfig: {
+    ignore: RegExp[];
+    babelrc: false;
+    configFile: false;
+    presets: PluginItem[];
+    plugins: PluginItem[];
+};
 export default userCommonConfig;
 //# sourceMappingURL=babel.user.common.config.d.ts.map

package/dist/build/babel.user.common.config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"babel.user.common.config.d.ts","sourceRoot":"","sources":["../../src/build/babel.user.common.config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAcnD,QAAA,MAAM,gBAAgB,EAAE,gBA6BvB,CAAA;AAED,eAAe,gBAAgB,CAAA"}
+{"version":3,"file":"babel.user.common.config.d.ts","sourceRoot":"","sources":["../../src/build/babel.user.common.config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAoB,MAAM,aAAa,CAAA;AAW/D,wBAAgB,gBAAgB,IAAI,UAAU,CAG7C;AAMD,QAAA,MAAM,gBAAgB;;;;aAcb,UAAU,EAAE;aAMZ,UAAU,EAAE;CACO,CAAA;AAE5B,eAAe,gBAAgB,CAAA"}