@dbx-tools/path 0.3.37 → 0.3.40

package/README.md

@@ -22,7 +22,7 @@ Key features:
 import { find, ignore } from "@dbx-tools/path";
 
 const files = find
-  .findFiles(["workspaces/**/src/**/*.ts"], {
+  .findFiles(["packages/**/src/**/*.ts"], {
     ignore: ignore.ignorePatterns(),
   })
   .toArray();
@@ -41,7 +41,7 @@ should agree with package discovery, barrel generation, or cleanup logic.
 import { match } from "@dbx-tools/path";
 
 const isTest = match.toPathMatcher("**/*.test.ts");
-if (isTest("workspaces/shared/model/test/classify.test.ts")) {
+if (isTest("packages/shared/model/test/classify.test.ts")) {
   skip();
 }
 ```
@@ -71,7 +71,7 @@ generated files, build output, VCS metadata, and package-manager output.
 import { scan } from "@dbx-tools/path";
 
 const options: scan.FileScanOptions = {
-  roots: ["workspaces", "example-workspaces"],
+  roots: ["workspaces", "example-packages"],
   followSymlinks: scan.FOLLOW_SYMLINKS_DEFAULT,
 };
 ```
@@ -85,7 +85,7 @@ like synthesis does.
 ```ts
 import { watch } from "@dbx-tools/path";
 
-const watcher = watch.watchFiles(["workspaces/**/src/**/*.ts"], {
+const watcher = watch.watchFiles(["packages/**/src/**/*.ts"], {
   ignoreInitial: true,
 });
 
@@ -111,7 +111,7 @@ Pattern helpers keep generated glob fragments escaped and consistent.
 - `find` - glob-backed lazy file finding.
 - `match` - glob-to-predicate path matchers.
 - `ignore` - standard ignore pattern and matcher construction.
-- `scan` - workspace package scan option types and defaults.
+- `scan` - package scan option types and defaults.
 - `watch` - chokidar wrapper for file watching.
 - `pattern` - escaped directory-name and extension glob fragments.
 

package/package.json

@@ -3,7 +3,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/reggie-db/dbx-tools.git",
-    "directory": "workspaces/node/path"
+    "directory": "packages/node/path"
   },
   "devDependencies": {
     "@types/node": "^24.6.0",
@@ -14,21 +14,25 @@
     "chokidar": "^4.0.3",
     "glob": "^13.0.6",
     "minimatch": "^10.2.5",
-    "@dbx-tools/core": "0.3.37",
-    "@dbx-tools/shared-core": "0.3.37"
+    "@dbx-tools/core": "0.3.40",
+    "@dbx-tools/shared-core": "0.3.40"
   },
   "main": "index.ts",
   "license": "UNLICENSED",
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.3.37",
+  "version": "0.3.40",
   "types": "index.ts",
   "type": "module",
   "exports": {
     ".": "./index.ts",
     "./package.json": "./package.json"
   },
+  "files": [
+    "index.ts",
+    "src"
+  ],
   "dbxToolsConfig": {
     "tags": [
       "node"

package/src/match.ts

@@ -61,6 +61,6 @@ if (import.meta.main) {
   const matcher = ignorePathMatcher({ test: true })
     .negate()
     .and(...pathMatchTests("**/cool.ts", "**/wow.ts"));
-  console.log(matcher("workspaces/node/file-scan/src/cool.ts"));
-  console.log(matcher("workspaces/node/file-scan/.src/cool.ts"));
+  console.log(matcher("packages/node/file-scan/src/cool.ts"));
+  console.log(matcher("packages/node/file-scan/.src/cool.ts"));
 }

package/.projen/deps.json

@@ -1,44 +0,0 @@
-{
-  "dependencies": [
-    {
-      "name": "@types/node",
-      "version": "catalog:",
-      "type": "build"
-    },
-    {
-      "name": "tsx",
-      "version": "^4.23.0",
-      "type": "build"
-    },
-    {
-      "name": "typescript",
-      "type": "build"
-    },
-    {
-      "name": "@dbx-tools/core",
-      "version": "workspace:*",
-      "type": "runtime"
-    },
-    {
-      "name": "@dbx-tools/shared-core",
-      "version": "workspace:*",
-      "type": "runtime"
-    },
-    {
-      "name": "chokidar",
-      "version": "^4.0.3",
-      "type": "runtime"
-    },
-    {
-      "name": "glob",
-      "version": "^13.0.6",
-      "type": "runtime"
-    },
-    {
-      "name": "minimatch",
-      "version": "^10.2.5",
-      "type": "runtime"
-    }
-  ],
-  "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"pnpm exec projen\"."
-}

package/.projen/files.json

@@ -1,11 +0,0 @@
-{
-  "files": [
-    ".projen/deps.json",
-    ".projen/files.json",
-    ".projen/tasks.json",
-    "package.json",
-    "test/tsconfig.json",
-    "tsconfig.json"
-  ],
-  "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"pnpm exec projen\"."
-}

package/.projen/tasks.json

@@ -1,121 +0,0 @@
-{
-  "manifestVersion": 3,
-  "env": {
-    "PATH": "$(pnpm -c exec \"node --print process.env.PATH\")"
-  },
-  "tasks": {
-    "build": {
-      "name": "build",
-      "description": "Full release build",
-      "steps": [
-        {
-          "spawn": "pre-compile"
-        },
-        {
-          "spawn": "compile"
-        },
-        {
-          "spawn": "post-compile"
-        },
-        {
-          "spawn": "test"
-        },
-        {
-          "spawn": "package"
-        }
-      ]
-    },
-    "compile": {
-      "name": "compile",
-      "description": "Only compile",
-      "steps": [
-        {
-          "execArgs": [
-            "tsc",
-            "--build"
-          ]
-        }
-      ]
-    },
-    "default": {
-      "name": "default",
-      "description": "Synthesize project files",
-      "steps": [
-        {
-          "exec": "pnpm exec projen default",
-          "cwd": "../../.."
-        }
-      ]
-    },
-    "install": {
-      "name": "install",
-      "description": "Install project dependencies and update lockfile (non-frozen)",
-      "steps": [
-        {
-          "exec": "pnpm i --no-frozen-lockfile"
-        }
-      ]
-    },
-    "install:ci": {
-      "name": "install:ci",
-      "description": "Install project dependencies using frozen lockfile",
-      "steps": [
-        {
-          "exec": "pnpm i --frozen-lockfile"
-        }
-      ]
-    },
-    "package": {
-      "name": "package",
-      "description": "Creates the distribution package",
-      "steps": [
-        {
-          "execArgs": [
-            "mkdir",
-            "-p",
-            "dist/js"
-          ]
-        },
-        {
-          "execArgs": [
-            "pnpm",
-            "pack",
-            "--pack-destination",
-            "dist/js"
-          ]
-        }
-      ]
-    },
-    "post-compile": {
-      "name": "post-compile",
-      "description": "Runs after successful compilation"
-    },
-    "pre-compile": {
-      "name": "pre-compile",
-      "description": "Prepare the project for compilation"
-    },
-    "test": {
-      "name": "test",
-      "description": "Run tests",
-      "steps": [
-        {
-          "exec": "tsx --test 'test/**/*.test.ts'"
-        }
-      ]
-    },
-    "watch": {
-      "name": "watch",
-      "description": "Watch & compile in the background",
-      "steps": [
-        {
-          "execArgs": [
-            "tsc",
-            "--build",
-            "-w"
-          ]
-        }
-      ]
-    }
-  },
-  "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"pnpm exec projen\"."
-}

package/test/fixtures/sample-tree/.hidden/secret.ts

@@ -1 +0,0 @@
-export const secret = true;

package/test/fixtures/sample-tree/example/skip.ts

@@ -1 +0,0 @@
-export const skip = true;

package/test/fixtures/sample-tree/src/index.ts

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

package/test/fixtures/sample-tree/src/keep.ts

@@ -1 +0,0 @@
-export const keep = true;

package/test/match-parity.test.ts

@@ -1,99 +0,0 @@
-/**
- * Parity tests: the same ignore patterns must make {@link findFiles} and
- * {@link watchFiles} keep the same set of files. Both run against a temp copy of
- * the fixture tree (see the note below the imports for why a temp root is used)
- * and their results are asserted equal, then checked against a concrete list.
- */
-import assert from "node:assert/strict";
-import { cpSync, mkdtempSync, rmSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join, relative, sep, isAbsolute } from "node:path";
-import { after, before, describe, it } from "node:test";
-import { fileURLToPath } from "node:url";
-import { findFiles } from "../src/find";
-import { watchFiles } from "../src/watch";
-
-const FIXTURE_SOURCE = fileURLToPath(new URL("fixtures/sample-tree", import.meta.url));
-
-// glob matches ignore patterns against cwd-relative paths, while chokidar
-// matches them against absolute paths. The real fixture lives under a `test/`
-// directory, so the default `**/test/**` group would match in watch (absolute)
-// but not in scan (relative) - a mismatch unrelated to the shared patterns.
-// Copying the tree to a neutral temp root removes that ancestor so the two are
-// compared purely on pattern parity.
-let root: string;
-
-before(() => {
-  root = mkdtempSync(join(tmpdir(), "file-scan-parity-"));
-  cpSync(FIXTURE_SOURCE, root, { recursive: true });
-});
-
-after(() => {
-  rmSync(root, { recursive: true, force: true });
-});
-
-const toPosix = (path: string): string => path.split(sep).join("/");
-
-/** Files fileScan keeps for the fixture (relative, posix) given `ignore`. */
-function scannedFiles(ignore: string | string[] | undefined): Set<string> {
-  return new Set([...findFiles("**", { cwd: root, nodir: true, ignore })].map(toPosix));
-}
-
-/** Files fileWatch reports for the (static) fixture (relative, posix), then closes. */
-async function watchedFiles(ignore: string | string[] | undefined): Promise<Set<string>> {
-  const files = new Set<string>();
-  const watcher = watchFiles(root, {
-    cwd: root,
-    ignore,
-    persistent: false,
-    ignoreInitial: false,
-  });
-  watcher.on("add", (path) => {
-    const rel = isAbsolute(path) ? relative(root, path) : path;
-    files.add(toPosix(rel === "" ? "." : rel));
-  });
-  try {
-    await new Promise<void>((resolve, reject) => {
-      watcher.once("ready", () => resolve());
-      watcher.once("error", reject);
-    });
-  } finally {
-    await watcher.close();
-  }
-  return files;
-}
-
-/**
- * The same ignore patterns must make fileScan and fileWatch keep the same files.
- * Asserts parity, then returns the (shared) sorted result for concrete checks.
- */
-async function keptByBoth(patterns: string | string[] | undefined): Promise<string[]> {
-  const scanned = [...scannedFiles(patterns)].sort();
-  const watched = [...(await watchedFiles(patterns))].sort();
-  assert.deepEqual(watched, scanned);
-  return scanned;
-}
-
-describe("scan/watch matching parity", () => {
-  // `.hidden` (dot group) and any node_modules/dist (default groups) are dropped
-  // by both; only the plain source files survive the default ignore list.
-  it("keeps the same files with only the default ignore groups", async () => {
-    assert.deepEqual(await keptByBoth(undefined), [
-      "example/skip.ts",
-      "src/index.ts",
-      "src/keep.ts",
-    ]);
-  });
-
-  it("keeps the same files ignoring a file pattern", async () => {
-    assert.deepEqual(await keptByBoth("**/index.ts"), ["example/skip.ts", "src/keep.ts"]);
-  });
-
-  it("keeps the same files ignoring a directory pattern", async () => {
-    assert.deepEqual(await keptByBoth(["**/example/**"]), ["src/index.ts", "src/keep.ts"]);
-  });
-
-  it("keeps the same files ignoring multiple patterns", async () => {
-    assert.deepEqual(await keptByBoth(["**/index.ts", "**/example/**"]), ["src/keep.ts"]);
-  });
-});

package/test/tsconfig.json

@@ -1,14 +0,0 @@
-// ~~ Generated by projen. To modify, edit .projenrc.js and run "pnpm exec projen".
-{
-  "extends": "../tsconfig.json",
-  "compilerOptions": {
-    "noEmit": true,
-    "rootDir": ".."
-  },
-  "include": [
-    "**/*.ts"
-  ],
-  "exclude": [
-    "node_modules"
-  ]
-}

package/tsconfig.json

@@ -1,41 +0,0 @@
-// ~~ Generated by projen. To modify, edit .projenrc.js and run "pnpm exec projen".
-{
-  "compilerOptions": {
-    "rootDir": "src",
-    "outDir": "lib",
-    "alwaysStrict": true,
-    "declaration": true,
-    "esModuleInterop": true,
-    "experimentalDecorators": true,
-    "inlineSourceMap": true,
-    "inlineSources": true,
-    "lib": [
-      "ES2022"
-    ],
-    "module": "ESNext",
-    "noEmitOnError": false,
-    "noFallthroughCasesInSwitch": true,
-    "noImplicitAny": true,
-    "noImplicitReturns": true,
-    "noImplicitThis": true,
-    "noUnusedLocals": true,
-    "noUnusedParameters": true,
-    "resolveJsonModule": true,
-    "strict": true,
-    "strictNullChecks": true,
-    "strictPropertyInitialization": true,
-    "stripInternal": true,
-    "target": "ES2022",
-    "types": [
-      "node"
-    ],
-    "moduleResolution": "bundler",
-    "skipLibCheck": true
-  },
-  "include": [
-    "src/**/*.ts"
-  ],
-  "exclude": [
-    "node_modules"
-  ]
-}