@cldmv/wisp 1.0.0 → 1.0.5

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cldmv/wisp",
-	"version": "1.0.0",
+	"version": "1.0.5",
 	"description": "Version-agnostic JSON importing for Node.js with fallback handling and caller path resolution.",
 	"type": "module",
 	"exports": {
@@ -12,7 +12,7 @@
 	"scripts": {
 		"test": "mocha --recursive \"test/**/*.mjs\"",
 		"test:watch": "mocha --watch \"test/**/*.mjs\"",
-		"lint": "eslint src/",
+		"lint": "eslint --config .configs/eslint.config.mjs .",
 		"build:types": "tsc",
 		"test:types": "tsc --noEmit",
 		"build:ci": "npm run test && npm run build:types && npm run test:types"
@@ -64,10 +64,13 @@
 		"package.json"
 	],
 	"devDependencies": {
-		"mocha": "^10.2.0",
-		"chai": "^4.3.10",
-		"typescript": "^5.2.0",
-		"@types/node": "^20.8.0"
+		"@eslint/js": "^10.0.1",
+		"@types/node": "^26.6.2",
+		"chai": "^6.2.2",
+		"eslint": "^10.10.0",
+		"globals": "^17.12.0",
+		"mocha": "^12.0.1",
+		"typescript": "^6.0.3"
 	},
 	"publishConfig": {
 		"access": "public"

package/src/lib/resolve-from-caller.mjs

@@ -133,13 +133,27 @@ export function getStack(skipFn) {
 }
 
 const THIS_FILE = fileURLToPath(import.meta.url);
-const THIS_DIR = path.dirname(THIS_FILE);
+
+// Find the package root by looking for package.json
+function findPackageRoot(startPath) {
+	let currentPath = startPath;
+	while (currentPath !== path.dirname(currentPath)) {
+		const packageJsonPath = path.join(currentPath, "package.json");
+		if (fs.existsSync(packageJsonPath)) {
+			return currentPath;
+		}
+		currentPath = path.dirname(currentPath);
+	}
+	return null;
+}
+
+const PACKAGE_ROOT = findPackageRoot(THIS_FILE);
 
 /* ---------- base selection (shared) ---------- */
-// Rule you specified:
-// 1) Find the LAST frame whose basename is "slothlet.mjs".
-// 2) Take the NEXT frame; if its basename is "index.[mjs|cjs|js]", take the following one.
-// 3) Fallback: first non-helper frame that isn’t slothlet.mjs.
+// Two-flag state machine for detecting when we've exited package infrastructure:
+// 1) Flag 1: Set when we exit src/ or dist/ directories
+// 2) Flag 2: Set when we exit index.* entry point files
+// 3) Once both flags are set, we've found the actual caller outside the package
 
 /**
  * @function pickPrimaryBaseFile
@@ -148,51 +162,77 @@ const THIS_DIR = path.dirname(THIS_FILE);
  * @returns {string|null} Primary base file path for resolution, null if detection fails
  *
  * @description
- * Find the primary base file using stack trace analysis.
- * Implements sophisticated caller detection algorithm designed for slothlet's module loading patterns.
- * Uses a two-phase approach: locate the last slothlet.mjs frame, then find the actual user code.
+ * Find the primary base file using stack trace analysis with a two-flag state machine.
+ * Tracks when we **exit** from package infrastructure directories/files.
  *
  * Algorithm:
- * 1. Scan stack trace to find the LAST frame whose basename is "slothlet.mjs"
- * 2. Take the NEXT frame after slothlet.mjs
- * 3. If that frame is "index.[mjs|cjs|js]", take the following frame instead
- * 4. Return null if no suitable frame found (fallback will be used)
- *
- * This pattern handles slothlet's loading chain: slothlet.mjs → index.mjs → user-code.mjs
+ * 1. Walk stack trace backwards (from deepest to shallowest calls)
+ * 2. Flag 1: Set when we exit src/ or dist/ folder (transition from src/dist to non-src/dist)
+ * 3. Flag 2: Set when we exit index.* files (transition from index.* to non-index.*)
+ * 4. Once both flags are set, we've fully exited the package infrastructure
+ * 5. Return the current file as the actual caller
  *
  * @example
- * // Stack trace scenario:
- * // 0: pickPrimaryBaseFile() [this function]
- * // 1: resolveWith() [internal helper]
- * // 2: resolvePathFromCaller() [public API]
- * // 3: slothlet.mjs [slothlet loader] ← LAST slothlet.mjs
- * // 4: index.mjs [entry point] ← Skip this
- * // 5: user-code.mjs [actual caller] ← Return this
+ * // Stack trace flow (wisp example):
+ * // 0: src/lib/resolve-from-caller.mjs [in src/]
+ * // 1: src/wisp.mjs [still in src/]
+ * // 2: index.mjs [exited src/ - Flag 1 set]
+ * // 3: user-code.mjs [exited index.* - Flag 2 set, return this!]
  */
 function pickPrimaryBaseFile() {
-	const files = [];
+	let exitedSrcOrDist = false; // Flag 1: Have we exited src/ or dist/?
+	// This function's own docstring documents a "Flag 2 set, return this!"
+	// scenario, but nothing reads exitedIndex to return early once it's set --
+	// looks like a pre-existing gap between the documented intent and the
+	// implementation. Left as-is; fixing the behavior is a separate decision
+	// from unblocking lint.
+	let exitedIndex = false; // Flag 2: Have we exited index.*?
+	let previousWasInSrcOrDist = false;
+	let previousWasIndex = false;
+
 	for (const cs of getStack(pickPrimaryBaseFile)) {
 		const f = toFsPath(cs?.getFileName?.());
 		if (!f) continue;
 		if (f.startsWith?.("node:internal")) continue;
-		files.push(f);
-	}
+		if (f === THIS_FILE) continue;
 
-	let iSloth = -1;
-	for (let i = 0; i < files.length; i++) {
-		if (path.basename(files[i]).toLowerCase() === "slothlet.mjs") iSloth = i;
-	}
-	if (iSloth !== -1) {
-		const j = iSloth + 1;
-		if (j < files.length) {
-			const b = path.basename(files[j]).toLowerCase();
-			if (/^index\.(mjs|cjs|js)$/.test(b) && j + 1 < files.length) return files[j + 1];
-			return files[j];
+		let currentIsInSrcOrDist = false;
+		let currentIsIndex = false;
+
+		// Check if this file is in our package
+		if (PACKAGE_ROOT && f.startsWith(PACKAGE_ROOT + path.sep)) {
+			const relativePath = path.relative(PACKAGE_ROOT, f);
+			const segments = relativePath.split(path.sep);
+
+			// Check if current file is in src/ or dist/
+			currentIsInSrcOrDist = segments[0] === "src" || segments[0] === "dist";
+
+			// Check if current file is index.*
+			currentIsIndex = segments.length === 1 && /^index\.(mjs|cjs|js|ts)$/.test(segments[0]);
 		}
+
+		// Flag 1: Check if we've exited src/dist (was in, now not in)
+		if (previousWasInSrcOrDist && !currentIsInSrcOrDist) {
+			exitedSrcOrDist = true;
+		}
+
+		// Flag 2: Check if we've exited index.* (was index, now not index)
+		if (previousWasIndex && !currentIsIndex) {
+			// eslint-disable-next-line no-unused-vars -- see the declaration above
+			exitedIndex = true;
+		}
+
+		// If we've exited src/dist, we've found the caller (index.mjs might be optimized away)
+		if (exitedSrcOrDist) {
+			return f;
+		}
+
+		// Update previous state for next iteration
+		previousWasInSrcOrDist = currentIsInSrcOrDist;
+		previousWasIndex = currentIsIndex;
 	}
 	return null;
 }
-
 /**
  * @function pickFallbackBaseFile
  * @internal
@@ -222,13 +262,12 @@ function pickPrimaryBaseFile() {
  * // - Direct API usage without slothlet loader
  */
 function pickFallbackBaseFile() {
+	// Use simpler fallback logic - just find first non-Node.js-internal file
 	for (const cs of getStack(pickFallbackBaseFile)) {
 		const f = toFsPath(cs?.getFileName?.());
 		if (!f) continue;
 		if (f.startsWith?.("node:internal")) continue;
 		if (f === THIS_FILE) continue;
-		if (f.startsWith(THIS_DIR + path.sep)) continue; // helper’s own dir
-		if (path.basename(f).toLowerCase() === "slothlet.mjs") continue;
 		return f;
 	}
 	return THIS_FILE;

package/src/wisp.mjs

@@ -90,14 +90,15 @@ export async function wisp(input, options = {}) {
 			try {
 				validate(val);
 			} catch (e) {
-				throw new Error(`@cldmv/wisp: ${e?.message ?? e}`);
+				throw new Error(`@cldmv/wisp: ${e?.message ?? e}`, { cause: e });
 			}
 		}
 		return val;
 	} catch {}
 
 	try {
-		const mod = await import(url.href, { assert: { type } });
+		// Legacy import assertions (`assert`) for Node 16.14-20.9, which predate `with`; the cast keeps the type checker from rejecting the key.
+		const mod = await import(url.href, /** @type {any} */ ({ assert: { type } }));
 		if (!reviver && !validate) return mod?.default ?? mod;
 		let val = deepClone(mod?.default ?? mod);
 		if (reviver) val = JSON.parse(JSON.stringify(val), reviver);
@@ -105,7 +106,7 @@ export async function wisp(input, options = {}) {
 			try {
 				validate(val);
 			} catch (e) {
-				throw new Error(`@cldmv/wisp: ${e?.message ?? e}`);
+				throw new Error(`@cldmv/wisp: ${e?.message ?? e}`, { cause: e });
 			}
 		}
 		return val;
@@ -119,7 +120,7 @@ export async function wisp(input, options = {}) {
 				try {
 					validate(val);
 				} catch (e) {
-					throw new Error(`@cldmv/wisp: ${e?.message ?? e}`);
+					throw new Error(`@cldmv/wisp: ${e?.message ?? e}`, { cause: e });
 				}
 			}
 			return val;
@@ -127,7 +128,7 @@ export async function wisp(input, options = {}) {
 			if (fallback) {
 				return wisp(fallback, options);
 			}
-			throw new Error(`@cldmv/wisp: Failed to load JSON file at ${url.href}: ${e.message}`);
+			throw new Error(`@cldmv/wisp: Failed to load JSON file at ${url.href}: ${e.message}`, { cause: e });
 		}
 	}
 
@@ -154,7 +155,7 @@ export async function wisp(input, options = {}) {
  * const data = wispSync('./config.json');
  */
 export function wispSync(input, options = {}) {
-	const { base, validate, reviver, type = "json", fallback } = options;
+	const { base, validate, reviver, fallback } = options;
 	let url;
 	if (input instanceof URL) url = input;
 	else {
@@ -172,7 +173,7 @@ export function wispSync(input, options = {}) {
 			try {
 				validate(val);
 			} catch (e) {
-				throw new Error(`@cldmv/wisp: ${e?.message ?? e}`);
+				throw new Error(`@cldmv/wisp: ${e?.message ?? e}`, { cause: e });
 			}
 		}
 		return val;
@@ -180,7 +181,7 @@ export function wispSync(input, options = {}) {
 		if (fallback) {
 			return wispSync(fallback, options);
 		}
-		throw new Error(`@cldmv/wisp: Failed to load JSON file at ${url.href}: ${e.message}`);
+		throw new Error(`@cldmv/wisp: Failed to load JSON file at ${url.href}: ${e.message}`, { cause: e });
 	}
 }
 

package/types/lib/resolve-from-caller.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-from-caller.d.mts","sourceRoot":"","sources":["../../src/lib/resolve-from-caller.mjs"],"names":[],"mappings":"AAqFA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,6CAhCa,KAAK,CAAC,QAAQ,CAAC,CA0C3B;AAqKD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,2CAzCW,MAAM,GACJ,MAAM,CAsDlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,0CA1CW,MAAM,GACJ,MAAM,CAuDlB;AA/UM,4BAvBI,GAAG,GACD,MAAM,GAAC,IAAI,CAsB+F;;iBAmVzG,MAAY,MAAM,GAAC,SAAS;mBAC5B,MAAY,MAAM,GAAC,SAAS;qBAC5B,MAAY,MAAM,GAAC,SAAS;iBAC5B,MAAY,MAAM,GAAC,SAAS;mBAC5B,MAAY,MAAM,GAAC,SAAS;8BAC5B,MAAY,MAAM,GAAC,SAAS;qBAC5B,MAAY,MAAM,GAAC,SAAS;cAC5B,MAAY,OAAO,GAAC,SAAS;YAC7B,MAAY,OAAO,GAAC,SAAS;mBAC7B,MAAY,OAAO,GAAC,SAAS;gBAC7B,MAAY,OAAO,GAAC,SAAS;aAC7B,MAAY,OAAO,GAAC,SAAS;kBAC7B,MAAY,OAAO,GAAC,SAAS;qBAC7B,MAAY,MAAM,GAAC,SAAS"}
+{"version":3,"file":"resolve-from-caller.d.mts","sourceRoot":"","sources":["../../src/lib/resolve-from-caller.mjs"],"names":[],"mappings":"AAqFA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,6CAhCa,KAAK,CAAC,QAAQ,CAAC,CA0C3B;AA4MD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,2CAzCW,MAAM,GACJ,MAAM,CAsDlB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,0CA1CW,MAAM,GACJ,MAAM,CAuDlB;AAtXM,4BAvBI,GAAG,GACD,MAAM,GAAC,IAAI,CAsB+F;;iBA0XzG,MAAY,MAAM,GAAC,SAAS;mBAC5B,MAAY,MAAM,GAAC,SAAS;qBAC5B,MAAY,MAAM,GAAC,SAAS;iBAC5B,MAAY,MAAM,GAAC,SAAS;mBAC5B,MAAY,MAAM,GAAC,SAAS;8BAC5B,MAAY,MAAM,GAAC,SAAS;qBAC5B,MAAY,MAAM,GAAC,SAAS;cAC5B,MAAY,OAAO,GAAC,SAAS;YAC7B,MAAY,OAAO,GAAC,SAAS;mBAC7B,MAAY,OAAO,GAAC,SAAS;gBAC7B,MAAY,OAAO,GAAC,SAAS;aAC7B,MAAY,OAAO,GAAC,SAAS;kBAC7B,MAAY,OAAO,GAAC,SAAS;qBAC7B,MAAY,MAAM,GAAC,SAAS"}

package/types/wisp.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"wisp.d.mts","sourceRoot":"","sources":["../src/wisp.mjs"],"names":[],"mappings":"AAmDA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,4BAjBW,MAAM,GAAC,GAAG,YAElB;IAA6B,IAAI,GAAzB,MAAM,GAAC,GAAG;IACmB,QAAQ,GAArC,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI;IACoC,OAAO,GAA7D,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG;IAC1B,IAAI,GAArB,MAAM;IACe,QAAQ,GAA7B,MAAM,GAAC,GAAG;CAClB,GAAU,OAAO,CAAC,GAAC,CAAC,CAyEtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,gCAhBW,MAAM,GAAC,GAAG,YAElB;IAA6B,IAAI,GAAzB,MAAM,GAAC,GAAG;IACmB,QAAQ,GAArC,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI;IACoC,OAAO,GAA7D,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG;IAC1B,IAAI,GAArB,MAAM;IACe,QAAQ,GAA7B,MAAM,GAAC,GAAG;CAClB,GAAU,GAAC,CAsCb"}
+{"version":3,"file":"wisp.d.mts","sourceRoot":"","sources":["../src/wisp.mjs"],"names":[],"mappings":"AAmDA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,4BAjBW,MAAM,GAAC,GAAG,YAElB;IAA6B,IAAI,GAAzB,MAAM,GAAC,GAAG;IACmB,QAAQ,GAArC,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI;IACoC,OAAO,GAA7D,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG;IAC1B,IAAI,GAArB,MAAM;IACe,QAAQ,GAA7B,MAAM,GAAC,GAAG;CAClB,GAAU,OAAO,CAAC,GAAC,CAAC,CA0EtB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,gCAhBW,MAAM,GAAC,GAAG,YAElB;IAA6B,IAAI,GAAzB,MAAM,GAAC,GAAG;IACmB,QAAQ,GAArC,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI;IACoC,OAAO,GAA7D,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,GAAG;IAC1B,IAAI,GAArB,MAAM;IACe,QAAQ,GAA7B,MAAM,GAAC,GAAG;CAClB,GAAU,GAAC,CAsCb"}