bintastic 3.0.0

package/README.md

@@ -0,0 +1,121 @@
+# bintastic
+
+![CI Build](https://github.com/scalvert/bintastic/workflows/CI%20Build/badge.svg)
+[![npm version](https://badge.fury.io/js/bintastic.svg)](https://badge.fury.io/js/bintastic)
+[![License](https://img.shields.io/npm/l/bintastic.svg)](https://github.com/scalvert/bintastic/blob/master/package.json)
+![Dependabot](https://badgen.net/badge/icon/dependabot?icon=dependabot&label)
+[![Code Style: prettier](https://img.shields.io/badge/code_style-prettier-ff69b4.svg?style=flat-square)](#badge)
+
+> **Note:** This package was formerly published as `@scalvert/bin-tester`.
+
+A test harness for Node.js CLI tools.
+
+Testing a CLI isn't like testing a library—you can't just import functions and call them. You need to spawn your CLI as a subprocess, give it real files to work with, and capture its output. bintastic simplifies this:
+
+```ts snippet=basic-example.ts
+import { createBintastic } from 'bintastic';
+
+describe('my-cli', () => {
+  const { setupProject, teardownProject, runBin } = createBintastic({
+    binPath: './bin/my-cli.js',
+  });
+
+  let project;
+
+  beforeEach(async () => {
+    project = await setupProject();
+  });
+
+  afterEach(() => {
+    teardownProject();
+  });
+
+  test('processes files', async () => {
+    project.files = { 'input.txt': 'hello' };
+    await project.write();
+
+    const result = await runBin('input.txt');
+
+    expect(result.exitCode).toBe(0);
+    expect(result.stdout).toContain('processed');
+  });
+});
+```
+
+## Install
+
+```bash
+npm add bintastic --save-dev
+```
+
+## Usage
+
+`createBintastic` returns helpers for setting up projects, running your CLI, and cleaning up:
+
+```ts snippet=create-bintastic.ts
+const { setupProject, teardownProject, runBin } = createBintastic({
+  binPath: './bin/my-cli.js',
+  staticArgs: ['--verbose'], // args passed to every invocation
+});
+```
+
+**Setup and teardown:**
+
+```ts snippet=setup-teardown.ts
+const project = await setupProject(); // creates temp directory
+// ... run tests ...
+teardownProject(); // removes temp directory
+```
+
+**Writing fixture files:**
+
+```ts snippet=writing-fixtures.ts
+project.files = {
+  'src/index.js': 'export default 42;',
+  'package.json': JSON.stringify({ name: 'test' }),
+};
+await project.write();
+```
+
+**Running your CLI:**
+
+```ts snippet=running-cli.ts
+const result = await runBin('--flag', 'arg');
+
+result.exitCode; // number
+result.stdout; // string
+result.stderr; // string
+```
+
+## Debugging
+
+Set `BINTASTIC_DEBUG` to enable the Node inspector and preserve fixtures for inspection:
+
+```bash
+BINTASTIC_DEBUG=attach npm test  # attach debugger
+BINTASTIC_DEBUG=break npm test   # break on first line
+```
+
+Or use `runBinDebug()` programmatically:
+
+```ts snippet=run-bin-debug.ts
+await runBinDebug('--flag'); // runs with --inspect
+```
+
+For VS Code, add to `.vscode/launch.json`:
+
+```jsonc
+{
+  "name": "Debug Tests",
+  "type": "node",
+  "request": "launch",
+  "runtimeExecutable": "${workspaceFolder}/node_modules/.bin/vitest",
+  "runtimeArgs": ["run"],
+  "autoAttachChildProcesses": true,
+  "console": "integratedTerminal",
+}
+```
+
+## API
+
+See the [full API documentation](https://scalvert.github.io/bintastic/).

package/dist/index.cjs

@@ -0,0 +1,175 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BintasticProject: () => BintasticProject,
+  createBintastic: () => createBintastic
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/create-bintastic.ts
+var import_execa2 = require("execa");
+
+// src/project.ts
+var import_execa = require("execa");
+var import_fixturify_project = require("fixturify-project");
+var ROOT = process.cwd();
+var BintasticProject = class extends import_fixturify_project.Project {
+  /**
+   * Constructs an instance of a BintasticProject.
+   * @param {string} name - The name of the project. Used within the package.json as the name property.
+   * @param {string} version - The version of the project. Used within the package.json as the version property.
+   * @param {Function} cb - An optional callback for additional setup steps after the project is constructed.
+   */
+  constructor(name = "fake-project", version, cb) {
+    super(name, version, cb);
+    this._dirChanged = false;
+    this.pkg = Object.assign({}, this.pkg, {
+      license: "MIT",
+      description: "Fake project",
+      repository: "http://fakerepo.com"
+    });
+  }
+  /**
+   * Runs `git init` inside a project.
+   * @returns {*} {ResultPromise}
+   */
+  gitInit() {
+    return (0, import_execa.execa)("git", ["init", "-q", this.baseDir]);
+  }
+  /**
+   * Writes the project files to disk.
+   */
+  async write() {
+    return super.write();
+  }
+  /**
+   * Changes a directory from inside the project.
+   */
+  async chdir() {
+    this._dirChanged = true;
+    await this.write();
+    process.chdir(this.baseDir);
+  }
+  /**
+   * Correctly disposes of the project, observing when the directory has been changed.
+   * @returns {void}
+   */
+  dispose() {
+    if (this._dirChanged) {
+      process.chdir(ROOT);
+    }
+    return super.dispose();
+  }
+};
+
+// src/create-bintastic.ts
+var DEFAULT_BINTASTIC_OPTIONS = {
+  staticArgs: []
+};
+function parseArgs(args) {
+  if (args.length > 0 && typeof args[args.length - 1] === "object") {
+    const argsCopy = [...args];
+    const execaOptions = argsCopy.pop();
+    return {
+      args: argsCopy,
+      execaOptions
+    };
+  } else {
+    return {
+      args: [...args],
+      execaOptions: {}
+    };
+  }
+}
+function createBintastic(options) {
+  let project;
+  const mergedOptions = {
+    ...DEFAULT_BINTASTIC_OPTIONS,
+    ...options
+  };
+  function runBin(...args) {
+    const mergedRunOptions = parseArgs(args);
+    const binPath = typeof mergedOptions.binPath === "function" ? mergedOptions.binPath(project) : mergedOptions.binPath;
+    const optionsEnv = mergedRunOptions.execaOptions.env;
+    const debugEnv = optionsEnv?.BINTASTIC_DEBUG ?? process.env.BINTASTIC_DEBUG;
+    const nodeOptions = [];
+    if (debugEnv && debugEnv !== "0" && debugEnv.toLowerCase() !== "false") {
+      if (debugEnv.toLowerCase() === "break") {
+        nodeOptions.push("--inspect-brk=0");
+      } else {
+        nodeOptions.push("--inspect=0");
+      }
+      console.log(`[bintastic] Debugging enabled. Fixture: ${project.baseDir}`);
+    }
+    const resolvedCwd = mergedRunOptions.execaOptions.cwd ?? project.baseDir;
+    return (0, import_execa2.execaNode)(binPath, [...mergedOptions.staticArgs, ...mergedRunOptions.args], {
+      reject: false,
+      cwd: resolvedCwd,
+      nodeOptions,
+      ...mergedRunOptions.execaOptions
+    });
+  }
+  function runBinDebug(...args) {
+    const parsedArgs = parseArgs(args);
+    const debugEnv = process.env.BINTASTIC_DEBUG || "attach";
+    parsedArgs.execaOptions = {
+      ...parsedArgs.execaOptions,
+      env: {
+        ...parsedArgs.execaOptions.env,
+        BINTASTIC_DEBUG: debugEnv
+      }
+    };
+    const reconstructedArgs = [...parsedArgs.args, parsedArgs.execaOptions];
+    return runBin(...reconstructedArgs);
+  }
+  async function setupProject() {
+    project = "createProject" in mergedOptions ? await mergedOptions.createProject() : new BintasticProject();
+    await project.write();
+    return project;
+  }
+  async function setupTmpDir() {
+    if (typeof project === "undefined") {
+      await setupProject();
+    }
+    return project.baseDir;
+  }
+  function teardownProject() {
+    const debugEnv = process.env.BINTASTIC_DEBUG;
+    if (debugEnv && debugEnv !== "0" && debugEnv.toLowerCase() !== "false") {
+      console.log(`[bintastic] Fixture preserved: ${project.baseDir}`);
+      return;
+    }
+    project.dispose();
+  }
+  return {
+    runBin,
+    runBinDebug,
+    setupProject,
+    teardownProject,
+    setupTmpDir
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BintasticProject,
+  createBintastic
+});

package/dist/index.d.cts

@@ -0,0 +1,112 @@
+import { ResultPromise, Options } from 'execa';
+import { Project } from 'fixturify-project';
+
+declare class BintasticProject extends Project {
+    private _dirChanged;
+    /**
+     * Constructs an instance of a BintasticProject.
+     * @param {string} name - The name of the project. Used within the package.json as the name property.
+     * @param {string} version - The version of the project. Used within the package.json as the version property.
+     * @param {Function} cb - An optional callback for additional setup steps after the project is constructed.
+     */
+    constructor(name?: string, version?: string, cb?: (project: Project) => void);
+    /**
+     * Runs `git init` inside a project.
+     * @returns {*} {ResultPromise}
+     */
+    gitInit(): ResultPromise;
+    /**
+     * Writes the project files to disk.
+     */
+    write(): Promise<void>;
+    /**
+     * Changes a directory from inside the project.
+     */
+    chdir(): Promise<void>;
+    /**
+     * Correctly disposes of the project, observing when the directory has been changed.
+     * @returns {void}
+     */
+    dispose(): void;
+}
+
+/**
+ * Options for configuring bintastic.
+ */
+interface BintasticOptions<TProject> {
+    /**
+     * The absolute path to the bin to invoke
+     */
+    binPath: string | (<TProject extends BintasticProject>(project: TProject) => string);
+    /**
+     * An array of static arguments that will be used every time when running the bin
+     */
+    staticArgs?: string[];
+    /**
+     * An optional function to use to create the project. Use this if you want to provide a custom implementation of a BintasticProject.
+     */
+    createProject?: () => Promise<TProject>;
+}
+/**
+ * Function signature for running the configured CLI binary.
+ */
+interface RunBin {
+    /**
+     * A runBin implementation that takes no parameters.
+     * @returns {*}  {ResultPromise}
+     */
+    (): ResultPromise;
+    /**
+     * A runBin implementation that takes string varargs.
+     * @param {...RunBinArgs} args
+     * @returns {*}  {ResultPromise}
+     */
+    (...args: [...binArgs: string[]]): ResultPromise;
+    /**
+     * A runBin implementation that takes an Options object.
+     * @param {...RunBinArgs} args
+     * @returns {*}  {ResultPromise}
+     */
+    (...args: [execaOptions: Options]): ResultPromise;
+    /**
+     * A runBin implementation that takes string or an Options object varargs.
+     * @param {...RunBinArgs} args
+     * @returns {*}  {ResultPromise}
+     */
+    (...args: [...binArgs: string[], execaOptions: Options]): ResultPromise;
+}
+/**
+ * The result returned by createBintastic.
+ */
+interface CreateBintasticResult<TProject extends BintasticProject> {
+    /**
+     * Runs the configured bin function via execa.
+     */
+    runBin: RunBin;
+    /**
+     * Sets up the specified project for use within tests.
+     */
+    setupProject: () => Promise<TProject>;
+    /**
+     * Sets up a tmp directory for use within tests.
+     */
+    setupTmpDir: () => Promise<string>;
+    /**
+     * Tears the project down, ensuring the tmp directory is removed.
+     * When BINTASTIC_DEBUG is set, fixtures are preserved for inspection.
+     */
+    teardownProject: () => void;
+    /**
+     * Runs the configured bin with Node inspector enabled in attach mode (--inspect).
+     * Set BINTASTIC_DEBUG=break to break on first line instead.
+     */
+    runBinDebug: RunBin;
+}
+/**
+ * Creates the bintastic API functions to use within tests.
+ * @param {BintasticOptions<TProject>} options - An object of bintastic options
+ * @returns {CreateBintasticResult<TProject>} - A project instance.
+ */
+declare function createBintastic<TProject extends BintasticProject>(options: BintasticOptions<TProject>): CreateBintasticResult<TProject>;
+
+export { type BintasticOptions, BintasticProject, type CreateBintasticResult, type RunBin, createBintastic };

package/dist/index.d.ts

@@ -0,0 +1,112 @@
+import { ResultPromise, Options } from 'execa';
+import { Project } from 'fixturify-project';
+
+declare class BintasticProject extends Project {
+    private _dirChanged;
+    /**
+     * Constructs an instance of a BintasticProject.
+     * @param {string} name - The name of the project. Used within the package.json as the name property.
+     * @param {string} version - The version of the project. Used within the package.json as the version property.
+     * @param {Function} cb - An optional callback for additional setup steps after the project is constructed.
+     */
+    constructor(name?: string, version?: string, cb?: (project: Project) => void);
+    /**
+     * Runs `git init` inside a project.
+     * @returns {*} {ResultPromise}
+     */
+    gitInit(): ResultPromise;
+    /**
+     * Writes the project files to disk.
+     */
+    write(): Promise<void>;
+    /**
+     * Changes a directory from inside the project.
+     */
+    chdir(): Promise<void>;
+    /**
+     * Correctly disposes of the project, observing when the directory has been changed.
+     * @returns {void}
+     */
+    dispose(): void;
+}
+
+/**
+ * Options for configuring bintastic.
+ */
+interface BintasticOptions<TProject> {
+    /**
+     * The absolute path to the bin to invoke
+     */
+    binPath: string | (<TProject extends BintasticProject>(project: TProject) => string);
+    /**
+     * An array of static arguments that will be used every time when running the bin
+     */
+    staticArgs?: string[];
+    /**
+     * An optional function to use to create the project. Use this if you want to provide a custom implementation of a BintasticProject.
+     */
+    createProject?: () => Promise<TProject>;
+}
+/**
+ * Function signature for running the configured CLI binary.
+ */
+interface RunBin {
+    /**
+     * A runBin implementation that takes no parameters.
+     * @returns {*}  {ResultPromise}
+     */
+    (): ResultPromise;
+    /**
+     * A runBin implementation that takes string varargs.
+     * @param {...RunBinArgs} args
+     * @returns {*}  {ResultPromise}
+     */
+    (...args: [...binArgs: string[]]): ResultPromise;
+    /**
+     * A runBin implementation that takes an Options object.
+     * @param {...RunBinArgs} args
+     * @returns {*}  {ResultPromise}
+     */
+    (...args: [execaOptions: Options]): ResultPromise;
+    /**
+     * A runBin implementation that takes string or an Options object varargs.
+     * @param {...RunBinArgs} args
+     * @returns {*}  {ResultPromise}
+     */
+    (...args: [...binArgs: string[], execaOptions: Options]): ResultPromise;
+}
+/**
+ * The result returned by createBintastic.
+ */
+interface CreateBintasticResult<TProject extends BintasticProject> {
+    /**
+     * Runs the configured bin function via execa.
+     */
+    runBin: RunBin;
+    /**
+     * Sets up the specified project for use within tests.
+     */
+    setupProject: () => Promise<TProject>;
+    /**
+     * Sets up a tmp directory for use within tests.
+     */
+    setupTmpDir: () => Promise<string>;
+    /**
+     * Tears the project down, ensuring the tmp directory is removed.
+     * When BINTASTIC_DEBUG is set, fixtures are preserved for inspection.
+     */
+    teardownProject: () => void;
+    /**
+     * Runs the configured bin with Node inspector enabled in attach mode (--inspect).
+     * Set BINTASTIC_DEBUG=break to break on first line instead.
+     */
+    runBinDebug: RunBin;
+}
+/**
+ * Creates the bintastic API functions to use within tests.
+ * @param {BintasticOptions<TProject>} options - An object of bintastic options
+ * @returns {CreateBintasticResult<TProject>} - A project instance.
+ */
+declare function createBintastic<TProject extends BintasticProject>(options: BintasticOptions<TProject>): CreateBintasticResult<TProject>;
+
+export { type BintasticOptions, BintasticProject, type CreateBintasticResult, type RunBin, createBintastic };

package/dist/index.js

@@ -0,0 +1,147 @@
+// src/create-bintastic.ts
+import { execaNode } from "execa";
+
+// src/project.ts
+import { execa } from "execa";
+import { Project } from "fixturify-project";
+var ROOT = process.cwd();
+var BintasticProject = class extends Project {
+  /**
+   * Constructs an instance of a BintasticProject.
+   * @param {string} name - The name of the project. Used within the package.json as the name property.
+   * @param {string} version - The version of the project. Used within the package.json as the version property.
+   * @param {Function} cb - An optional callback for additional setup steps after the project is constructed.
+   */
+  constructor(name = "fake-project", version, cb) {
+    super(name, version, cb);
+    this._dirChanged = false;
+    this.pkg = Object.assign({}, this.pkg, {
+      license: "MIT",
+      description: "Fake project",
+      repository: "http://fakerepo.com"
+    });
+  }
+  /**
+   * Runs `git init` inside a project.
+   * @returns {*} {ResultPromise}
+   */
+  gitInit() {
+    return execa("git", ["init", "-q", this.baseDir]);
+  }
+  /**
+   * Writes the project files to disk.
+   */
+  async write() {
+    return super.write();
+  }
+  /**
+   * Changes a directory from inside the project.
+   */
+  async chdir() {
+    this._dirChanged = true;
+    await this.write();
+    process.chdir(this.baseDir);
+  }
+  /**
+   * Correctly disposes of the project, observing when the directory has been changed.
+   * @returns {void}
+   */
+  dispose() {
+    if (this._dirChanged) {
+      process.chdir(ROOT);
+    }
+    return super.dispose();
+  }
+};
+
+// src/create-bintastic.ts
+var DEFAULT_BINTASTIC_OPTIONS = {
+  staticArgs: []
+};
+function parseArgs(args) {
+  if (args.length > 0 && typeof args[args.length - 1] === "object") {
+    const argsCopy = [...args];
+    const execaOptions = argsCopy.pop();
+    return {
+      args: argsCopy,
+      execaOptions
+    };
+  } else {
+    return {
+      args: [...args],
+      execaOptions: {}
+    };
+  }
+}
+function createBintastic(options) {
+  let project;
+  const mergedOptions = {
+    ...DEFAULT_BINTASTIC_OPTIONS,
+    ...options
+  };
+  function runBin(...args) {
+    const mergedRunOptions = parseArgs(args);
+    const binPath = typeof mergedOptions.binPath === "function" ? mergedOptions.binPath(project) : mergedOptions.binPath;
+    const optionsEnv = mergedRunOptions.execaOptions.env;
+    const debugEnv = optionsEnv?.BINTASTIC_DEBUG ?? process.env.BINTASTIC_DEBUG;
+    const nodeOptions = [];
+    if (debugEnv && debugEnv !== "0" && debugEnv.toLowerCase() !== "false") {
+      if (debugEnv.toLowerCase() === "break") {
+        nodeOptions.push("--inspect-brk=0");
+      } else {
+        nodeOptions.push("--inspect=0");
+      }
+      console.log(`[bintastic] Debugging enabled. Fixture: ${project.baseDir}`);
+    }
+    const resolvedCwd = mergedRunOptions.execaOptions.cwd ?? project.baseDir;
+    return execaNode(binPath, [...mergedOptions.staticArgs, ...mergedRunOptions.args], {
+      reject: false,
+      cwd: resolvedCwd,
+      nodeOptions,
+      ...mergedRunOptions.execaOptions
+    });
+  }
+  function runBinDebug(...args) {
+    const parsedArgs = parseArgs(args);
+    const debugEnv = process.env.BINTASTIC_DEBUG || "attach";
+    parsedArgs.execaOptions = {
+      ...parsedArgs.execaOptions,
+      env: {
+        ...parsedArgs.execaOptions.env,
+        BINTASTIC_DEBUG: debugEnv
+      }
+    };
+    const reconstructedArgs = [...parsedArgs.args, parsedArgs.execaOptions];
+    return runBin(...reconstructedArgs);
+  }
+  async function setupProject() {
+    project = "createProject" in mergedOptions ? await mergedOptions.createProject() : new BintasticProject();
+    await project.write();
+    return project;
+  }
+  async function setupTmpDir() {
+    if (typeof project === "undefined") {
+      await setupProject();
+    }
+    return project.baseDir;
+  }
+  function teardownProject() {
+    const debugEnv = process.env.BINTASTIC_DEBUG;
+    if (debugEnv && debugEnv !== "0" && debugEnv.toLowerCase() !== "false") {
+      console.log(`[bintastic] Fixture preserved: ${project.baseDir}`);
+      return;
+    }
+    project.dispose();
+  }
+  return {
+    runBin,
+    runBinDebug,
+    setupProject,
+    teardownProject,
+    setupTmpDir
+  };
+}
+export {
+  BintasticProject,
+  createBintastic
+};

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "bintastic",
+  "version": "3.0.0",
+  "description": "A test harness for Node.js CLI tools",
+  "keywords": [
+    "cli",
+    "test",
+    "harness",
+    "binary",
+    "subprocess"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/scalvert/bintastic.git"
+  },
+  "homepage": "https://github.com/scalvert/bintastic#readme",
+  "bugs": {
+    "url": "https://github.com/scalvert/bintastic/issues"
+  },
+  "license": "MIT",
+  "author": "Steve Calvert <steve.calvert@gmail.com>",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "docs": "typedoc",
+    "docs:check": "markdown-code check",
+    "docs:sync": "markdown-code sync",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint . && npm run format:check && npm run docs:check",
+    "prepublishOnly": "npm run build",
+    "test": "npm run lint && npm run test:vitest",
+    "test:vitest": "vitest run",
+    "test:watch": "vitest",
+    "watch": "npm run build -- --watch src"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "execa": "^9.6.1",
+    "fixturify-project": "^7.1.3"
+  },
+  "devDependencies": {
+    "@babel/plugin-proposal-class-properties": "^7.18.6",
+    "@babel/plugin-proposal-object-rest-spread": "^7.20.7",
+    "@babel/plugin-transform-typescript": "^7.27.0",
+    "@babel/preset-env": "^7.26.9",
+    "@babel/preset-typescript": "^7.27.0",
+    "@release-it-plugins/lerna-changelog": "^8.0.1",
+    "@typescript-eslint/eslint-plugin": "^8.29.1",
+    "@typescript-eslint/parser": "^8.29.1",
+    "eslint": "^9.24.0",
+    "eslint-config-prettier": "^10.1.2",
+    "eslint-plugin-jsdoc": "^61.5.0",
+    "eslint-plugin-node": "^11.1.0",
+    "eslint-plugin-prettier": "^5.2.6",
+    "eslint-plugin-unicorn": "^62.0.0",
+    "fixturify": "^3.0.0",
+    "markdown-code": "^0.6.1",
+    "prettier": "^3.5.3",
+    "release-it": "^19.2.2",
+    "tsup": "^8.4.0",
+    "type-fest": "^5.3.1",
+    "typedoc": "^0.28.15",
+    "typescript": "^5.8.3",
+    "vite": "^7.3.0",
+    "vitest": "^4.0.16"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "release-it": {
+    "plugins": {
+      "@release-it-plugins/lerna-changelog": {
+        "infile": "CHANGELOG.md",
+        "launchEditor": true
+      }
+    },
+    "git": {
+      "tagName": "v${version}"
+    },
+    "github": {
+      "release": true,
+      "tokenRef": "GITHUB_AUTH"
+    }
+  }
+}