@velarscript/cli 0.10.1

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,117 @@
+# @velarscript/cli
+
+Command-line compiler, project tooling, development/verified-production
+servers, Core/browser test runners, production artifact verifier, and language
+server for VelarScript. The language server and project graph are compiler-owned;
+editors, including the injected VelarOS Workbench contribution, consume them as
+independent clients. Requires Node.js 24 or later.
+
+The same server routes JavaScript and TypeScript documents to the pure
+VelarScript `@velarscript/script-analysis` package through an internal bundled
+tool edge. That package publishes bounded lexical
+and local structural diagnostics, symbols, hover, definition, references,
+rename, completion, and semantic tokens with incremental lexical updates. It is
+not the TypeScript compiler: cross-file/package type checking and JavaScript/
+TypeScript formatting remain unsupported and are never synthesized by the CLI.
+
+Application framework behavior is injected. For each project extension the CLI
+loads its compiler entry and optional host entry, validates the versioned host
+protocol, then supplies generic filesystem, bundling, development transport,
+preview, and browser-driver services. The CLI distribution includes exact
+official Node capability plus Web and Desktop application targets so a zero-`node_modules` project can
+consume that toolchain generation, but it owns none of their syntax, HTML,
+CSP, lifecycle, runtime, or native packaging behavior. Project-local targets
+take precedence and third-party extensions never use this fallback.
+The distribution also pins and bundles the implementation dependencies behind
+the official `velar/msgpack`, `velar/compression`, and `velar/noise` adapters;
+applications import those Velar modules, not `msgpackr`, `fflate`, or
+`simplex-noise` directly.
+
+```sh
+npx @velarscript/cli create my-app
+npx @velarscript/cli create api --template node
+npx @velarscript/cli create desktop-app --template desktop
+npx @velarscript/cli create product-docs --template docs
+npx @velarscript/cli create design-kit --template component
+cd my-app
+npm install
+npm exec velar -- format --check
+npm exec velar -- test
+npm exec velar -- dev
+```
+
+Project creation delegates to the exact matching `create-velar` package, the
+same implementation used by `npm create velar@latest`. First-class application
+templates are `web`, `node`, and `desktop`; `docs`, `library`, and `component`
+remain available for specialized projects. Creation never installs or initializes Git.
+
+VelarScript deliberately uses npm as its package registry, resolver, installer, and
+lockfile authority. After the initial `npm install`, the project-aware commands
+provide a smaller everyday surface:
+
+```sh
+npm exec velar -- install
+npm exec velar -- add chart-library
+npm exec velar -- add test-helper --dev
+npm exec velar -- remove chart-library
+npm exec velar -- update
+```
+
+`add` accepts npm registry names and versions, not paths, Git URLs, aliases, or
+raw npm flags. Packages that publish `velar.extension` metadata are also added
+to `velar.json`; removal deletes that declaration and its owned manifest field.
+The npm operation remains authoritative for `package.json`, `package-lock.json`,
+and `node_modules`, while VelarScript atomically owns only its project manifest.
+
+```sh
+npm exec velar -- test --browser
+npm exec velar -- build
+npm exec velar -- package
+npm exec velar -- verify
+npm exec velar -- preview
+npm exec velar -- verify-deployment --url https://preview.example.com
+npm exec velar -- verify-deployment --url https://preview.example.com --json
+```
+
+Browser tests run in a dedicated supervised process, not in the long-lived CLI
+owner. Each test has a 120-second deadline, the complete run has a 20-minute
+deadline, and browser/context cleanup has a 10-second deadline. The supervisor
+owns a private process group on POSIX hosts, forwards SIGHUP/SIGINT/SIGTERM,
+escalates to SIGKILL, and reaps any remaining BrowserServer or renderer process
+before it returns. The worker also observes parent IPC disconnect, so terminating
+or force-killing the invoking CLI cannot leave a browser test running. Signals
+retain conventional exit codes 129, 130, and 143.
+
+`verify-deployment` compares the verified local output to the served HTTPS
+origin. CI may provide the same target with `VELAR_DEPLOYMENT_URL`.
+`--json` emits the versioned verification report used as external-preview
+evidence.
+
+`velar repro` is for the case where the compiler itself looks wrong. It writes
+a self-contained minimal reproduction — the source the diagnostic touches,
+`velar.json`, the verbatim output, and the toolchain, Node, and platform
+versions — into `.velar/repro`, then prints the path. Its `README.md` arrives
+laid out in the three sections a defect report carries, with *What the compiler
+said* already filled in. Nothing is uploaded, nothing about the machine is
+collected, and every absolute path is rewritten to a project-relative one. The
+bundle is extracted to a temporary directory and re-checked before the command
+returns; a copy that stops reproducing is reported as such rather than handed
+over as a clean report. A failing `velar check` ends with the one line naming
+the command.
+
+The distribution also carries the VelarScript AI skill brief
+(`skill/ai-skill.md`, kept byte-identical to the repository's
+`docs/ai-skill.md` by a permanent gate). `velar skill` prints it verbatim to
+stdout, so any coding agent can load the language brief with one offline
+command.
+
+Use `velar help <command>` or `velar <command> --help` for command-specific
+usage and defaults. Project creation is transactional, manifests reject unknown
+fields, and production/release verification fails closed rather than serving or
+accepting undeclared output.
+
+`velar format path/to/file.vel` resolves the file's nearest project before
+formatting and uses that project's official compiler extensions. A Web or
+Desktop file therefore keeps its extension-owned angle syntax even when the
+caller names one file instead of the project root; a malformed project is not
+silently retried as standalone Core source.

