mac-helper 0.1.2 → 0.1.4

package/README.md

@@ -2,8 +2,9 @@
 
 > useful helper for macOS
 
-[![Build Status](https://img.shields.io/github/actions/workflow/status/magicdawn/mac-helper/ci.yml?style=flat-square&branch=main)](https://github.com/magicdawn/mac-helper/actions/workflows/ci.yml)
-[![Coverage Status](https://img.shields.io/codecov/c/github/magicdawn/mac-helper.svg?style=flat-square)](https://codecov.io/gh/magicdawn/mac-helper)
+<!-- [![Build Status](https://img.shields.io/github/actions/workflow/status/magicdawn/mac-helper/ci.yml?style=flat-square&branch=main)](https://github.com/magicdawn/mac-helper/actions/workflows/ci.yml)
+[![Coverage Status](https://img.shields.io/codecov/c/github/magicdawn/mac-helper.svg?style=flat-square)](https://codecov.io/gh/magicdawn/mac-helper) -->
+
 [![npm version](https://img.shields.io/npm/v/mac-helper.svg?style=flat-square)](https://www.npmjs.com/package/mac-helper)
 [![npm downloads](https://img.shields.io/npm/dm/mac-helper.svg?style=flat-square)](https://www.npmjs.com/package/mac-helper)
 [![npm license](https://img.shields.io/npm/l/mac-helper.svg?style=flat-square)](http://magicdawn.mit-license.org)
@@ -16,8 +17,8 @@ $ pnpm add mac-helper
 
 ## API
 
-```js
-const MacHelper = require('mac-helper')
+```ts
+import * as MacHelper from 'mac-helper'
 ```
 
 ## Changelog

package/lib/app.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 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 declare function isAppRunning(appName: string): Promise<boolean>;

package/lib/app.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAppRunning = void 0;
+const child_process_1 = require("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
+ */
+async function isAppRunning(appName) {
+    return new Promise((resolve, reject) => {
+        (0, child_process_1.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);
+        });
+    });
+}
+exports.isAppRunning = isAppRunning;
+// isAppRunning('Visual Studio Code').then(console.log)

package/lib/finder.d.ts

@@ -1,5 +1,6 @@
-export declare function getPathFinderSelected(): Promise<string[]>;
-export declare function getFinderSelected(): Promise<string[]>;
+/**
+ * `App` named epxorts
+ */
 export declare const PathFinder: {
     allSelected(): Promise<string[]>;
     singleSelected(): Promise<string | undefined>;
@@ -8,3 +9,18 @@ export declare const Finder: {
     allSelected(): Promise<string[]>;
     singleSelected(): Promise<string | undefined>;
 };
+export declare const QSpace: {
+    allSelected(): Promise<string[]>;
+    singleSelected(): Promise<string | undefined>;
+};
+/**
+ * impls
+ */
+export declare function getPathFinderSelected(): Promise<string[]>;
+export declare function getFinderSelected(): Promise<string[]>;
+export type QSpaceFileItem = {
+    id: () => string;
+    name: () => string;
+    urlstr: () => string;
+};
+export declare function getQSpaceSelected(): Promise<string[]>;

package/lib/finder.js

@@ -1,8 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Finder = exports.PathFinder = exports.getFinderSelected = exports.getPathFinderSelected = void 0;
+exports.getQSpaceSelected = exports.getFinderSelected = exports.getPathFinderSelected = exports.QSpace = exports.Finder = exports.PathFinder = void 0;
 const run_1 = require("@jxa/run");
 const url_1 = require("url");
+/**
+ * `App` named epxorts
+ */
+exports.PathFinder = {
+    async allSelected() {
+        return getPathFinderSelected();
+    },
+    async singleSelected() {
+        return (await getPathFinderSelected())[0];
+    },
+};
+exports.Finder = {
+    async allSelected() {
+        return getFinderSelected();
+    },
+    async singleSelected() {
+        return (await getFinderSelected())[0];
+    },
+};
+exports.QSpace = {
+    async allSelected() {
+        return getQSpaceSelected();
+    },
+    async singleSelected() {
+        return (await getQSpaceSelected())[0];
+    },
+};
+/**
+ * impls
+ */
 async function getPathFinderSelected() {
     const filePaths = await (0, run_1.run)(() => {
         const app = Application('Path Finder');
@@ -20,22 +50,15 @@ async function getFinderSelected() {
     return urls.map((u) => (0, url_1.fileURLToPath)(u));
 }
 exports.getFinderSelected = getFinderSelected;
-exports.PathFinder = {
-    async allSelected() {
-        return getPathFinderSelected();
-    },
-    async singleSelected() {
-        return (await getPathFinderSelected())[0];
-    },
-};
-exports.Finder = {
-    async allSelected() {
-        return getFinderSelected();
-    },
-    async singleSelected() {
-        return (await getFinderSelected())[0];
-    },
-};
+async function getQSpaceSelected() {
+    const urls = await (0, run_1.run)(() => {
+        const app = Application('QSpace Pro');
+        const selection = (app.selectedItems() || []).map((x) => x.urlstr());
+        return selection;
+    });
+    return urls.map((u) => (0, url_1.fileURLToPath)(u));
+}
+exports.getQSpaceSelected = getQSpaceSelected;
 // ;(async () => {
-//   console.log(await PathFinder.allSelected())
+//   console.log(await getQSpaceSelected())
 // })()

package/lib/index.d.ts

@@ -1,3 +1,4 @@
+export * from './app';
 export * from './chrome';
 export * from './dialog';
 export * from './finder';

package/lib/index.js

@@ -16,6 +16,7 @@ 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);

package/lib/system-events.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/system-events.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mac-helper",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "useful helper for macOS",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -39,27 +39,26 @@
     "@jxa/global-type": "^1.3.6",
     "@jxa/sdef-to-dts": "^1.3.6",
     "@jxa/types": "^1.3.6",
-    "@magicdawn/prettier-config": "^0.0.2",
-    "@swc/core": "1.3.78",
-    "@types/fs-extra": "^11.0.2",
-    "@types/mocha": "^10.0.1",
-    "@types/node": "^20.6.2",
-    "@typescript-eslint/eslint-plugin": "^6.7.0",
-    "@typescript-eslint/parser": "^6.7.0",
-    "@vitest/coverage-v8": "^0.34.4",
-    "delay": "^5.0.0",
-    "eslint": "^8.49.0",
-    "eslint-config-prettier": "^9.0.0",
-    "fs-extra": "^11.1.1",
-    "husky": "^8.0.3",
+    "@magicdawn/prettier-config": "^0.0.3",
+    "@swc/core": "1.5.7",
+    "@types/fs-extra": "^11.0.4",
+    "@types/mocha": "^10.0.6",
+    "@types/node": "^20.12.12",
+    "@typescript-eslint/eslint-plugin": "^7.10.0",
+    "@typescript-eslint/parser": "^7.10.0",
+    "@vitest/coverage-v8": "^1.6.0",
+    "delay": "^6.0.0",
+    "eslint": "^9.3.0",
+    "eslint-config-prettier": "^9.1.0",
+    "fs-extra": "^11.2.0",
+    "husky": "^9.0.11",
     "jxa-common-used": "^0.0.3",
-    "lint-staged": "^14.0.1",
-    "prettier": "^3.0.3",
+    "lint-staged": "^15.2.4",
+    "prettier": "^3.2.5",
     "should": "^13.2.3",
-    "typescript": "^5.2.2",
-    "vitest": "^0.34.4"
+    "typescript": "^5.4.5",
+    "vitest": "^1.6.0"
   },
-  "packageManager": "pnpm@8.7.5",
   "publishConfig": {
     "registry": "https://registry.npmjs.org"
   },
@@ -67,5 +66,6 @@
     "*.{js,jsx,ts,tsx,less,md}": [
       "prettier --write"
     ]
-  }
+  },
+  "packageManager": "pnpm@9.1.2+sha512.127dc83b9ea10c32be65d22a8efb4a65fb952e8fefbdfded39bdc3c97efc32d31b48b00420df2c1187ace28c921c902f0cb5a134a4d032b8b5295cbfa2c681e2"
 }

package/src/app.ts

@@ -0,0 +1,26 @@
+import { exec } from '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 async 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/finder.ts

@@ -2,6 +2,38 @@ import { run as jxaRun } from '@jxa/run'
 import { type PathFinder as PathFinderType } from 'jxa-common-used'
 import { fileURLToPath } from 'url'
 
+/**
+ * `App` named epxorts
+ */
+export const PathFinder = {
+  async allSelected() {
+    return getPathFinderSelected()
+  },
+  async singleSelected(): Promise<string | undefined> {
+    return (await getPathFinderSelected())[0]
+  },
+}
+export const Finder = {
+  async allSelected() {
+    return getFinderSelected()
+  },
+  async singleSelected(): Promise<string | undefined> {
+    return (await getFinderSelected())[0]
+  },
+}
+export const QSpace = {
+  async allSelected() {
+    return getQSpaceSelected()
+  },
+  async singleSelected(): Promise<string | undefined> {
+    return (await getQSpaceSelected())[0]
+  },
+}
+
+/**
+ * impls
+ */
+
 export async function getPathFinderSelected() {
   const filePaths: string[] = await jxaRun(() => {
     const app = Application<PathFinderType>('Path Finder')
@@ -19,24 +51,29 @@ export async function getFinderSelected() {
   return urls.map((u) => fileURLToPath(u))
 }
 
-export const PathFinder = {
-  async allSelected() {
-    return getPathFinderSelected()
-  },
-  async singleSelected(): Promise<string | undefined> {
-    return (await getPathFinderSelected())[0]
-  },
+// 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
 }
 
-export const Finder = {
-  async allSelected() {
-    return getFinderSelected()
-  },
-  async singleSelected(): Promise<string | undefined> {
-    return (await getFinderSelected())[0]
-  },
+export async function getQSpaceSelected() {
+  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))
 }
 
 // ;(async () => {
-//   console.log(await PathFinder.allSelected())
+//   console.log(await getQSpaceSelected())
 // })()

package/src/index.ts

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

package/src/system-events.ts

@@ -0,0 +1,28 @@
+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
+  })
+}