vscode-find-up 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 vida xie
+
+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,59 @@
+# vscode-find-up
+
+[![npm version][npm-version-src]][npm-version-href]
+[![npm bundle size][npm-bundle-size-src]][npm-bundle-size-href]
+[![License][license-src]][license-href]
+
+Zero-dependency [find-up](https://github.com/sindresorhus/find-up) for VS Code extension environment. Uses `vscode.workspace.fs` API to support all [file system providers](https://code.visualstudio.com/api/references/vscode-api#FileSystemProvider) (local, remote, virtual, etc.).
+
+## Install
+
+```bash
+npm install vscode-find-up
+```
+
+## Usage
+
+```ts
+import { findUp, walkUp } from 'vscode-find-up'
+
+// Find a file by walking up from cwd
+const uri = await findUp('package.json', {
+  cwd: currentFileUri,
+})
+
+// Walk parent directories as a generator
+for (const dir of walkUp(startUri)) {
+  // ...
+}
+```
+
+## API
+
+### `findUp(name, options?): Promise<Uri | undefined>`
+
+Find a file by name, walking parent directories until found.
+
+### `walkUp(base, options?): Generator<Uri>`
+
+Generator that yields each directory from `base` up to the root (or `last`).
+
+### Options
+
+| Option | Type | Default | Description |
+| --- | --- | --- | --- |
+| `cwd` | `Uri` | — | The starting directory |
+| `last` | `string \| Uri` | `"/"` | Stop directory (inclusive) |
+
+## License
+
+[MIT](./LICENSE) License &copy; 2026-PRESENT [Vida Xie](https://github.com/9romise)
+
+<!-- Badges -->
+
+[npm-version-src]: https://npmx.dev/api/registry/badge/version/vscode-find-up
+[npm-version-href]: https://npmx.dev/package/vscode-find-up
+[npm-bundle-size-src]: https://npmx.dev/api/registry/badge/size/vscode-find-up
+[npm-bundle-size-href]: https://npmx.dev/package/vscode-find-up
+[license-src]: https://npmx.dev/api/registry/badge/license/vscode-find-up
+[license-href]: https://opensource.org/licenses/MIT

package/dist/index.d.mts

@@ -0,0 +1,36 @@
+import { FileType, 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.
+ *
+ * @param name The item name to find.
+ * @returns The {@link Uri} of the item, if found.
+ */
+declare function up(name: string, options?: Options): Promise<Uri | undefined>;
+/**
+ * Get the first path that matches any of the names provided.
+ *
+ * @param names The item names to find.
+ * @returns The {@link Uri} of the first item found, if any.
+ */
+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 };

package/dist/index.mjs

@@ -0,0 +1,68 @@
+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.
+*
+* @param name The item name to find.
+* @returns The {@link Uri} of the item, if found.
+*/
+async function up(name, options = {}) {
+	const { cwd } = options;
+	const folders = cwd ? [cwd] : workspace.workspaceFolders?.map(({ uri }) => uri);
+	if (!folders) return;
+	let folder, dir, tmp;
+	for (folder of folders) for (dir of up$1(folder, options)) {
+		tmp = Uri.joinPath(dir, name);
+		if (await ok(tmp)) return tmp;
+	}
+}
+/**
+* Get the first path that matches any of the names provided.
+*
+* @param names The item names to find.
+* @returns The {@link Uri} of the first item found, if any.
+*/
+async function any(names, options = {}) {
+	const { cwd } = options;
+	const folders = cwd ? [cwd] : workspace.workspaceFolders?.map(({ uri }) => uri);
+	if (!folders) return;
+	let folder, dir, tmp;
+	let j = 0;
+	const len = names.length;
+	for (folder of folders) for (dir of up$1(folder, options)) for (j = 0; j < len; j++) {
+		tmp = Uri.joinPath(dir, names[j]);
+		if (await ok(tmp)) return tmp;
+	}
+}
+
+//#endregion
+export { ok as accessOk, any as findAny, up as findUp, up$1 as walkUp };

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "vscode-find-up",
+  "type": "module",
+  "version": "0.0.1",
+  "packageManager": "pnpm@10.30.3",
+  "author": {
+    "name": "Vida Xie",
+    "email": "vida_2020@163.com",
+    "url": "https://github.com/9romise"
+  },
+  "license": "MIT",
+  "homepage": "https://github.com/9romise/vscode-find-up#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/9romise/vscode-find-up.git"
+  },
+  "bugs": {
+    "url": "https://github.com/9romise/vscode-find-up/issues"
+  },
+  "keywords": [
+    "vscode",
+    "find-up"
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./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"
+  },
+  "simple-git-hooks": {
+    "pre-commit": "npx nano-staged"
+  },
+  "nano-staged": {
+    "*": "eslint --fix"
+  }
+}