@pixui-dev/inflight-test-webpack-plugin 0.0.7-inflight.1

package/dist/index.cjs

@@ -0,0 +1,226 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+let node_fs = require("node:fs");
+let node_path = require("node:path");
+let picomatch = require("picomatch");
+picomatch = __toESM(picomatch, 1);
+//#region src/index.ts
+/**
+* @pixui-dev/inflight-test-webpack-plugin
+*
+* Wires inflight-test into a PixUI activity's webpack build:
+*   - discovers test files by glob (default `**\/*.test.{ts,tsx,js,jsx}`),
+*   - generates a runner module that binds the discovered cases to the
+*     inflight-test runtime, exporting `start` / `startWithoutReport`,
+*   - and aliases `@pixui-dev/inflight-test/runner` to that generated module,
+*     so the activity just does
+*       `import { start } from '@pixui-dev/inflight-test/runner'`
+*     and calls it (from a button / QA panel) — no globals, no separate
+*     entry/chunk to load.
+*
+* The cases are inlined (`webpackMode: "eager"`) into whatever chunk imports the
+* runner, because the PixUI QuickJS runtime has no async chunk loader.
+*
+* Cross-version: it only mutates `resolve.alias` (+ writes a file), which is
+* identical on webpack 4 and 5 — no version-specific entry/asset APIs.
+*/
+const ALWAYS_EXCLUDE = [
+	"**/node_modules/**",
+	"**/dist/**",
+	"**/build/**",
+	"**/.git/**"
+];
+function toArray(v, fallback) {
+	if (v == null) return fallback;
+	return Array.isArray(v) ? v : [v];
+}
+var InflightTestPlugin = class {
+	_opts;
+	constructor(options = {}) {
+		this._opts = options;
+	}
+	apply(compiler) {
+		if (this._opts.enabled === false) return;
+		const cwd = (0, node_path.resolve)(this._opts.cwd ?? compiler.context ?? process.cwd());
+		const runtimeImport = this._opts.runtimeImport ?? "@pixui-dev/inflight-test";
+		const opts = {
+			include: toArray(this._opts.include, ["**/*.test.{ts,tsx,js,jsx}"]),
+			exclude: toArray(this._opts.exclude, []),
+			cwd,
+			runtimeImport,
+			runnerImport: this._opts.runnerImport ?? `${runtimeImport}/runner`,
+			bridge: this._opts.bridge ?? "gamelet",
+			gameletImport: this._opts.gameletImport ?? "gamelet-pixui-frame"
+		};
+		const testFiles = this._discover(opts);
+		const runnerFile = this._writeRunnerModule(opts, testFiles);
+		this._aliasRunner(compiler, opts.runnerImport, runnerFile);
+		this._aliasRuntimeForWebpack4(compiler, opts.runtimeImport);
+	}
+	/**
+	* Point the runner specifier at the generated module via `resolve.alias`.
+	* Works identically on webpack 4 and 5 (object or array alias forms).
+	*/
+	_aliasRunner(compiler, specifier, file) {
+		const resolveOpts = compiler.options.resolve ??= {};
+		const alias = resolveOpts.alias ??= {};
+		if (Array.isArray(alias)) alias.push({
+			name: specifier,
+			alias: file,
+			onlyModule: true
+		});
+		else alias[`${specifier}$`] = file;
+	}
+	/**
+	* webpack 4 doesn't support package.json `exports`. Alias the runtime's main
+	* entry to its dist file so `import … from '@pixui-dev/inflight-test'` resolves.
+	* On webpack 5 the alias is redundant but harmless.
+	*/
+	_aliasRuntimeForWebpack4(compiler, runtimeImport) {
+		let pkgDir;
+		try {
+			pkgDir = require.resolve(`${runtimeImport}/package.json`).replace(/[\\/]package\.json$/, "");
+		} catch {
+			return;
+		}
+		const main = (0, node_path.join)(pkgDir, "dist", "index.js");
+		if (!(0, node_fs.existsSync)(main)) return;
+		const resolveOpts = compiler.options.resolve ??= {};
+		const alias = resolveOpts.alias ??= {};
+		if (Array.isArray(alias)) alias.push({
+			name: runtimeImport,
+			alias: main,
+			onlyModule: true
+		});
+		else alias[`${runtimeImport}$`] = main;
+	}
+	_discover(opts) {
+		const isMatch = (0, picomatch.default)(opts.include, { dot: false });
+		const isExcluded = (0, picomatch.default)([...ALWAYS_EXCLUDE, ...opts.exclude], { dot: true });
+		const out = [];
+		const walk = (dir) => {
+			let entries;
+			try {
+				entries = (0, node_fs.readdirSync)(dir);
+			} catch {
+				return;
+			}
+			for (const name of entries) {
+				const abs = (0, node_path.join)(dir, name);
+				const rel = (0, node_path.relative)(opts.cwd, abs).replace(/\\/g, "/");
+				if (isExcluded(rel)) continue;
+				let st;
+				try {
+					st = (0, node_fs.statSync)(abs);
+				} catch {
+					continue;
+				}
+				if (st.isDirectory()) walk(abs);
+				else if (isMatch(rel)) out.push({
+					id: rel,
+					absolute: abs.replace(/\\/g, "/")
+				});
+			}
+		};
+		walk(opts.cwd);
+		out.sort((a, b) => a.id.localeCompare(b.id));
+		return out;
+	}
+	_writeRunnerModule(opts, testFiles) {
+		const cacheDir = (0, node_path.join)(opts.cwd, "node_modules", ".cache", "inflight-test");
+		if (!(0, node_fs.existsSync)(cacheDir)) (0, node_fs.mkdirSync)(cacheDir, { recursive: true });
+		const runnerFile = (0, node_path.join)(cacheDir, "runner.mjs");
+		const specs = testFiles.map((f) => {
+			return `  { id: ${JSON.stringify(f.id)}, load: () => import(/* webpackMode: "eager" */ ${JSON.stringify(f.absolute)}) },`;
+		}).join("\n");
+		const useGamelet = opts.bridge === "gamelet";
+		const gameletImportLine = useGamelet ? `import __inflightGamelet from ${JSON.stringify(opts.gameletImport)}\n` : "";
+		const bridgeBlock = useGamelet ? `
+// Default activity bridge over gamelet-pixui-frame (host screenshot protocol etc.).
+var GameletAPI = __inflightGamelet.GameletAPI
+function makeActivityBridge() {
+  return {
+    callGame: function (protocol, payload) {
+      // gamelet-pixui-frame fills appId/appName automatically; we only send the
+      // type + content envelope and the call-specific payload.
+      GameletAPI.callGame(JSON.stringify(Object.assign({ type: protocol, content: '' }, payload)))
+    },
+    onSDKMessage: function (protocol, handler) {
+      var myAppId = GameletAPI.getAppID()
+      var listener = function (cmd) {
+        var msg
+        try { msg = JSON.parse(cmd) } catch (e) { return }
+        if (!msg || msg.type !== protocol) return
+        // Ignore messages addressed to another app: addOnGameCommandListener
+        // also subscribes the GLOBAL game-message channel, which isn't
+        // app-scoped, so a different app's callback can reach us. Compare as
+        // strings — the backend sends appId as a string ("7442") while
+        // getAppID() returns a number (7442).
+        if (msg.appId != null && String(msg.appId) !== String(myAppId)) return
+        handler(msg)
+      }
+      GameletAPI.addOnGameCommandListener(listener)
+      return function () { GameletAPI.removeOnGameCommandListener(listener) }
+    },
+  }
+}
+` : "";
+		const applyBridge = useGamelet ? `  if (!o.activityBridge) o.activityBridge = makeActivityBridge()\n` : "";
+		(0, node_fs.writeFileSync)(runnerFile, `// AUTO-GENERATED by @pixui-dev/inflight-test-webpack-plugin — do not edit.
+import { start as _start } from ${JSON.stringify(opts.runtimeImport)}
+${gameletImportLine}
+const specs = [
+${specs}
+]
+
+/** Ids of the discovered test files. */
+export const testFiles = specs.map(function (s) { return s.id })
+${bridgeBlock}
+/**
+ * Run the discovered inflight tests. Writes a Vitest blob report by default
+ * (auto-wired from the PixUI host \`os\` / \`external.writeablePath\`); pass
+ * \`{ report: false }\` to skip. Call from a button / QA panel — no options
+ * needed in the normal case.
+ */
+export function start(options) {
+  var o = Object.assign({}, options)
+${applyBridge}  return _start(specs, o)
+}
+
+/** Run the discovered inflight tests without writing a report. */
+export function startWithoutReport(options) {
+  return start(Object.assign({}, options, { report: false }))
+}
+`, "utf8");
+		return runnerFile;
+	}
+};
+//#endregion
+exports.InflightTestPlugin = InflightTestPlugin;
+exports.default = InflightTestPlugin;
+
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

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

