@traqula/test-utils 1.1.2 → 1.1.5

package/dist/cjs/lib/generators/algebraGenerators.js

@@ -8,16 +8,32 @@ const node_fs_1 = require("node:fs");
 const node_path_1 = require("node:path");
 const fileUtils_js_1 = require("../fileUtils.js");
 const utils_js_1 = require("./utils.js");
-const rootDir = (0, utils_js_1.getStaticFilePath)('algebra');
-const rootSparql = (0, node_path_1.join)(rootDir, 'sparql');
-const rootJson = (0, node_path_1.join)(rootDir, 'algebra');
-const rootJsonBlankToVariable = (0, node_path_1.join)(rootDir, 'algebra-blank-to-var');
-const rootCanonicalSparql = (0, node_path_1.join)(rootDir, 'canonical-sparql', 'base');
-const rootCanonicalSparqlBlankToVar = (0, node_path_1.join)(rootDir, 'canonical-sparql', 'blank-to-var');
+// Computed lazily inside each generator so that getStaticFilePath() is not
+// called at module-evaluation time.  This avoids an ESM initialisation-order
+// issue where algebraGenerators.js would execute before index.ts has had a
+// chance to call _initStaticsRoot().
+function getRootDir() {
+    return (0, utils_js_1.getStaticFilePath)('algebra');
+}
+function getRootSparql() {
+    return (0, node_path_1.join)(getRootDir(), 'sparql');
+}
+function getRootJson() {
+    return (0, node_path_1.join)(getRootDir(), 'algebra');
+}
+function getRootJsonBlankToVariable() {
+    return (0, node_path_1.join)(getRootDir(), 'algebra-blank-to-var');
+}
+function getRootCanonicalSparql() {
+    return (0, node_path_1.join)(getRootDir(), 'canonical-sparql', 'base');
+}
+function getRootCanonicalSparqlBlankToVar() {
+    return (0, node_path_1.join)(getRootDir(), 'canonical-sparql', 'blank-to-var');
+}
 function* sparqlAlgebraTests(suite, blankToVariable, getSPARQL) {
     // Relative path starting from roots declared above.
     function* subGen(relativePath) {
-        const absolutePath = (0, node_path_1.join)(blankToVariable ? rootJsonBlankToVariable : rootJson, relativePath);
+        const absolutePath = (0, node_path_1.join)(blankToVariable ? getRootJsonBlankToVariable() : getRootJson(), relativePath);
         if ((0, node_fs_1.lstatSync)(absolutePath).isDirectory()) {
             // Recursion
             for (const sub of (0, node_fs_1.readdirSync)(absolutePath)) {
@@ -26,8 +42,8 @@ function* sparqlAlgebraTests(suite, blankToVariable, getSPARQL) {
         }
         else {
             const name = relativePath.replace(/\.json$/u, '');
-            const sparqlPath = (0, node_path_1.join)(rootSparql, relativePath.replace(/\.json/u, '.sparql'));
-            const canonicalSparqlPath = (0, node_path_1.join)(blankToVariable ? rootCanonicalSparqlBlankToVar : rootCanonicalSparql, relativePath.replace(/\.json/u, '.sparql'));
+            const sparqlPath = (0, node_path_1.join)(getRootSparql(), relativePath.replace(/\.json/u, '.sparql'));
+            const canonicalSparqlPath = (0, node_path_1.join)(blankToVariable ? getRootCanonicalSparqlBlankToVar() : getRootCanonicalSparql(), relativePath.replace(/\.json/u, '.sparql'));
             yield {
                 name,
                 json: JSON.parse((0, fileUtils_js_1.readFileSync)(absolutePath)),
@@ -37,7 +53,7 @@ function* sparqlAlgebraTests(suite, blankToVariable, getSPARQL) {
             };
         }
     }
-    const subfolders = (0, node_fs_1.readdirSync)(blankToVariable ? rootJsonBlankToVariable : rootJson);
+    const subfolders = (0, node_fs_1.readdirSync)(blankToVariable ? getRootJsonBlankToVariable() : getRootJson());
     if (subfolders.includes(suite)) {
         yield* subGen(suite);
     }
@@ -48,7 +64,7 @@ function* sparqlAlgebraTests(suite, blankToVariable, getSPARQL) {
  */
 function* sparqlQueries(suite) {
     function* subGen(relativePath) {
-        const absolutePath = (0, node_path_1.join)(rootSparql, relativePath);
+        const absolutePath = (0, node_path_1.join)(getRootSparql(), relativePath);
         if ((0, node_fs_1.lstatSync)(absolutePath).isDirectory()) {
             // Recursion
             for (const sub of (0, node_fs_1.readdirSync)(absolutePath)) {
@@ -64,7 +80,7 @@ function* sparqlQueries(suite) {
             };
         }
     }
-    const subfolders = (0, node_fs_1.readdirSync)(rootSparql);
+    const subfolders = (0, node_fs_1.readdirSync)(getRootSparql());
     if (subfolders.includes(suite)) {
         yield* subGen(suite);
     }

package/dist/cjs/lib/generators/algebraGenerators.js.map

@@ -1 +1 @@
-{"version":3,"file":"algebraGenerators.js","sourceRoot":"","sources":["../../../../lib/generators/algebraGenerators.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable import/no-nodejs-modules */\nimport { lstatSync, readdirSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { readFile, readFileSync } from '../fileUtils.js';\nimport type { NegativeTest } from './generators.js';\nimport { getStaticFilePath } from './utils.js';\n\nconst rootDir = getStaticFilePath('algebra');\nconst rootSparql = join(rootDir, 'sparql');\nconst rootJson = join(rootDir, 'algebra');\nconst rootJsonBlankToVariable = join(rootDir, 'algebra-blank-to-var');\nconst rootCanonicalSparql = join(rootDir, 'canonical-sparql', 'base');\nconst rootCanonicalSparqlBlankToVar = join(rootDir, 'canonical-sparql', 'blank-to-var');\n\nexport interface algebraTestGen {\n  name: string;\n  json: unknown;\n  quads: boolean;\n  sparql: string | undefined;\n  canonicalSparql: string | undefined;\n}\n\nexport type AlgebraTestSuite = 'dawg-syntax' | 'sparql-1.1' | 'sparql11-query' | 'sparql12';\n\n/**\n * Yields algebra-level test cases from the static test fixtures.\n * Each test provides a SPARQL query, expected algebra JSON, and optionally a canonical SPARQL string.\n * @param suite - The test suite to iterate.\n * @param blankToVariable - Whether to use the blank-to-variable fixture variant.\n * @param getSPARQL - Whether to load the SPARQL and canonical SPARQL strings.\n */\nexport function sparqlAlgebraTests(suite: AlgebraTestSuite, blankToVariable: boolean, getSPARQL: true):\nGenerator<algebraTestGen & { sparql: string; canonicalSparql: string }>;\nexport function sparqlAlgebraTests(suite: AlgebraTestSuite, blankToVariable: boolean, getSPARQL: boolean):\nGenerator<algebraTestGen>;\nexport function* sparqlAlgebraTests(suite: AlgebraTestSuite, blankToVariable: boolean, getSPARQL: boolean):\nGenerator<algebraTestGen> {\n  // Relative path starting from roots declared above.\n  function* subGen(relativePath: string): Generator<algebraTestGen> {\n    const absolutePath = join(blankToVariable ? rootJsonBlankToVariable : rootJson, relativePath);\n    if (lstatSync(absolutePath).isDirectory()) {\n      // Recursion\n      for (const sub of readdirSync(absolutePath)) {\n        yield* subGen(join(relativePath, sub));\n      }\n    } else {\n      const name = relativePath.replace(/\\.json$/u, '');\n      const sparqlPath = join(rootSparql, relativePath.replace(/\\.json/u, '.sparql'));\n      const canonicalSparqlPath = join(\n        blankToVariable ? rootCanonicalSparqlBlankToVar : rootCanonicalSparql,\n        relativePath.replace(/\\.json/u, '.sparql'),\n      );\n      yield {\n        name,\n        json: JSON.parse(readFileSync(absolutePath)),\n        sparql: getSPARQL ? readFileSync(sparqlPath, 'utf8') : undefined,\n        canonicalSparql: getSPARQL ? readFileSync(canonicalSparqlPath, 'utf-8') : undefined,\n        quads: name.endsWith('-quads'),\n      };\n    }\n  }\n\n  const subfolders = readdirSync(blankToVariable ? rootJsonBlankToVariable : rootJson);\n  if (subfolders.includes(suite)) {\n    yield* subGen(suite);\n  }\n}\n\ntype GenQuery = { query: string; name: string };\n/**\n * Yields raw SPARQL query strings from the static test fixtures for a given suite.\n * @param suite - The test suite to iterate.\n */\nexport function* sparqlQueries(suite: AlgebraTestSuite): Generator<GenQuery> {\n  function* subGen(relativePath: string): Generator<GenQuery> {\n    const absolutePath = join(rootSparql, relativePath);\n    if (lstatSync(absolutePath).isDirectory()) {\n      // Recursion\n      for (const sub of readdirSync(absolutePath)) {\n        yield* subGen(join(relativePath, sub));\n      }\n    } else {\n      const name = relativePath.replace(/\\.sparql$/u, '');\n      const content = readFileSync(absolutePath, 'utf-8');\n      yield {\n        name,\n        query: content.replaceAll(/\\r?\\n/gu, '\\n'),\n      };\n    }\n  }\n\n  const subfolders = readdirSync(rootSparql);\n  if (subfolders.includes(suite)) {\n    yield* subGen(suite);\n  }\n}\n\nexport type NegativeAlgebraSuite = 'sparql-1.1-negative' | 'sparql-1.2-negative';\n\n/**\n * Yields test cases for negative (invalid) algebra-level tests.\n * Each test provides a SPARQL query that should fail during algebra transformation.\n * @param suite - The negative test suite to iterate.\n * @param filter - Optional filter predicate applied to the test file name.\n */\nexport function* sparqlAlgebraNegativeTests(\n  suite: NegativeAlgebraSuite,\n  filter?: (name: string) => boolean,\n): Generator<NegativeTest> {\n  const astDir = getStaticFilePath('algebra');\n  const sparqlDir = join(astDir, 'sparql', suite);\n  const statics = readdirSync(sparqlDir);\n  for (const file of statics.filter(f => f.endsWith('.sparql'))) {\n    if (filter && !filter(file.replace('.sparql', ''))) {\n      continue;\n    }\n    const name = file.replace(/\\.sparql$/u, '');\n    yield {\n      name,\n      statics: async() => {\n        const query = await readFile(join(sparqlDir, file));\n        return {\n          query,\n        };\n      },\n    };\n  }\n}\n"]}
+{"version":3,"file":"algebraGenerators.js","sourceRoot":"","sources":["../../../../lib/generators/algebraGenerators.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable import/no-nodejs-modules */\nimport { lstatSync, readdirSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { readFile, readFileSync } from '../fileUtils.js';\nimport type { NegativeTest } from './generators.js';\nimport { getStaticFilePath } from './utils.js';\n\n// Computed lazily inside each generator so that getStaticFilePath() is not\n// called at module-evaluation time.  This avoids an ESM initialisation-order\n// issue where algebraGenerators.js would execute before index.ts has had a\n// chance to call _initStaticsRoot().\nfunction getRootDir(): string {\n  return getStaticFilePath('algebra');\n}\nfunction getRootSparql(): string {\n  return join(getRootDir(), 'sparql');\n}\nfunction getRootJson(): string {\n  return join(getRootDir(), 'algebra');\n}\nfunction getRootJsonBlankToVariable(): string {\n  return join(getRootDir(), 'algebra-blank-to-var');\n}\nfunction getRootCanonicalSparql(): string {\n  return join(getRootDir(), 'canonical-sparql', 'base');\n}\nfunction getRootCanonicalSparqlBlankToVar(): string {\n  return join(getRootDir(), 'canonical-sparql', 'blank-to-var');\n}\n\nexport interface algebraTestGen {\n  name: string;\n  json: unknown;\n  quads: boolean;\n  sparql: string | undefined;\n  canonicalSparql: string | undefined;\n}\n\nexport type AlgebraTestSuite = 'dawg-syntax' | 'sparql-1.1' | 'sparql11-query' | 'sparql12';\n\n/**\n * Yields algebra-level test cases from the static test fixtures.\n * Each test provides a SPARQL query, expected algebra JSON, and optionally a canonical SPARQL string.\n * @param suite - The test suite to iterate.\n * @param blankToVariable - Whether to use the blank-to-variable fixture variant.\n * @param getSPARQL - Whether to load the SPARQL and canonical SPARQL strings.\n */\nexport function sparqlAlgebraTests(suite: AlgebraTestSuite, blankToVariable: boolean, getSPARQL: true):\nGenerator<algebraTestGen & { sparql: string; canonicalSparql: string }>;\nexport function sparqlAlgebraTests(suite: AlgebraTestSuite, blankToVariable: boolean, getSPARQL: boolean):\nGenerator<algebraTestGen>;\nexport function* sparqlAlgebraTests(suite: AlgebraTestSuite, blankToVariable: boolean, getSPARQL: boolean):\nGenerator<algebraTestGen> {\n  // Relative path starting from roots declared above.\n  function* subGen(relativePath: string): Generator<algebraTestGen> {\n    const absolutePath = join(blankToVariable ? getRootJsonBlankToVariable() : getRootJson(), relativePath);\n    if (lstatSync(absolutePath).isDirectory()) {\n      // Recursion\n      for (const sub of readdirSync(absolutePath)) {\n        yield* subGen(join(relativePath, sub));\n      }\n    } else {\n      const name = relativePath.replace(/\\.json$/u, '');\n      const sparqlPath = join(getRootSparql(), relativePath.replace(/\\.json/u, '.sparql'));\n      const canonicalSparqlPath = join(\n        blankToVariable ? getRootCanonicalSparqlBlankToVar() : getRootCanonicalSparql(),\n        relativePath.replace(/\\.json/u, '.sparql'),\n      );\n      yield {\n        name,\n        json: JSON.parse(readFileSync(absolutePath)),\n        sparql: getSPARQL ? readFileSync(sparqlPath, 'utf8') : undefined,\n        canonicalSparql: getSPARQL ? readFileSync(canonicalSparqlPath, 'utf-8') : undefined,\n        quads: name.endsWith('-quads'),\n      };\n    }\n  }\n\n  const subfolders = readdirSync(blankToVariable ? getRootJsonBlankToVariable() : getRootJson());\n  if (subfolders.includes(suite)) {\n    yield* subGen(suite);\n  }\n}\n\ntype GenQuery = { query: string; name: string };\n/**\n * Yields raw SPARQL query strings from the static test fixtures for a given suite.\n * @param suite - The test suite to iterate.\n */\nexport function* sparqlQueries(suite: AlgebraTestSuite): Generator<GenQuery> {\n  function* subGen(relativePath: string): Generator<GenQuery> {\n    const absolutePath = join(getRootSparql(), relativePath);\n    if (lstatSync(absolutePath).isDirectory()) {\n      // Recursion\n      for (const sub of readdirSync(absolutePath)) {\n        yield* subGen(join(relativePath, sub));\n      }\n    } else {\n      const name = relativePath.replace(/\\.sparql$/u, '');\n      const content = readFileSync(absolutePath, 'utf-8');\n      yield {\n        name,\n        query: content.replaceAll(/\\r?\\n/gu, '\\n'),\n      };\n    }\n  }\n\n  const subfolders = readdirSync(getRootSparql());\n  if (subfolders.includes(suite)) {\n    yield* subGen(suite);\n  }\n}\n\nexport type NegativeAlgebraSuite = 'sparql-1.1-negative' | 'sparql-1.2-negative';\n\n/**\n * Yields test cases for negative (invalid) algebra-level tests.\n * Each test provides a SPARQL query that should fail during algebra transformation.\n * @param suite - The negative test suite to iterate.\n * @param filter - Optional filter predicate applied to the test file name.\n */\nexport function* sparqlAlgebraNegativeTests(\n  suite: NegativeAlgebraSuite,\n  filter?: (name: string) => boolean,\n): Generator<NegativeTest> {\n  const astDir = getStaticFilePath('algebra');\n  const sparqlDir = join(astDir, 'sparql', suite);\n  const statics = readdirSync(sparqlDir);\n  for (const file of statics.filter(f => f.endsWith('.sparql'))) {\n    if (filter && !filter(file.replace('.sparql', ''))) {\n      continue;\n    }\n    const name = file.replace(/\\.sparql$/u, '');\n    yield {\n      name,\n      statics: async() => {\n        const query = await readFile(join(sparqlDir, file));\n        return {\n          query,\n        };\n      },\n    };\n  }\n}\n"]}

package/dist/cjs/lib/generators/utils.js

@@ -3,18 +3,70 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports._initStaticsRoot = _initStaticsRoot;
 exports.getStaticFilePath = getStaticFilePath;
 /* eslint-disable import/no-nodejs-modules */
+const node_fs_1 = require("node:fs");
 const node_path_1 = __importDefault(require("node:path"));
-// Path.resolve() returns process.cwd() — the monorepo root when running via vitest.
-// This avoids __dirname (CJS-only) and import.meta.url (ESM-only).
-const staticsPath = node_path_1.default.resolve('packages/test-utils/statics');
+/**
+ * Walk up the directory tree from startDir until a directory that contains
+ * both a `package.json` and a `statics` folder is found.  Stopping at the
+ * package-root boundary avoids the risk of matching an unrelated `statics/`
+ * folder higher up the filesystem.
+ */
+function resolveStaticsPath(startDir) {
+    let dir = startDir;
+    while (true) {
+        if ((0, node_fs_1.existsSync)(node_path_1.default.join(dir, 'statics')) && (0, node_fs_1.existsSync)(node_path_1.default.join(dir, 'package.json'))) {
+            return node_path_1.default.join(dir, 'statics');
+        }
+        const parent = node_path_1.default.dirname(dir);
+        // Guard: filesystem root reached before finding a package boundary — unreachable in practice.
+        /* v8 ignore next 3 */
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    // Guard: statics not found even after reaching the filesystem root — unreachable in practice.
+    /* v8 ignore next */
+    throw new Error(`Cannot locate statics/ directory (with co-located package.json) starting from ${startDir}`);
+}
+// Resolved on demand after the package entry point calls _initStaticsRoot().
+let _staticsPath;
+/**
+ * Initialises the statics root from the directory of the package entry point.
+ * Must be called before any test fixture helpers are invoked.
+ *
+ * The package entry points (index.ts for ESM, index.cts for CJS) call this
+ * with their own `path.dirname(fileURLToPath(import.meta.url))` or `__dirname`
+ * respectively, so this module contains no module-system-specific syntax and
+ * compiles correctly under both `module: NodeNext` and `module: CommonJS`.
+ *
+ * Design note — eager-init vs lazy resolution:
+ * An alternative would be to resolve the statics path lazily inside
+ * getStaticFilePath() on first call (eliminating _initStaticsRoot and the
+ * entry-point coupling entirely).  Eager-init was chosen instead because lazy
+ * resolution cannot safely use import.meta.url in a CommonJS build, and
+ * __dirname is not available in an ESM build.  The entry-point side-effect
+ * approach lets this module stay free of module-system-specific syntax while
+ * still capturing the correct anchor directory at load time.
+ * @internal
+ */
+function _initStaticsRoot(dir) {
+    _staticsPath = resolveStaticsPath(dir);
+}
 /**
  * Resolve a path relative to the test-utils statics directory.
  * @param paths - Path segments to join after the statics root.
  * @returns The absolute path to the static fixture.
  */
 function getStaticFilePath(...paths) {
-    return node_path_1.default.join(staticsPath, ...paths);
+    // Guard: entry point must call _initStaticsRoot() before this helper is used.
+    /* v8 ignore next 3 */
+    if (!_staticsPath) {
+        throw new Error('getStaticFilePath() called before the package entry point initialised the statics root');
+    }
+    return node_path_1.default.join(_staticsPath, ...paths);
 }
 //# sourceMappingURL=utils.js.map

package/dist/cjs/lib/generators/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../lib/generators/utils.ts"],"names":[],"mappings":";;;;;AAYA,8CAEC;AAdD,6CAA6C;AAC7C,0DAA6B;AAE7B,oFAAoF;AACpF,mEAAmE;AACnE,MAAM,WAAW,GAAG,mBAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;AAEhE;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,GAAG,KAAe;IAClD,OAAO,mBAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,CAAC;AAC1C,CAAC","sourcesContent":["/* eslint-disable import/no-nodejs-modules */\nimport path from 'node:path';\n\n// Path.resolve() returns process.cwd() — the monorepo root when running via vitest.\n// This avoids __dirname (CJS-only) and import.meta.url (ESM-only).\nconst staticsPath = path.resolve('packages/test-utils/statics');\n\n/**\n * Resolve a path relative to the test-utils statics directory.\n * @param paths - Path segments to join after the statics root.\n * @returns The absolute path to the static fixture.\n */\nexport function getStaticFilePath(...paths: string[]): string {\n  return path.join(staticsPath, ...paths);\n}\n"]}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../lib/generators/utils.ts"],"names":[],"mappings":";;;;;AAmDA,4CAEC;AAOD,8CAOC;AAnED,6CAA6C;AAC7C,qCAAqC;AACrC,0DAA6B;AAE7B;;;;;GAKG;AACH,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,IAAA,oBAAU,EAAC,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,IAAI,IAAA,oBAAU,EAAC,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YACxF,OAAO,mBAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,MAAM,GAAG,mBAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,8FAA8F;QAC9F,sBAAsB;QACtB,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,MAAM;QACR,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,8FAA8F;IAC9F,oBAAoB;IACpB,MAAM,IAAI,KAAK,CAAC,iFAAiF,QAAQ,EAAE,CAAC,CAAC;AAC/G,CAAC;AAED,6EAA6E;AAC7E,IAAI,YAAgC,CAAC;AAErC;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,gBAAgB,CAAC,GAAW;IAC1C,YAAY,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAAC,GAAG,KAAe;IAClD,8EAA8E;IAC9E,sBAAsB;IACtB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,wFAAwF,CAAC,CAAC;IAC5G,CAAC;IACD,OAAO,mBAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,KAAK,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["/* eslint-disable import/no-nodejs-modules */\nimport { existsSync } from 'node:fs';\nimport path from 'node:path';\n\n/**\n * Walk up the directory tree from startDir until a directory that contains\n * both a `package.json` and a `statics` folder is found.  Stopping at the\n * package-root boundary avoids the risk of matching an unrelated `statics/`\n * folder higher up the filesystem.\n */\nfunction resolveStaticsPath(startDir: string): string {\n  let dir = startDir;\n  while (true) {\n    if (existsSync(path.join(dir, 'statics')) && existsSync(path.join(dir, 'package.json'))) {\n      return path.join(dir, 'statics');\n    }\n    const parent = path.dirname(dir);\n    // Guard: filesystem root reached before finding a package boundary — unreachable in practice.\n    /* v8 ignore next 3 */\n    if (parent === dir) {\n      break;\n    }\n    dir = parent;\n  }\n  // Guard: statics not found even after reaching the filesystem root — unreachable in practice.\n  /* v8 ignore next */\n  throw new Error(`Cannot locate statics/ directory (with co-located package.json) starting from ${startDir}`);\n}\n\n// Resolved on demand after the package entry point calls _initStaticsRoot().\nlet _staticsPath: string | undefined;\n\n/**\n * Initialises the statics root from the directory of the package entry point.\n * Must be called before any test fixture helpers are invoked.\n *\n * The package entry points (index.ts for ESM, index.cts for CJS) call this\n * with their own `path.dirname(fileURLToPath(import.meta.url))` or `__dirname`\n * respectively, so this module contains no module-system-specific syntax and\n * compiles correctly under both `module: NodeNext` and `module: CommonJS`.\n *\n * Design note — eager-init vs lazy resolution:\n * An alternative would be to resolve the statics path lazily inside\n * getStaticFilePath() on first call (eliminating _initStaticsRoot and the\n * entry-point coupling entirely).  Eager-init was chosen instead because lazy\n * resolution cannot safely use import.meta.url in a CommonJS build, and\n * __dirname is not available in an ESM build.  The entry-point side-effect\n * approach lets this module stay free of module-system-specific syntax while\n * still capturing the correct anchor directory at load time.\n * @internal\n */\nexport function _initStaticsRoot(dir: string): void {\n  _staticsPath = resolveStaticsPath(dir);\n}\n\n/**\n * Resolve a path relative to the test-utils statics directory.\n * @param paths - Path segments to join after the statics root.\n * @returns The absolute path to the static fixture.\n */\nexport function getStaticFilePath(...paths: string[]): string {\n  // Guard: entry point must call _initStaticsRoot() before this helper is used.\n  /* v8 ignore next 3 */\n  if (!_staticsPath) {\n    throw new Error('getStaticFilePath() called before the package entry point initialised the statics root');\n  }\n  return path.join(_staticsPath, ...paths);\n}\n"]}

package/dist/cjs/lib/indexCjs.js

@@ -0,0 +1,31 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+exports.getStaticFilePath = void 0;
+const utils_js_1 = require("./generators/utils.js");
+// Initialise the statics root using __dirname (the directory of this compiled
+// CJS file) so that the walk-up in utils.ts lands on the correct package root.
+// This side-effect runs before any re-exported functions are called.
+(0, utils_js_1._initStaticsRoot)(__dirname);
+__exportStar(require("./matchers/toEqualParsedQuery.js"), exports);
+__exportStar(require("./matchers/vitest.js"), exports);
+__exportStar(require("./generators/generators.js"), exports);
+__exportStar(require("./generators/algebraGenerators.js"), exports);
+var utils_js_2 = require("./generators/utils.js");
+Object.defineProperty(exports, "getStaticFilePath", { enumerable: true, get: function () { return utils_js_2.getStaticFilePath; } });
+__exportStar(require("./Sparql11NotesTest.js"), exports);
+__exportStar(require("./fileUtils.js"), exports);
+//# sourceMappingURL=indexCjs.js.map

package/dist/cjs/lib/indexCjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexCjs.js","sourceRoot":"","sources":["../../../lib/indexCjs.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oDAAyD;AAEzD,8EAA8E;AAC9E,+EAA+E;AAC/E,qEAAqE;AACrE,IAAA,2BAAgB,EAAC,SAAS,CAAC,CAAC;AAE5B,mEAAiD;AACjD,uDAAqC;AACrC,6DAA2C;AAC3C,oEAAkD;AAClD,kDAA0D;AAAjD,6GAAA,iBAAiB,OAAA;AAC1B,yDAAuC;AACvC,iDAA+B","sourcesContent":["import { _initStaticsRoot } from './generators/utils.js';\n\n// Initialise the statics root using __dirname (the directory of this compiled\n// CJS file) so that the walk-up in utils.ts lands on the correct package root.\n// This side-effect runs before any re-exported functions are called.\n_initStaticsRoot(__dirname);\n\nexport * from './matchers/toEqualParsedQuery.js';\nexport * from './matchers/vitest.js';\nexport * from './generators/generators.js';\nexport * from './generators/algebraGenerators.js';\nexport { getStaticFilePath } from './generators/utils.js';\nexport * from './Sparql11NotesTest.js';\nexport * from './fileUtils.js';\n"]}

package/dist/esm/lib/generators/algebraGenerators.js

@@ -3,16 +3,32 @@ import { lstatSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
 import { readFile, readFileSync } from '../fileUtils.js';
 import { getStaticFilePath } from './utils.js';
-const rootDir = getStaticFilePath('algebra');
-const rootSparql = join(rootDir, 'sparql');
-const rootJson = join(rootDir, 'algebra');
-const rootJsonBlankToVariable = join(rootDir, 'algebra-blank-to-var');
-const rootCanonicalSparql = join(rootDir, 'canonical-sparql', 'base');
-const rootCanonicalSparqlBlankToVar = join(rootDir, 'canonical-sparql', 'blank-to-var');
+// Computed lazily inside each generator so that getStaticFilePath() is not
+// called at module-evaluation time.  This avoids an ESM initialisation-order
+// issue where algebraGenerators.js would execute before index.ts has had a
+// chance to call _initStaticsRoot().
+function getRootDir() {
+    return getStaticFilePath('algebra');
+}
+function getRootSparql() {
+    return join(getRootDir(), 'sparql');
+}
+function getRootJson() {
+    return join(getRootDir(), 'algebra');
+}
+function getRootJsonBlankToVariable() {
+    return join(getRootDir(), 'algebra-blank-to-var');
+}
+function getRootCanonicalSparql() {
+    return join(getRootDir(), 'canonical-sparql', 'base');
+}
+function getRootCanonicalSparqlBlankToVar() {
+    return join(getRootDir(), 'canonical-sparql', 'blank-to-var');
+}
 export function* sparqlAlgebraTests(suite, blankToVariable, getSPARQL) {
     // Relative path starting from roots declared above.
     function* subGen(relativePath) {
-        const absolutePath = join(blankToVariable ? rootJsonBlankToVariable : rootJson, relativePath);
+        const absolutePath = join(blankToVariable ? getRootJsonBlankToVariable() : getRootJson(), relativePath);
         if (lstatSync(absolutePath).isDirectory()) {
             // Recursion
             for (const sub of readdirSync(absolutePath)) {
@@ -21,8 +37,8 @@ export function* sparqlAlgebraTests(suite, blankToVariable, getSPARQL) {
         }
         else {
             const name = relativePath.replace(/\.json$/u, '');
-            const sparqlPath = join(rootSparql, relativePath.replace(/\.json/u, '.sparql'));
-            const canonicalSparqlPath = join(blankToVariable ? rootCanonicalSparqlBlankToVar : rootCanonicalSparql, relativePath.replace(/\.json/u, '.sparql'));
+            const sparqlPath = join(getRootSparql(), relativePath.replace(/\.json/u, '.sparql'));
+            const canonicalSparqlPath = join(blankToVariable ? getRootCanonicalSparqlBlankToVar() : getRootCanonicalSparql(), relativePath.replace(/\.json/u, '.sparql'));
             yield {
                 name,
                 json: JSON.parse(readFileSync(absolutePath)),
@@ -32,7 +48,7 @@ export function* sparqlAlgebraTests(suite, blankToVariable, getSPARQL) {
             };
         }
     }
-    const subfolders = readdirSync(blankToVariable ? rootJsonBlankToVariable : rootJson);
+    const subfolders = readdirSync(blankToVariable ? getRootJsonBlankToVariable() : getRootJson());
     if (subfolders.includes(suite)) {
         yield* subGen(suite);
     }
@@ -43,7 +59,7 @@ export function* sparqlAlgebraTests(suite, blankToVariable, getSPARQL) {
  */
 export function* sparqlQueries(suite) {
     function* subGen(relativePath) {
-        const absolutePath = join(rootSparql, relativePath);
+        const absolutePath = join(getRootSparql(), relativePath);
         if (lstatSync(absolutePath).isDirectory()) {
             // Recursion
             for (const sub of readdirSync(absolutePath)) {
@@ -59,7 +75,7 @@ export function* sparqlQueries(suite) {
             };
         }
     }
-    const subfolders = readdirSync(rootSparql);
+    const subfolders = readdirSync(getRootSparql());
     if (subfolders.includes(suite)) {
         yield* subGen(suite);
     }

package/dist/esm/lib/generators/algebraGenerators.js.map

@@ -1 +1 @@
-{"version":3,"file":"algebraGenerators.js","sourceRoot":"","sources":["../../../../lib/generators/algebraGenerators.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable import/no-nodejs-modules */\nimport { lstatSync, readdirSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { readFile, readFileSync } from '../fileUtils.js';\nimport type { NegativeTest } from './generators.js';\nimport { getStaticFilePath } from './utils.js';\n\nconst rootDir = getStaticFilePath('algebra');\nconst rootSparql = join(rootDir, 'sparql');\nconst rootJson = join(rootDir, 'algebra');\nconst rootJsonBlankToVariable = join(rootDir, 'algebra-blank-to-var');\nconst rootCanonicalSparql = join(rootDir, 'canonical-sparql', 'base');\nconst rootCanonicalSparqlBlankToVar = join(rootDir, 'canonical-sparql', 'blank-to-var');\n\nexport interface algebraTestGen {\n  name: string;\n  json: unknown;\n  quads: boolean;\n  sparql: string | undefined;\n  canonicalSparql: string | undefined;\n}\n\nexport type AlgebraTestSuite = 'dawg-syntax' | 'sparql-1.1' | 'sparql11-query' | 'sparql12';\n\n/**\n * Yields algebra-level test cases from the static test fixtures.\n * Each test provides a SPARQL query, expected algebra JSON, and optionally a canonical SPARQL string.\n * @param suite - The test suite to iterate.\n * @param blankToVariable - Whether to use the blank-to-variable fixture variant.\n * @param getSPARQL - Whether to load the SPARQL and canonical SPARQL strings.\n */\nexport function sparqlAlgebraTests(suite: AlgebraTestSuite, blankToVariable: boolean, getSPARQL: true):\nGenerator<algebraTestGen & { sparql: string; canonicalSparql: string }>;\nexport function sparqlAlgebraTests(suite: AlgebraTestSuite, blankToVariable: boolean, getSPARQL: boolean):\nGenerator<algebraTestGen>;\nexport function* sparqlAlgebraTests(suite: AlgebraTestSuite, blankToVariable: boolean, getSPARQL: boolean):\nGenerator<algebraTestGen> {\n  // Relative path starting from roots declared above.\n  function* subGen(relativePath: string): Generator<algebraTestGen> {\n    const absolutePath = join(blankToVariable ? rootJsonBlankToVariable : rootJson, relativePath);\n    if (lstatSync(absolutePath).isDirectory()) {\n      // Recursion\n      for (const sub of readdirSync(absolutePath)) {\n        yield* subGen(join(relativePath, sub));\n      }\n    } else {\n      const name = relativePath.replace(/\\.json$/u, '');\n      const sparqlPath = join(rootSparql, relativePath.replace(/\\.json/u, '.sparql'));\n      const canonicalSparqlPath = join(\n        blankToVariable ? rootCanonicalSparqlBlankToVar : rootCanonicalSparql,\n        relativePath.replace(/\\.json/u, '.sparql'),\n      );\n      yield {\n        name,\n        json: JSON.parse(readFileSync(absolutePath)),\n        sparql: getSPARQL ? readFileSync(sparqlPath, 'utf8') : undefined,\n        canonicalSparql: getSPARQL ? readFileSync(canonicalSparqlPath, 'utf-8') : undefined,\n        quads: name.endsWith('-quads'),\n      };\n    }\n  }\n\n  const subfolders = readdirSync(blankToVariable ? rootJsonBlankToVariable : rootJson);\n  if (subfolders.includes(suite)) {\n    yield* subGen(suite);\n  }\n}\n\ntype GenQuery = { query: string; name: string };\n/**\n * Yields raw SPARQL query strings from the static test fixtures for a given suite.\n * @param suite - The test suite to iterate.\n */\nexport function* sparqlQueries(suite: AlgebraTestSuite): Generator<GenQuery> {\n  function* subGen(relativePath: string): Generator<GenQuery> {\n    const absolutePath = join(rootSparql, relativePath);\n    if (lstatSync(absolutePath).isDirectory()) {\n      // Recursion\n      for (const sub of readdirSync(absolutePath)) {\n        yield* subGen(join(relativePath, sub));\n      }\n    } else {\n      const name = relativePath.replace(/\\.sparql$/u, '');\n      const content = readFileSync(absolutePath, 'utf-8');\n      yield {\n        name,\n        query: content.replaceAll(/\\r?\\n/gu, '\\n'),\n      };\n    }\n  }\n\n  const subfolders = readdirSync(rootSparql);\n  if (subfolders.includes(suite)) {\n    yield* subGen(suite);\n  }\n}\n\nexport type NegativeAlgebraSuite = 'sparql-1.1-negative' | 'sparql-1.2-negative';\n\n/**\n * Yields test cases for negative (invalid) algebra-level tests.\n * Each test provides a SPARQL query that should fail during algebra transformation.\n * @param suite - The negative test suite to iterate.\n * @param filter - Optional filter predicate applied to the test file name.\n */\nexport function* sparqlAlgebraNegativeTests(\n  suite: NegativeAlgebraSuite,\n  filter?: (name: string) => boolean,\n): Generator<NegativeTest> {\n  const astDir = getStaticFilePath('algebra');\n  const sparqlDir = join(astDir, 'sparql', suite);\n  const statics = readdirSync(sparqlDir);\n  for (const file of statics.filter(f => f.endsWith('.sparql'))) {\n    if (filter && !filter(file.replace('.sparql', ''))) {\n      continue;\n    }\n    const name = file.replace(/\\.sparql$/u, '');\n    yield {\n      name,\n      statics: async() => {\n        const query = await readFile(join(sparqlDir, file));\n        return {\n          query,\n        };\n      },\n    };\n  }\n}\n"]}
+{"version":3,"file":"algebraGenerators.js","sourceRoot":"","sources":["../../../../lib/generators/algebraGenerators.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable import/no-nodejs-modules */\nimport { lstatSync, readdirSync } from 'node:fs';\nimport { join } from 'node:path';\nimport { readFile, readFileSync } from '../fileUtils.js';\nimport type { NegativeTest } from './generators.js';\nimport { getStaticFilePath } from './utils.js';\n\n// Computed lazily inside each generator so that getStaticFilePath() is not\n// called at module-evaluation time.  This avoids an ESM initialisation-order\n// issue where algebraGenerators.js would execute before index.ts has had a\n// chance to call _initStaticsRoot().\nfunction getRootDir(): string {\n  return getStaticFilePath('algebra');\n}\nfunction getRootSparql(): string {\n  return join(getRootDir(), 'sparql');\n}\nfunction getRootJson(): string {\n  return join(getRootDir(), 'algebra');\n}\nfunction getRootJsonBlankToVariable(): string {\n  return join(getRootDir(), 'algebra-blank-to-var');\n}\nfunction getRootCanonicalSparql(): string {\n  return join(getRootDir(), 'canonical-sparql', 'base');\n}\nfunction getRootCanonicalSparqlBlankToVar(): string {\n  return join(getRootDir(), 'canonical-sparql', 'blank-to-var');\n}\n\nexport interface algebraTestGen {\n  name: string;\n  json: unknown;\n  quads: boolean;\n  sparql: string | undefined;\n  canonicalSparql: string | undefined;\n}\n\nexport type AlgebraTestSuite = 'dawg-syntax' | 'sparql-1.1' | 'sparql11-query' | 'sparql12';\n\n/**\n * Yields algebra-level test cases from the static test fixtures.\n * Each test provides a SPARQL query, expected algebra JSON, and optionally a canonical SPARQL string.\n * @param suite - The test suite to iterate.\n * @param blankToVariable - Whether to use the blank-to-variable fixture variant.\n * @param getSPARQL - Whether to load the SPARQL and canonical SPARQL strings.\n */\nexport function sparqlAlgebraTests(suite: AlgebraTestSuite, blankToVariable: boolean, getSPARQL: true):\nGenerator<algebraTestGen & { sparql: string; canonicalSparql: string }>;\nexport function sparqlAlgebraTests(suite: AlgebraTestSuite, blankToVariable: boolean, getSPARQL: boolean):\nGenerator<algebraTestGen>;\nexport function* sparqlAlgebraTests(suite: AlgebraTestSuite, blankToVariable: boolean, getSPARQL: boolean):\nGenerator<algebraTestGen> {\n  // Relative path starting from roots declared above.\n  function* subGen(relativePath: string): Generator<algebraTestGen> {\n    const absolutePath = join(blankToVariable ? getRootJsonBlankToVariable() : getRootJson(), relativePath);\n    if (lstatSync(absolutePath).isDirectory()) {\n      // Recursion\n      for (const sub of readdirSync(absolutePath)) {\n        yield* subGen(join(relativePath, sub));\n      }\n    } else {\n      const name = relativePath.replace(/\\.json$/u, '');\n      const sparqlPath = join(getRootSparql(), relativePath.replace(/\\.json/u, '.sparql'));\n      const canonicalSparqlPath = join(\n        blankToVariable ? getRootCanonicalSparqlBlankToVar() : getRootCanonicalSparql(),\n        relativePath.replace(/\\.json/u, '.sparql'),\n      );\n      yield {\n        name,\n        json: JSON.parse(readFileSync(absolutePath)),\n        sparql: getSPARQL ? readFileSync(sparqlPath, 'utf8') : undefined,\n        canonicalSparql: getSPARQL ? readFileSync(canonicalSparqlPath, 'utf-8') : undefined,\n        quads: name.endsWith('-quads'),\n      };\n    }\n  }\n\n  const subfolders = readdirSync(blankToVariable ? getRootJsonBlankToVariable() : getRootJson());\n  if (subfolders.includes(suite)) {\n    yield* subGen(suite);\n  }\n}\n\ntype GenQuery = { query: string; name: string };\n/**\n * Yields raw SPARQL query strings from the static test fixtures for a given suite.\n * @param suite - The test suite to iterate.\n */\nexport function* sparqlQueries(suite: AlgebraTestSuite): Generator<GenQuery> {\n  function* subGen(relativePath: string): Generator<GenQuery> {\n    const absolutePath = join(getRootSparql(), relativePath);\n    if (lstatSync(absolutePath).isDirectory()) {\n      // Recursion\n      for (const sub of readdirSync(absolutePath)) {\n        yield* subGen(join(relativePath, sub));\n      }\n    } else {\n      const name = relativePath.replace(/\\.sparql$/u, '');\n      const content = readFileSync(absolutePath, 'utf-8');\n      yield {\n        name,\n        query: content.replaceAll(/\\r?\\n/gu, '\\n'),\n      };\n    }\n  }\n\n  const subfolders = readdirSync(getRootSparql());\n  if (subfolders.includes(suite)) {\n    yield* subGen(suite);\n  }\n}\n\nexport type NegativeAlgebraSuite = 'sparql-1.1-negative' | 'sparql-1.2-negative';\n\n/**\n * Yields test cases for negative (invalid) algebra-level tests.\n * Each test provides a SPARQL query that should fail during algebra transformation.\n * @param suite - The negative test suite to iterate.\n * @param filter - Optional filter predicate applied to the test file name.\n */\nexport function* sparqlAlgebraNegativeTests(\n  suite: NegativeAlgebraSuite,\n  filter?: (name: string) => boolean,\n): Generator<NegativeTest> {\n  const astDir = getStaticFilePath('algebra');\n  const sparqlDir = join(astDir, 'sparql', suite);\n  const statics = readdirSync(sparqlDir);\n  for (const file of statics.filter(f => f.endsWith('.sparql'))) {\n    if (filter && !filter(file.replace('.sparql', ''))) {\n      continue;\n    }\n    const name = file.replace(/\\.sparql$/u, '');\n    yield {\n      name,\n      statics: async() => {\n        const query = await readFile(join(sparqlDir, file));\n        return {\n          query,\n        };\n      },\n    };\n  }\n}\n"]}

package/dist/esm/lib/generators/utils.d.ts

@@ -1,3 +1,23 @@
+/**
+ * Initialises the statics root from the directory of the package entry point.
+ * Must be called before any test fixture helpers are invoked.
+ *
+ * The package entry points (index.ts for ESM, index.cts for CJS) call this
+ * with their own `path.dirname(fileURLToPath(import.meta.url))` or `__dirname`
+ * respectively, so this module contains no module-system-specific syntax and
+ * compiles correctly under both `module: NodeNext` and `module: CommonJS`.
+ *
+ * Design note — eager-init vs lazy resolution:
+ * An alternative would be to resolve the statics path lazily inside
+ * getStaticFilePath() on first call (eliminating _initStaticsRoot and the
+ * entry-point coupling entirely).  Eager-init was chosen instead because lazy
+ * resolution cannot safely use import.meta.url in a CommonJS build, and
+ * __dirname is not available in an ESM build.  The entry-point side-effect
+ * approach lets this module stay free of module-system-specific syntax while
+ * still capturing the correct anchor directory at load time.
+ * @internal
+ */
+export declare function _initStaticsRoot(dir: string): void;
 /**
  * Resolve a path relative to the test-utils statics directory.
  * @param paths - Path segments to join after the statics root.

package/dist/esm/lib/generators/utils.js

@@ -1,14 +1,65 @@
 /* eslint-disable import/no-nodejs-modules */
+import { existsSync } from 'node:fs';
 import path from 'node:path';
-// Path.resolve() returns process.cwd() — the monorepo root when running via vitest.
-// This avoids __dirname (CJS-only) and import.meta.url (ESM-only).
-const staticsPath = path.resolve('packages/test-utils/statics');
+/**
+ * Walk up the directory tree from startDir until a directory that contains
+ * both a `package.json` and a `statics` folder is found.  Stopping at the
+ * package-root boundary avoids the risk of matching an unrelated `statics/`
+ * folder higher up the filesystem.
+ */
+function resolveStaticsPath(startDir) {
+    let dir = startDir;
+    while (true) {
+        if (existsSync(path.join(dir, 'statics')) && existsSync(path.join(dir, 'package.json'))) {
+            return path.join(dir, 'statics');
+        }
+        const parent = path.dirname(dir);
+        // Guard: filesystem root reached before finding a package boundary — unreachable in practice.
+        /* v8 ignore next 3 */
+        if (parent === dir) {
+            break;
+        }
+        dir = parent;
+    }
+    // Guard: statics not found even after reaching the filesystem root — unreachable in practice.
+    /* v8 ignore next */
+    throw new Error(`Cannot locate statics/ directory (with co-located package.json) starting from ${startDir}`);
+}
+// Resolved on demand after the package entry point calls _initStaticsRoot().
+let _staticsPath;
+/**
+ * Initialises the statics root from the directory of the package entry point.
+ * Must be called before any test fixture helpers are invoked.
+ *
+ * The package entry points (index.ts for ESM, index.cts for CJS) call this
+ * with their own `path.dirname(fileURLToPath(import.meta.url))` or `__dirname`
+ * respectively, so this module contains no module-system-specific syntax and
+ * compiles correctly under both `module: NodeNext` and `module: CommonJS`.
+ *
+ * Design note — eager-init vs lazy resolution:
+ * An alternative would be to resolve the statics path lazily inside
+ * getStaticFilePath() on first call (eliminating _initStaticsRoot and the
+ * entry-point coupling entirely).  Eager-init was chosen instead because lazy
+ * resolution cannot safely use import.meta.url in a CommonJS build, and
+ * __dirname is not available in an ESM build.  The entry-point side-effect
+ * approach lets this module stay free of module-system-specific syntax while
+ * still capturing the correct anchor directory at load time.
+ * @internal
+ */
+export function _initStaticsRoot(dir) {
+    _staticsPath = resolveStaticsPath(dir);
+}
 /**
  * Resolve a path relative to the test-utils statics directory.
  * @param paths - Path segments to join after the statics root.
  * @returns The absolute path to the static fixture.
  */
 export function getStaticFilePath(...paths) {
-    return path.join(staticsPath, ...paths);
+    // Guard: entry point must call _initStaticsRoot() before this helper is used.
+    /* v8 ignore next 3 */
+    if (!_staticsPath) {
+        throw new Error('getStaticFilePath() called before the package entry point initialised the statics root');
+    }
+    return path.join(_staticsPath, ...paths);
 }
 //# sourceMappingURL=utils.js.map

package/dist/esm/lib/generators/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../lib/generators/utils.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,oFAAoF;AACpF,mEAAmE;AACnE,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,6BAA6B,CAAC,CAAC;AAEhE;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAG,KAAe;IAClD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,GAAG,KAAK,CAAC,CAAC;AAC1C,CAAC","sourcesContent":["/* eslint-disable import/no-nodejs-modules */\nimport path from 'node:path';\n\n// Path.resolve() returns process.cwd() — the monorepo root when running via vitest.\n// This avoids __dirname (CJS-only) and import.meta.url (ESM-only).\nconst staticsPath = path.resolve('packages/test-utils/statics');\n\n/**\n * Resolve a path relative to the test-utils statics directory.\n * @param paths - Path segments to join after the statics root.\n * @returns The absolute path to the static fixture.\n */\nexport function getStaticFilePath(...paths: string[]): string {\n  return path.join(staticsPath, ...paths);\n}\n"]}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../lib/generators/utils.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;GAKG;AACH,SAAS,kBAAkB,CAAC,QAAgB;IAC1C,IAAI,GAAG,GAAG,QAAQ,CAAC;IACnB,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YACxF,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;QACnC,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,8FAA8F;QAC9F,sBAAsB;QACtB,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,MAAM;QACR,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,8FAA8F;IAC9F,oBAAoB;IACpB,MAAM,IAAI,KAAK,CAAC,iFAAiF,QAAQ,EAAE,CAAC,CAAC;AAC/G,CAAC;AAED,6EAA6E;AAC7E,IAAI,YAAgC,CAAC;AAErC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,YAAY,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAG,KAAe;IAClD,8EAA8E;IAC9E,sBAAsB;IACtB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,IAAI,KAAK,CAAC,wFAAwF,CAAC,CAAC;IAC5G,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,KAAK,CAAC,CAAC;AAC3C,CAAC","sourcesContent":["/* eslint-disable import/no-nodejs-modules */\nimport { existsSync } from 'node:fs';\nimport path from 'node:path';\n\n/**\n * Walk up the directory tree from startDir until a directory that contains\n * both a `package.json` and a `statics` folder is found.  Stopping at the\n * package-root boundary avoids the risk of matching an unrelated `statics/`\n * folder higher up the filesystem.\n */\nfunction resolveStaticsPath(startDir: string): string {\n  let dir = startDir;\n  while (true) {\n    if (existsSync(path.join(dir, 'statics')) && existsSync(path.join(dir, 'package.json'))) {\n      return path.join(dir, 'statics');\n    }\n    const parent = path.dirname(dir);\n    // Guard: filesystem root reached before finding a package boundary — unreachable in practice.\n    /* v8 ignore next 3 */\n    if (parent === dir) {\n      break;\n    }\n    dir = parent;\n  }\n  // Guard: statics not found even after reaching the filesystem root — unreachable in practice.\n  /* v8 ignore next */\n  throw new Error(`Cannot locate statics/ directory (with co-located package.json) starting from ${startDir}`);\n}\n\n// Resolved on demand after the package entry point calls _initStaticsRoot().\nlet _staticsPath: string | undefined;\n\n/**\n * Initialises the statics root from the directory of the package entry point.\n * Must be called before any test fixture helpers are invoked.\n *\n * The package entry points (index.ts for ESM, index.cts for CJS) call this\n * with their own `path.dirname(fileURLToPath(import.meta.url))` or `__dirname`\n * respectively, so this module contains no module-system-specific syntax and\n * compiles correctly under both `module: NodeNext` and `module: CommonJS`.\n *\n * Design note — eager-init vs lazy resolution:\n * An alternative would be to resolve the statics path lazily inside\n * getStaticFilePath() on first call (eliminating _initStaticsRoot and the\n * entry-point coupling entirely).  Eager-init was chosen instead because lazy\n * resolution cannot safely use import.meta.url in a CommonJS build, and\n * __dirname is not available in an ESM build.  The entry-point side-effect\n * approach lets this module stay free of module-system-specific syntax while\n * still capturing the correct anchor directory at load time.\n * @internal\n */\nexport function _initStaticsRoot(dir: string): void {\n  _staticsPath = resolveStaticsPath(dir);\n}\n\n/**\n * Resolve a path relative to the test-utils statics directory.\n * @param paths - Path segments to join after the statics root.\n * @returns The absolute path to the static fixture.\n */\nexport function getStaticFilePath(...paths: string[]): string {\n  // Guard: entry point must call _initStaticsRoot() before this helper is used.\n  /* v8 ignore next 3 */\n  if (!_staticsPath) {\n    throw new Error('getStaticFilePath() called before the package entry point initialised the statics root');\n  }\n  return path.join(_staticsPath, ...paths);\n}\n"]}

package/dist/esm/lib/index.d.ts

@@ -2,6 +2,6 @@ export * from './matchers/toEqualParsedQuery.js';
 export * from './matchers/vitest.js';
 export * from './generators/generators.js';
 export * from './generators/algebraGenerators.js';
-export * from './generators/utils.js';
+export { getStaticFilePath } from './generators/utils.js';
 export * from './Sparql11NotesTest.js';
 export * from './fileUtils.js';

package/dist/esm/lib/index.js

@@ -1,8 +1,17 @@
+/* eslint-disable import/no-nodejs-modules */
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { _initStaticsRoot } from './generators/utils.js';
+// Initialise the statics root using this file's own location so that the
+// walk-up in utils.ts lands on the correct package root regardless of the
+// install depth.  This side-effect runs before any of the re-exported
+// functions are called by consuming tests.
+_initStaticsRoot(path.dirname(fileURLToPath(import.meta.url)));
 export * from './matchers/toEqualParsedQuery.js';
 export * from './matchers/vitest.js';
 export * from './generators/generators.js';
 export * from './generators/algebraGenerators.js';
-export * from './generators/utils.js';
+export { getStaticFilePath } from './generators/utils.js';
 export * from './Sparql11NotesTest.js';
 export * from './fileUtils.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC","sourcesContent":["export * from './matchers/toEqualParsedQuery.js';\nexport * from './matchers/vitest.js';\nexport * from './generators/generators.js';\nexport * from './generators/algebraGenerators.js';\nexport * from './generators/utils.js';\nexport * from './Sparql11NotesTest.js';\nexport * from './fileUtils.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/index.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,yEAAyE;AACzE,0EAA0E;AAC1E,sEAAsE;AACtE,2CAA2C;AAC3C,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE/D,cAAc,kCAAkC,CAAC;AACjD,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mCAAmC,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC","sourcesContent":["/* eslint-disable import/no-nodejs-modules */\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport { _initStaticsRoot } from './generators/utils.js';\n\n// Initialise the statics root using this file's own location so that the\n// walk-up in utils.ts lands on the correct package root regardless of the\n// install depth.  This side-effect runs before any of the re-exported\n// functions are called by consuming tests.\n_initStaticsRoot(path.dirname(fileURLToPath(import.meta.url)));\n\nexport * from './matchers/toEqualParsedQuery.js';\nexport * from './matchers/vitest.js';\nexport * from './generators/generators.js';\nexport * from './generators/algebraGenerators.js';\nexport { getStaticFilePath } from './generators/utils.js';\nexport * from './Sparql11NotesTest.js';\nexport * from './fileUtils.js';\n"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@traqula/test-utils",
   "type": "module",
-  "version": "1.1.2",
+  "version": "1.1.5",
   "description": "Test utils used by the Traqula monorepo",
   "lsd:module": true,
   "license": "MIT",
@@ -13,7 +13,10 @@
   "bugs": {
     "url": "https://github.com/comunica/traqula/issues"
   },
-  "sideEffects": false,
+  "sideEffects": [
+    "**/index.js",
+    "**/indexCjs.js"
+  ],
   "publishConfig": {
     "access": "public"
   },
@@ -22,7 +25,7 @@
     ".": {
       "types": "./dist/esm/lib/index.d.ts",
       "import": "./dist/esm/lib/index.js",
-      "require": "./dist/cjs/lib/index.js"
+      "require": "./dist/cjs/lib/indexCjs.js"
     }
   },
   "main": "dist/esm/lib/index.js",
@@ -49,5 +52,5 @@
   "devDependencies": {
     "@rdfjs/types": "^2.0.0"
   },
-  "gitHead": "4a8a40e902755a39eab0d9f4f144e2e46d44b4d2"
+  "gitHead": "ca24949dfd7d4b01c42b1c6fdc2d1f70fbee08af"
 }

package/statics/algebra/algebra/sparql12/codepoint-esc-05.json

@@ -0,0 +1,38 @@
+{
+  "type": "project",
+  "input": {
+    "type": "bgp",
+    "patterns": [
+      {
+        "type": "pattern",
+        "termType": "Quad",
+        "subject": {
+          "termType": "NamedNode",
+          "value": "http://example/abc"
+        },
+        "predicate": {
+          "termType": "Variable",
+          "value": "p"
+        },
+        "object": {
+          "termType": "Variable",
+          "value": "o"
+        },
+        "graph": {
+          "termType": "DefaultGraph",
+          "value": ""
+        }
+      }
+    ]
+  },
+  "variables": [
+    {
+      "termType": "Variable",
+      "value": "o"
+    },
+    {
+      "termType": "Variable",
+      "value": "p"
+    }
+  ]
+}