@cldmv/slothlet 2.11.0 → 3.0.0

package/dist/lib/helpers/multidefault.mjs

@@ -1,216 +0,0 @@
-/*
-	Copyright 2026 CLDMV/Shinrai
-
-	Licensed under the Apache License, Version 2.0 (the "License");
-	you may not use this file except in compliance with the License.
-	You may obtain a copy of the License at
-
-		http://www.apache.org/licenses/LICENSE-2.0
-
-	Unless required by applicable law or agreed to in writing, software
-	distributed under the License is distributed on an "AS IS" BASIS,
-	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-	See the License for the specific language governing permissions and
-	limitations under the License.
-*/
-
-
-
-
-
-import path from "path";
-
-
-async function multidefault_analyzeModules(moduleFiles, baseDir, options = {}) {
-	const { debug = false, instance = null } = options;
-	const selfReferentialFiles = new Set();
-	const rawModuleCache = new Map();
-	const defaultExportFiles = [];
-	let totalDefaultExports = 0;
-
-	if (debug) {
-		console.log(`[DEBUG] multidefault_analyzeModules: Processing ${moduleFiles.length} files in ${baseDir}`);
-	}
-
-	
-	for (const file of moduleFiles) {
-		const moduleExt = path.extname(file.name);
-		const fileName = path.basename(file.name, moduleExt);
-		const moduleFilePath = path.resolve(baseDir, file.name);
-
-		
-		
-		let importUrl = `file://${moduleFilePath.replace(/\\/g, "/")}`;
-		const separator = importUrl.includes("?") ? "&" : "?";
-
-		
-		importUrl = `${importUrl}${separator}_t=${Date.now()}_${Math.random().toString(36).slice(2)}`;
-
-		
-		if (instance && instance.instanceId) {
-			const runtimeType = instance.config?.runtime || "async";
-			if (runtimeType === "live") {
-				importUrl = `${importUrl}&slothlet_instance=${instance.instanceId}`;
-			}
-		}
-
-		
-		const rawImport = await import(importUrl);
-
-		
-		const isCjsFile = moduleExt === ".cjs";
-		const rawMod = isCjsFile ? rawImport.default : rawImport;
-		rawModuleCache.set(file.name, rawMod);
-
-		
-		const hasRealDefault = rawMod && "default" in rawMod;
-		if (hasRealDefault) {
-			totalDefaultExports++; 
-
-			
-			const isSelfReferential = multidefault_isSelfReferential(rawMod);
-
-			if (debug) {
-				console.log(`[DEBUG] multidefault_analyzeModules: Checking ${file.name}`);
-				console.log(`[DEBUG]   - fileName: ${fileName}`);
-				console.log(`[DEBUG]   - has default: ${hasRealDefault}`);
-				console.log(`[DEBUG]   - isSelfReferential: ${isSelfReferential}`);
-			}
-
-			if (!isSelfReferential) {
-				
-				defaultExportFiles.push({ fileName, rawModule: rawMod });
-				if (debug) {
-					console.log(`[DEBUG] Found default export in ${file.name} (non-self-referential)`);
-				}
-			} else {
-				selfReferentialFiles.add(fileName); 
-				if (debug) {
-					console.log(`[DEBUG] Skipped ${file.name} - self-referential default export`);
-				}
-			}
-		} else if (debug) {
-			console.log(`[DEBUG] multidefault_analyzeModules: Checking ${file.name}`);
-			console.log(`[DEBUG]   - fileName: ${fileName}`);
-			console.log(`[DEBUG]   - has default: ${hasRealDefault}`);
-			if (isCjsFile) {
-				console.log(`[DEBUG]   - CJS file unwrapped from Node.js wrapper`);
-			}
-		}
-	}
-
-	
-	const hasMultipleDefaultExports = totalDefaultExports > 1;
-
-	if (debug) {
-		console.log(`[DEBUG] multidefault_analyzeModules results:`);
-		console.log(`[DEBUG]   - selfReferentialFiles:`, Array.from(selfReferentialFiles));
-		console.log(`[DEBUG]   - totalDefaultExports:`, totalDefaultExports);
-		console.log(`[DEBUG]   - hasMultipleDefaultExports:`, hasMultipleDefaultExports);
-		console.log(`[DEBUG]   - defaultExportFiles count:`, defaultExportFiles.length);
-	}
-
-	return {
-		totalDefaultExports,
-		hasMultipleDefaultExports,
-		selfReferentialFiles,
-		rawModuleCache,
-		defaultExportFiles
-	};
-}
-
-
-function multidefault_isSelfReferential(rawModule) {
-	if (!rawModule || !("default" in rawModule)) {
-		return false;
-	}
-
-	
-	return Object.entries(rawModule).some(([key, value]) => key !== "default" && value === rawModule.default);
-}
-
-
-function multidefault_getFlatteningDecision(options) {
-	const {
-		hasMultipleDefaultExports,
-		moduleHasDefault,
-		isSelfReferential,
-		moduleKeys,
-		apiPathKey,
-		totalModuleCount,
-		debug = false
-	} = options;
-
-	if (debug) {
-		console.log(`[DEBUG] multidefault_getFlatteningDecision: Analyzing flattening for ${apiPathKey}`);
-		console.log(`[DEBUG]   - hasMultipleDefaultExports: ${hasMultipleDefaultExports}`);
-		console.log(`[DEBUG]   - moduleHasDefault: ${moduleHasDefault}`);
-		console.log(`[DEBUG]   - isSelfReferential: ${isSelfReferential}`);
-		console.log(`[DEBUG]   - moduleKeys: [${moduleKeys.join(", ")}]`);
-		console.log(`[DEBUG]   - totalModuleCount: ${totalModuleCount}`);
-	}
-
-	
-	if (isSelfReferential) {
-		return {
-			shouldFlatten: false,
-			flattenToRoot: false,
-			preserveAsNamespace: true,
-			reason: "self-referential default export"
-		};
-	}
-
-	
-	if (hasMultipleDefaultExports) {
-		if (moduleHasDefault) {
-			
-			return {
-				shouldFlatten: false,
-				flattenToRoot: false,
-				preserveAsNamespace: true,
-				reason: "multi-default context with default export"
-			};
-		} else {
-			
-			return {
-				shouldFlatten: true,
-				flattenToRoot: true,
-				preserveAsNamespace: false,
-				reason: "multi-default context without default export"
-			};
-		}
-	}
-
-	
-	
-	if (moduleKeys.length === 1 && moduleKeys[0] === apiPathKey) {
-		return {
-			shouldFlatten: true,
-			flattenToRoot: false,
-			preserveAsNamespace: false,
-			reason: "single named export matching filename"
-		};
-	}
-
-	
-	
-	
-	
-	
-	
-	
-	
-	
-	
-	
-
-	
-	return {
-		shouldFlatten: false,
-		flattenToRoot: false,
-		preserveAsNamespace: true,
-		reason: "default namespace preservation"
-	};
-}
-
-export { multidefault_analyzeModules, multidefault_isSelfReferential, multidefault_getFlatteningDecision };