package/dist/index.d.cts

@@ -0,0 +1,56 @@
+import { Compiler } from "webpack";
+
+//#region src/index.d.ts
+interface InflightTestPluginOptions {
+  /** Glob(s) for discovering test files. Default: `**\/*.test.{ts,tsx,js,jsx}`. */
+  include?: string | string[];
+  /** Glob(s) to exclude. `node_modules` / build dirs are always excluded. */
+  exclude?: string | string[];
+  /** Root directory to scan. Default: the webpack `context`. */
+  cwd?: string;
+  /**
+   * Enable the plugin. Default `true` — inflight-test is meant to ship with the
+   * activity (including production), that's the point. Set `false` to opt out.
+   */
+  enabled?: boolean;
+  /** The inflight-test runtime package the generated runner imports. */
+  runtimeImport?: string;
+  /**
+   * The subpath specifier the activity imports the runner from. Default
+   * `${runtimeImport}/runner` (i.e. `@pixui-dev/inflight-test/runner`).
+   */
+  runnerImport?: string;
+  /**
+   * Default activity bridge wired into `start()` so the activity needs no
+   * options for screenshots:
+   *   - `'gamelet'` (default): wire a bridge over `gamelet-pixui-frame`
+   *     (`GameletAPI.callGame` + `addOnGameCommandListener`). All normal PixUI
+   *     activities use this SDK, so the bridge lives here — no per-repo file.
+   *   - `'none'`: wire nothing (caller passes their own `activityBridge`); use
+   *     for non-gamelet hosts.
+   */
+  bridge?: 'gamelet' | 'none';
+  /** The SDK package the `'gamelet'` bridge imports. Default `gamelet-pixui-frame`. */
+  gameletImport?: string;
+}
+declare class InflightTestPlugin {
+  private readonly _opts;
+  constructor(options?: InflightTestPluginOptions);
+  apply(compiler: Compiler): void;
+  /**
+   * Point the runner specifier at the generated module via `resolve.alias`.
+   * Works identically on webpack 4 and 5 (object or array alias forms).
+   */
+  private _aliasRunner;
+  /**
+   * webpack 4 doesn't support package.json `exports`. Alias the runtime's main
+   * entry to its dist file so `import … from '@pixui-dev/inflight-test'` resolves.
+   * On webpack 5 the alias is redundant but harmless.
+   */
+  private _aliasRuntimeForWebpack4;
+  private _discover;
+  private _writeRunnerModule;
+}
+//#endregion
+export { InflightTestPlugin, InflightTestPlugin as default, InflightTestPluginOptions };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/index.ts"],"mappings":";;;UAyBiB,yBAAA;EAmDE;EAjDjB,OAAA;EAmDqB;EAjDrB,OAAA;EAqDA;EAnDA,GAAA;EAmDM;;;;EA9CN,OAAA;EAsJ0B;EApJ1B,aAAA;;;;;EAKA,YAAA;;;;;;;;;;EAUA,MAAA;;EAEA,aAAA;AAAA;AAAA,cAoBW,kBAAA;EAAA,iBACM,KAAA;cAEL,OAAA,GAAS,yBAAA;EAIrB,KAAA,CAAM,QAAA,EAAU,QAAA;;;;;UA0BR,YAAA;;;;;;UAgBA,wBAAA;EAAA,QAuBA,SAAA;EAAA,QAuCA,kBAAA;AAAA"}

