@m3rcena/eco 0.0.0-stage → 14.28.1

package/dist/resolver.cjs

@@ -0,0 +1,305 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("./rolldown-runtime-CmQyd0Gu.cjs");
+let node_fs = require("node:fs");
+node_fs = require_rolldown_runtime.__toESM(node_fs);
+let node_path = require("node:path");
+node_path = require_rolldown_runtime.__toESM(node_path);
+// src/resolver.ts
+/**
+* @m3rcena/eco - Rust-Style Submodule & Path Resolver
+*
+* Inspired by Cargo's workspace and [patch.crates-io] resolver algorithm.
+* Enables zero-friction consumption of @m3rcena packages via Git submodules,
+* local vendor paths, or standard NPM registry installs without code changes.
+*
+* @copyright 2026 M3rcena Development. All rights reserved.
+* @license Apache-2.0
+*/
+const KNOWN_PACKAGES = {
+	"@m3rcena/weky": {
+		aliases: [
+			"m3rcena-weky",
+			"weky",
+			"weky-manager"
+		],
+		envVar: "M3RCENA_WEKY_PATH"
+	},
+	"@m3rcena/eco": {
+		aliases: [
+			"m3rcena-eco",
+			"eco",
+			"economy"
+		],
+		envVar: "M3RCENA_ECO_PATH"
+	},
+	"@m3rcena/bridge": {
+		aliases: [
+			"m3rcena-bridge",
+			"bridge",
+			"m3rcena-core"
+		],
+		envVar: "M3RCENA_BRIDGE_PATH"
+	}
+};
+const CANDIDATE_CONTAINERS = [
+	".",
+	"submodules",
+	"submodule",
+	"vendor",
+	"packages",
+	"libs",
+	"modules"
+];
+function isTypeScriptRuntime() {
+	if (typeof process.isBun !== "undefined") return true;
+	if (typeof process.isDeno !== "undefined") return true;
+	const execArgv = process.execArgv.join(" ");
+	if (/tsx|ts-node|@swc\/register|ts-loader/.test(execArgv)) return true;
+	if (process.argv[1]?.endsWith(".ts") || process.argv[1]?.endsWith(".mts")) return true;
+	if (process.env.M3RCENA_PREFER_SOURCE === "true" || process.env.M3RCENA_PREFER_SOURCE === "1") return true;
+	return false;
+}
+function findProjectRoot(startDir = process.cwd()) {
+	let current = node_path.default.resolve(startDir);
+	for (let i = 0; i < 6; i++) {
+		const pkgJson = node_path.default.join(current, "package.json");
+		if (node_fs.default.existsSync(pkgJson)) return current;
+		const parent = node_path.default.dirname(current);
+		if (parent === current) break;
+		current = parent;
+	}
+	return node_path.default.resolve(startDir);
+}
+function loadResolverConfig(cwd = process.cwd()) {
+	const root = findProjectRoot(cwd);
+	const resolverFile = node_path.default.join(root, "m3rcena.resolver.json");
+	if (node_fs.default.existsSync(resolverFile)) try {
+		return JSON.parse(node_fs.default.readFileSync(resolverFile, "utf-8"));
+	} catch {}
+	const pkgJsonPath = node_path.default.join(root, "package.json");
+	if (node_fs.default.existsSync(pkgJsonPath)) try {
+		const pkg = JSON.parse(node_fs.default.readFileSync(pkgJsonPath, "utf-8"));
+		if (pkg.m3rcena && typeof pkg.m3rcena === "object") return pkg.m3rcena;
+	} catch {}
+	return null;
+}
+function inspectSubmoduleDirectory(dirPath, expectedName) {
+	if (!node_fs.default.existsSync(dirPath)) return { isValid: false };
+	try {
+		if (!node_fs.default.statSync(dirPath).isDirectory()) return { isValid: false };
+		const pkgPath = node_path.default.join(dirPath, "package.json");
+		if (node_fs.default.existsSync(pkgPath)) {
+			const data = JSON.parse(node_fs.default.readFileSync(pkgPath, "utf-8"));
+			if (data.name === expectedName) return {
+				isValid: true,
+				version: data.version
+			};
+		}
+		if (node_fs.default.existsSync(node_path.default.join(dirPath, "src", "index.ts"))) return { isValid: true };
+	} catch {
+		return { isValid: false };
+	}
+	return { isValid: false };
+}
+function resolveSubmoduleEntryPoint(dirPath, preferSource) {
+	const srcTs = node_path.default.join(dirPath, "src", "index.ts");
+	const distMjs = node_path.default.join(dirPath, "dist", "index.mjs");
+	const distCjs = node_path.default.join(dirPath, "dist", "index.cjs");
+	const isBuilt = node_fs.default.existsSync(distMjs) || node_fs.default.existsSync(distCjs);
+	if (preferSource && node_fs.default.existsSync(srcTs)) return {
+		entryPath: srcTs,
+		type: "source",
+		isBuilt
+	};
+	if (node_fs.default.existsSync(distMjs)) return {
+		entryPath: distMjs,
+		type: "dist",
+		isBuilt: true
+	};
+	if (node_fs.default.existsSync(distCjs)) return {
+		entryPath: distCjs,
+		type: "dist",
+		isBuilt: true
+	};
+	if (node_fs.default.existsSync(srcTs)) return {
+		entryPath: srcTs,
+		type: "source",
+		isBuilt: false
+	};
+	return {
+		entryPath: dirPath,
+		type: "dist",
+		isBuilt
+	};
+}
+function resolvePackage(packageName, options = {}) {
+	const root = findProjectRoot(options.cwd ?? process.cwd());
+	const cfg = loadResolverConfig(root);
+	const pkgMeta = KNOWN_PACKAGES[packageName];
+	const preferSource = options.preferSource ?? cfg?.preferSource ?? isTypeScriptRuntime();
+	const rootInspected = inspectSubmoduleDirectory(root, packageName);
+	if (rootInspected.isValid) {
+		const ep = resolveSubmoduleEntryPoint(root, preferSource);
+		return {
+			name: packageName,
+			status: "submodule",
+			type: ep.type,
+			path: ep.entryPath,
+			rootDirectory: root,
+			version: rootInspected.version,
+			isBuilt: ep.isBuilt
+		};
+	}
+	if (options.overrides?.[packageName]) {
+		const customPath = node_path.default.resolve(root, options.overrides[packageName]);
+		const inspected = inspectSubmoduleDirectory(customPath, packageName);
+		if (inspected.isValid) {
+			const ep = resolveSubmoduleEntryPoint(customPath, preferSource);
+			return {
+				name: packageName,
+				status: "submodule",
+				type: ep.type,
+				path: ep.entryPath,
+				rootDirectory: customPath,
+				version: inspected.version,
+				isBuilt: ep.isBuilt
+			};
+		}
+	}
+	const envVal = process.env[pkgMeta.envVar];
+	if (envVal) {
+		const customPath = node_path.default.resolve(root, envVal);
+		const inspected = inspectSubmoduleDirectory(customPath, packageName);
+		if (inspected.isValid) {
+			const ep = resolveSubmoduleEntryPoint(customPath, preferSource);
+			return {
+				name: packageName,
+				status: "submodule",
+				type: ep.type,
+				path: ep.entryPath,
+				rootDirectory: customPath,
+				version: inspected.version,
+				isBuilt: ep.isBuilt
+			};
+		}
+	}
+	if (cfg?.packages?.[packageName]) {
+		const customPath = node_path.default.resolve(root, cfg.packages[packageName]);
+		const inspected = inspectSubmoduleDirectory(customPath, packageName);
+		if (inspected.isValid) {
+			const ep = resolveSubmoduleEntryPoint(customPath, preferSource);
+			return {
+				name: packageName,
+				status: "submodule",
+				type: ep.type,
+				path: ep.entryPath,
+				rootDirectory: customPath,
+				version: inspected.version,
+				isBuilt: ep.isBuilt
+			};
+		}
+	}
+	const candidateContainers = [
+		options.submodulesDir,
+		cfg?.submodulesDir,
+		process.env.M3RCENA_SUBMODULES_DIR,
+		...CANDIDATE_CONTAINERS
+	].filter((c) => typeof c === "string" && c.trim().length > 0);
+	const searchRoots = [
+		root,
+		node_path.default.resolve(root, ".."),
+		node_path.default.resolve(root, "../..")
+	];
+	for (const sRoot of searchRoots) for (const container of candidateContainers) for (const alias of pkgMeta.aliases) {
+		const candidateDir = node_path.default.resolve(sRoot, container, alias);
+		const inspected = inspectSubmoduleDirectory(candidateDir, packageName);
+		if (inspected.isValid) {
+			const ep = resolveSubmoduleEntryPoint(candidateDir, preferSource);
+			return {
+				name: packageName,
+				status: "submodule",
+				type: ep.type,
+				path: ep.entryPath,
+				rootDirectory: candidateDir,
+				version: inspected.version,
+				isBuilt: ep.isBuilt
+			};
+		}
+	}
+	try {
+		return {
+			name: packageName,
+			status: "npm",
+			type: "registry",
+			path: require.resolve(packageName, { paths: [root, process.cwd()] })
+		};
+	} catch {
+		const nmPath = node_path.default.join(root, "node_modules", packageName);
+		if (node_fs.default.existsSync(nmPath)) return {
+			name: packageName,
+			status: "npm",
+			type: "registry",
+			path: nmPath
+		};
+	}
+	return {
+		name: packageName,
+		status: "missing",
+		type: "registry",
+		path: packageName
+	};
+}
+function getAllPackageResolutions(options = {}) {
+	return {
+		"@m3rcena/weky": resolvePackage("@m3rcena/weky", options),
+		"@m3rcena/eco": resolvePackage("@m3rcena/eco", options),
+		"@m3rcena/bridge": resolvePackage("@m3rcena/bridge", options)
+	};
+}
+function generateTsConfigPaths(options = {}) {
+	const resolutions = getAllPackageResolutions(options);
+	const root = findProjectRoot(options.cwd ?? process.cwd());
+	const paths = {};
+	for (const [name, res] of Object.entries(resolutions)) if (res.status === "submodule" && res.rootDirectory) {
+		const rel = node_path.default.relative(root, res.rootDirectory).replace(/\\/g, "/");
+		const cleanRel = !rel || rel === "." ? "." : rel.startsWith(".") ? rel : `./${rel}`;
+		paths[name] = [
+			`${cleanRel}/src`,
+			`${cleanRel}/dist/index.mjs`,
+			cleanRel
+		];
+		if (name === "@m3rcena/bridge") paths["@m3rcena/bridge/client"] = [`${cleanRel}/src/client`, `${cleanRel}/dist/client.mjs`];
+	}
+	return paths;
+}
+function printResolutionSummary(options = {}) {
+	const resolutions = getAllPackageResolutions(options);
+	const cyan = (s) => `\x1b[36m${s}\x1b[39m`;
+	const green = (s) => `\x1b[32m${s}\x1b[39m`;
+	const yellow = (s) => `\x1b[33m${s}\x1b[39m`;
+	const gray = (s) => `\x1b[90m${s}\x1b[39m`;
+	const bold = (s) => `\x1b[1m${s}\x1b[22m`;
+	console.log(cyan("┌────────────────────────────────────────────────────────────────────────┐"));
+	console.log(cyan("│") + bold("  🦀 M3RCENA RUST-STYLE SUBMODULE RESOLVER                              ") + cyan("│"));
+	console.log(cyan("├────────────────────────────────────────────────────────────────────────┤"));
+	for (const [name, res] of Object.entries(resolutions)) {
+		const padName = name.padEnd(16);
+		if (res.status === "submodule") {
+			const mode = res.type === "source" ? yellow("[SOURCE]") : green("[DIST]");
+			const ver = res.version ? `v${res.version}` : "local";
+			const shortPath = res.rootDirectory ? node_path.default.basename(res.rootDirectory) : res.path;
+			console.log(cyan("│") + `  ${bold(padName)} -> ${green("submodule")} ${mode} ${gray(ver)} ${gray(`(${shortPath})`)}`.padEnd(79) + cyan("│"));
+		} else if (res.status === "npm") console.log(cyan("│") + `  ${bold(padName)} -> ${cyan("npm registry")} ${gray("(node_modules)")}`.padEnd(79) + cyan("│"));
+		else console.log(cyan("│") + `  ${bold(padName)} -> ${gray("not installed")}`.padEnd(79) + cyan("│"));
+	}
+	console.log(cyan("└────────────────────────────────────────────────────────────────────────┘"));
+}
+exports.findProjectRoot = findProjectRoot;
+exports.generateTsConfigPaths = generateTsConfigPaths;
+exports.getAllPackageResolutions = getAllPackageResolutions;
+exports.isTypeScriptRuntime = isTypeScriptRuntime;
+exports.loadResolverConfig = loadResolverConfig;
+exports.printResolutionSummary = printResolutionSummary;
+exports.resolvePackage = resolvePackage;
+
+//# sourceMappingURL=resolver.cjs.map