package/dist/application-package-host.d.ts

@@ -0,0 +1,5 @@
+import { type ApplicationPackageHost, type ApplicationPackageResult } from "@velarscript/compiler/application-package-host";
+import type { VelarProjectConfig } from "./config.ts";
+export declare function loadApplicationPackageHost(project: VelarProjectConfig): Promise<ApplicationPackageHost>;
+export declare function validateApplicationPackageResult(value: unknown, projectRoot: string): ApplicationPackageResult;
+//# sourceMappingURL=application-package-host.d.ts.map

package/dist/application-package-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-package-host.d.ts","sourceRoot":"","sources":["../src/application-package-host.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,wBAAwB,EAC9B,MAAM,gDAAgD,CAAC;AACxD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAItD,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAuB7G;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,wBAAwB,CAa9G"}

package/dist/application-package-host.js

@@ -0,0 +1,67 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { createRequire } from "node:module";
+import { isAbsolute, relative, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { VELAR_APPLICATION_PACKAGE_HOST_PROTOCOL_VERSION, } from "@velarscript/compiler/application-package-host";
+import { bundledApplicationPackageHost } from "./bundled-application-package-host-registry.js";
+import { hostErrorCode, hostErrorMessage } from "./host-error.js";
+export async function loadApplicationPackageHost(project) {
+    const framework = project.framework;
+    if (!framework)
+        throw new Error("this project does not enable an application target");
+    const package_ = project.extensionGraph.find((item) => item.name === framework.host.id);
+    if (!package_)
+        throw new Error(`application target '${framework.host.id}' is absent from the resolved extension graph`);
+    const bundled = bundledApplicationPackageHost(package_.name);
+    if (bundled)
+        return validateApplicationPackageHost(bundled, package_.name, framework.host.apiVersion);
+    const require = createRequire(package_.manifestPath);
+    const specifier = `${package_.name}/package-host`;
+    let entry;
+    try {
+        entry = require.resolve(specifier);
+    }
+    catch (error) {
+        const code = hostErrorCode(error);
+        const message = hostErrorMessage(error);
+        if (code === "ERR_PACKAGE_PATH_NOT_EXPORTED"
+            || (code === "MODULE_NOT_FOUND" && message.includes(`'${specifier}'`))) {
+            throw new Error(`application target '${package_.name}' does not provide native packaging`);
+        }
+        throw error;
+    }
+    const namespace = await import(__rewriteRelativeImportExtension(pathToFileURL(entry).href));
+    return validateApplicationPackageHost(namespace.velarApplicationPackageHost, package_.name, framework.host.apiVersion);
+}
+export function validateApplicationPackageResult(value, projectRoot) {
+    const result = value;
+    if (!result || typeof result !== "object" || typeof result.artifactPath !== "string" || !isAbsolute(result.artifactPath)
+        || !Array.isArray(result.details) || result.details.length > 16
+        || result.details.some((item) => typeof item !== "string" || item.length > 1024 || /[\0\r\n]/u.test(item))) {
+        throw new Error("application package host returned an invalid result");
+    }
+    const artifactPath = resolve(result.artifactPath);
+    const fromRoot = relative(projectRoot, artifactPath);
+    if (fromRoot === "" || fromRoot === ".." || fromRoot.startsWith(`..${process.platform === "win32" ? "\\" : "/"}`) || isAbsolute(fromRoot)) {
+        throw new Error("application package host returned an artifact path outside the project root");
+    }
+    return Object.freeze({ artifactPath, details: Object.freeze([...result.details]) });
+}
+function validateApplicationPackageHost(value, name, apiVersion) {
+    const host = value;
+    if (!host || typeof host !== "object"
+        || host.protocolVersion !== VELAR_APPLICATION_PACKAGE_HOST_PROTOCOL_VERSION
+        || host.id !== name || host.apiVersion !== apiVersion
+        || typeof host.packageApplication !== "function") {
+        throw new Error(`'${name}/package-host' exports an invalid application package host`);
+    }
+    return Object.freeze(host);
+}
+//# sourceMappingURL=application-package-host.js.map

package/dist/application-package-host.js.map

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

package/dist/bounded-text.d.ts

@@ -0,0 +1,2 @@
+export declare function readBoundedText(path: string, maximumBytes: number, label: string): Promise<string>;
+//# sourceMappingURL=bounded-text.d.ts.map

package/dist/bounded-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-text.d.ts","sourceRoot":"","sources":["../src/bounded-text.ts"],"names":[],"mappings":"AAEA,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAOxG"}

package/dist/bounded-text.js

@@ -0,0 +1,13 @@
+import { readFile, stat } from "node:fs/promises";
+export async function readBoundedText(path, maximumBytes, label) {
+    const metadata = await stat(path);
+    if (!metadata.isFile())
+        throw new Error(`${label} is not a regular file`);
+    if (metadata.size > maximumBytes)
+        throw new RangeError(`${label} exceeds ${maximumBytes} bytes`);
+    const source = await readFile(path, "utf8");
+    if (Buffer.byteLength(source, "utf8") > maximumBytes)
+        throw new RangeError(`${label} exceeds ${maximumBytes} bytes`);
+    return source;
+}
+//# sourceMappingURL=bounded-text.js.map

package/dist/bounded-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-text.js","sourceRoot":"","sources":["../src/bounded-text.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,YAAoB,EAAE,KAAa;IACrF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,wBAAwB,CAAC,CAAC;IAC1E,IAAI,QAAQ,CAAC,IAAI,GAAG,YAAY;QAAE,MAAM,IAAI,UAAU,CAAC,GAAG,KAAK,YAAY,YAAY,QAAQ,CAAC,CAAC;IACjG,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY;QAAE,MAAM,IAAI,UAAU,CAAC,GAAG,KAAK,YAAY,YAAY,QAAQ,CAAC,CAAC;IACrH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/browser-process-owner.d.ts

@@ -0,0 +1,15 @@
+import type { Browser, BrowserServer } from "playwright";
+export interface BrowserWorkerProcessOptions {
+    readonly executable: string;
+    readonly arguments: readonly string[];
+    readonly cwd: string;
+    readonly environment: NodeJS.ProcessEnv;
+    readonly deadlineMs: number;
+    readonly cleanupTimeoutMs: number;
+}
+export declare function superviseBrowserWorker(options: BrowserWorkerProcessOptions): Promise<number>;
+export declare function observeBrowserWorkerParent(): () => void;
+export declare function exitBrowserWorker(code: number): Promise<never>;
+export declare function terminateBrowserServer(browser: Browser | null, server: BrowserServer, timeoutMs: number): Promise<void>;
+export declare function boundedBrowserOperation<T>(operation: Promise<T>, timeoutMs: number, label: string, cancellation?: Promise<never> | null): Promise<T>;
+//# sourceMappingURL=browser-process-owner.d.ts.map

package/dist/browser-process-owner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-process-owner.d.ts","sourceRoot":"","sources":["../src/browser-process-owner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGzD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,UAAU,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,MAAM,CAAC,CAwDlG;AAqBD,wBAAgB,0BAA0B,IAAI,MAAM,IAAI,CAIvD;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAKpE;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,OAAO,GAAG,IAAI,EACvB,MAAM,EAAE,aAAa,EACrB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED,wBAAsB,uBAAuB,CAAC,CAAC,EAC7C,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,EACrB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,YAAY,GAAE,OAAO,CAAC,KAAK,CAAC,GAAG,IAAW,GACzC,OAAO,CAAC,CAAC,CAAC,CAUZ"}

package/dist/browser-process-owner.js

@@ -0,0 +1,151 @@
+import { spawn } from "node:child_process";
+import { hostErrorStack } from "./host-error.js";
+export async function superviseBrowserWorker(options) {
+    const ownsProcessGroup = process.platform !== "win32";
+    const child = spawn(options.executable, options.arguments, {
+        cwd: options.cwd,
+        detached: ownsProcessGroup,
+        env: options.environment,
+        stdio: ["ignore", "inherit", "inherit", "ipc"],
+    });
+    return new Promise((resolveExit, reject) => {
+        let settled = false;
+        let forwarded = null;
+        let forcedTimer = null;
+        const cleanup = () => {
+            process.off("SIGHUP", onHangup);
+            process.off("SIGINT", onInterrupt);
+            process.off("SIGTERM", onTerminate);
+            clearTimeout(deadlineTimer);
+            if (forcedTimer !== null)
+                clearTimeout(forcedTimer);
+        };
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            signalOwnedWorker(child, "SIGKILL", ownsProcessGroup, true);
+            cleanup();
+            resolveExit(value);
+        };
+        const forward = (signal) => {
+            if (forwarded !== null)
+                return;
+            forwarded = signal;
+            signalOwnedWorker(child, signal, ownsProcessGroup, false);
+            forcedTimer = setTimeout(() => {
+                signalOwnedWorker(child, "SIGKILL", ownsProcessGroup, true);
+            }, options.cleanupTimeoutMs + 5_000);
+        };
+        const onHangup = () => forward("SIGHUP");
+        const onInterrupt = () => forward("SIGINT");
+        const onTerminate = () => forward("SIGTERM");
+        process.once("SIGHUP", onHangup);
+        process.once("SIGINT", onInterrupt);
+        process.once("SIGTERM", onTerminate);
+        const deadlineTimer = setTimeout(() => forward("SIGTERM"), options.deadlineMs);
+        child.once("error", (error) => {
+            if (settled)
+                return;
+            settled = true;
+            signalOwnedWorker(child, "SIGKILL", ownsProcessGroup, true);
+            cleanup();
+            reject(error);
+        });
+        child.once("exit", (code, signal) => {
+            if (code !== null)
+                finish(code);
+            else if (forwarded === "SIGHUP")
+                finish(129);
+            else if (forwarded === "SIGINT")
+                finish(130);
+            else if (forwarded === "SIGTERM")
+                finish(143);
+            else
+                finish(signal === null ? 1 : 128);
+        });
+    });
+}
+function signalOwnedWorker(child, signal, ownsProcessGroup, includeExitedGroup) {
+    if (ownsProcessGroup && child.pid !== undefined
+        && (includeExitedGroup || (child.exitCode === null && child.signalCode === null))) {
+        try {
+            process.kill(-child.pid, signal);
+            return;
+        }
+        catch { }
+    }
+    if (child.exitCode === null && child.signalCode === null) {
+        try {
+            child.kill(signal);
+        }
+        catch { }
+    }
+}
+export function observeBrowserWorkerParent() {
+    const parentDisconnected = () => { process.kill(process.pid, "SIGTERM"); };
+    process.once("disconnect", parentDisconnected);
+    return () => process.off("disconnect", parentDisconnected);
+}
+export async function exitBrowserWorker(code) {
+    await flushWritable(process.stdout);
+    await flushWritable(process.stderr);
+    if (process.connected && typeof process.disconnect === "function")
+        process.disconnect();
+    process.exit(code);
+}
+export async function terminateBrowserServer(browser, server, timeoutMs) {
+    const child = server.process();
+    if (browser !== null && browser.isConnected()) {
+        try {
+            await boundedBrowserOperation(browser.close(), timeoutMs, "Browser connection cleanup");
+        }
+        catch { }
+    }
+    try {
+        await boundedBrowserOperation(server.close(), timeoutMs, "Browser graceful cleanup");
+        await boundedBrowserOperation(waitForChildExit(child), timeoutMs, "Browser process exit");
+        return;
+    }
+    catch (gracefulError) {
+        try {
+            await boundedBrowserOperation(server.kill(), timeoutMs, "Browser forced cleanup");
+            await boundedBrowserOperation(waitForChildExit(child), timeoutMs, "Forced browser process exit");
+            return;
+        }
+        catch (forcedError) {
+            if (child.exitCode === null && child.signalCode === null)
+                child.kill("SIGKILL");
+            try {
+                await boundedBrowserOperation(waitForChildExit(child), timeoutMs, "Emergency browser process exit");
+            }
+            catch {
+                throw new Error(`Browser cleanup failed after graceful and forced termination: ${hostErrorStack(gracefulError)}\n${hostErrorStack(forcedError)}`);
+            }
+        }
+    }
+}
+export async function boundedBrowserOperation(operation, timeoutMs, label, cancellation = null) {
+    let timer = null;
+    const timeout = new Promise((_resolve, reject) => {
+        timer = setTimeout(() => reject(new Error(`${label} did not settle within ${timeoutMs} milliseconds`)), timeoutMs);
+    });
+    try {
+        return await Promise.race(cancellation === null ? [operation, timeout] : [operation, timeout, cancellation]);
+    }
+    finally {
+        if (timer !== null)
+            clearTimeout(timer);
+    }
+}
+function waitForChildExit(child) {
+    if (child.exitCode !== null || child.signalCode !== null)
+        return Promise.resolve();
+    return new Promise((resolveExit) => child.once("exit", () => resolveExit()));
+}
+async function flushWritable(stream) {
+    await new Promise((resolveFlush, reject) => {
+        stream.write("", (error) => error ? reject(error) : resolveFlush());
+    });
+}
+//# sourceMappingURL=browser-process-owner.js.map

package/dist/browser-process-owner.js.map

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

package/dist/browser-test-runner.d.ts

@@ -0,0 +1,11 @@
+import type { VelarProjectConfig } from "./config.ts";
+export type BrowserEngine = "chromium" | "firefox" | "webkit";
+export type BrowserEngineSelection = BrowserEngine | "all";
+export interface BrowserTestRunnerOptions {
+    readonly testTimeoutMs?: number;
+    readonly runTimeoutMs?: number;
+    readonly cleanupTimeoutMs?: number;
+    readonly executable?: string;
+}
+export declare function runBrowserTests(config: VelarProjectConfig, explicitInput: string | null, selection: BrowserEngineSelection, options?: BrowserTestRunnerOptions): Promise<number>;
+//# sourceMappingURL=browser-test-runner.d.ts.map

package/dist/browser-test-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-test-runner.d.ts","sourceRoot":"","sources":["../src/browser-test-runner.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA8BtD,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;AAC9D,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG,KAAK,CAAC;AAiO3D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAwCD,wBAAsB,eAAe,CACnC,MAAM,EAAE,kBAAkB,EAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,EAC5B,SAAS,EAAE,sBAAsB,EACjC,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,MAAM,CAAC,CAyBjB"}