package/dist/index.d.mts

@@ -0,0 +1,56 @@
+import { Compiler } from "webpack";
+
+//#region src/index.d.ts
+interface InflightTestPluginOptions {
+  /** Glob(s) for discovering test files. Default: `**\/*.test.{ts,tsx,js,jsx}`. */
+  include?: string | string[];
+  /** Glob(s) to exclude. `node_modules` / build dirs are always excluded. */
+  exclude?: string | string[];
+  /** Root directory to scan. Default: the webpack `context`. */
+  cwd?: string;
+  /**
+   * Enable the plugin. Default `true` — inflight-test is meant to ship with the
+   * activity (including production), that's the point. Set `false` to opt out.
+   */
+  enabled?: boolean;
+  /** The inflight-test runtime package the generated runner imports. */
+  runtimeImport?: string;
+  /**
+   * The subpath specifier the activity imports the runner from. Default
+   * `${runtimeImport}/runner` (i.e. `@pixui-dev/inflight-test/runner`).
+   */
+  runnerImport?: string;
+  /**
+   * Default activity bridge wired into `start()` so the activity needs no
+   * options for screenshots:
+   *   - `'gamelet'` (default): wire a bridge over `gamelet-pixui-frame`
+   *     (`GameletAPI.callGame` + `addOnGameCommandListener`). All normal PixUI
+   *     activities use this SDK, so the bridge lives here — no per-repo file.
+   *   - `'none'`: wire nothing (caller passes their own `activityBridge`); use
+   *     for non-gamelet hosts.
+   */
+  bridge?: 'gamelet' | 'none';
+  /** The SDK package the `'gamelet'` bridge imports. Default `gamelet-pixui-frame`. */
+  gameletImport?: string;
+}
+declare class InflightTestPlugin {
+  private readonly _opts;
+  constructor(options?: InflightTestPluginOptions);
+  apply(compiler: Compiler): void;
+  /**
+   * Point the runner specifier at the generated module via `resolve.alias`.
+   * Works identically on webpack 4 and 5 (object or array alias forms).
+   */
+  private _aliasRunner;
+  /**
+   * webpack 4 doesn't support package.json `exports`. Alias the runtime's main
+   * entry to its dist file so `import … from '@pixui-dev/inflight-test'` resolves.
+   * On webpack 5 the alias is redundant but harmless.
+   */
+  private _aliasRuntimeForWebpack4;
+  private _discover;
+  private _writeRunnerModule;
+}
+//#endregion
+export { InflightTestPlugin, InflightTestPlugin as default, InflightTestPluginOptions };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;UAyBiB,yBAAA;EAmDE;EAjDjB,OAAA;EAmDqB;EAjDrB,OAAA;EAqDA;EAnDA,GAAA;EAmDM;;;;EA9CN,OAAA;EAsJ0B;EApJ1B,aAAA;;;;;EAKA,YAAA;;;;;;;;;;EAUA,MAAA;;EAEA,aAAA;AAAA;AAAA,cAoBW,kBAAA;EAAA,iBACM,KAAA;cAEL,OAAA,GAAS,yBAAA;EAIrB,KAAA,CAAM,QAAA,EAAU,QAAA;;;;;UA0BR,YAAA;;;;;;UAgBA,wBAAA;EAAA,QAuBA,SAAA;EAAA,QAuCA,kBAAA;AAAA"}