package/dist/resolver.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.cjs","names":["path","fs"],"sources":["../src/resolver.ts"],"sourcesContent":["/**\n * @m3rcena/eco - Rust-Style Submodule & Path Resolver\n *\n * Inspired by Cargo's workspace and [patch.crates-io] resolver algorithm.\n * Enables zero-friction consumption of @m3rcena packages via Git submodules,\n * local vendor paths, or standard NPM registry installs without code changes.\n *\n * @copyright 2026 M3rcena Development. All rights reserved.\n * @license Apache-2.0\n */\n\nimport fs from \"node:fs\";\nimport path from \"node:path\";\n\nexport type M3rcenaPackageName = \"@m3rcena/weky\" | \"@m3rcena/eco\" | \"@m3rcena/bridge\";\n\nexport interface PackageResolution {\n  name: M3rcenaPackageName;\n  status: \"submodule\" | \"npm\" | \"missing\";\n  type: \"source\" | \"dist\" | \"registry\";\n  path: string;\n  rootDirectory?: string;\n  version?: string;\n  isBuilt?: boolean;\n}\n\nexport interface ResolverOptions {\n  cwd?: string;\n  submodulesDir?: string;\n  preferSource?: boolean;\n  overrides?: Partial<Record<M3rcenaPackageName, string>>;\n  silent?: boolean;\n}\n\nexport interface M3rcenaResolverConfig {\n  submodulesDir?: string;\n  preferSource?: boolean;\n  packages?: Partial<Record<M3rcenaPackageName, string>>;\n}\n\nconst KNOWN_PACKAGES: Record<M3rcenaPackageName, { aliases: string[]; envVar: string }> = {\n  \"@m3rcena/weky\": {\n    aliases: [\"m3rcena-weky\", \"weky\", \"weky-manager\"],\n    envVar: \"M3RCENA_WEKY_PATH\",\n  },\n  \"@m3rcena/eco\": {\n    aliases: [\"m3rcena-eco\", \"eco\", \"economy\"],\n    envVar: \"M3RCENA_ECO_PATH\",\n  },\n  \"@m3rcena/bridge\": {\n    aliases: [\"m3rcena-bridge\", \"bridge\", \"m3rcena-core\"],\n    envVar: \"M3RCENA_BRIDGE_PATH\",\n  },\n};\n\nconst CANDIDATE_CONTAINERS = [\n  \".\",\n  \"submodules\",\n  \"submodule\",\n  \"vendor\",\n  \"packages\",\n  \"libs\",\n  \"modules\",\n];\n\nexport function isTypeScriptRuntime(): boolean {\n  if (typeof (process as any).isBun !== \"undefined\") return true;\n  if (typeof (process as any).isDeno !== \"undefined\") return true;\n  const execArgv = process.execArgv.join(\" \");\n  if (/tsx|ts-node|@swc\\/register|ts-loader/.test(execArgv)) return true;\n  if (process.argv[1]?.endsWith(\".ts\") || process.argv[1]?.endsWith(\".mts\")) return true;\n  if (process.env.M3RCENA_PREFER_SOURCE === \"true\" || process.env.M3RCENA_PREFER_SOURCE === \"1\") return true;\n  return false;\n}\n\nexport function findProjectRoot(startDir: string = process.cwd()): string {\n  let current = path.resolve(startDir);\n  for (let i = 0; i < 6; i++) {\n    const pkgJson = path.join(current, \"package.json\");\n    if (fs.existsSync(pkgJson)) {\n      return current;\n    }\n    const parent = path.dirname(current);\n    if (parent === current) break;\n    current = parent;\n  }\n  return path.resolve(startDir);\n}\n\nexport function loadResolverConfig(cwd: string = process.cwd()): M3rcenaResolverConfig | null {\n  const root = findProjectRoot(cwd);\n  const resolverFile = path.join(root, \"m3rcena.resolver.json\");\n  if (fs.existsSync(resolverFile)) {\n    try {\n      return JSON.parse(fs.readFileSync(resolverFile, \"utf-8\")) as M3rcenaResolverConfig;\n    } catch {\n      // Ignore\n    }\n  }\n\n  const pkgJsonPath = path.join(root, \"package.json\");\n  if (fs.existsSync(pkgJsonPath)) {\n    try {\n      const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, \"utf-8\"));\n      if (pkg.m3rcena && typeof pkg.m3rcena === \"object\") {\n        return pkg.m3rcena as M3rcenaResolverConfig;\n      }\n    } catch {\n      // Ignore\n    }\n  }\n\n  return null;\n}\n\nfunction inspectSubmoduleDirectory(dirPath: string, expectedName: M3rcenaPackageName): { isValid: boolean; version?: string } {\n  if (!fs.existsSync(dirPath)) return { isValid: false };\n  try {\n    const stat = fs.statSync(dirPath);\n    if (!stat.isDirectory()) return { isValid: false };\n\n    const pkgPath = path.join(dirPath, \"package.json\");\n    if (fs.existsSync(pkgPath)) {\n      const data = JSON.parse(fs.readFileSync(pkgPath, \"utf-8\"));\n      if (data.name === expectedName) {\n        return { isValid: true, version: data.version };\n      }\n    }\n\n    if (fs.existsSync(path.join(dirPath, \"src\", \"index.ts\"))) {\n      return { isValid: true };\n    }\n  } catch {\n    return { isValid: false };\n  }\n  return { isValid: false };\n}\n\nfunction resolveSubmoduleEntryPoint(dirPath: string, preferSource: boolean): { entryPath: string; type: \"source\" | \"dist\"; isBuilt: boolean } {\n  const srcTs = path.join(dirPath, \"src\", \"index.ts\");\n  const distMjs = path.join(dirPath, \"dist\", \"index.mjs\");\n  const distCjs = path.join(dirPath, \"dist\", \"index.cjs\");\n  const isBuilt = fs.existsSync(distMjs) || fs.existsSync(distCjs);\n\n  if (preferSource && fs.existsSync(srcTs)) {\n    return { entryPath: srcTs, type: \"source\", isBuilt };\n  }\n\n  if (fs.existsSync(distMjs)) {\n    return { entryPath: distMjs, type: \"dist\", isBuilt: true };\n  }\n  if (fs.existsSync(distCjs)) {\n    return { entryPath: distCjs, type: \"dist\", isBuilt: true };\n  }\n\n  if (fs.existsSync(srcTs)) {\n    return { entryPath: srcTs, type: \"source\", isBuilt: false };\n  }\n\n  return { entryPath: dirPath, type: \"dist\", isBuilt };\n}\n\nexport function resolvePackage(packageName: M3rcenaPackageName, options: ResolverOptions = {}): PackageResolution {\n  const root = findProjectRoot(options.cwd ?? process.cwd());\n  const cfg = loadResolverConfig(root);\n  const pkgMeta = KNOWN_PACKAGES[packageName];\n\n  const preferSource = options.preferSource ?? cfg?.preferSource ?? isTypeScriptRuntime();\n\n  // 0. Current project check: if root itself IS the requested package\n  const rootInspected = inspectSubmoduleDirectory(root, packageName);\n  if (rootInspected.isValid) {\n    const ep = resolveSubmoduleEntryPoint(root, preferSource);\n    return {\n      name: packageName,\n      status: \"submodule\",\n      type: ep.type,\n      path: ep.entryPath,\n      rootDirectory: root,\n      version: rootInspected.version,\n      isBuilt: ep.isBuilt,\n    };\n  }\n\n  if (options.overrides?.[packageName]) {\n    const customPath = path.resolve(root, options.overrides[packageName]!);\n    const inspected = inspectSubmoduleDirectory(customPath, packageName);\n    if (inspected.isValid) {\n      const ep = resolveSubmoduleEntryPoint(customPath, preferSource);\n      return {\n        name: packageName,\n        status: \"submodule\",\n        type: ep.type,\n        path: ep.entryPath,\n        rootDirectory: customPath,\n        version: inspected.version,\n        isBuilt: ep.isBuilt,\n      };\n    }\n  }\n\n  const envVal = process.env[pkgMeta.envVar];\n  if (envVal) {\n    const customPath = path.resolve(root, envVal);\n    const inspected = inspectSubmoduleDirectory(customPath, packageName);\n    if (inspected.isValid) {\n      const ep = resolveSubmoduleEntryPoint(customPath, preferSource);\n      return {\n        name: packageName,\n        status: \"submodule\",\n        type: ep.type,\n        path: ep.entryPath,\n        rootDirectory: customPath,\n        version: inspected.version,\n        isBuilt: ep.isBuilt,\n      };\n    }\n  }\n\n  if (cfg?.packages?.[packageName]) {\n    const customPath = path.resolve(root, cfg.packages[packageName]!);\n    const inspected = inspectSubmoduleDirectory(customPath, packageName);\n    if (inspected.isValid) {\n      const ep = resolveSubmoduleEntryPoint(customPath, preferSource);\n      return {\n        name: packageName,\n        status: \"submodule\",\n        type: ep.type,\n        path: ep.entryPath,\n        rootDirectory: customPath,\n        version: inspected.version,\n        isBuilt: ep.isBuilt,\n      };\n    }\n  }\n\n  const candidateContainers = [\n    options.submodulesDir,\n    cfg?.submodulesDir,\n    process.env.M3RCENA_SUBMODULES_DIR,\n    ...CANDIDATE_CONTAINERS,\n  ].filter((c): c is string => typeof c === \"string\" && c.trim().length > 0);\n\n  const searchRoots = [root, path.resolve(root, \"..\"), path.resolve(root, \"../..\")];\n\n  for (const sRoot of searchRoots) {\n    for (const container of candidateContainers) {\n      for (const alias of pkgMeta.aliases) {\n        const candidateDir = path.resolve(sRoot, container, alias);\n        const inspected = inspectSubmoduleDirectory(candidateDir, packageName);\n        if (inspected.isValid) {\n          const ep = resolveSubmoduleEntryPoint(candidateDir, preferSource);\n          return {\n            name: packageName,\n            status: \"submodule\",\n            type: ep.type,\n            path: ep.entryPath,\n            rootDirectory: candidateDir,\n            version: inspected.version,\n            isBuilt: ep.isBuilt,\n          };\n        }\n      }\n    }\n  }\n\n  try {\n    const resolvedNpm = require.resolve(packageName, { paths: [root, process.cwd()] });\n    return {\n      name: packageName,\n      status: \"npm\",\n      type: \"registry\",\n      path: resolvedNpm,\n    };\n  } catch {\n    const nmPath = path.join(root, \"node_modules\", packageName);\n    if (fs.existsSync(nmPath)) {\n      return {\n        name: packageName,\n        status: \"npm\",\n        type: \"registry\",\n        path: nmPath,\n      };\n    }\n  }\n\n  return {\n    name: packageName,\n    status: \"missing\",\n    type: \"registry\",\n    path: packageName,\n  };\n}\n\nexport function getAllPackageResolutions(options: ResolverOptions = {}): Record<M3rcenaPackageName, PackageResolution> {\n  return {\n    \"@m3rcena/weky\": resolvePackage(\"@m3rcena/weky\", options),\n    \"@m3rcena/eco\": resolvePackage(\"@m3rcena/eco\", options),\n    \"@m3rcena/bridge\": resolvePackage(\"@m3rcena/bridge\", options),\n  };\n}\n\nexport function generateTsConfigPaths(options: ResolverOptions = {}): Record<string, string[]> {\n  const resolutions = getAllPackageResolutions(options);\n  const root = findProjectRoot(options.cwd ?? process.cwd());\n  const paths: Record<string, string[]> = {};\n\n  for (const [name, res] of Object.entries(resolutions)) {\n    if (res.status === \"submodule\" && res.rootDirectory) {\n      const rel = path.relative(root, res.rootDirectory).replace(/\\\\/g, \"/\");\n      const cleanRel = !rel || rel === \".\" ? \".\" : (rel.startsWith(\".\") ? rel : `./${rel}`);\n      paths[name] = [`${cleanRel}/src`, `${cleanRel}/dist/index.mjs`, cleanRel];\n      if (name === \"@m3rcena/bridge\") {\n        paths[\"@m3rcena/bridge/client\"] = [`${cleanRel}/src/client`, `${cleanRel}/dist/client.mjs`];\n      }\n    }\n  }\n\n  return paths;\n}\n\nexport function printResolutionSummary(options: ResolverOptions = {}): void {\n  const resolutions = getAllPackageResolutions(options);\n  const cyan = (s: string) => `\\x1b[36m${s}\\x1b[39m`;\n  const green = (s: string) => `\\x1b[32m${s}\\x1b[39m`;\n  const yellow = (s: string) => `\\x1b[33m${s}\\x1b[39m`;\n  const gray = (s: string) => `\\x1b[90m${s}\\x1b[39m`;\n  const bold = (s: string) => `\\x1b[1m${s}\\x1b[22m`;\n\n  console.log(cyan(\"┌────────────────────────────────────────────────────────────────────────┐\"));\n  console.log(cyan(\"│\") + bold(\"  🦀 M3RCENA RUST-STYLE SUBMODULE RESOLVER                              \") + cyan(\"│\"));\n  console.log(cyan(\"├────────────────────────────────────────────────────────────────────────┤\"));\n\n  for (const [name, res] of Object.entries(resolutions)) {\n    const padName = name.padEnd(16);\n    if (res.status === \"submodule\") {\n      const mode = res.type === \"source\" ? yellow(\"[SOURCE]\") : green(\"[DIST]\");\n      const ver = res.version ? `v${res.version}` : \"local\";\n      const shortPath = res.rootDirectory ? path.basename(res.rootDirectory) : res.path;\n      console.log(\n        cyan(\"│\") +\n        `  ${bold(padName)} -> ${green(\"submodule\")} ${mode} ${gray(ver)} ${gray(`(${shortPath})`)}`.padEnd(79) +\n        cyan(\"│\")\n      );\n    } else if (res.status === \"npm\") {\n      console.log(cyan(\"│\") + `  ${bold(padName)} -> ${cyan(\"npm registry\")} ${gray(\"(node_modules)\")}`.padEnd(79) + cyan(\"│\"));\n    } else {\n      console.log(cyan(\"│\") + `  ${bold(padName)} -> ${gray(\"not installed\")}`.padEnd(79) + cyan(\"│\"));\n    }\n  }\n\n  console.log(cyan(\"└────────────────────────────────────────────────────────────────────────┘\"));\n}\n"],"mappings":"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"}

