vscode-find-up 0.0.1 → 0.1.1

package/README.md

@@ -15,40 +15,70 @@ npm install vscode-find-up
 ## Usage
 
 ```ts
-import { findUp, walkUp } from 'vscode-find-up'
+import { accessOk, findAny, findUp, walkUp } from 'vscode-find-up'
 
 // Find a file by walking up from cwd
 const uri = await findUp('package.json', {
   cwd: currentFileUri,
 })
 
+// Find the first match from multiple names
+const config = await findAny(
+  ['tsconfig.json', 'jsconfig.json'],
+  { cwd: currentFileUri },
+)
+
+// Check if a file exists
+const exists = await accessOk(fileUri)
+
 // Walk parent directories as a generator
 for (const dir of walkUp(startUri)) {
   // ...
 }
 ```
 
+Subpath imports are also available:
+
+```ts
+import { ok as accessOk } from 'vscode-find-up/access'
+import { up as findUp } from 'vscode-find-up/find'
+import { up as walkUp } from 'vscode-find-up/walk'
+```
+
 ## API
 
 ### `findUp(name, options?): Promise<Uri | undefined>`
 
-Find a file by name, walking parent directories until found.
+Find a file by name, walking parent directories until found. If `cwd` is not provided, searches from all workspace folders.
+
+### `findAny(names, options?): Promise<Uri | undefined>`
+
+Get the first path that matches any of the names provided. If `cwd` is not provided, searches from all workspace folders.
 
 ### `walkUp(base, options?): Generator<Uri>`
 
-Generator that yields each directory from `base` up to the root (or `last`).
+Generator that yields each directory from `base` up to the root (or `stopAt`).
+
+### `accessOk(uri, type?): Promise<boolean>`
+
+Check if a file or directory exists. Optionally check for a specific `FileType`.
 
 ### Options
 
 | Option | Type | Default | Description |
 | --- | --- | --- | --- |