package/dist/index.mjs

@@ -0,0 +1,202 @@
+import { createRequire } from "node:module";
+import { existsSync, mkdirSync, readdirSync, statSync, writeFileSync } from "node:fs";
+import { join, relative, resolve } from "node:path";
+import picomatch from "picomatch";
+//#region \0rolldown/runtime.js
+var __require = /* @__PURE__ */ createRequire(import.meta.url);
+//#endregion
+//#region src/index.ts
+/**
+* @pixui-dev/inflight-test-webpack-plugin
+*
+* Wires inflight-test into a PixUI activity's webpack build:
+*   - discovers test files by glob (default `**\/*.test.{ts,tsx,js,jsx}`),
+*   - generates a runner module that binds the discovered cases to the
+*     inflight-test runtime, exporting `start` / `startWithoutReport`,
+*   - and aliases `@pixui-dev/inflight-test/runner` to that generated module,
+*     so the activity just does
+*       `import { start } from '@pixui-dev/inflight-test/runner'`
+*     and calls it (from a button / QA panel) — no globals, no separate
+*     entry/chunk to load.
+*
+* The cases are inlined (`webpackMode: "eager"`) into whatever chunk imports the
+* runner, because the PixUI QuickJS runtime has no async chunk loader.
+*
+* Cross-version: it only mutates `resolve.alias` (+ writes a file), which is
+* identical on webpack 4 and 5 — no version-specific entry/asset APIs.
+*/
+const ALWAYS_EXCLUDE = [
+	"**/node_modules/**",
+	"**/dist/**",
+	"**/build/**",
+	"**/.git/**"
+];
+function toArray(v, fallback) {
+	if (v == null) return fallback;
+	return Array.isArray(v) ? v : [v];
+}
+var InflightTestPlugin = class {
+	_opts;
+	constructor(options = {}) {
+		this._opts = options;
+	}
+	apply(compiler) {
+		if (this._opts.enabled === false) return;
+		const cwd = resolve(this._opts.cwd ?? compiler.context ?? process.cwd());
+		const runtimeImport = this._opts.runtimeImport ?? "@pixui-dev/inflight-test";
+		const opts = {
+			include: toArray(this._opts.include, ["**/*.test.{ts,tsx,js,jsx}"]),
+			exclude: toArray(this._opts.exclude, []),
+			cwd,
+			runtimeImport,
+			runnerImport: this._opts.runnerImport ?? `${runtimeImport}/runner`,
+			bridge: this._opts.bridge ?? "gamelet",
+			gameletImport: this._opts.gameletImport ?? "gamelet-pixui-frame"
+		};
+		const testFiles = this._discover(opts);
+		const runnerFile = this._writeRunnerModule(opts, testFiles);
+		this._aliasRunner(compiler, opts.runnerImport, runnerFile);
+		this._aliasRuntimeForWebpack4(compiler, opts.runtimeImport);
+	}
+	/**
+	* Point the runner specifier at the generated module via `resolve.alias`.
+	* Works identically on webpack 4 and 5 (object or array alias forms).
+	*/
+	_aliasRunner(compiler, specifier, file) {
+		const resolveOpts = compiler.options.resolve ??= {};
+		const alias = resolveOpts.alias ??= {};
+		if (Array.isArray(alias)) alias.push({
+			name: specifier,
+			alias: file,
+			onlyModule: true
+		});
+		else alias[`${specifier}$`] = file;
+	}
+	/**
+	* webpack 4 doesn't support package.json `exports`. Alias the runtime's main
+	* entry to its dist file so `import … from '@pixui-dev/inflight-test'` resolves.
+	* On webpack 5 the alias is redundant but harmless.
+	*/
+	_aliasRuntimeForWebpack4(compiler, runtimeImport) {
+		let pkgDir;
+		try {
+			pkgDir = __require.resolve(`${runtimeImport}/package.json`).replace(/[\\/]package\.json$/, "");
+		} catch {
+			return;
+		}
+		const main = join(pkgDir, "dist", "index.js");
+		if (!existsSync(main)) return;
+		const resolveOpts = compiler.options.resolve ??= {};
+		const alias = resolveOpts.alias ??= {};
+		if (Array.isArray(alias)) alias.push({
+			name: runtimeImport,
+			alias: main,
+			onlyModule: true
+		});
+		else alias[`${runtimeImport}$`] = main;
+	}
+	_discover(opts) {
+		const isMatch = picomatch(opts.include, { dot: false });
+		const isExcluded = picomatch([...ALWAYS_EXCLUDE, ...opts.exclude], { dot: true });
+		const out = [];
+		const walk = (dir) => {
+			let entries;
+			try {
+				entries = readdirSync(dir);
+			} catch {
+				return;
+			}
+			for (const name of entries) {
+				const abs = join(dir, name);
+				const rel = relative(opts.cwd, abs).replace(/\\/g, "/");
+				if (isExcluded(rel)) continue;
+				let st;
+				try {
+					st = statSync(abs);
+				} catch {
+					continue;
+				}
+				if (st.isDirectory()) walk(abs);
+				else if (isMatch(rel)) out.push({
+					id: rel,
+					absolute: abs.replace(/\\/g, "/")
+				});
+			}
+		};
+		walk(opts.cwd);
+		out.sort((a, b) => a.id.localeCompare(b.id));
+		return out;
+	}
+	_writeRunnerModule(opts, testFiles) {
+		const cacheDir = join(opts.cwd, "node_modules", ".cache", "inflight-test");
+		if (!existsSync(cacheDir)) mkdirSync(cacheDir, { recursive: true });
+		const runnerFile = join(cacheDir, "runner.mjs");
+		const specs = testFiles.map((f) => {
+			return `  { id: ${JSON.stringify(f.id)}, load: () => import(/* webpackMode: "eager" */ ${JSON.stringify(f.absolute)}) },`;
+		}).join("\n");
+		const useGamelet = opts.bridge === "gamelet";
+		const gameletImportLine = useGamelet ? `import __inflightGamelet from ${JSON.stringify(opts.gameletImport)}\n` : "";
+		const bridgeBlock = useGamelet ? `
+// Default activity bridge over gamelet-pixui-frame (host screenshot protocol etc.).
+var GameletAPI = __inflightGamelet.GameletAPI
+function makeActivityBridge() {
+  return {
+    callGame: function (protocol, payload) {
+      // gamelet-pixui-frame fills appId/appName automatically; we only send the
+      // type + content envelope and the call-specific payload.
+      GameletAPI.callGame(JSON.stringify(Object.assign({ type: protocol, content: '' }, payload)))
+    },
+    onSDKMessage: function (protocol, handler) {
+      var myAppId = GameletAPI.getAppID()
+      var listener = function (cmd) {
+        var msg
+        try { msg = JSON.parse(cmd) } catch (e) { return }
+        if (!msg || msg.type !== protocol) return
+        // Ignore messages addressed to another app: addOnGameCommandListener
+        // also subscribes the GLOBAL game-message channel, which isn't
+        // app-scoped, so a different app's callback can reach us. Compare as
+        // strings — the backend sends appId as a string ("7442") while
+        // getAppID() returns a number (7442).
+        if (msg.appId != null && String(msg.appId) !== String(myAppId)) return
+        handler(msg)
+      }
+      GameletAPI.addOnGameCommandListener(listener)
+      return function () { GameletAPI.removeOnGameCommandListener(listener) }
+    },
+  }
+}
+` : "";
+		const applyBridge = useGamelet ? `  if (!o.activityBridge) o.activityBridge = makeActivityBridge()\n` : "";
+		writeFileSync(runnerFile, `// AUTO-GENERATED by @pixui-dev/inflight-test-webpack-plugin — do not edit.
+import { start as _start } from ${JSON.stringify(opts.runtimeImport)}
+${gameletImportLine}
+const specs = [
+${specs}
+]
+
+/** Ids of the discovered test files. */
+export const testFiles = specs.map(function (s) { return s.id })
+${bridgeBlock}
+/**
+ * Run the discovered inflight tests. Writes a Vitest blob report by default
+ * (auto-wired from the PixUI host \`os\` / \`external.writeablePath\`); pass
+ * \`{ report: false }\` to skip. Call from a button / QA panel — no options
+ * needed in the normal case.
+ */
+export function start(options) {
+  var o = Object.assign({}, options)
+${applyBridge}  return _start(specs, o)
+}
+
+/** Run the discovered inflight tests without writing a report. */
+export function startWithoutReport(options) {
+  return start(Object.assign({}, options, { report: false }))
+}
+`, "utf8");
+		return runnerFile;
+	}
+};
+//#endregion
+export { InflightTestPlugin, InflightTestPlugin as default };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

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

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@pixui-dev/inflight-test-webpack-plugin",
+  "license": "UNLICENSED",
+  "version": "0.0.7-inflight.1",
+  "description": "Webpack plugin that discovers *.test.ts cases and wires them into a PixUI activity as an opt-in inflight-test chunk",
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "picomatch": "^4.0.4"
+  },
+  "peerDependencies": {
+    "webpack": "^4.0.0 || ^5.0.0"
+  },
+  "devDependencies": {
+    "@types/picomatch": "^4.0.3",
+    "tsdown": "^0.21.10",
+    "webpack": "^5.0.0"
+  }
+}