ectrol 0.0.2

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-PRESENT Cee Vee X <https://github.com/ceeveex>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# Ectrol = Electron + Control
+
+一个基于 Electron WebContents 的轻量级自动化助手，用于在你的应用内对网页内容进行交互（点击、输入、聚焦、键盘事件等）。
+
+- 专注于 Electron 环境：无需引入完整的浏览器自动化运行时。
+- 轻量且易用：API 风格参考了部分 Playwright 用法，学习成本低。
+- 支持 iframe 穿越选择器：使用 `|>` 分隔层级，轻松访问嵌套内容。
+
+## 安装
+
+你可以使用任意包管理器进行安装：
+
+```powershell
+# PNPM
+pnpm add ectrol
+
+# NPM
+npm install ectrol
+
+# Yarn
+yarn add ectrol
+```
+
+## 快速开始
+
+在主进程中创建 `Ectrol` 实例，并传入目标 `WebContents`：
+
+```ts
+import Ectrol from 'ectrol'
+import { app, BrowserWindow } from 'electron'
+
+let win: BrowserWindow
+
+app.whenReady().then(async () => {
+  win = new BrowserWindow({
+    webPreferences: {
+      nodeIntegration: false,
+      contextIsolation: true,
+    },
+  })
+
+  await win.loadURL('https://example.com')
+
+  const ctl = new Ectrol(win.webContents)
+
+  // 基本查询与点击
+  const exist = await ctl.$('button.submit').exist(2000)
+  if (exist) {
+    await ctl.$('button.submit').click()
+  }
+
+  // 输入文本（支持 input / textarea / contenteditable）
+  await ctl.$('input[name="username"]').fill('hello-world', { timeout: 2000 })
+
+  // 组合键：Ctrl+Shift+T（Windows/Linux 下为 Control，macOS 可用 Meta）
+  await ctl.$('input[name="username"]').press('Control+Shift+T', { delay: 50 })
+
+  // 读写存储
+  await ctl.localStorage.setItem('token', 'abc123')
+  const token = await ctl.localStorage.getItem('token')
+  console.log('token:', token)
+})
+```
+
+### iframe 选择器
+
+当页面包含 iframe 时，使用 `|>` 逐层穿越：
+
+```ts
+// 选择外层 iframe，再选择里层的输入框
+await ctl.$('iframe#login |> input[name="username"]').fill('user')
+
+// 更深层级示例
+await ctl.$('iframe#outer |> iframe#inner |> button.go').click()
+```
+
+### 常用 API
+
+- `ctl.$(selector).exist(timeout?)`: 检查元素是否存在（支持超时轮询）。
+- `ctl.$(selector).click(options?)`: 点击元素（可配置按钮、次数、修饰键）。
+- `ctl.$(selector).dblclick(options?)`: 双击元素。
+- `ctl.$(selector).fill(value, options?)`: 填充文本并触发 `input` 事件。
+- `ctl.$(selector).press(keys, options?)`: 在元素上发送组合键（自动聚焦）。
+- `ctl.$(selector).focus(options?)`: 聚焦输入型元素。
+- `ctl.$(selector).getBoundingClientRect(timeout?)`: 获取包含中心点坐标的位置信息。
+- `ctl.localStorage.* / ctl.sessionStorage.*`: 操作存储（字符串键值）。
+
+## 为什么不是 Playwright？
+
+编写该库时尚不熟悉 Playwright。后续了解后发现其功能全面，但在 Electron 应用内做少量、直接的页面交互，往往只需要一个轻量方案。Electrol 的设计目标是：在不引入额外浏览器驱动与上下文的前提下，以最小侵入实现 Electron 内的页面自动化。
+
+## 许可
+
+详见 `LICENSE.md`。

package/dist/index.d.mts

