bingo-systems 0.5.4 → 0.6.0

package/README.md

@@ -3,9 +3,9 @@
 <p align="center">File, network, and shell wrapper APIs used by <a href="https://create.bingo">Bingo</a>. 🧰</p>
 
 <p align="center">
-	<a href="https://github.com/JoshuaKGoldberg/bingo/blob/main/.github/CODE_OF_CONDUCT.md" target="_blank"><img alt="🤝 Code of Conduct: Kept" src="https://img.shields.io/badge/%F0%9F%A4%9D_code_of_conduct-kept-21bb42" /></a>
-	<a href="https://codecov.io/gh/JoshuaKGoldberg/bingo" target="_blank"><img alt="🧪 Coverage" src="https://img.shields.io/codecov/c/github/JoshuaKGoldberg/bingo?label=%F0%9F%A7%AA%20coverage" /></a>
-	<a href="https://github.com/JoshuaKGoldberg/bingo/blob/main/LICENSE.md" target="_blank"><img alt="📝 License: MIT" src="https://img.shields.io/badge/%F0%9F%93%9D_license-MIT-21bb42.svg"></a>
+	<a href="https://github.com/bingo-js/bingo/blob/main/.github/CODE_OF_CONDUCT.md" target="_blank"><img alt="🤝 Code of Conduct: Kept" src="https://img.shields.io/badge/%F0%9F%A4%9D_code_of_conduct-kept-21bb42" /></a>
+	<a href="https://codecov.io/gh/bingo-js/bingo" target="_blank"><img alt="🧪 Coverage" src="https://img.shields.io/codecov/c/github/bingo-js/bingo?label=%F0%9F%A7%AA%20coverage" /></a>
+	<a href="https://github.com/bingo-js/bingo/blob/main/LICENSE.md" target="_blank"><img alt="📝 License: MIT" src="https://img.shields.io/badge/%F0%9F%93%9D_license-MIT-21bb42.svg"></a>
 	<a href="http://npmjs.com/package/bingo-testers"><img alt="📦 npm version" src="https://img.shields.io/npm/v/bingo-testers?color=21bb42&label=%F0%9F%93%A6%20npm" /></a>
 	<img alt="💪 TypeScript: Strict" src="https://img.shields.io/badge/%F0%9F%92%AA_typescript-strict-21bb42.svg" />
 </p>