package/dist/lib/modes/slothlet_eager.mjs

@@ -1,154 +0,0 @@
-/*
-	Copyright 2026 CLDMV/Shinrai
-
-	Licensed under the Apache License, Version 2.0 (the "License");
-	you may not use this file except in compliance with the License.
-	You may obtain a copy of the License at
-
-		http://www.apache.org/licenses/LICENSE-2.0
-
-	Unless required by applicable law or agreed to in writing, software
-	distributed under the License is distributed on an "AS IS" BASIS,
-	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-	See the License for the specific language governing permissions and
-	limitations under the License.
-*/
-
-
-
-
-
-
-
-import fs from "node:fs/promises";
-import path from "node:path";
-import { processModuleForAPI } from "@cldmv/slothlet/helpers/api_builder";
-import { multidefault_analyzeModules } from "@cldmv/slothlet/helpers/multidefault";
-
-
-
-
-
-export async function create(dir, maxDepth = Infinity, currentDepth = 0) {
-	const entries = await fs.readdir(dir, { withFileTypes: true });
-	const api = {};
-	let rootDefaultFunction = null;
-
-	
-	const moduleFiles = entries.filter((e) => this._shouldIncludeFile(e));
-	const defaultExportFiles = [];
-	
-	const analysis = await multidefault_analyzeModules(moduleFiles, dir, { debug: this.config.debug, instance: this });
-
-	const { totalDefaultExports, hasMultipleDefaultExports, selfReferentialFiles, defaultExportFiles: analysisDefaults } = analysis;
-
-	
-	defaultExportFiles.length = 0; 
-	for (const { fileName } of analysisDefaults) {
-		const entry = moduleFiles.find((f) => path.basename(f.name, path.extname(f.name)) === fileName);
-		if (entry) {
-			const mod = await this._loadSingleModule(path.join(dir, entry.name));
-			defaultExportFiles.push({ entry, fileName, mod });
-		}
-	}
-
-	if (this.config.debug) {
-		console.log(`[DEBUG] Eager mode: Using shared multidefault utility results`);
-		console.log(
-			`[DEBUG] Detection result: ${totalDefaultExports} total defaults (${defaultExportFiles.length} non-self-referential + ${selfReferentialFiles.size} self-referential), hasMultipleDefaultExports=${hasMultipleDefaultExports}`
-		);
-		console.log(
-			`[DEBUG] Default export files:`,
-			defaultExportFiles.map((f) => f.fileName)
-		);
-	}
-
-	
-	for (const entry of moduleFiles) {
-		const ext = path.extname(entry.name);
-		const fileName = path.basename(entry.name, ext);
-		const apiPathKey = this._toapiPathKey(fileName);
-
-		
-		const moduleResult = await this._loadSingleModule(path.join(dir, entry.name), true);
-		const mod = moduleResult.mod;
-		const analysis = moduleResult.analysis;
-
-		
-		const isSelfReferential = selfReferentialFiles.has(fileName);
-
-		processModuleForAPI({
-			mod,
-			fileName,
-			apiPathKey,
-			hasMultipleDefaultExports,
-			isSelfReferential,
-			api,
-			getRootDefault: () => rootDefaultFunction,
-			setRootDefault: (fn) => {
-				rootDefaultFunction = fn;
-			},
-			context: {
-				debug: this.config.debug,
-				mode: "root",
-				totalModules: moduleFiles.length
-			},
-			originalAnalysis: analysis
-		});
-	}
-
-	for (const entry of entries) {
-		if (entry.isDirectory() && !entry.name.startsWith(".") && currentDepth < maxDepth) {
-			const categoryPath = path.join(dir, entry.name);
-			const categoryKey = this._toapiPathKey(entry.name);
-			const categoryResult = await this._buildCategory(categoryPath, {
-				currentDepth: currentDepth + 1,
-				maxDepth,
-				mode: "eager",
-				existingApi: api 
-			});
-
-			
-			if (
-				api[categoryKey] &&
-				typeof api[categoryKey] === "object" &&
-				typeof categoryResult === "object" &&
-				!Array.isArray(api[categoryKey]) &&
-				!Array.isArray(categoryResult)
-			) {
-				if (this.config.debug) {
-					console.log(
-						`[DEBUG] eager: Merging subdirectory '${categoryKey}' - existing:`,
-						Object.keys(api[categoryKey]),
-						"new:",
-						Object.keys(categoryResult)
-					);
-				}
-				
-				Object.assign(api[categoryKey], categoryResult);
-			} else {
-				api[categoryKey] = categoryResult;
-			}
-		}
-	}
-
-	let finalApi;
-	if (this.config.debug) {
-		console.log(`[DEBUG] Final assembly: rootDefaultFunction=${!!rootDefaultFunction}`);
-		console.log(`[DEBUG] API object keys before final assembly:`, Object.keys(api));
-	}
-	if (rootDefaultFunction) {
-		Object.assign(rootDefaultFunction, api);
-		finalApi = rootDefaultFunction;
-		if (this.config.debug) {
-			console.log(`[DEBUG] Applied root contributor pattern - final API is function`);
-		}
-	} else {
-		finalApi = api;
-		if (this.config.debug) {
-			console.log(`[DEBUG] No root function - final API is object`);
-		}
-	}
-
-	return finalApi;
-}