package/dist/resolver.d.cts

@@ -0,0 +1,40 @@
+/**
+ * @m3rcena/eco - Rust-Style Submodule & Path Resolver
+ *
+ * Inspired by Cargo's workspace and [patch.crates-io] resolver algorithm.
+ * Enables zero-friction consumption of @m3rcena packages via Git submodules,
+ * local vendor paths, or standard NPM registry installs without code changes.
+ *
+ * @copyright 2026 M3rcena Development. All rights reserved.
+ * @license Apache-2.0
+ */
+export type M3rcenaPackageName = "@m3rcena/weky" | "@m3rcena/eco" | "@m3rcena/bridge";
+export interface PackageResolution {
+  name: M3rcenaPackageName;
+  status: "submodule" | "npm" | "missing";
+  type: "source" | "dist" | "registry";
+  path: string;
+  rootDirectory?: string;
+  version?: string;
+  isBuilt?: boolean;
+}
+export interface ResolverOptions {
+  cwd?: string;
+  submodulesDir?: string;
+  preferSource?: boolean;
+  overrides?: Partial<Record<M3rcenaPackageName, string>>;
+  silent?: boolean;
+}
+export interface M3rcenaResolverConfig {
+  submodulesDir?: string;
+  preferSource?: boolean;
+  packages?: Partial<Record<M3rcenaPackageName, string>>;
+}
+export declare function isTypeScriptRuntime(): boolean;
+export declare function findProjectRoot(startDir?: string): string;
+export declare function loadResolverConfig(cwd?: string): M3rcenaResolverConfig | null;
+export declare function resolvePackage(packageName: M3rcenaPackageName, options?: ResolverOptions): PackageResolution;
+export declare function getAllPackageResolutions(options?: ResolverOptions): Record<M3rcenaPackageName, PackageResolution>;
+export declare function generateTsConfigPaths(options?: ResolverOptions): Record<string, string[]>;
+export declare function printResolutionSummary(options?: ResolverOptions): void;
+//# sourceMappingURL=resolver.d.cts.map

