mac-helper 0.8.1 → 0.10.0

package/lib/app.js

@@ -1,14 +1,11 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isAppRunning = isAppRunning;
-const node_child_process_1 = require("node:child_process");
+import { exec } from 'node:child_process';
 /**
  * file path based process running detect.
  * for vscode, process name = `Code`, file is `Visual Studio Code.app`, the `Visual Studio Code` should be passed
  */
-function isAppRunning(appName) {
+export function isAppRunning(appName) {
     return new Promise((resolve, reject) => {
-        (0, node_child_process_1.exec)(`ps -ax -o command`, (err, stdout, stderr) => {
+        exec(`ps -ax -o command`, (err, stdout, stderr) => {
             if (err)
                 return reject(err);
             const lines = stdout

package/lib/chrome.d.ts

@@ -10,11 +10,11 @@ export declare class ChromiumBrowserHelper {
     appName: string;
     constructor(appName: string);
     isRunning: () => Promise<boolean>;
-    isFrontmost: () => Promise<boolean>;
-    getActiveTab: () => Promise<ActiveTab | undefined>;
+    isFrontmost: (signal?: AbortSignal) => Promise<boolean>;
+    getActiveTab: (signal?: AbortSignal) => Promise<ActiveTab | undefined>;
 }
 export declare const Chrome: ChromiumBrowserHelper;
 export declare const Brave: ChromiumBrowserHelper;
 export declare function isChromiumAppRunning(appName?: string): Promise<boolean>;
-export declare function getChromiumActiveTab(appName?: string): Promise<ActiveTab | undefined>;
-export declare function getChromiumIsFrontmost(appName?: string): Promise<boolean>;
+export declare function getChromiumActiveTab(appName?: string, signal?: AbortSignal): Promise<ActiveTab | undefined>;
+export declare function getChromiumIsFrontmost(appName?: string, signal?: AbortSignal): Promise<boolean>;

package/lib/chrome.js

@@ -1,36 +1,29 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Brave = exports.Chrome = exports.ChromiumBrowserHelper = exports.BrowserAppName = void 0;
-exports.isChromiumAppRunning = isChromiumAppRunning;
-exports.getChromiumActiveTab = getChromiumActiveTab;
-exports.getChromiumIsFrontmost = getChromiumIsFrontmost;
-const run_1 = require("@jxa/run");
-const app_1 = require("./app");
-var BrowserAppName;
+import { runJxa } from 'run-jxa';
+import { isAppRunning } from './app.js';
+export var BrowserAppName;
 (function (BrowserAppName) {
     BrowserAppName["Chrome"] = "Google Chrome";
     BrowserAppName["Brave"] = "Brave Browser";
-})(BrowserAppName || (exports.BrowserAppName = BrowserAppName = {}));
-class ChromiumBrowserHelper {
+})(BrowserAppName || (BrowserAppName = {}));
+export class ChromiumBrowserHelper {
     appName;
     constructor(appName) {
         this.appName = appName;
     }
     isRunning = () => isChromiumAppRunning(this.appName);
-    isFrontmost = () => getChromiumIsFrontmost(this.appName);
-    getActiveTab = () => getChromiumActiveTab(this.appName);
+    isFrontmost = (signal) => getChromiumIsFrontmost(this.appName, signal);
+    getActiveTab = (signal) => getChromiumActiveTab(this.appName, signal);
 }
-exports.ChromiumBrowserHelper = ChromiumBrowserHelper;
-exports.Chrome = new ChromiumBrowserHelper(BrowserAppName.Chrome);
-exports.Brave = new ChromiumBrowserHelper(BrowserAppName.Brave);
+export const Chrome = new ChromiumBrowserHelper(BrowserAppName.Chrome);
+export const Brave = new ChromiumBrowserHelper(BrowserAppName.Brave);
 /* #region implements */
-function isChromiumAppRunning(appName = BrowserAppName.Chrome) {
-    return (0, app_1.isAppRunning)(appName);
+export function isChromiumAppRunning(appName = BrowserAppName.Chrome) {
+    return isAppRunning(appName);
 }
-async function getChromiumActiveTab(appName = BrowserAppName.Chrome) {
+export async function getChromiumActiveTab(appName = BrowserAppName.Chrome, signal) {
     if (!(await isChromiumAppRunning(appName)))
         return;
-    return await (0, run_1.run)((appName) => {
+    return await runJxa((appName) => {
         const app = Application(appName);
         app.includeStandardAdditions = true;
         const win = (app.windows() || []).find((w) => !w.minimized());
@@ -39,15 +32,15 @@ async function getChromiumActiveTab(appName = BrowserAppName.Chrome) {
             url: tab?.url(),
             title: tab?.title(),
         };
-    }, appName);
+    }, [appName], { signal });
 }
-async function getChromiumIsFrontmost(appName = BrowserAppName.Chrome) {
+export async function getChromiumIsFrontmost(appName = BrowserAppName.Chrome, signal) {
     if (!isChromiumAppRunning(appName))
         return false;
-    return await (0, run_1.run)((appName) => {
+    return await runJxa((appName) => {
         const app = Application(appName);
         app.includeStandardAdditions = true;
         return app.frontmost();
-    }, appName);
+    }, [appName], { signal });
 }
 /* #endregion */

package/lib/dialog.d.ts

@@ -4,11 +4,11 @@ export declare const dialog: {
     chooseFromList: typeof chooseFromList;
     chooseMultipleFromList: typeof chooseMultipleFromList;
 };
-declare function prompt(label: string, defaultValue?: string): Promise<string>;
+declare function prompt(label: string, defaultValue?: string, signal?: AbortSignal): Promise<string>;
 type ChooseOption = {
     label: string;
     value: string;
 };
-declare function chooseFromList(list: string[] | ChooseOption[], options?: StandardAdditions.StandardAdditions.ChooseFromListOptionalParameter): Promise<string | undefined>;
-declare function chooseMultipleFromList(list: string[] | ChooseOption[], options?: StandardAdditions.StandardAdditions.ChooseFromListOptionalParameter): Promise<string[]>;
+declare function chooseFromList(list: string[] | ChooseOption[], options?: StandardAdditions.StandardAdditions.ChooseFromListOptionalParameter, signal?: AbortSignal): Promise<string | undefined>;
+declare function chooseMultipleFromList(list: string[] | ChooseOption[], options?: StandardAdditions.StandardAdditions.ChooseFromListOptionalParameter, signal?: AbortSignal): Promise<string[]>;
 export {};

package/lib/dialog.js

@@ -1,35 +1,32 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.dialog = void 0;
-const run_1 = require("@jxa/run");
-exports.dialog = {
+import { runJxa } from 'run-jxa';
+export const dialog = {
     prompt,
     chooseFromList,
     chooseMultipleFromList,
 };
-async function prompt(label, defaultValue = '') {
+async function prompt(label, defaultValue = '', signal) {
     // if cancel dialog, will throw error
     try {
-        return ((await (0, run_1.run)((label) => {
+        return ((await runJxa((label) => {
             const app = Application.currentApplication();
             app.includeStandardAdditions = true;
             const response = app.displayDialog(label, { defaultAnswer: '' });
             return response.textReturned;
-        }, label)) || defaultValue);
+        }, [label], { signal })) || defaultValue);
     }
     catch {
         return defaultValue;
     }
 }
-async function runOnCurrentApp(method, ...args) {
-    return await (0, run_1.run)((method, ...args) => {
+async function runOnCurrentApp(method, args, signal) {
+    return await runJxa((method, ...args) => {
         const app = Application.currentApplication();
         app.includeStandardAdditions = true;
         // @ts-ignore
         return app[method]?.(...args);
-    }, method, ...args);
+    }, [method, ...(args || [])], { signal });
 }
-async function chooseFromList(list, options = {}) {
+async function chooseFromList(list, options = {}, signal) {
     let usingOption = false;
     let showList = [];
     if (typeof list[0] === 'object') {
@@ -39,10 +36,7 @@ async function chooseFromList(list, options = {}) {
     else {
         showList = list;
     }
-    const selected = await runOnCurrentApp('chooseFromList', showList, {
-        multipleSelectionsAllowed: false,
-        ...options,
-    });
+    const selected = await runOnCurrentApp('chooseFromList', [showList, { multipleSelectionsAllowed: false, ...options }], signal);
     if (!selected)
         return;
     const label = selected[0];
@@ -54,7 +48,7 @@ async function chooseFromList(list, options = {}) {
         return val;
     }
 }
-async function chooseMultipleFromList(list, options = {}) {
+async function chooseMultipleFromList(list, options = {}, signal) {
     let usingOption = false;
     let showList = [];
     if (typeof list[0] === 'object') {
@@ -64,10 +58,7 @@ async function chooseMultipleFromList(list, options = {}) {
     else {
         showList = list;
     }
-    const selected = await runOnCurrentApp('chooseFromList', showList, {
-        multipleSelectionsAllowed: true,
-        ...options,
-    });
+    const selected = await runOnCurrentApp('chooseFromList', [showList, { multipleSelectionsAllowed: true, ...options }], signal);
     if (!selected)
         return [];
     if (!usingOption) {

package/lib/finder.d.ts

@@ -2,32 +2,45 @@
  * `App` named epxorts
  */
 export declare const PathFinder: {
-    allSelected(): Promise<string[]>;
-    singleSelected(): Promise<string | undefined>;
-    setSelected(filePaths: string[]): Promise<void>;
+    allSelected: typeof PathFinder_allSelected;
+    singleSelected: typeof PathFinder_singleSelected;
+    setSelected: typeof PathFinder_setSelected;
     getActiveTabDir: typeof PathFinder_getActiveTabDir;
 };
 export declare const Finder: {
-    allSelected(): Promise<string[]>;
-    singleSelected(): Promise<string | undefined>;
-    setSelected(filePaths: string[]): Promise<void>;
+    allSelected: typeof Finder_allSelected;
+    singleSelected(signal?: AbortSignal): Promise<string | undefined>;
+    setSelected: typeof Finder_setSelected;
+    showInfoWindow: typeof Finder_showInfoWindow;
 };
 export declare const QSpace: {
-    allSelected(): Promise<string[]>;
-    singleSelected(): Promise<string | undefined>;
+    allSelected: typeof QSpace_allSelected;
+    singleSelected(signal?: AbortSignal): Promise<string | undefined>;
 };
+/**
+ * impls
+ */
+declare function PathFinder_allSelected(signal?: AbortSignal): Promise<string[]>;
+declare function PathFinder_singleSelected(signal?: AbortSignal): Promise<string | undefined>;
+declare function PathFinder_setSelected(filePaths: string[], signal?: AbortSignal): Promise<void>;
 /**
  * 获取 activeTab dir, 当没有 selection 时可用,
  * 要求只能有一个 visible window, 从 jxa 这一层无法区分 window z-index
  */
-declare function PathFinder_getActiveTabDir(): Promise<string | undefined>;
+declare function PathFinder_getActiveTabDir(signal?: AbortSignal): Promise<string | undefined>;
+declare function Finder_allSelected(signal?: AbortSignal): Promise<string[]>;
+declare function Finder_setSelected(filePaths: string[], signal?: AbortSignal): Promise<void>;
+declare function Finder_showInfoWindow(filePaths: string | string[], signal?: AbortSignal): Promise<void>;
 export type QSpaceFileItem = {
     id: () => string;
     name: () => string;
     urlstr: () => string;
 };
+declare function QSpace_allSelected(signal?: AbortSignal): Promise<string[]>;
 export declare function isRepresentPF(file: string): boolean;
 export declare function isRepresentQS(file: string): boolean;
+export declare const isRepresentPFDescription = "@pf or $pf or pf, ignore case";
+export declare const isRepresentQSDescription = "@qs or $qs or qs, ignore case";
 /**
  * 处理 `@pf` `@qs`, ignore case
  */

package/lib/finder.js

@@ -1,154 +1,154 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.QSpace = exports.Finder = exports.PathFinder = void 0;
-exports.isRepresentPF = isRepresentPF;
-exports.isRepresentQS = isRepresentQS;
-exports.normalizeInputFileList = normalizeInputFileList;
-const node_os_1 = require("node:os");
-const node_path_1 = __importDefault(require("node:path"));
-const node_url_1 = require("node:url");
-const run_1 = require("@jxa/run");
-const es_toolkit_1 = require("es-toolkit");
-const promise_map_1 = __importDefault(require("promise.map"));
-const app_1 = require("./app");
+import { availableParallelism } from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import dedent from 'dedent';
+import { uniq } from 'es-toolkit';
+import pmap from 'promise.map';
+import { runAppleScript } from 'run-applescript';
+import { runJxa } from 'run-jxa';
+import { isAppRunning } from './app.js';
 /**
  * `App` named epxorts
  */
-exports.PathFinder = {
-    allSelected() {
-        return PathFinder_allSelected();
-    },
-    singleSelected() {
-        return PathFinder_singleSelected();
-    },
-    setSelected(filePaths) {
-        return PathFinder_setSelected(filePaths);
-    },
+export const PathFinder = {
+    allSelected: PathFinder_allSelected,
+    singleSelected: PathFinder_singleSelected,
+    setSelected: PathFinder_setSelected,
     getActiveTabDir: PathFinder_getActiveTabDir,
 };
-exports.Finder = {
-    allSelected() {
-        return Finder_allSelected();
-    },
-    async singleSelected() {
-        return (await Finder_allSelected())[0];
-    },
-    setSelected(filePaths) {
-        return Finder_setSelected(filePaths);
+export const Finder = {
+    allSelected: Finder_allSelected,
+    async singleSelected(signal) {
+        return (await Finder_allSelected(signal))[0];
     },
+    setSelected: Finder_setSelected,
+    showInfoWindow: Finder_showInfoWindow,
 };
-exports.QSpace = {
-    allSelected() {
-        return QSpace_allSelected();
-    },
-    async singleSelected() {
-        return (await QSpace_allSelected())[0];
+export const QSpace = {
+    allSelected: QSpace_allSelected,
+    async singleSelected(signal) {
+        return (await QSpace_allSelected(signal))[0];
     },
 };
 /**
  * impls
  */
 /* #region PathFinder */
-async function PathFinder_allSelected() {
-    if (!(await (0, app_1.isAppRunning)('Path Finder'))) {
+async function PathFinder_allSelected(signal) {
+    if (!(await isAppRunning('Path Finder'))) {
         return [];
     }
-    const filePaths = await (0, run_1.run)(() => {
+    const filePaths = await runJxa(() => {
         const app = Application('Path Finder');
         return (app.selection() || []).map((x) => x.posixPath());
-    });
+    }, undefined, { signal });
     return filePaths;
 }
-async function PathFinder_singleSelected() {
-    if (!(await (0, app_1.isAppRunning)('Path Finder'))) {
+async function PathFinder_singleSelected(signal) {
+    if (!(await isAppRunning('Path Finder'))) {
         return;
     }
-    const firstFilePath = await (0, run_1.run)(() => {
+    const firstFilePath = await runJxa(() => {
         const app = Application('Path Finder');
         return (app.selection() || [])[0]?.posixPath();
-    });
+    }, undefined, { signal });
     return firstFilePath;
 }
-async function PathFinder_setSelected(filePaths) {
-    await (0, run_1.run)((filePaths) => {
+async function PathFinder_setSelected(filePaths, signal) {
+    await runJxa((filePaths) => {
         const app = Application('Path Finder');
         app.select(filePaths);
-    }, filePaths);
+        return null;
+    }, [filePaths], { signal });
 }
 /**
  * 获取 activeTab dir, 当没有 selection 时可用,
  * 要求只能有一个 visible window, 从 jxa 这一层无法区分 window z-index
  */
-async function PathFinder_getActiveTabDir() {
-    if (!(await (0, app_1.isAppRunning)('Path Finder')))
+async function PathFinder_getActiveTabDir(signal) {
+    if (!(await isAppRunning('Path Finder')))
         return;
-    const visibleWindowCount = await (0, run_1.run)(() => {
+    const visibleWindowCount = await runJxa(() => {
         const app = Application('Path Finder');
         return app.finderWindows.whose({ visible: true }).length;
-    });
+    }, undefined, { signal });
     if (!visibleWindowCount)
         return;
     if (visibleWindowCount > 1) {
         throw new Error('Multiple visible PathFinder window not supported in PathFinder_getActiveTabDir');
     }
-    const dir = await (0, run_1.run)(() => {
+    const dir = await runJxa(() => {
         const app = Application('Path Finder');
         const w = app.finderWindows.whose({ visible: true })[0];
         return w.target.posixPath();
-    });
+    }, undefined, { signal });
     return dir;
 }
 /* #endregion */
 /* #region Finder */
-async function Finder_allSelected() {
-    const urls = await (0, run_1.run)(() => {
+async function Finder_allSelected(signal) {
+    const urls = await runJxa(() => {
         const app = Application('Finder');
         const selection = app.selection();
         return (selection || []).map((x) => x.url());
-    });
-    return urls.map((u) => (0, node_url_1.fileURLToPath)(u));
+    }, undefined, { signal });
+    return urls.map((u) => fileURLToPath(u));
 }
-async function Finder_setSelected(filePaths) {
-    await (0, run_1.run)((filePaths) => {
+async function Finder_setSelected(filePaths, signal) {
+    await runJxa((filePaths) => {
         const app = Application('Finder');
         app.select(filePaths.map((f) => Path(f)));
         app.activate();
-    }, filePaths);
+        return null;
+    }, [filePaths], { signal });
+}
+async function Finder_showInfoWindow(filePaths, signal) {
+    const inputPaths = [filePaths].flat().map((x) => path.resolve(x));
+    if (!inputPaths.length)
+        return;
+    // https://apple.stackexchange.com/questions/409243/use-the-finder-to-act-on-a-path-via-jxa
+    // no easy way to write this in JXA
+    const applescriptContent = dedent `
+    tell application "Finder"
+      ${inputPaths.map((p) => `open information window of (POSIX file "${p}" as alias)`).join('\n')}
+      activate
+    end tell
+  `;
+    await runAppleScript(applescriptContent, { signal });
 }
-async function QSpace_allSelected() {
-    if (!(await (0, app_1.isAppRunning)('QSpace Pro'))) {
+async function QSpace_allSelected(signal) {
+    if (!(await isAppRunning('QSpace Pro'))) {
         return [];
     }
-    const urls = await (0, run_1.run)(() => {
+    const urls = await runJxa(() => {
         const app = Application('QSpace Pro');
         const selection = (app.selectedItems() || []).map((x) => x.urlstr());
         return selection;
-    });
-    return urls.map((u) => (0, node_url_1.fileURLToPath)(u));
+    }, undefined, { signal });
+    return urls.map((u) => fileURLToPath(u));
 }
 /* #endregion */
 /* #region Top Level Helper */
-function isRepresentPF(file) {
+export function isRepresentPF(file) {
     return /^[@$]?pf$/i.test(file);
 }
-function isRepresentQS(file) {
+export function isRepresentQS(file) {
     return /^[@$]?qs$/i.test(file);
 }
+export const isRepresentPFDescription = '@pf or $pf or pf, ignore case';
+export const isRepresentQSDescription = '@qs or $qs or qs, ignore case';
 /**
  * 处理 `@pf` `@qs`, ignore case
  */
-async function normalizeInputFileList(fileList) {
-    return (0, es_toolkit_1.uniq)((await (0, promise_map_1.default)(fileList, async (f) => {
+export async function normalizeInputFileList(fileList) {
+    return uniq((await pmap(fileList, async (f) => {
         if (process.platform === 'darwin') {
             if (isRepresentPF(f))
-                return await exports.PathFinder.allSelected();
+                return await PathFinder.allSelected();
             if (isRepresentQS(f))
-                return await exports.QSpace.allSelected();
+                return await QSpace.allSelected();
         }
-        return node_path_1.default.resolve(f);
-    }, (0, node_os_1.availableParallelism)())).flat());
+        return path.resolve(f);
+    }, availableParallelism())).flat());
 }
 /* #endregion */

package/lib/index.d.ts

@@ -1,5 +1,5 @@
-export * from './app';
-export * from './chrome';
-export * from './dialog';
-export * from './finder';
-export * from './iterm';
+export * from './app.js';
+export * from './chrome.js';
+export * from './dialog.js';
+export * from './finder.js';
+export * from './iterm.js';

package/lib/index.js

@@ -1,23 +1,7 @@
-"use strict";
 /// <reference types='@jxa/global-type' />
 /// <reference types='@jxa/types' />
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./app"), exports);
-__exportStar(require("./chrome"), exports);
-__exportStar(require("./dialog"), exports);
-__exportStar(require("./finder"), exports);
-__exportStar(require("./iterm"), exports);
+export * from './app.js';
+export * from './chrome.js';
+export * from './dialog.js';
+export * from './finder.js';
+export * from './iterm.js';

package/lib/iterm.js

@@ -1,10 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.iTerm = void 0;
-exports.runInIterm = runInIterm;
-const run_1 = require("@jxa/run");
-async function runInIterm(command, reuse = true) {
-    const result = await (0, run_1.run)((command, reuse) => {
+import { runJxa } from 'run-jxa';
+export async function runInIterm(command, reuse = true) {
+    const result = await runJxa((command, reuse) => {
         const app = Application('iTerm');
         app.includeStandardAdditions = true;
         app.activate();
@@ -25,12 +21,13 @@ async function runInIterm(command, reuse = true) {
         if (!usingSession)
             return 'no-session';
         app.write(usingSession, { text: command });
-    }, command, reuse);
+        return null;
+    }, [command, reuse]);
     if (result === 'no-session') {
         console.error('No iTerm session found');
     }
 }
-exports.iTerm = {
+export const iTerm = {
     run: runInIterm,
     runInIterm,
 };

package/lib/system-events.js

@@ -1,22 +1,20 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const run_1 = require("@jxa/run");
+import { runJxa } from 'run-jxa';
 /**
  * 不太准确, 比如 vscode 进程 `Code` 在运行, 检测不到
  */
-async function isAppRunning(appName) {
-    return await (0, run_1.run)((appName) => {
+async function isAppRunning(appName, signal) {
+    return await runJxa((appName) => {
         const app = Application('System Events');
         app.includeStandardAdditions = true;
         const runningAppNames = app.processes().map((p) => p.name());
         return runningAppNames.includes(appName);
-    }, appName);
+    }, [appName], { signal });
 }
-async function getRunningAppNames() {
-    return await (0, run_1.run)(() => {
+async function getRunningAppNames(signal) {
+    return await runJxa(() => {
         const app = Application('System Events');
         app.includeStandardAdditions = true;
         const runningAppNames = app.processes().map((p) => p.name());
         return runningAppNames;
-    });
+    }, undefined, { signal });
 }

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "mac-helper",
-  "version": "0.8.1",
-  "packageManager": "pnpm@11.1.3+sha512.c85357fe17ca12dd23dd7071822666dfd7e3cb76fe214e3370b5ea2fb34f2a231185509b63e717f3cd0acb38dd3f8d82bcd5e8172400ae678b70ea4fbed0896d",
+  "type": "module",
+  "version": "0.10.0",
+  "packageManager": "pnpm@11.8.0+sha512.c1f5e7c4cb241c8f174b743851d82f42b802324afc8b0f116b96adb15aa06664948dde36960a3ba1079ba5b4b29dd0140135b94b5b5f5263592249d68e555f26",
   "description": "useful helper for macOS",
   "author": "magicdawn",
   "license": "MIT",
@@ -18,11 +19,14 @@
     "helper",
     "mac-helper"
   ],
+  "exports": {
+    "types": "./lib/index.d.ts",
+    "default": "./lib/index.js"
+  },
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "files": [
-    "lib/",
-    "src/"
+    "lib/"
   ],
   "publishConfig": {
     "registry": "https://registry.npmjs.org"
@@ -32,40 +36,47 @@
     "test": "vitest run --globals --testTimeout=30000",
     "test:dev": "vitest --globals --testTimeout=30000",
     "test-cover": "vitest run --globals --coverage --testTimeout=30000",
-    "dev": "tsc -w --incremental",
-    "typecheck": "tsc --noEmit",
-    "build": "rm -rf lib; rm *.tsbuildinfo; tsc",
+    "dev": "tsgo -w --incremental",
+    "typecheck": "tsgo --noEmit",
+    "build": "rm -rf lib; tsgo",
     "prepublishOnly": "pnpm test && pnpm build"
   },
   "dependencies": {
-    "@jxa/run": "^1.4.0",
-    "es-toolkit": "^1.46.1",
-    "promise.map": "^1.1.3"
+    "dedent": "^1.7.2",
+    "es-toolkit": "^1.47.1",
+    "promise.map": "^1.2.0",
+    "run-applescript": "^7.1.0",
+    "run-jxa": "^4.0.0"
   },
   "devDependencies": {
     "@jxa/global-type": "^1.4.0",
     "@jxa/sdef-to-dts": "^1.4.0",
     "@jxa/types": "^1.4.0",
-    "@magicdawn/eslint-config": "^1.6.5",
+    "@magicdawn/eslint-config": "^1.6.8",
     "@magicdawn/prettier-config": "^0.1.0",
     "@types/fs-extra": "^11.0.4",
-    "@types/node": "^25.8.0",
-    "@vitest/coverage-v8": "^4.1.6",
+    "@types/node": "^25.9.4",
+    "@typescript/native-preview": "7.0.0-dev.20260620.1",
+    "@vitest/coverage-v8": "^4.1.9",
     "delay": "^7.0.0",
-    "eslint": "^10.4.0",
+    "eslint": "^10.5.0",
     "eslint-config-prettier": "^10.1.8",
     "fs-extra": "^11.3.5",
     "husky": "^9.1.7",
     "jxa-common-used": "^0.0.3",
-    "lint-staged": "^17.0.5",
-    "prettier": "^3.8.3",
+    "lint-staged": "^17.0.7",
+    "prettier": "^3.8.4",
     "should": "^13.2.3",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.6"
+    "vitest": "^4.1.9"
   },
   "lint-staged": {
-    "*.{js,jsx,ts,tsx,less,md}": [
-      "prettier --write"
+    "*.{?(c|m)(j|t)s?(x),json,y?(a)ml}": [
+      "eslint --fix --no-warn-ignored",
+      "prettier --write --ignore-unknown"
+    ],
+    "!*.{?(c|m)(j|t)s?(x),json,y?(a)ml}": [
+      "prettier --write --ignore-unknown"
     ]
   }
 }

package/src/app.ts

@@ -1,26 +0,0 @@
-import { exec } from 'node:child_process'
-
-/**
- * file path based process running detect.
- * for vscode, process name = `Code`, file is `Visual Studio Code.app`, the `Visual Studio Code` should be passed
- */
-
-export function isAppRunning(appName: string): Promise<boolean> {
-  return new Promise((resolve, reject) => {
-    exec(`ps -ax -o command`, (err, stdout, stderr) => {
-      if (err) return reject(err)
-
-      const lines = stdout
-        .trim()
-        .split('\n')
-        .map((x) => x.trim())
-        .filter(Boolean)
-      const searchText = `${appName}.app/Contents/MacOS/`
-
-      const running = !!lines.find((line) => line.includes(searchText))
-      resolve(running)
-    })
-  })
-}
-
-// isAppRunning('Visual Studio Code').then(console.log)

package/src/chrome.ts

@@ -1,47 +0,0 @@
-import { run } from '@jxa/run'
-import { isAppRunning } from './app'
-import type { GoogleChrome } from 'jxa-common-used'
-
-export type ActiveTab = { url: string; title: string }
-
-export enum BrowserAppName {
-  Chrome = 'Google Chrome',
-  Brave = 'Brave Browser',
-}
-
-export class ChromiumBrowserHelper {
-  constructor(public appName: string) {}
-  isRunning = (): Promise<boolean> => isChromiumAppRunning(this.appName)
-  isFrontmost = (): Promise<boolean> => getChromiumIsFrontmost(this.appName)
-  getActiveTab = (): Promise<ActiveTab | undefined> => getChromiumActiveTab(this.appName)
-}
-
-export const Chrome = new ChromiumBrowserHelper(BrowserAppName.Chrome)
-export const Brave = new ChromiumBrowserHelper(BrowserAppName.Brave)
-
-/* #region implements */
-export function isChromiumAppRunning(appName: string = BrowserAppName.Chrome): Promise<boolean> {
-  return isAppRunning(appName)
-}
-export async function getChromiumActiveTab(appName: string = BrowserAppName.Chrome): Promise<ActiveTab | undefined> {
-  if (!(await isChromiumAppRunning(appName))) return
-  return await run((appName: string) => {
-    const app = Application<GoogleChrome>(appName)
-    app.includeStandardAdditions = true
-    const win = (app.windows() || []).find((w) => !w.minimized())
-    const tab = win?.activeTab()
-    return {
-      url: tab?.url(),
-      title: tab?.title(),
-    }
-  }, appName)
-}
-export async function getChromiumIsFrontmost(appName: string = BrowserAppName.Chrome): Promise<boolean> {
-  if (!isChromiumAppRunning(appName)) return false
-  return await run((appName: string) => {
-    const app = Application<GoogleChrome>(appName)
-    app.includeStandardAdditions = true
-    return app.frontmost()
-  }, appName)
-}
-/* #endregion */

package/src/dialog.ts

@@ -1,132 +0,0 @@
-import { run } from '@jxa/run'
-import type { StandardAdditions } from '@jxa/types'
-
-export const dialog = {
-  prompt,
-  chooseFromList,
-  chooseMultipleFromList,
-}
-
-async function prompt(label: string, defaultValue = ''): Promise<string> {
-  // if cancel dialog, will throw error
-  try {
-    return (
-      (await run((label) => {
-        const app = Application.currentApplication()
-        app.includeStandardAdditions = true
-        const response = app.displayDialog(label, { defaultAnswer: '' })
-        return response.textReturned
-      }, label)) || defaultValue
-    )
-  } catch {
-    return defaultValue
-  }
-}
-
-type AppMethod = 'chooseFromList'
-
-async function runOnCurrentApp(method: AppMethod, ...args: any[]) {
-  return await run(
-    (method: AppMethod, ...args: any[]) => {
-      const app = Application.currentApplication()
-      app.includeStandardAdditions = true
-      // @ts-ignore
-      return app[method]?.(...args)
-    },
-    method,
-    ...args,
-  )
-}
-
-type ChooseOption = { label: string; value: string }
-
-async function chooseFromList(
-  list: string[] | ChooseOption[],
-  options: StandardAdditions.StandardAdditions.ChooseFromListOptionalParameter = {},
-): Promise<string | undefined> {
-  let usingOption = false
-  let showList: string[] = []
-  if (typeof list[0] === 'object') {
-    usingOption = true
-    showList = (list as ChooseOption[]).map((l) => l.label)
-  } else {
-    showList = list as string[]
-  }
-
-  const selected = await runOnCurrentApp('chooseFromList', showList, {
-    multipleSelectionsAllowed: false,
-    ...options,
-  })
-
-  if (!selected) return
-  const label = (selected as any)[0]
-
-  if (!usingOption) {
-    return label
-  } else {
-    const val = (list as ChooseOption[]).find((item) => item.label === label)?.value
-    return val
-  }
-}
-
-async function chooseMultipleFromList(
-  list: string[] | ChooseOption[],
-  options: StandardAdditions.StandardAdditions.ChooseFromListOptionalParameter = {},
-): Promise<string[]> {
-  let usingOption = false
-  let showList: string[] = []
-  if (typeof list[0] === 'object') {
-    usingOption = true
-    showList = (list as ChooseOption[]).map((l) => l.label)
-  } else {
-    showList = list as string[]
-  }
-
-  const selected = await runOnCurrentApp('chooseFromList', showList, {
-    multipleSelectionsAllowed: true,
-    ...options,
-  })
-
-  if (!selected) return []
-
-  if (!usingOption) {
-    return selected as string[]
-  } else {
-    const valArr = (selected as string[]).map(
-      (label) => (list as ChooseOption[]).find((item) => item.label === label)!.value,
-    )
-    return valArr
-  }
-}
-
-// dialog.chooseFromList(['hello', 'world']).then((selected) => {
-//   console.log(selected)
-// })
-
-// dialog
-//   .chooseFromList([
-//     { value: 'yes', label: '是吧~~~' },
-//     { value: 'halo', label: 'Halo 啊洒洒' },
-//   ])
-//   .then((selected) => {
-//     console.log(selected)
-//   })
-
-// dialog
-//   .chooseMultipleFromList(
-//     [
-//       { value: 'yes', label: '是吧~~~' },
-//       { value: 'halo', label: 'Halo 啊洒洒' },
-//     ],
-//     {
-//       withTitle: 'title',
-//       withPrompt: 'prompt',
-//       cancelButtonName: '取消!',
-//       // @ts-ignore
-//       okButtonName: '酱紫吧~',
-//     }
-//   )
-//   .then((selected) => {
-//     console.log(selected)
-//   })
-// dialog.prompt('hello', 'world').then(console.log)

package/src/finder.ts

@@ -1,178 +0,0 @@
-import { availableParallelism } from 'node:os'
-import path from 'node:path'
-import { fileURLToPath } from 'node:url'
-import { run as jxaRun } from '@jxa/run'
-import { uniq } from 'es-toolkit'
-import pmap from 'promise.map'
-import { isAppRunning } from './app'
-import type { PathFinder as PathFinderType } from 'jxa-common-used'
-
-/**
- * `App` named epxorts
- */
-export const PathFinder = {
-  allSelected() {
-    return PathFinder_allSelected()
-  },
-  singleSelected() {
-    return PathFinder_singleSelected()
-  },
-  setSelected(filePaths: string[]) {
-    return PathFinder_setSelected(filePaths)
-  },
-  getActiveTabDir: PathFinder_getActiveTabDir,
-}
-export const Finder = {
-  allSelected() {
-    return Finder_allSelected()
-  },
-  async singleSelected(): Promise<string | undefined> {
-    return (await Finder_allSelected())[0]
-  },
-  setSelected(filePaths: string[]) {
-    return Finder_setSelected(filePaths)
-  },
-}
-export const QSpace = {
-  allSelected() {
-    return QSpace_allSelected()
-  },
-  async singleSelected(): Promise<string | undefined> {
-    return (await QSpace_allSelected())[0]
-  },
-}
-
-/**
- * impls
- */
-/* #region PathFinder */
-async function PathFinder_allSelected() {
-  if (!(await isAppRunning('Path Finder'))) {
-    return []
-  }
-  const filePaths: string[] = await jxaRun(() => {
-    const app = Application<PathFinderType>('Path Finder')
-    return (app.selection() || []).map((x) => x.posixPath())
-  })
-  return filePaths
-}
-
-async function PathFinder_singleSelected(): Promise<string | undefined> {
-  if (!(await isAppRunning('Path Finder'))) {
-    return
-  }
-  const firstFilePath: string | undefined = await jxaRun(() => {
-    const app = Application<PathFinderType>('Path Finder')
-    return (app.selection() || [])[0]?.posixPath()
-  })
-  return firstFilePath
-}
-
-async function PathFinder_setSelected(filePaths: string[]) {
-  await jxaRun((filePaths: string[]) => {
-    const app = Application<PathFinderType>('Path Finder')
-    app.select(filePaths)
-  }, filePaths)
-}
-
-/**
- * 获取 activeTab dir, 当没有 selection 时可用,
- * 要求只能有一个 visible window, 从 jxa 这一层无法区分 window z-index
- */
-async function PathFinder_getActiveTabDir(): Promise<string | undefined> {
-  if (!(await isAppRunning('Path Finder'))) return
-
-  const visibleWindowCount: number = await jxaRun(() => {
-    const app = Application<PathFinderType>('Path Finder')
-    return app.finderWindows.whose({ visible: true }).length
-  })
-  if (!visibleWindowCount) return
-  if (visibleWindowCount > 1) {
-    throw new Error('Multiple visible PathFinder window not supported in PathFinder_getActiveTabDir')
-  }
-
-  const dir: string = await jxaRun(() => {
-    const app = Application<PathFinderType>('Path Finder')
-    const w = app.finderWindows.whose({ visible: true })[0]
-    return w.target.posixPath()
-  })
-  return dir
-}
-/* #endregion */
-
-/* #region Finder */
-async function Finder_allSelected() {
-  const urls: string[] = await jxaRun(() => {
-    const app = Application('Finder')
-    const selection = app.selection()
-    return (selection || []).map((x) => x.url())
-  })
-  return urls.map((u) => fileURLToPath(u))
-}
-async function Finder_setSelected(filePaths: string[]) {
-  await jxaRun((filePaths: string[]) => {
-    const app = Application('Finder')
-    app.select(filePaths.map((f) => Path(f)))
-    app.activate()
-  }, filePaths)
-}
-/* #endregion */
-
-/* #region QSpace */
-// file item n [inh. item] : A file item.
-// properties
-//  - id (text, r/o) : The unique identifier of the item.
-//  - name (text, r/o) : The name of the file.
-//  - urlstr (text, r/o) : The absolute string of URL of the file.
-export type QSpaceFileItem = {
-  // the unique identifier of the item
-  id: () => string
-  // the name of the file
-  name: () => string
-  // the absolute string of URL of the file
-  urlstr: () => string
-}
-
-async function QSpace_allSelected() {
-  if (!(await isAppRunning('QSpace Pro'))) {
-    return []
-  }
-  const urls: string[] = await jxaRun(() => {
-    const app = Application('QSpace Pro')
-    const selection = (app.selectedItems() || []).map((x: QSpaceFileItem) => x.urlstr())
-    return selection
-  })
-  return urls.map((u) => fileURLToPath(u))
-}
-/* #endregion */
-
-/* #region Top Level Helper */
-export function isRepresentPF(file: string) {
-  return /^[@$]?pf$/i.test(file)
-}
-
-export function isRepresentQS(file: string) {
-  return /^[@$]?qs$/i.test(file)
-}
-
-/**
- * 处理 `@pf` `@qs`, ignore case
- */
-export async function normalizeInputFileList(fileList: string[]) {
-  return uniq(
-    (
-      await pmap(
-        fileList,
-        async (f) => {
-          if (process.platform === 'darwin') {
-            if (isRepresentPF(f)) return await PathFinder.allSelected()
-            if (isRepresentQS(f)) return await QSpace.allSelected()
-          }
-          return path.resolve(f)
-        },
-        availableParallelism(),
-      )
-    ).flat(),
-  )
-}
-/* #endregion */

package/src/index.ts

@@ -1,8 +0,0 @@
-/// <reference types='@jxa/global-type' />
-/// <reference types='@jxa/types' />
-
-export * from './app'
-export * from './chrome'
-export * from './dialog'
-export * from './finder'
-export * from './iterm'

package/src/iterm.ts

@@ -1,44 +0,0 @@
-import { run } from '@jxa/run'
-import type { iTerm2 } from 'jxa-common-used'
-
-export async function runInIterm(command: string, reuse = true) {
-  type RunResult = 'no-session' | undefined
-  const result: RunResult = await run(
-    (command, reuse): RunResult => {
-      const app = Application<iTerm2>('iTerm')
-      app.includeStandardAdditions = true
-      app.activate()
-
-      let usingSession: iTerm2.Session | undefined
-
-      // reuse when possible
-      if (reuse) {
-        const session: iTerm2.Session | undefined = app.currentWindow()?.currentSession()
-        const isIdle = session?.isAtShellPrompt()
-        if (isIdle) {
-          usingSession = session
-        }
-      }
-
-      // create new tab when necessary
-      if (!usingSession) {
-        const tab = app.createTabWithDefaultProfile(app.currentWindow)
-        usingSession = tab?.currentSession() // TODO: iterm2 updated, this code no longer works
-      }
-
-      if (!usingSession) return 'no-session'
-      app.write(usingSession, { text: command })
-    },
-    command,
-    reuse,
-  )
-
-  if (result === 'no-session') {
-    console.error('No iTerm session found')
-  }
-}
-
-export const iTerm = {
-  run: runInIterm,
-  runInIterm,
-}

package/src/system-events.ts

@@ -1,24 +0,0 @@
-import { run } from '@jxa/run'
-import type { SystemEvents } from '@jxa/types'
-
-/**
- * 不太准确, 比如 vscode 进程 `Code` 在运行, 检测不到
- */
-
-async function isAppRunning(appName: string): Promise<boolean> {
-  return await run((appName) => {
-    const app = Application<SystemEvents.SystemEvents.Application>('System Events')
-    app.includeStandardAdditions = true
-    const runningAppNames: string[] = app.processes().map((p: SystemEvents.SystemEvents.Process) => p.name())
-    return runningAppNames.includes(appName)
-  }, appName)
-}
-
-async function getRunningAppNames(): Promise<string[]> {
-  return await run(() => {
-    const app = Application<SystemEvents.SystemEvents.Application>('System Events')
-    app.includeStandardAdditions = true
-    const runningAppNames: string[] = app.processes().map((p: SystemEvents.SystemEvents.Process) => p.name())
-    return runningAppNames
-  })
-}