package/lib/fetchers/createSystemFetchers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createSystemFetchers.d.ts","sourceRoot":"","sources":["../../src/fetchers/createSystemFetchers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,sBAAsB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACrB;AAED,wBAAgB,oBAAoB,CAAC,EACpC,IAAI,EACJ,KAAwB,GACxB,EAAE,sBAAsB,GAAG,cAAc,CAQzC"}
+{"version":3,"file":"createSystemFetchers.d.ts","sourceRoot":"","sources":["../../src/fetchers/createSystemFetchers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,MAAM,WAAW,sBAAsB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACrB;AAED,wBAAgB,oBAAoB,CAAC,EACpC,IAAI,EACJ,KAAwB,GACxB,EAAE,sBAAsB,GAAG,cAAc,CAUzC"}

package/lib/fetchers/createSystemFetchers.js

@@ -2,10 +2,12 @@ import { Octokit } from "octokit";
 export function createSystemFetchers({ auth, fetch = globalThis.fetch, }) {
     return {
         fetch,
-        octokit: new Octokit({
-            auth,
-            request: { fetch },
-        }),
+        octokit: auth
+            ? new Octokit({
+                auth,
+                request: { fetch },
+            })
+            : undefined,
     };
 }
 //# sourceMappingURL=createSystemFetchers.js.map

package/lib/fetchers/createSystemFetchers.js.map

@@ -1 +1 @@
-{"version":3,"file":"createSystemFetchers.js","sourceRoot":"","sources":["../../src/fetchers/createSystemFetchers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AASlC,MAAM,UAAU,oBAAoB,CAAC,EACpC,IAAI,EACJ,KAAK,GAAG,UAAU,CAAC,KAAK,GACA;IACxB,OAAO;QACN,KAAK;QACL,OAAO,EAAE,IAAI,OAAO,CAAC;YACpB,IAAI;YACJ,OAAO,EAAE,EAAE,KAAK,EAAE;SAClB,CAAC;KACF,CAAC;AACH,CAAC"}
+{"version":3,"file":"createSystemFetchers.js","sourceRoot":"","sources":["../../src/fetchers/createSystemFetchers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AASlC,MAAM,UAAU,oBAAoB,CAAC,EACpC,IAAI,EACJ,KAAK,GAAG,UAAU,CAAC,KAAK,GACA;IACxB,OAAO;QACN,KAAK;QACL,OAAO,EAAE,IAAI;YACZ,CAAC,CAAC,IAAI,OAAO,CAAC;gBACZ,IAAI;gBACJ,OAAO,EAAE,EAAE,KAAK,EAAE;aAClB,CAAC;YACH,CAAC,CAAC,SAAS;KACZ,CAAC;AACH,CAAC"}

package/lib/fetchers/createSystemFetchers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=createSystemFetchers.test.d.ts.map

package/lib/fetchers/createSystemFetchers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSystemFetchers.test.d.ts","sourceRoot":"","sources":["../../src/fetchers/createSystemFetchers.test.ts"],"names":[],"mappings":""}

package/lib/fetchers/createSystemFetchers.test.js

@@ -0,0 +1,34 @@
+import { Octokit } from "octokit";
+import { describe, expect, it, vi } from "vitest";
+import { createSystemFetchers } from "./createSystemFetchers.js";
+describe("createSystemFetchers", () => {
+    it("returns an object with only fetch when no auth is provided", () => {
+        const fetchers = createSystemFetchers({});
+        expect(fetchers).toEqual({
+            fetch: globalThis.fetch,
+            octokit: undefined,
+        });
+    });
+    it("returns an object with fetch and octokit when auth is provided", () => {
+        const fetchers = createSystemFetchers({ auth: "abc123" });
+        expect(fetchers).toEqual({
+            fetch: globalThis.fetch,
+            octokit: expect.any(Octokit),
+        });
+    });
+    it("returns an object with the custom fetch when fetch is provided", () => {
+        const fetch = vi.fn();
+        const fetchers = createSystemFetchers({ fetch });
+        expect(fetchers).toEqual({ fetch });
+    });
+    it("returns an object with the custom fetch and octokit when auth and fetch are provided", () => {
+        const auth = "abc123";
+        const fetch = vi.fn();
+        const fetchers = createSystemFetchers({ auth, fetch });
+        expect(fetchers).toEqual({
+            fetch,
+            octokit: expect.any(Octokit),
+        });
+    });
+});
+//# sourceMappingURL=createSystemFetchers.test.js.map

package/lib/fetchers/createSystemFetchers.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSystemFetchers.test.js","sourceRoot":"","sources":["../../src/fetchers/createSystemFetchers.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,4DAA4D,EAAE,GAAG,EAAE;QACrE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;QAE1C,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACxB,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,OAAO,EAAE,SAAS;SAClB,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACzE,MAAM,QAAQ,GAAG,oBAAoB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAE1D,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACxB,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;SAC5B,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACzE,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAEjD,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sFAAsF,EAAE,GAAG,EAAE;QAC/F,MAAM,IAAI,GAAG,QAAQ,CAAC;QACtB,MAAM,KAAK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QACtB,MAAM,QAAQ,GAAG,oBAAoB,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAEvD,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;YACxB,KAAK;YACL,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;SAC5B,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/lib/fetchers/types.d.ts

@@ -9,9 +9,9 @@ export interface SystemFetchers {
      */
     fetch: typeof fetch;
     /**
-     * Octokit.js instance wrapping the same `fetch` function.
+     * Octokit.js instance wrapping the same `fetch` function, if authenticated.
      * @see {@link https://octokit.github.io/rest.js}
      */
-    octokit: Octokit;
+    octokit: Octokit | undefined;
 }
 //# sourceMappingURL=types.d.ts.map

package/lib/fetchers/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/fetchers/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B;;;OAGG;IACH,KAAK,EAAE,OAAO,KAAK,CAAC;IAEpB;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/fetchers/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B;;;OAGG;IACH,KAAK,EAAE,OAAO,KAAK,CAAC;IAEpB;;;OAGG;IACH,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B"}

package/lib/files/createReadingFileSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createReadingFileSystem.d.ts","sourceRoot":"","sources":["../../src/files/createReadingFileSystem.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,uBAAuB,IAAI,iBAAiB,CAM3D"}
+{"version":3,"file":"createReadingFileSystem.d.ts","sourceRoot":"","sources":["../../src/files/createReadingFileSystem.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,uBAAuB,IAAI,iBAAiB,CAQ3D"}

package/lib/files/createReadingFileSystem.js

@@ -1,8 +1,16 @@
 import * as fs from "node:fs/promises";
 export function createReadingFileSystem() {
     return {
+        glob: async (patterns) => await collect(fs.glob(patterns)),
         readDirectory: async (filePath) => await fs.readdir(filePath),
         readFile: async (filePath) => (await fs.readFile(filePath)).toString(),
     };
 }
+async function collect(matches) {
+    const collected = [];
+    for await (const match of matches) {
+        collected.push(match);
+    }
+    return collected;
+}
 //# sourceMappingURL=createReadingFileSystem.js.map

package/lib/files/createReadingFileSystem.js.map

@@ -1 +1 @@
-{"version":3,"file":"createReadingFileSystem.js","sourceRoot":"","sources":["../../src/files/createReadingFileSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAIvC,MAAM,UAAU,uBAAuB;IACtC,OAAO;QACN,aAAa,EAAE,KAAK,EAAE,QAAgB,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;QACrE,QAAQ,EAAE,KAAK,EAAE,QAAgB,EAAE,EAAE,CACpC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;KACzC,CAAC;AACH,CAAC"}
+{"version":3,"file":"createReadingFileSystem.js","sourceRoot":"","sources":["../../src/files/createReadingFileSystem.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAIvC,MAAM,UAAU,uBAAuB;IACtC,OAAO;QACN,IAAI,EAAE,KAAK,EAAE,QAA2B,EAAE,EAAE,CAC3C,MAAM,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,aAAa,EAAE,KAAK,EAAE,QAAgB,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;QACrE,QAAQ,EAAE,KAAK,EAAE,QAAgB,EAAE,EAAE,CACpC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;KACzC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,OAA8B;IACpD,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QACnC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/lib/files/createReadingFileSystem.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=createReadingFileSystem.test.d.ts.map

package/lib/files/createReadingFileSystem.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createReadingFileSystem.test.d.ts","sourceRoot":"","sources":["../../src/files/createReadingFileSystem.test.ts"],"names":[],"mappings":""}

package/lib/files/createReadingFileSystem.test.js

@@ -0,0 +1,58 @@
+import { Readable } from "node:stream";
+import { describe, expect, it, vi } from "vitest";
+import { createReadingFileSystem } from "./createReadingFileSystem.js";
+const mockGlob = vi.fn();
+const mockReaddir = vi.fn();
+const mockReadFile = vi.fn();
+vi.mock("node:fs/promises", () => ({
+    get glob() {
+        return mockGlob;
+    },
+    get readdir() {
+        return mockReaddir;
+    },
+    get readFile() {
+        return mockReadFile;
+    },
+}));
+describe("createReadingFileSystem", () => {
+    describe("glob", () => {
+        it("resolves with the matched paths when given one pattern", async () => {
+            const matches = [".github/workflows/ci.yml"];
+            mockGlob.mockReturnValueOnce(Readable.from(matches));
+            const system = createReadingFileSystem();
+            const actual = await system.glob(".github/**/*.yml");
+            expect(actual).toEqual(matches);
+            expect(mockGlob).toHaveBeenCalledWith(".github/**/*.yml");
+        });
+        it("resolves with the matched paths when given multiple patterns", async () => {
+            const patterns = [".github/**/*.yml", "src/**/*.ts"];
+            const matches = [".github/workflows/ci.yml", "src/index.ts"];
+            mockGlob.mockReturnValueOnce(Readable.from(matches));
+            const system = createReadingFileSystem();
+            const actual = await system.glob(patterns);
+            expect(actual).toEqual(matches);
+            expect(mockGlob).toHaveBeenCalledWith(patterns);
+        });
+    });
+    describe("readDirectory", () => {
+        it("resolves with the directory's children", async () => {
+            const children = ["index.ts"];
+            mockReaddir.mockResolvedValueOnce(children);
+            const system = createReadingFileSystem();
+            const actual = await system.readDirectory("src");
+            expect(actual).toBe(children);
+            expect(mockReaddir).toHaveBeenCalledWith("src");
+        });
+    });
+    describe("readFile", () => {
+        it("resolves with the file's contents as text", async () => {
+            mockReadFile.mockResolvedValueOnce(Buffer.from("abc123"));
+            const system = createReadingFileSystem();
+            const actual = await system.readFile("src/index.ts");
+            expect(actual).toBe("abc123");
+            expect(mockReadFile).toHaveBeenCalledWith("src/index.ts");
+        });
+    });
+});
+//# sourceMappingURL=createReadingFileSystem.test.js.map

package/lib/files/createReadingFileSystem.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createReadingFileSystem.test.js","sourceRoot":"","sources":["../../src/files/createReadingFileSystem.test.ts"],"names":[],"mappings":"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"}

package/lib/files/createWritingFileSystem.d.ts

@@ -2,6 +2,7 @@ import { CreatedFileMetadata } from "bingo-fs";
 export declare function createWritingFileSystem(): {
     writeDirectory: (directoryPath: string) => Promise<undefined>;
     writeFile: (filePath: string, contents: string, options?: CreatedFileMetadata) => Promise<void>;
+    glob: import("./types.js").Glob;
     readDirectory: import("./types.js").ReadDirectory;
     readFile: import("./types.js").ReadFile;
 };

package/lib/files/createWritingFileSystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createWritingFileSystem.d.ts","sourceRoot":"","sources":["../../src/files/createWritingFileSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAK/C,wBAAgB,uBAAuB;oCAGC,MAAM;0BAGjC,MAAM,YACN,MAAM,YACN,mBAAmB;;;EAoB/B"}
+{"version":3,"file":"createWritingFileSystem.d.ts","sourceRoot":"","sources":["../../src/files/createWritingFileSystem.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAK/C,wBAAgB,uBAAuB;oCAGC,MAAM;0BAGjC,MAAM,YACN,MAAM,YACN,mBAAmB;;;;EAoB/B"}

package/lib/files/createWritingFileSystem.js

@@ -8,7 +8,7 @@ export function createWritingFileSystem() {
             try {
                 // If the file had custom permissions written, it might support
                 // being deleted but not being written to.
-                // https://github.com/JoshuaKGoldberg/bingo/issues/238
+                // https://github.com/bingo-js/bingo/issues/238
                 await fs.rm(filePath);
             }
             catch {

package/lib/files/createWritingFileSystem.js.map

@@ -1 +1 @@
-{"version":3,"file":"createWritingFileSystem.js","sourceRoot":"","sources":["../../src/files/createWritingFileSystem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,MAAM,UAAU,uBAAuB;IACtC,OAAO;QACN,GAAG,uBAAuB,EAAE;QAC5B,cAAc,EAAE,KAAK,EAAE,aAAqB,EAAE,EAAE,CAC/C,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,SAAS,EAAE,KAAK,EACf,QAAgB,EAChB,QAAgB,EAChB,OAA6B,EAC5B,EAAE;YACH,IAAI,CAAC;gBACJ,+DAA+D;gBAC/D,0CAA0C;gBAC1C,sDAAsD;gBACtD,MAAM,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACR,6CAA6C;gBAC7C,6DAA6D;gBAC7D,4DAA4D;YAC7D,CAAC;YAED,MAAM,EAAE,CAAC,SAAS,CACjB,QAAQ,EACR,QAAQ,EACR,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CACjD,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC"}
+{"version":3,"file":"createWritingFileSystem.js","sourceRoot":"","sources":["../../src/files/createWritingFileSystem.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,MAAM,UAAU,uBAAuB;IACtC,OAAO;QACN,GAAG,uBAAuB,EAAE;QAC5B,cAAc,EAAE,KAAK,EAAE,aAAqB,EAAE,EAAE,CAC/C,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,SAAS,EAAE,KAAK,EACf,QAAgB,EAChB,QAAgB,EAChB,OAA6B,EAC5B,EAAE;YACH,IAAI,CAAC;gBACJ,+DAA+D;gBAC/D,0CAA0C;gBAC1C,+CAA+C;gBAC/C,MAAM,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACR,6CAA6C;gBAC7C,6DAA6D;gBAC7D,4DAA4D;YAC7D,CAAC;YAED,MAAM,EAAE,CAAC,SAAS,CACjB,QAAQ,EACR,QAAQ,EACR,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CACjD,CAAC;QACH,CAAC;KACD,CAAC;AACH,CAAC"}

package/lib/files/types.d.ts

@@ -1,3 +1,9 @@
+/**
+ * Finds the paths matching one or more glob patterns.
+ * @param patterns Glob pattern(s) to match paths against.
+ * @returns Promise for the matching paths, relative to the current directory.
+ */
+export type Glob = (patterns: string | string[]) => Promise<string[]>;
 /**
  * Reads the names of a directory's children.
  * @param directoryPath Path to the directory on disk.
@@ -14,6 +20,10 @@ export type ReadFile = (filePath: string) => Promise<string>;
  * APIs to read from a file system.
  */
 export interface ReadingFileSystem {
+    /**
+     * Finds the paths matching one or more glob patterns.
+     */
+    glob: Glob;
     /**
      * Reads the names of a directory's children.
      */

package/lib/files/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/files/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAEzE;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,aAAa,EAAE,aAAa,CAAC;IAE7B;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,CACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,gBAAgB,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC3D;;OAEG;IACH,cAAc,EAAE,cAAc,CAAC;IAE/B;;OAEG;IACH,SAAS,EAAE,SAAS,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/files/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAEtE;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAEzE;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;IAEX;;OAEG;IACH,aAAa,EAAE,aAAa,CAAC;IAE7B;;OAEG;IACH,QAAQ,EAAE,QAAQ,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEtE;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,CACvB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,gBAAgB,KACtB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAkB,SAAQ,iBAAiB;IAC3D;;OAEG;IACH,cAAc,EAAE,cAAc,CAAC;IAE/B;;OAEG;IACH,SAAS,EAAE,SAAS,CAAC;CACrB"}

package/lib/runner/createSystemRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createSystemRunner.d.ts","sourceRoot":"","sources":["../../src/runner/createSystemRunner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,wBAAgB,kBAAkB,CAAC,SAAS,SAAM,GAAG,YAAY,CAIhE"}
+{"version":3,"file":"createSystemRunner.d.ts","sourceRoot":"","sources":["../../src/runner/createSystemRunner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,wBAAgB,kBAAkB,CAAC,SAAS,SAAM,GAAG,YAAY,CAQhE"}

package/lib/runner/createSystemRunner.js

@@ -1,6 +1,11 @@
 import { execa, parseCommandString } from "execa";
+import { getColorsEnv } from "./getColorsEnv.js";
 export function createSystemRunner(directory = ".") {
-    const executor = execa({ cwd: directory, reject: false });
+    const executor = execa({
+        cwd: directory,
+        env: getColorsEnv(),
+        reject: false,
+    });
     return (command) => executor `${parseCommandString(command)}`;
 }
 //# sourceMappingURL=createSystemRunner.js.map

package/lib/runner/createSystemRunner.js.map

@@ -1 +1 @@
-{"version":3,"file":"createSystemRunner.js","sourceRoot":"","sources":["../../src/runner/createSystemRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAIlD,MAAM,UAAU,kBAAkB,CAAC,SAAS,GAAG,GAAG;IACjD,MAAM,QAAQ,GAAG,KAAK,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAE1D,OAAO,CAAC,OAAe,EAAE,EAAE,CAAC,QAAQ,CAAA,GAAG,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;AACtE,CAAC"}
+{"version":3,"file":"createSystemRunner.js","sourceRoot":"","sources":["../../src/runner/createSystemRunner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,OAAO,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGjD,MAAM,UAAU,kBAAkB,CAAC,SAAS,GAAG,GAAG;IACjD,MAAM,QAAQ,GAAG,KAAK,CAAC;QACtB,GAAG,EAAE,SAAS;QACd,GAAG,EAAE,YAAY,EAAE;QACnB,MAAM,EAAE,KAAK;KACb,CAAC,CAAC;IAEH,OAAO,CAAC,OAAe,EAAE,EAAE,CAAC,QAAQ,CAAA,GAAG,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;AACtE,CAAC"}

package/lib/runner/createSystemRunner.test.js

@@ -1,5 +1,11 @@
 import { describe, expect, it, vi } from "vitest";
 import { createSystemRunner } from "./createSystemRunner.js";
+const mockGetColorsEnv = vi.fn();
+vi.mock("./getColorsEnv.js", () => ({
+    get getColorsEnv() {
+        return mockGetColorsEnv;
+    },
+}));
 const mockExecutor = vi.fn();
 const mockExeca = vi.fn().mockReturnValue(mockExecutor);
 vi.mock("execa", async () => ({
@@ -16,6 +22,13 @@ describe("createSystemRunner", () => {
         expect(mockExeca.mock.calls).toEqual([[{ cwd, reject: false }]]);
         expect(mockExecutor.mock.calls).toEqual([[["", ""], ["abc"]]]);
     });
+    it("executes the command with a colors env when the terminal supports colors", async () => {
+        const env = { FORCE_COLOR: "3" };
+        mockGetColorsEnv.mockReturnValueOnce(env);
+        const runner = createSystemRunner();
+        await runner("abc");
+        expect(mockExeca.mock.calls).toEqual([[{ cwd: ".", env, reject: false }]]);
+    });
     it("executes the command as a parsed command string when it includes spaces", async () => {
         const runner = createSystemRunner();
         await runner("a bc d");

package/lib/runner/createSystemRunner.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"createSystemRunner.test.js","sourceRoot":"","sources":["../../src/runner/createSystemRunner.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAC7B,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;AAExD,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC7B,GAAG,CAAC,MAAM,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,KAAK;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;CACD,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,GAAG,GAAG,cAAc,CAAC;QAC3B,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAEvC,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;QAEpB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IACH,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;QACxF,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;QAEpC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEvB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QACtE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;YACvC;gBACC,CAAC,EAAE,EAAE,EAAE,CAAC;gBACR,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC;aAChB;SACD,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}
+{"version":3,"file":"createSystemRunner.test.js","sourceRoot":"","sources":["../../src/runner/createSystemRunner.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,gBAAgB,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAEjC,EAAE,CAAC,IAAI,CAAC,mBAAmB,EAAE,GAAG,EAAE,CAAC,CAAC;IACnC,IAAI,YAAY;QACf,OAAO,gBAAgB,CAAC;IACzB,CAAC;CACD,CAAC,CAAC,CAAC;AAEJ,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;AAC7B,MAAM,SAAS,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC;AAExD,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC7B,GAAG,CAAC,MAAM,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,KAAK;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;CACD,CAAC,CAAC,CAAC;AAEJ,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,GAAG,GAAG,cAAc,CAAC;QAC3B,MAAM,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAEvC,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;QAEpB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACzF,MAAM,GAAG,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;QACjC,gBAAgB,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;QAEpC,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;QAEpB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yEAAyE,EAAE,KAAK,IAAI,EAAE;QACxF,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;QAEpC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEvB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QACtE,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC;YACvC;gBACC,CAAC,EAAE,EAAE,EAAE,CAAC;gBACR,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC;aAChB;SACD,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/lib/runner/getColorsEnv.d.ts

@@ -0,0 +1,9 @@
+interface ColorsStream {
+    hasColors(count: number): boolean;
+    isTTY: boolean;
+}
+export declare function getColorsEnv(stdout?: ColorsStream): {
+    FORCE_COLOR: string;
+} | undefined;
+export {};
+//# sourceMappingURL=getColorsEnv.d.ts.map

package/lib/runner/getColorsEnv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getColorsEnv.d.ts","sourceRoot":"","sources":["../../src/runner/getColorsEnv.ts"],"names":[],"mappings":"AAAA,UAAU,YAAY;IACrB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,KAAK,EAAE,OAAO,CAAC;CACf;AAED,wBAAgB,YAAY,CAAC,MAAM,GAAE,YAA6B;;cAkBjE"}

package/lib/runner/getColorsEnv.js

@@ -0,0 +1,16 @@
+export function getColorsEnv(stdout = process.stdout) {
+    if (!stdout.isTTY) {
+        return undefined;
+    }
+    if (stdout.hasColors(2 ** 24)) {
+        return { FORCE_COLOR: "3" };
+    }
+    if (stdout.hasColors(2 ** 8)) {
+        return { FORCE_COLOR: "2" };
+    }
+    if (stdout.hasColors(16)) {
+        return { FORCE_COLOR: "1" };
+    }
+    return undefined;
+}
+//# sourceMappingURL=getColorsEnv.js.map

package/lib/runner/getColorsEnv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getColorsEnv.js","sourceRoot":"","sources":["../../src/runner/getColorsEnv.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,YAAY,CAAC,SAAuB,OAAO,CAAC,MAAM;IACjE,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;IAC7B,CAAC;IAED,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/lib/runner/getColorsEnv.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=getColorsEnv.test.d.ts.map

package/lib/runner/getColorsEnv.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getColorsEnv.test.d.ts","sourceRoot":"","sources":["../../src/runner/getColorsEnv.test.ts"],"names":[],"mappings":""}

package/lib/runner/getColorsEnv.test.js

@@ -0,0 +1,31 @@
+import { describe, expect, it } from "vitest";
+import { getColorsEnv } from "./getColorsEnv.js";
+function createStdout(isTTY, maxColors = 0) {
+    return {
+        hasColors: (count) => count <= maxColors,
+        isTTY,
+    };
+}
+describe(getColorsEnv, () => {
+    it("returns undefined when stdout is not a TTY", () => {
+        const actual = getColorsEnv(createStdout(false, 2 ** 24));
+        expect(actual).toBeUndefined();
+    });
+    it("returns undefined when the TTY does not support colors", () => {
+        const actual = getColorsEnv(createStdout(true));
+        expect(actual).toBeUndefined();
+    });
+    it("returns level 1 when the TTY supports only basic colors", () => {
+        const actual = getColorsEnv(createStdout(true, 16));
+        expect(actual).toEqual({ FORCE_COLOR: "1" });
+    });
+    it("returns level 2 when the TTY supports 256 colors", () => {
+        const actual = getColorsEnv(createStdout(true, 2 ** 8));
+        expect(actual).toEqual({ FORCE_COLOR: "2" });
+    });
+    it("returns level 3 when the TTY supports 16 million colors", () => {
+        const actual = getColorsEnv(createStdout(true, 2 ** 24));
+        expect(actual).toEqual({ FORCE_COLOR: "3" });
+    });
+});
+//# sourceMappingURL=getColorsEnv.test.js.map

package/lib/runner/getColorsEnv.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getColorsEnv.test.js","sourceRoot":"","sources":["../../src/runner/getColorsEnv.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,SAAS,YAAY,CAAC,KAAc,EAAE,SAAS,GAAG,CAAC;IAClD,OAAO;QACN,SAAS,EAAE,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,IAAI,SAAS;QAChD,KAAK;KACL,CAAC;AACH,CAAC;AAED,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACrD,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAE1D,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QACjE,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAEhD,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QAClE,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;QAEpD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAExD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QAClE,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAEzD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "bingo-systems",
-  "version": "0.5.4",
+  "version": "0.6.0",
   "description": "File, network, and shell wrapper APIs used by Bingo. 🧰",
+  "homepage": "https://www.create.bingo/build/packages/bingo-systems",
   "repository": {
     "type": "git",
-    "url": "https://github.com/JoshuaKGoldberg/bingo",
+    "url": "https://github.com/bingo-js/bingo",
     "directory": "packages/bingo-systems"
   },
   "license": "MIT",
@@ -15,22 +16,19 @@
   "type": "module",
   "main": "./lib/index.js",
   "files": [
-    "lib/",
-    "package.json",
-    "LICENSE.md",
-    "README.md"
+    "lib/"
   ],
   "dependencies": {
-    "execa": "^9.5.2",
-    "get-github-auth-token": "^0.1.1",
-    "octokit": "^4.1.2",
-    "bingo-fs": "^0.5.4"
+    "execa": "^9.6.1",
+    "get-github-auth-token": "^0.1.2",
+    "octokit": "^5.0.5",
+    "bingo-fs": "^0.5.6"
   },
   "devDependencies": {
-    "@types/node": "22.13.9"
+    "@types/node": "24.10.1"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "scripts": {
     "build": "tsc"