tungsten 0.4.2 → 0.4.3

package/dist/bin/commands/help.d.ts

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

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

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

package/dist/bin/commands/help.js

@@ -0,0 +1,16 @@
+import { cliOut } from "../../cliOutput.js";
+const command = process.argv[2];
+cliOut(`Usage: tungsten <command> [options]
+
+Commands:
+  dev                   Start dev mode [--no-boot] [--profile]
+  devmon                Dev mode, auto-restarts on framework rebuilds (same options as dev)
+  build                 Production build [--profile]
+  start                 Start production server
+  static                Preview a static site build
+  clean                 Delete build assets
+  compile [targets]     Compile targets in isolation; run "tungsten compile --help" for details
+  compile-simple-package <sourceFolder> <destFolder>
+
+Run "tungsten <command> --help" where supported for command-specific options.`);
+process.exit(command === undefined || command === '' ? 1 : 0);

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

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

package/dist/bin/index.js

@@ -2,10 +2,16 @@ import { cliOut, cliWarn } from "../cliOutput.js";
 // get command line args
 const args = process.argv.slice(2);
 const command = args[0];
-if (command === undefined || command === '') {
-  cliWarn(`Please choose a command, e.g. "tungsten dev"`);
-}
 switch (command) {
+  case undefined:
+  case '':
+  case 'help':
+  case '--help':
+  case '-h':
+    {
+      await import("./commands/help.js");
+      break;
+    }
   case 'dev':
     {
       cliOut(`Starting Tungsten dev mode`);
@@ -61,6 +67,7 @@ switch (command) {
     }
   default:
     {
-      cliWarn(`tungsten: unknown command "${command}"`);
+      cliWarn(`tungsten: unknown command "${command}" (run "tungsten --help" for usage)`);
+      process.exit(1);
     }
 }

package/dist/testing/hydrateTestApp.js

@@ -15,7 +15,7 @@ import { initStores } from "../Servers/initStores.js";
 import { deleteNodeIfRendered } from "../update/integrateUpdateVdom.js";
 import { UpdateScheduler } from "../update/UpdateScheduler.js";
 import { DomPointer } from "../DomPointer.js";
-import { ensureTestEnvLoaded } from "./ensureTestEnvLoaded.js";
+import { waitForEnvIfLoading } from "./loadEnv.js";
 // hydrate.tsx references several DOM globals directly (Node.COMMENT_NODE, `instanceof Text`, the
 // bare `document`) the way real browser code always can - happy-dom only puts these on its own
 // Window, not on Node.js's global scope. Every hand-written hydration test before this harness
@@ -108,7 +108,7 @@ class HydrateTestAppImplementation {
  * client hydrator does, so a caller reproducing that class of bug should assert on the rejection.
  */
 export async function hydrateTestApp(RootComponent, ...args) {
-  await ensureTestEnvLoaded();
+  await waitForEnvIfLoading();
   const options = args[0]; // eslint-disable-line no-type-assertion/no-type-assertion
   const suppliedDocument = options?.document ?? globalThis.document; // eslint-disable-line no-type-assertion/no-type-assertion
   if (suppliedDocument === undefined) {

package/dist/testing/index.d.ts

@@ -1,5 +1,6 @@
 import type { ConstructPackage, TungstenBaseComponent, TungstenBaseComponentType, TungstenComponentPropsBase } from '../Components.jsx';
-export { ensureTestEnvLoaded, testEnvVariableName } from './ensureTestEnvLoaded.js';
+export { loadEnv } from './loadEnv.js';
+export { testEnvVariableName } from './testEnvIsRequested.js';
 export { hydrateTestApp, type HydrateTestApp, type HydrateTestAppOptions } from './hydrateTestApp.js';
 import type { TrueStore } from '../Store/makeStore.js';
 export type ComponentProps<ComponentType extends TungstenBaseComponentType<any, any>> = InstanceType<ComponentType>['props'];

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"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"}

package/dist/testing/index.js

@@ -8,8 +8,9 @@ function _classPrivateFieldSet(s, a, r) { return s.set(_assertClassBrand(s, a),
 function _assertClassBrand(e, t, n) { if ("function" == typeof e ? e === t : e.has(t)) return arguments.length < 3 ? t : n; throw new TypeError("Private element is not present on this object"); }
 import { Instance } from "../Instance/Instance.js";
 import { initStores } from "../Servers/initStores.js";
-import { ensureTestEnvLoaded } from "./ensureTestEnvLoaded.js";
-export { ensureTestEnvLoaded, testEnvVariableName } from "./ensureTestEnvLoaded.js";
+import { waitForEnvIfLoading } from "./loadEnv.js";
+export { loadEnv } from "./loadEnv.js";
+export { testEnvVariableName } from "./testEnvIsRequested.js";
 export { hydrateTestApp } from "./hydrateTestApp.js";
 import { createTungstenRootComponent, deleteTungstenRoot } from "../update/integrateUpdateVdom.js";
 import { UpdateScheduler } from "../update/UpdateScheduler.js";
@@ -87,7 +88,7 @@ export async function createTestApp(
 // type arguments - so a generic component's own parameters collapse to
 // their constraints before `props` is ever considered.
 RootComponent, ...args) {
-  await ensureTestEnvLoaded();
+  await waitForEnvIfLoading();
   const options = args[0];
   const suppliedDocument = options?.document ?? globalThis.document;
   if (suppliedDocument === undefined) {

package/dist/testing/loadEnv.d.ts

@@ -0,0 +1,3 @@
+export declare function loadEnv(): Promise<void>;
+export declare function waitForEnvIfLoading(): Promise<void>;
+//# sourceMappingURL=loadEnv.d.ts.map

package/dist/testing/loadEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadEnv.d.ts","sourceRoot":"","sources":["../../src/testing/loadEnv.ts"],"names":[],"mappings":"AAaA,wBAAgB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAWvC;AAID,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAEnD"}

package/dist/testing/loadEnv.js

@@ -0,0 +1,28 @@
+import { getUserConfig } from "../getUserConfig.js";
+import { loadEnvsDev } from "../Servers/loadEnvsDev.js";
+import { testEnvIsRequested, testEnvVariableName } from "./testEnvIsRequested.js";
+let loadPromise;
+// Populate global.tungstenPublicEnv / global.tungstenPrivateEnv for DOM component tests, once
+// per process. Compiled client component code reads these as bare globals, so they must exist
+// before any component runs under the test runner. Call this from the test runner setup hook.
+//
+// TUNGSTEN_TEST_ENV chooses which env files: set it to prefer .env.test* over the base files.
+// A missing or invalid env schemas file is a hard error - an app that asked for env and did not
+// get it must not run its tests regardless.
+export function loadEnv() {
+  if (loadPromise === undefined) {
+    loadPromise = (async () => {
+      const config = await getUserConfig({}, 'silent');
+      const useTestEnvFiles = testEnvIsRequested(process.env[testEnvVariableName]);
+      // iteration 0: schemas are stable within a test run.
+      // _firstLoad = false: suppress the CLI boot output.
+      await loadEnvsDev(config, 0, process.env, false, useTestEnvFiles);
+    })();
+  }
+  return loadPromise;
+}
+// Passive companion for the test harness: wait for an in-progress loadEnv(), or do nothing if
+// setup never started one. Never initiates a load, so it never fails on its own.
+export function waitForEnvIfLoading() {
+  return loadPromise ?? Promise.resolve();
+}

package/dist/testing/loadEnvSetup.d.ts

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

package/dist/testing/loadEnvSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadEnvSetup.d.ts","sourceRoot":"","sources":["../../src/testing/loadEnvSetup.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,CAAA"}

package/dist/testing/loadEnvSetup.js

@@ -0,0 +1,7 @@
+// Side-effect setup module for the sxy-test-runner `setup` file-location form, which imports the
+// file rather than calling an export. Reference it from an app's test config to load app env for
+// component tests:
+//   setup: ['node_modules/tungsten/dist/testing/loadEnvSetup.js']
+// (the path is resolved from the project dir). Or call loadEnv() directly in a setup function.
+import { loadEnv } from "./loadEnv.js";
+await loadEnv();

package/dist/testing/{ensureTestEnvLoaded.d.ts → testEnvIsRequested.d.ts}

@@ -1,4 +1,3 @@
 export declare const testEnvVariableName = "TUNGSTEN_TEST_ENV";
 export declare function testEnvIsRequested(value: string | undefined): boolean;
-export declare function ensureTestEnvLoaded(): Promise<void>;
-//# sourceMappingURL=ensureTestEnvLoaded.d.ts.map
+//# sourceMappingURL=testEnvIsRequested.d.ts.map

package/dist/testing/testEnvIsRequested.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testEnvIsRequested.d.ts","sourceRoot":"","sources":["../../src/testing/testEnvIsRequested.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,mBAAmB,sBAAsB,CAAA;AAEtD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAIrE"}

package/dist/testing/testEnvIsRequested.js

@@ -0,0 +1,7 @@
+// Set this to prefer the .env.test* files over the base ones when test env is loaded.
+export const testEnvVariableName = 'TUNGSTEN_TEST_ENV';
+export function testEnvIsRequested(value) {
+  if (value === undefined) return false;
+  const normalized = value.trim().toLowerCase();
+  return normalized !== '' && normalized !== '0' && normalized !== 'false';
+}

package/package.json

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

package/dist/testing/ensureTestEnvLoaded.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ensureTestEnvLoaded.d.ts","sourceRoot":"","sources":["../../src/testing/ensureTestEnvLoaded.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,mBAAmB,sBAAsB,CAAA;AAEtD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAIrE;AAaD,wBAAgB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAYnD"}

package/dist/testing/ensureTestEnvLoaded.js

@@ -1,32 +0,0 @@
-import { getUserConfig } from "../getUserConfig.js";
-import { loadEnvsDev } from "../Servers/loadEnvsDev.js";
-// Set this in the test script or a runner hook to have component tests load app env.
-export const testEnvVariableName = 'TUNGSTEN_TEST_ENV';
-export function testEnvIsRequested(value) {
-  if (value === undefined) return false;
-  const normalized = value.trim().toLowerCase();
-  return normalized !== '' && normalized !== '0' && normalized !== 'false';
-}
-let loadPromise;
-// Populate global.tungstenPublicEnv / global.tungstenPrivateEnv for DOM component tests,
-// exactly once per process. Compiled client component code reads these as bare globals, so
-// they must exist before any component runs under the test runner.
-//
-// Opt-in, via TUNGSTEN_TEST_ENV. An app that sets it gets its envs loaded with the .env.test*
-// files preferred over the base ones, and a missing or invalid env schemas file is then a hard
-// error — an app that asked for env and did not get it must not run its tests regardless.
-// Without the variable nothing is loaded, which is what a package with no env schemas of its
-// own (the framework itself, or a component library) needs.
-export function ensureTestEnvLoaded() {
-  if (loadPromise === undefined) {
-    loadPromise = (async () => {
-      if (!testEnvIsRequested(process.env[testEnvVariableName])) return;
-      const config = await getUserConfig({}, 'silent');
-      // iteration 0: schemas are stable within a test run.
-      // _firstLoad = false: suppress the CLI boot output.
-      // useTestEnvFiles = true: prefer .env.test* files.
-      await loadEnvsDev(config, 0, process.env, false, true);
-    })();
-  }
-  return loadPromise;
-}