package/dist/resolver.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.cts","names":[],"sources":["../src/resolver.ts"],"mappings":";;;;;;;;;;YAcY;iBAEK;EACf,MAAM;EACN;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA,YAAY,QAAQ,OAAO;EAC3B;;iBAGe;EACf;EACA;EACA,WAAW,QAAQ,OAAO;;wBA4BZ;wBAUA,gBAAgB;wBAchB,mBAAmB,eAA8B;wBAyEjD,eAAe,aAAa,oBAAoB,UAAS,kBAAuB;wBAoIhF,yBAAyB,UAAS,kBAAuB,OAAO,oBAAoB;wBAQpF,sBAAsB,UAAS,kBAAuB;wBAmBtD,uBAAuB,UAAS"}

package/dist/resolver.d.mts

@@ -0,0 +1,40 @@
+/**
+ * @m3rcena/eco - Rust-Style Submodule & Path Resolver
+ *
+ * Inspired by Cargo's workspace and [patch.crates-io] resolver algorithm.
+ * Enables zero-friction consumption of @m3rcena packages via Git submodules,
+ * local vendor paths, or standard NPM registry installs without code changes.
+ *
+ * @copyright 2026 M3rcena Development. All rights reserved.
+ * @license Apache-2.0
+ */
+export type M3rcenaPackageName = "@m3rcena/weky" | "@m3rcena/eco" | "@m3rcena/bridge";
+export interface PackageResolution {
+  name: M3rcenaPackageName;
+  status: "submodule" | "npm" | "missing";
+  type: "source" | "dist" | "registry";
+  path: string;
+  rootDirectory?: string;
+  version?: string;
+  isBuilt?: boolean;
+}
+export interface ResolverOptions {
+  cwd?: string;
+  submodulesDir?: string;
+  preferSource?: boolean;
+  overrides?: Partial<Record<M3rcenaPackageName, string>>;
+  silent?: boolean;
+}
+export interface M3rcenaResolverConfig {
+  submodulesDir?: string;
+  preferSource?: boolean;
+  packages?: Partial<Record<M3rcenaPackageName, string>>;
+}
+export declare function isTypeScriptRuntime(): boolean;
+export declare function findProjectRoot(startDir?: string): string;
+export declare function loadResolverConfig(cwd?: string): M3rcenaResolverConfig | null;
+export declare function resolvePackage(packageName: M3rcenaPackageName, options?: ResolverOptions): PackageResolution;
+export declare function getAllPackageResolutions(options?: ResolverOptions): Record<M3rcenaPackageName, PackageResolution>;
+export declare function generateTsConfigPaths(options?: ResolverOptions): Record<string, string[]>;
+export declare function printResolutionSummary(options?: ResolverOptions): void;
+//# sourceMappingURL=resolver.d.mts.map

package/dist/resolver.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.mts","names":[],"sources":["../src/resolver.ts"],"mappings":";;;;;;;;;;YAcY;iBAEK;EACf,MAAM;EACN;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA,YAAY,QAAQ,OAAO;EAC3B;;iBAGe;EACf;EACA;EACA,WAAW,QAAQ,OAAO;;wBA4BZ;wBAUA,gBAAgB;wBAchB,mBAAmB,eAA8B;wBAyEjD,eAAe,aAAa,oBAAoB,UAAS,kBAAuB;wBAoIhF,yBAAyB,UAAS,kBAAuB,OAAO,oBAAoB;wBAQpF,sBAAsB,UAAS,kBAAuB;wBAmBtD,uBAAuB,UAAS"}