@@ -0,0 +1,196 @@
+import { WebContents } from "electron";
+
+//#region src/element.d.ts
+
+/**
+ * 扩展版的元素位置信息，基于 DOMRect 并补充中心点坐标。
+ */
+interface IBoundingClientRect {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+  top: number;
+  right: number;
+  bottom: number;
+  left: number;
+  centerX: number;
+  centerY: number;
+}
+/**
+ * 二维向量坐标。
+ */
+interface IVector2D {
+  x: number;
+  y: number;
+}
+/**
+ * 尺寸信息。
+ */
+interface ISize {
+  width: number;
+  height: number;
+}
+/**
+ * ElementHandle
+ *
+ * - 封装了在指定 WebContents 中对单个元素进行操作的能力
+ * - 选择器支持 iframe 穿越，形如：`iframe.sel |> .inner |> button.submit`
+ * - 大多数 API 接受 `timeout`，轮询查找元素直到超时
+ */
+declare class ElementHandle {
+  readonly contents: WebContents;
+  readonly selector: string;
+  isNotFound: boolean;
+  constructor(contents: WebContents, selector: string);
+  /**
+   * 生成在 renderer 端执行的查找脚本。
+   * - 通过 `|>` 支持逐层进入 iframe。
+   * - 在 `window.__ELECTROL__` 上缓存找到的元素及其 rect，以减少后续访问成本。
+   * - 当传入 `timeout > 0` 时会在 renderer 端做原地轮询，直到找到或超时。
+   */
+  private _getElement;
+  /**
+   * 触发元素 mouseover 事件（不移动真实鼠标）。
+   */
+  hover(): Promise<any>;
+  /**
+   * 点击
+   * - 通过 WebContents.sendInputEvent 发送 mouseDown/mouseUp 事件
+   * - 默认在元素中心点点击
+   * - 支持修饰键（Alt/Control/Meta/Shift）按下期间点击
+   * - 注意：此操作会触发鼠标悬浮事件
+   */
+  click(options?: {
+    button?: 'left' | 'right' | 'middle';
+    clickCount?: number;
+    delay?: number;
+    modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[];
+    position?: IVector2D;
+    timeout?: number;
+  }): Promise<void>;
+  /**
+   * 双击
+   * - 底层复用 click，并将 `clickCount` 设为 2。
+   */
+  dblclick(options?: {
+    button?: 'left' | 'right' | 'middle';
+    delay?: number;
+    modifiers?: ('Alt' | 'Control' | 'ControlOrMeta' | 'Meta' | 'Shift')[];
+    position?: IVector2D;
+    timeout?: number;
+  }): Promise<void>;
+  /**
+   * 将复选框或单选按钮设为选中，并派发 change 事件。
+   */
+  check(): Promise<any>;
+  /**
+   * 填充输入框内容。
+   * - 适用于 `<input>`、`<textarea>` 或 `contenteditable` 元素。
+   * - 会触发 `input` 事件（冒泡）。
+   */
+  fill(value: string, options?: {
+    timeout?: number;
+  }): Promise<void>;
+  /**
+   * 在元素上发送按键事件。
+   * - 先调用 `focus()`，随后按下并抬起指定组合键。
+   * - 组合键用 `+` 连接，如 `Control+Shift+A`。
+   * @example
+   * press('a', { delay: 100, timeout: 1000 })
+   * press('Control+Shift+T')
+   */
+  press(key: string, options?: {
+    delay?: number;
+    timeout?: number;
+  }): Promise<void>;
+  /**
+   * 聚焦输入型元素（input/textarea/contenteditable）。
+   */
+  focus(options?: {
+    timeout?: number;
+  }): Promise<any>;
+  /**
+   * 检查元素是否存在（支持超时轮询）。
+   */
+  exist(timeout?: number): Promise<boolean>;
+  /**
+   * 获取元素的位置信息。
+   * - 返回扩展的 DOMRect 信息并包含元素中心点坐标。
+   */
+  getBoundingClientRect(timeout?: number): Promise<IBoundingClientRect | null>;
+}
+//#endregion
+//#region src/localStorage.d.ts
+/**
+ * LocalStorage 封装
+ *
+ * 通过 WebContents 在渲染进程中直接读取/写入 window.localStorage。
+ * 注意：键值均按字符串处理。
+ */
+declare class LocalStorage {
+  readonly contents: WebContents;
+  constructor(contents: WebContents);
+  /**
+   * 获取指定键的值。
+   */
+  getItem(key: string): Promise<string | null>;
+  /**
+   * 写入指定键的值。
+   */
+  setItem(key: string, value: string): Promise<void>;
+  /**
+   * 删除指定键。
+   */
+  removeItem(key: string): Promise<void>;
+}
+//#endregion
+//#region src/sessionStorage.d.ts
+/**
+ * SessionStorage 封装
+ *
+ * 通过 WebContents 在渲染进程中直接读取/写入 window.sessionStorage。
+ * 注意：键值均按字符串处理；生命周期为会话级别。
+ */
+declare class SessionStorage {
+  readonly contents: WebContents;
+  constructor(contents: WebContents);
+  /**
+   * 获取指定键的值。
+   */
+  getItem(key: string): Promise<string | null>;
+  /**
+   * 写入指定键的值。
+   */
+  setItem(key: string, value: string): Promise<void>;
+  /**
+   * 删除指定键。
+   */
+  removeItem(key: string): Promise<void>;
+}
+//#endregion
+//#region src/index.d.ts
+/**
+ * Ectrol
+ *
+ * 一个针对 Electron WebContents 的轻量级自动化助手。
+ * - 提供 `localStorage` / `sessionStorage` 封装
+ * - 通过 `$(selector)` 获取元素句柄进行点击、输入、聚焦等操作
+ *
+ * 选择器支持穿越 iframe：
+ * 使用 `|>` 分隔层级，如：`iframe#login |> input[name="username"]`
+ */
+declare class Ectrol {
+  readonly contents: WebContents;
+  readonly localStorage: LocalStorage;
+  readonly sessionStorage: SessionStorage;
+  constructor(contents: WebContents);
+  /**
+   * 获取一个元素句柄，用于后续交互。
+   * @param selector CSS 选择器；支持通过 `|>` 穿越 iframe
+   * @returns `ElementHandle` 实例
+   */
+  $(selector: string): ElementHandle;
+}
+//#endregion
+export { Ectrol, Ectrol as default, ElementHandle, IBoundingClientRect, ISize, IVector2D, LocalStorage, SessionStorage };