-| `cwd` | `Uri` | — | The starting directory |
-| `last` | `string \| Uri` | `"/"` | Stop directory (inclusive) |
+| `cwd` | `Uri` | workspace folders | The starting directory |
+| `stopAt` | `string \| Uri` | `cwd` | Stop directory (inclusive) |
 
 ## License
 
 [MIT](./LICENSE) License &copy; 2026-PRESENT [Vida Xie](https://github.com/9romise)
 
+## Credits
+
+- [find-up](https://npmx.dev/package/find-up) - [MIT](https://github.com/sindresorhus/find-up/blob/main/license)
+- [empathic](https://npmx.dev/package/empathic) - [MIT](https://github.com/lukeed/empathic/blob/main/license)
+
 <!-- Badges -->
 
 [npm-version-src]: https://npmx.dev/api/registry/badge/version/vscode-find-up

package/dist/access.d.ts

@@ -0,0 +1,6 @@
+import { FileType, Uri } from "vscode";
+
+//#region src/access.d.ts
+declare function ok(uri: Uri, type?: FileType): Promise<boolean>;
+//#endregion
+export { ok };

package/dist/access.js

@@ -0,0 +1,13 @@
+import { workspace } from "vscode";
+//#region src/access.ts
+async function ok(uri, type) {
+	try {
+		const stat = await workspace.fs.stat(uri);
+		if (type) return stat.type === type;
+		return true;
+	} catch {
+		return false;
+	}
+}
+//#endregion
+export { ok };

package/dist/{index.d.mts → find.d.ts}

@@ -1,22 +1,6 @@
-import { FileType, Uri } from "vscode";
+import { Options } from "./walk.js";
+import { Uri } from "vscode";
 
-//#region src/access.d.ts
-declare function ok(uri: Uri, type?: FileType): Promise<boolean>;
-//#endregion
-//#region src/walk.d.ts
-interface Options {
-  /**
-   *
-   * @default workspace.getWorkspaceFolder(base)?.uri ?? Uri.file('/')
-   */
-  cwd?: Uri;
-  /**
-   * @default options.cwd
-   */
-  stopAt?: Uri | string;
-}
-declare function up$1(base: Uri, options?: Options): Generator<Uri>;
-//#endregion
 //#region src/find.d.ts
 /**
  * Find an item by name, walking parent directories until found.
@@ -33,4 +17,4 @@ declare function up(name: string, options?: Options): Promise<Uri | undefined>;
  */
 declare function any(names: string[], options?: Options): Promise<Uri | undefined>;
 //#endregion
-export { type Options, ok as accessOk, any as findAny, up as findUp, up$1 as walkUp };
+export { any, up };

package/dist/{index.mjs → find.js}

@@ -1,33 +1,6 @@
+import { ok } from "./access.js";
+import { up as up$1 } from "./walk.js";
 import { Uri, workspace } from "vscode";
-
-//#region src/access.ts
-async function ok(uri, type) {
-	try {
-		const stat = await workspace.fs.stat(uri);
-		if (type) return stat.type === type;
-		return true;
-	} catch {
-		return false;
-	}
-}
-
-//#endregion
-//#region src/walk.ts
-function* up$1(base, options = {}) {
-	const { cwd } = options;
-	const root = (cwd ? workspace.getWorkspaceFolder(cwd)?.uri : workspace.workspaceFolders?.[0].uri) ?? Uri.file("/");
-	const last = typeof options.stopAt === "string" ? Uri.joinPath(root, options.stopAt) : options.stopAt ?? root;
-	let current = base;
-	while (true) {
-		yield current;
-		if (current.path === last.path) return;
-		const parent = Uri.joinPath(current, "..");
-		if (parent.path === current.path) return;
-		current = parent;
-	}
-}
-
-//#endregion
 //#region src/find.ts
 /**
 * Find an item by name, walking parent directories until found.
@@ -63,6 +36,5 @@ async function any(names, options = {}) {
 		if (await ok(tmp)) return tmp;
 	}
 }
-
 //#endregion
-export { ok as accessOk, any as findAny, up as findUp, up$1 as walkUp };
+export { any, up };

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import { ok } from "./access.js";
+import { Options, up as up$1 } from "./walk.js";
+import { any, up } from "./find.js";
+export { type Options, ok as accessOk, any as findAny, up as findUp, up$1 as walkUp };

package/dist/index.js

@@ -0,0 +1,4 @@
+import { ok } from "./access.js";
+import { up as up$1 } from "./walk.js";
+import { any, up } from "./find.js";
+export { ok as accessOk, any as findAny, up as findUp, up$1 as walkUp };

package/dist/walk.d.ts

@@ -0,0 +1,17 @@
+import { Uri } from "vscode";
+
+//#region src/walk.d.ts
+interface Options {
+  /**
+   *
+   * @default workspace.getWorkspaceFolder(base)?.uri ?? Uri.file('/')
+   */
+  cwd?: Uri;
+  /**
+   * @default options.cwd
+   */
+  stopAt?: Uri | string;
+}
+declare function up(base: Uri, options?: Options): Generator<Uri>;
+//#endregion
+export { Options, up };

package/dist/walk.js

@@ -0,0 +1,17 @@
+import { Uri, workspace } from "vscode";
+//#region src/walk.ts
+function* up(base, options = {}) {
+	const { cwd } = options;
+	const root = (cwd ? workspace.getWorkspaceFolder(cwd)?.uri : workspace.workspaceFolders?.[0].uri) ?? Uri.file("/");
+	const last = typeof options.stopAt === "string" ? Uri.joinPath(root, options.stopAt) : options.stopAt ?? root;
+	let current = base;
+	while (true) {
+		yield current;
+		if (current.path === last.path) return;
+		const parent = Uri.joinPath(current, "..");
+		if (parent.path === current.path) return;
+		current = parent;
+	}
+}
+//#endregion
+export { up };

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "vscode-find-up",
   "type": "module",
-  "version": "0.0.1",
-  "packageManager": "pnpm@10.30.3",
+  "version": "0.1.1",
   "author": {
     "name": "Vida Xie",
     "email": "vida_2020@163.com",
@@ -19,44 +18,50 @@
   },
   "keywords": [
     "vscode",
+    "find",
+    "up",
+    "findup",
     "find-up"
   ],
   "sideEffects": false,
   "exports": {
-    ".": "./dist/index.mjs",
+    ".": "./dist/index.js",
+    "./access": "./dist/access.js",
+    "./find": "./dist/find.js",
+    "./walk": "./dist/walk.js",
     "./package.json": "./package.json"
   },
-  "types": "./dist/index.d.mts",
   "files": [
     "dist"
   ],
-  "scripts": {
-    "dev": "tsdown --watch",
-    "build": "tsdown",
-    "test": "vitest",
-    "lint": "eslint .",
-    "lint:fix": "pnpm lint --fix",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build"
-  },
   "peerDependencies": {
     "@types/vscode": "*"
   },
   "devDependencies": {
-    "@types/node": "catalog:dev",
-    "@vida0905/eslint-config": "catalog:dev",
-    "eslint": "catalog:dev",
-    "jest-mock-vscode": "catalog:dev",
-    "nano-staged": "catalog:dev",
-    "simple-git-hooks": "catalog:dev",
-    "tsdown": "catalog:dev",
-    "typescript": "catalog:dev",
-    "vitest": "catalog:dev"
+    "@arethetypeswrong/core": "^0.18.2",
+    "@types/node": "^25.3.5",
+    "@vida0905/eslint-config": "^2.10.1",
+    "eslint": "^10.0.3",
+    "jest-mock-vscode": "^4.11.0",
+    "nano-staged": "^0.9.0",
+    "publint": "^0.3.18",
+    "simple-git-hooks": "^2.13.1",
+    "tsdown": "^0.21.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
   },
   "simple-git-hooks": {
     "pre-commit": "npx nano-staged"
   },
   "nano-staged": {
     "*": "eslint --fix"
+  },
+  "scripts": {
+    "dev": "tsdown --watch",
+    "build": "tsdown",
+    "test": "vitest",
+    "lint": "eslint .",
+    "lint:fix": "pnpm lint --fix",
+    "typecheck": "tsc --noEmit"
   }
-}
+}