package/dist/index.mjs

@@ -0,0 +1,390 @@
+//#region src/element.ts
+/**
+* ElementHandle
+*
+* - 封装了在指定 WebContents 中对单个元素进行操作的能力
+* - 选择器支持 iframe 穿越，形如：`iframe.sel |> .inner |> button.submit`
+* - 大多数 API 接受 `timeout`，轮询查找元素直到超时
+*/
+var ElementHandle = class {
+	isNotFound = false;
+	constructor(contents, selector) {
+		this.contents = contents;
+		this.selector = selector;
+	}
+	/**
+	* 生成在 renderer 端执行的查找脚本。
+	* - 通过 `|>` 支持逐层进入 iframe。
+	* - 在 `window.__ELECTROL__` 上缓存找到的元素及其 rect，以减少后续访问成本。
+	* - 当传入 `timeout > 0` 时会在 renderer 端做原地轮询，直到找到或超时。
+	*/
+	_getElement(timeout = 0) {
+		return `
+     (()=>{
+        function getElement() {
+          const selector = "${this.selector}";
+
+          if (!selector) return null;
+
+          window.__ELECTROL__ = window.__ELECTROL__ || {};
+          if (window.__ELECTROL__[selector]) {
+            return window.__ELECTROL__[selector];
+          }
+
+          // 分层选择器，支持 iframe 穿越
+          const parts = selector.split('|>').map(s => s.trim());
+          if (!parts.length) return null;
+
+          let currentDocument = document;
+          let offsetLeft = 0;
+          let offsetTop = 0;
+          let element = null;
+
+          for (let i = 0; i < parts.length; i++) {
+            if (!currentDocument) return null;
+
+            const part = parts[i];
+            // 在当前文档查找该层选择器
+            const el = currentDocument.querySelector(part);
+
+            if (!el) {
+              console.warn('未找到元素:', part);
+              return null;
+            }
+
+            const rect = el.getBoundingClientRect();
+
+            // 累加当前层级偏移
+            offsetLeft += rect.left;
+            offsetTop += rect.top;
+
+            element = el;
+
+            const isLast = i === parts.length - 1;
+            if (!isLast) {
+              if (el.tagName !== 'IFRAME') {
+                console.warn('非 iframe 元素却尝试进入下一层:', part);
+                return null;
+              }
+
+              const nextDoc = el.contentDocument || el.contentWindow?.document;
+              if (!nextDoc) {
+                console.warn('无法访问 iframe.contentDocument（可能跨域）');
+                return null;
+              }
+
+              currentDocument = nextDoc;
+            }
+          }
+
+          if (!element) return null;
+
+          const finalRect = element.getBoundingClientRect();
+
+          // 缓存元素
+          // 缓存以避免重复查找
+          window.__ELECTROL__[selector] = {
+            element,
+            rect: new DOMRect(
+              offsetLeft,
+              offsetTop,
+              finalRect.width,
+              finalRect.height
+            )
+          };
+
+          return window.__ELECTROL__[selector]
+        }
+
+        const timeout = ${timeout}
+
+        if(timeout <= 0) {
+          return getElement();
+        }
+
+        const startTime = Date.now()
+        while (Date.now() - startTime < timeout) {
+          const element = getElement();
+          if (element) return element;
+        }
+        return null;
+      })()
+    `;
+	}
+	/**
+	* 触发元素 mouseover 事件（不移动真实鼠标）。
+	*/
+	hover() {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement()};
+        if (!target) return null;
+
+        const event = new MouseEvent('mouseover', {
+          bubbles: true,
+          cancelable: true,
+          view: window
+        });
+        target.element.dispatchEvent(event);
+      })()
+    `);
+	}
+	/**
+	* 点击
+	* - 通过 WebContents.sendInputEvent 发送 mouseDown/mouseUp 事件
+	* - 默认在元素中心点点击
+	* - 支持修饰键（Alt/Control/Meta/Shift）按下期间点击
+	* - 注意：此操作会触发鼠标悬浮事件
+	*/
+	async click(options) {
+		const rect = await this.getBoundingClientRect(options?.timeout);
+		if (!rect) return;
+		const _handle = async () => {
+			this.contents.sendInputEvent({
+				type: "mouseDown",
+				x: rect.centerX,
+				y: rect.centerY,
+				button: options?.button || "left",
+				clickCount: 1
+			});
+			await new Promise((resolve) => setTimeout(resolve, options?.delay || 10));
+			this.contents.sendInputEvent({
+				type: "mouseUp",
+				x: rect.centerX,
+				y: rect.centerY,
+				button: options?.button || "left",
+				clickCount: 1
+			});
+		};
+		if (options?.modifiers) for (const modifier of options.modifiers) this.contents.sendInputEvent({
+			type: "keyDown",
+			keyCode: modifier
+		});
+		if (options?.clickCount) for (let i = 0; i < options.clickCount; i++) await _handle();
+		else await _handle();
+		if (options?.modifiers) for (const modifier of options.modifiers) this.contents.sendInputEvent({
+			type: "keyUp",
+			keyCode: modifier
+		});
+	}
+	/**
+	* 双击
+	* - 底层复用 click，并将 `clickCount` 设为 2。
+	*/
+	async dblclick(options) {
+		return this.click({
+			...options,
+			clickCount: 2
+		});
+	}
+	/**
+	* 将复选框或单选按钮设为选中，并派发 change 事件。
+	*/
+	check() {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement()};
+        if (!target) return null;
+
+        // 验证输入框是否是复选框或单选按钮
+        if (target.element.tagName !== 'INPUT' || (target.element.type !== 'checkbox' && target.element.type !== 'radio')) return null;
+
+        target.element.checked = true;
+        target.element.dispatchEvent(new Event('change', { bubbles: true }));
+      })()
+    `);
+	}
+	/**
+	* 填充输入框内容。
+	* - 适用于 `<input>`、`<textarea>` 或 `contenteditable` 元素。
+	* - 会触发 `input` 事件（冒泡）。
+	*/
+	async fill(value, options) {
+		await this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement(options?.timeout)};
+        if (!target) return null;
+
+        // 验证输入框是否是文本类型
+        if (target.element.tagName !== 'INPUT' && target.element.tagName !== 'TEXTAREA' && !target.element.isContentEditable) return null;
+
+        target.element.focus();
+
+        target.element.value = ${JSON.stringify(value)};
+        target.element.dispatchEvent(new Event('input', { bubbles: true }));
+      })()
+    `);
+	}
+	/**
+	* 在元素上发送按键事件。
+	* - 先调用 `focus()`，随后按下并抬起指定组合键。
+	* - 组合键用 `+` 连接，如 `Control+Shift+A`。
+	* @example
+	* press('a', { delay: 100, timeout: 1000 })
+	* press('Control+Shift+T')
+	*/
+	async press(key, options) {
+		await this.focus(options);
+		const keys = key.split("+");
+		for (const key$1 of keys) this.contents.sendInputEvent({
+			type: "keyDown",
+			keyCode: key$1
+		});
+		await new Promise((resolve) => setTimeout(resolve, options?.delay || 10));
+		for (const key$1 of keys) this.contents.sendInputEvent({
+			type: "keyUp",
+			keyCode: key$1
+		});
+	}
+	/**
+	* 聚焦输入型元素（input/textarea/contenteditable）。
+	*/
+	async focus(options) {
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement(options?.timeout)};
+        if (!target) return null;
+
+        // 验证输入框是否是文本类型
+        if (target.element.tagName !== 'INPUT' && target.element.tagName !== 'TEXTAREA' && !target.element.isContentEditable) return null;
+
+        target.element.focus();
+      })()
+    `);
+	}
+	/**
+	* 检查元素是否存在（支持超时轮询）。
+	*/
+	async exist(timeout) {
+		return await this.contents.executeJavaScript(`!!${this._getElement(timeout)}`);
+	}
+	/**
+	* 获取元素的位置信息。
+	* - 返回扩展的 DOMRect 信息并包含元素中心点坐标。
+	*/
+	getBoundingClientRect(timeout = 0) {
+		if (this.isNotFound) return Promise.resolve(null);
+		return this.contents.executeJavaScript(`
+      (function() {
+        const target = ${this._getElement(timeout)};
+
+        if (!target) return null;
+
+        const rect = target.rect;
+        return {
+          left: rect.left,
+          top: rect.top,
+          right: rect.right,
+          bottom: rect.bottom,
+          width: rect.width,
+          height: rect.height,
+          x: rect.x,
+          y: rect.y,
+          centerX: rect.x + rect.width / 2,
+          centerY: rect.y + rect.height / 2
+        };
+      })()
+    `);
+	}
+};
+var element_default = ElementHandle;
+
+//#endregion
+//#region src/localStorage.ts
+/**
+* LocalStorage 封装
+*
+* 通过 WebContents 在渲染进程中直接读取/写入 window.localStorage。
+* 注意：键值均按字符串处理。
+*/
+var LocalStorage = class {
+	constructor(contents) {
+		this.contents = contents;
+	}
+	/**
+	* 获取指定键的值。
+	*/
+	async getItem(key) {
+		return this.contents.executeJavaScript(`localStorage.getItem("${key}")`);
+	}
+	/**
+	* 写入指定键的值。
+	*/
+	async setItem(key, value) {
+		await this.contents.executeJavaScript(`localStorage.setItem("${key}", "${value}")`);
+	}
+	/**
+	* 删除指定键。
+	*/
+	async removeItem(key) {
+		await this.contents.executeJavaScript(`localStorage.removeItem("${key}")`);
+	}
+};
+var localStorage_default = LocalStorage;
+
+//#endregion
+//#region src/sessionStorage.ts
+/**
+* SessionStorage 封装
+*
+* 通过 WebContents 在渲染进程中直接读取/写入 window.sessionStorage。
+* 注意：键值均按字符串处理；生命周期为会话级别。
+*/
+var SessionStorage = class {
+	constructor(contents) {
+		this.contents = contents;
+	}
+	/**
+	* 获取指定键的值。
+	*/
+	async getItem(key) {
+		return this.contents.executeJavaScript(`sessionStorage.getItem("${key}")`);
+	}
+	/**
+	* 写入指定键的值。
+	*/
+	async setItem(key, value) {
+		await this.contents.executeJavaScript(`sessionStorage.setItem("${key}", "${value}")`);
+	}
+	/**
+	* 删除指定键。
+	*/
+	async removeItem(key) {
+		await this.contents.executeJavaScript(`sessionStorage.removeItem("${key}")`);
+	}
+};
+var sessionStorage_default = SessionStorage;
+
+//#endregion
+//#region src/index.ts
+/**
+* Ectrol
+*
+* 一个针对 Electron WebContents 的轻量级自动化助手。
+* - 提供 `localStorage` / `sessionStorage` 封装
+* - 通过 `$(selector)` 获取元素句柄进行点击、输入、聚焦等操作
+*
+* 选择器支持穿越 iframe：
+* 使用 `|>` 分隔层级，如：`iframe#login |> input[name="username"]`
+*/
+var Ectrol = class {
+	localStorage;
+	sessionStorage;
+	constructor(contents) {
+		this.contents = contents;
+		this.localStorage = new localStorage_default(contents);
+		this.sessionStorage = new sessionStorage_default(contents);
+	}
+	/**
+	* 获取一个元素句柄，用于后续交互。
+	* @param selector CSS 选择器；支持通过 `|>` 穿越 iframe
+	* @returns `ElementHandle` 实例
+	*/
+	$(selector) {
+		return new element_default(this.contents, selector);
+	}
+};
+var src_default = Ectrol;
+
+//#endregion
+export { Ectrol, ElementHandle, LocalStorage, SessionStorage, src_default as default };

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "ectrol",
+  "type": "module",
+  "version": "0.0.2",
+  "description": "一个基于 Electron WebContents 的轻量级自动化助手，用于在你的应用内对网页内容进行交互（点击、输入、聚焦、键盘事件等）。",
+  "author": "Cee Vee X <ceeveex@hotmail.com>",
+  "license": "MIT",
+  "funding": "https://github.com/sponsors/ceeveex",
+  "homepage": "https://github.com/ceeveex/ectrol#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ceeveex/ectrol.git"
+  },
+  "bugs": "https://github.com/ceeveex/ectrol/issues",
+  "keywords": [],
+  "sideEffects": false,
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/index.mjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "@antfu/eslint-config": "^6.6.1",
+    "@antfu/ni": "^28.0.0",
+    "@antfu/utils": "^9.3.0",
+    "@types/node": "^25.0.1",
+    "bumpp": "^10.3.2",
+    "electron": "^34.2.0",
+    "eslint": "^9.39.2",
+    "lint-staged": "^16.2.7",
+    "publint": "^0.3.16",
+    "simple-git-hooks": "^2.13.1",
+    "tinyexec": "^1.0.2",
+    "tsdown": "^0.17.3",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3",
+    "vite": "^7.2.7",
+    "vitest": "^4.0.15",
+    "vitest-package-exports": "^0.1.1",
+    "yaml": "^2.8.2"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "pnpm i --frozen-lockfile --ignore-scripts --offline && npx lint-staged"
+  },
+  "lint-staged": {
+    "*": "eslint --fix"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "lint": "eslint",
+    "release": "bumpp",
+    "start": "tsx src/index.ts",
+    "test": "vitest",
+    "typecheck": "tsc"
+  }
+}