@cldmv/slothlet 2.11.0 → 3.0.1

package/dist/lib/modes/slothlet_lazy.mjs

@@ -1,594 +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 { readdirSync } from "node:fs";
-import path from "node:path";
-import { types as utilTypes } from "node:util";
-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 instance = this; 
-
-	
-	const runtimePath = instance.config.runtime === "live" ? "@cldmv/slothlet/runtime/live" : "@cldmv/slothlet/runtime/async";
-	const { runWithCtx } = await import(runtimePath);
-
-	const entries = await fs.readdir(dir, { withFileTypes: true });
-	let api = {};
-	let rootDefaultFn = null;
-
-	
-	
-	const moduleFiles = entries.filter((e) => instance._shouldIncludeFile(e));
-	const defaultExportFiles = [];
-
-	
-	const analysis = await multidefault_analyzeModules(moduleFiles, dir, { debug: instance.config.debug, instance });
-
-	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 moduleResult = await instance._loadSingleModule(path.join(dir, entry.name), true);
-			const mod = moduleResult.mod;
-			const moduleAnalysis = moduleResult.analysis;
-			defaultExportFiles.push({ entry, fileName, mod, analysis: moduleAnalysis });
-		}
-	}
-
-	if (instance.config.debug) {
-		console.log(`[DEBUG] Lazy mode: Using shared multidefault utility results`);
-		console.log(`[DEBUG]   - totalDefaultExports: ${totalDefaultExports}`);
-		console.log(`[DEBUG]   - hasMultipleDefaultExports: ${hasMultipleDefaultExports}`);
-		console.log(`[DEBUG]   - selfReferentialFiles: ${Array.from(selfReferentialFiles)}`);
-	}
-
-	
-	const processedModuleCache = new Map(); 
-
-	for (const entry of moduleFiles) {
-		const ext = path.extname(entry.name);
-		const fileName = path.basename(entry.name, ext);
-		const apiPathKey = instance._toapiPathKey(fileName);
-
-		
-		let mod = null;
-		let analysis = null;
-		const existingDefault = defaultExportFiles.find((def) => def.fileName === fileName);
-		if (existingDefault) {
-			mod = existingDefault.mod; 
-			analysis = existingDefault.analysis; 
-		} else {
-			
-			const moduleResult = await instance._loadSingleModule(path.join(dir, entry.name), true);
-			mod = moduleResult.mod;
-			analysis = moduleResult.analysis;
-			processedModuleCache.set(entry.name, mod);
-		}
-
-		
-		const isSelfReferential = selfReferentialFiles.has(fileName);
-
-		
-		processModuleForAPI({
-			mod,
-			fileName,
-			apiPathKey,
-			hasMultipleDefaultExports,
-			isSelfReferential,
-			api,
-			getRootDefault: () => rootDefaultFn,
-			setRootDefault: (fn) => {
-				rootDefaultFn = fn;
-			},
-			context: {
-				debug: instance.config.debug,
-				mode: "root",
-				totalModules: moduleFiles.length
-			},
-			originalAnalysis: analysis
-		});
-	}
-
-	
-	if (rootDefaultFn) {
-		Object.assign(rootDefaultFn, api);
-		api = rootDefaultFn;
-	}
-
-	
-	for (const entry of entries) {
-		if (entry.isDirectory() && !entry.name.startsWith(".") && currentDepth < maxDepth) {
-			const key = instance._toapiPathKey(entry.name);
-			const subDirPath = path.join(dir, entry.name);
-			const parent = api;
-			const depth = 1; 
-
-			
-			try {
-				const subEntries = readdirSync(subDirPath, { withFileTypes: true });
-				const hasFiles = subEntries.some(
-					(subEntry) =>
-						subEntry.isFile() &&
-						!subEntry.name.startsWith(".") &&
-						(subEntry.name.endsWith(".mjs") || subEntry.name.endsWith(".cjs") || subEntry.name.endsWith(".js"))
-				);
-				const hasSubdirs = subEntries.some((subEntry) => subEntry.isDirectory() && !subEntry.name.startsWith("."));
-
-				
-				if (!hasFiles && !hasSubdirs) {
-					if (instance?.config?.debug) {
-						console.log(`[lazy][debug] empty folder detected during traversal: ${subDirPath} -> adding {}`);
-					}
-					parent[key] = {};
-					continue; 
-				}
-			} catch (error) {
-				
-				if (instance?.config?.debug) {
-					console.log(`[lazy][debug] error reading directory ${subDirPath}: ${error.message}, creating lazy proxy`);
-				}
-			}
-
-			const proxy = createFolderProxy({
-				subDirPath,
-				key,
-				parent,
-				instance,
-				depth,
-				maxDepth,
-				pathParts: [key],
-				runWithCtx,
-				existingContent: parent[key] 
-			});
-			parent[key] = proxy;
-		}
-	}
-
-	return api;
-}
-
-
-function replacePlaceholder(parent, key, placeholder, value, instance, depth) {
-	if (!parent || !key) return;
-
-	
-	if (
-		parent[key] !== placeholder &&
-		parent[key] &&
-		typeof parent[key] === "object" &&
-		typeof value === "object" &&
-		!Array.isArray(parent[key]) &&
-		!Array.isArray(value)
-	) {
-		if (instance?.config?.debug) {
-			console.log(`[lazy] MERGE CASE DETECTED for '${key}' - existing:`, Object.keys(parent[key]), "new:", Object.keys(value));
-			console.log(`[lazy] Before merge - parent[${key}]:`, parent[key]);
-		}
-		
-		Object.assign(parent[key], value);
-		if (instance?.config?.debug) {
-			console.log(`[lazy] After merge - parent[${key}]:`, Object.keys(parent[key]));
-		}
-		return;
-	}
-
-	if (parent[key] !== placeholder) return; 
-
-	
-	
-	
-	
-	const isCustomProxy = value && typeof value === "object" && (utilTypes?.isProxy?.(value) ?? false);
-
-	if (isCustomProxy) {
-		if (instance?.config?.debug) {
-			console.log(`[lazy][materialize] detected custom Proxy for ${key}, replacing placeholder to avoid memory leaks (${typeof value})`);
-		}
-		
-		try {
-			
-			const testAccess = value && typeof value === "object";
-			if (!testAccess) {
-				console.warn(`[lazy][materialize] Custom proxy for ${key} failed basic validation, but continuing with replacement`);
-			}
-		} catch (error) {
-			console.warn(`[lazy][materialize] Custom proxy for ${key} validation failed:`, error.message, "but continuing with replacement");
-		}
-		
-	}
-
-	
-	let finalKey = key;
-	if (typeof value === "function" && value.name && value.name.toLowerCase() === key.toLowerCase() && value.name !== key) {
-		
-		finalKey = value.name;
-
-		
-		if (finalKey !== key && key in parent) {
-			try {
-				delete parent[key];
-			} catch {
-				
-			}
-		}
-	}
-
-	try {
-		
-		if (
-			parent[finalKey] &&
-			typeof parent[finalKey] === "object" &&
-			typeof value === "object" &&
-			!Array.isArray(parent[finalKey]) &&
-			!Array.isArray(value)
-		) {
-			if (instance?.config?.debug) {
-				console.log(`[lazy] Merging subdirectory '${finalKey}' - existing:`, Object.keys(parent[finalKey]), "new:", Object.keys(value));
-			}
-			
-			Object.assign(parent[finalKey], value);
-		} else {
-			Object.defineProperty(parent, finalKey, { value, writable: true, enumerable: true, configurable: true });
-		}
-	} catch {
-		
-		if (
-			parent[finalKey] &&
-			typeof parent[finalKey] === "object" &&
-			typeof value === "object" &&
-			!Array.isArray(parent[finalKey]) &&
-			!Array.isArray(value)
-		) {
-			if (instance?.config?.debug) {
-				console.log(
-					`[lazy] Merging subdirectory '${finalKey}' (fallback) - existing:`,
-					Object.keys(parent[finalKey]),
-					"new:",
-					Object.keys(value)
-				);
-			}
-			Object.assign(parent[finalKey], value);
-		} else {
-			parent[finalKey] = value; 
-		}
-	}
-	if (instance?.config?.debug) {
-		console.log(`[lazy][materialize] replaced ${key}${finalKey !== key ? ` -> ${finalKey}` : ""} (${typeof value})`);
-	}
-	if (depth === 1 && typeof instance?.updateBoundApiProperty === "function") {
-		instance.updateBoundApiProperty(finalKey, parent[finalKey]);
-	}
-}
-
-
-function createFolderProxy({ subDirPath, key, parent, instance, depth, maxDepth, pathParts, runWithCtx, existingContent }) {
-	let materialized = null;
-	let inFlight = null;
-
-	
-	async function _materialize() {
-		if (materialized) return materialized;
-		if (inFlight) return inFlight;
-		
-		
-		const lazy_materializeCategory = async () => {
-			const value = await instance._buildCategory(subDirPath, {
-				currentDepth: depth,
-				maxDepth,
-				mode: "lazy",
-				existingApi: parent, 
-				subdirHandler: ({ subDirPath: nestedPath, key: nestedKey, categoryModules, currentDepth: cd, maxDepth: md }) =>
-					createFolderProxy({
-						subDirPath: nestedPath,
-						key: nestedKey,
-						parent: categoryModules,
-						instance,
-						depth: cd + 1,
-						maxDepth: md,
-						pathParts: [...pathParts, nestedKey],
-						runWithCtx
-					})
-			});
-			materialized = value;
-
-			
-			if (
-				existingContent &&
-				typeof existingContent === "object" &&
-				typeof materialized === "object" &&
-				!Array.isArray(existingContent) &&
-				!Array.isArray(materialized)
-			) {
-				if (instance?.config?.debug) {
-					console.log(
-						`[lazy] Merging existing content with materialized subdirectory '${key}' - existing:`,
-						Object.keys(existingContent),
-						"new:",
-						Object.keys(materialized)
-					);
-				}
-				
-				materialized = Object.assign({}, existingContent, materialized);
-			} else if (existingContent && !materialized) {
-				
-				materialized = existingContent;
-			}
-			if (instance?.config?.debug) {
-				try {
-					const infoKeys = materialized && typeof materialized === "object" ? Object.keys(materialized) : [];
-					const todayType = materialized && materialized.today ? typeof materialized.today : "n/a";
-					console.log(
-						`[lazy][debug] materialized key='${key}' path='${subDirPath}' type=${typeof materialized} keys=${JSON.stringify(
-							infoKeys
-						)} todayType=${todayType}`
-					);
-				} catch {
-					
-				}
-			}
-			
-			replacePlaceholder(parent, key, placeholder, materialized, instance, depth);
-			
-			if (instance.config.debug) {
-				try {
-					const type = typeof materialized;
-					const keys = type === "object" && materialized ? Object.keys(materialized) : [];
-					console.log(
-						`[lazy][debug] materialized '${pathParts.join("/")}' -> type=${type} keys=${JSON.stringify(keys)} parentHas=${
-							parent[key] === materialized
-						}`
-					);
-				} catch {
-					
-				}
-			}
-			placeholder.__materialized = materialized;
-			return materialized;
-		};
-		inFlight = lazy_materializeCategory();
-		try {
-			return await inFlight;
-		} finally {
-			inFlight = null;
-		}
-	}
-
-	
-	async function lazy_invoke(thisArg, ...args) {
-		const value = await _materialize();
-		if (typeof value === "function") {
-			
-			const ctx = instance.boundapi?.__ctx;
-			if (ctx) {
-				return runWithCtx(ctx, value, thisArg, args);
-			} else {
-				return value.apply(thisArg, args);
-			}
-		}
-		
-		
-		return value;
-	}
-
-	
-	
-	function lazy_lazyTarget(...args) {
-		return lazy_invoke(this, ...args);
-	}
-	
-	Object.defineProperty(lazy_lazyTarget, "__materialized", { value: null, writable: true, enumerable: false, configurable: true });
-	
-	Object.defineProperty(lazy_lazyTarget, "__slothletPath", { value: subDirPath, enumerable: false, configurable: true });
-	
-	Object.defineProperty(lazy_lazyTarget, "_materialize", { value: _materialize, enumerable: false, configurable: true, writable: true });
-
-	
-	try {
-		Object.defineProperty(lazy_lazyTarget, "name", { value: `lazyFolder_${key}`, configurable: true });
-	} catch {
-		
-	}
-
-	const placeholder = new Proxy(lazy_lazyTarget, {
-		apply(_t, thisArg, args) {
-			return lazy_invoke(thisArg, ...args);
-		},
-		get(_t, prop, _) {
-			if (prop === "__materialized") return materialized;
-			if (prop === "_materialize") return _materialize;
-			if (prop === "then") return undefined; 
-			
-			if (prop === "__slothletPath") {
-				return pathParts.length > 0 ? pathParts.join(".") : undefined;
-			}
-			
-			if (prop === "__metadata" || prop === "__sourceFolder") {
-				
-				return Reflect.get(_t, prop);
-			}
-			
-			if (materialized) {
-				if (materialized && (typeof materialized === "object" || typeof materialized === "function")) return materialized[prop];
-				return undefined;
-			}
-			
-			if (!inFlight) inFlight = _materialize();
-			
-			const apiPath = pathParts.length > 0 ? `${pathParts.join(".")}.${String(prop)}` : String(prop);
-			
-			
-			
-			
-			const propertyProxy = new Proxy(
-				
-				function lazy_propertyAccessor(...args) {
-					return inFlight.then(
-						
-						function lazy_handleResolvedValue(resolved) {
-							const value = resolved ? resolved[prop] : undefined;
-							if (typeof value === "function") {
-								
-								return value.apply(this, args);
-							}
-							return value;
-						}
-					);
-				},
-				{
-					
-					get(target, subProp) {
-						if (subProp === "name") return `lazy_${prop}`;
-						if (subProp === "length") return 0;
-						
-						if (subProp === "__slothletPath") {
-							return pathParts.length > 0 ? `${pathParts.join(".")}.${String(prop)}` : String(prop);
-						}
-						
-						return new Proxy(
-							 function lazy_deepPropertyAccessor() {},
-							{
-								get(target, nextProp) {
-									if (nextProp === "name") return `lazy_${prop}_${subProp}`;
-									if (nextProp === "length") return 0;
-									
-									return new Proxy(function lazy_deeperPropertyAccessor() {}, {
-										apply(target, thisArg, args) {
-											if (materialized) {
-												const value = materialized[prop];
-												const subValue = value ? value[subProp] : undefined;
-												if (subValue && typeof subValue[nextProp] === "function") {
-													
-													return subValue[nextProp].apply(thisArg, args);
-												}
-												return subValue ? subValue[nextProp] : undefined;
-											}
-
-											if (!inFlight) inFlight = _materialize();
-											return inFlight.then(function lazy_handleDeeperResolvedValue(resolved) {
-												const value = resolved ? resolved[prop] : undefined;
-												const subValue = value ? value[subProp] : undefined;
-												if (subValue && typeof subValue[nextProp] === "function") {
-													const ctx = instance.boundapi?.__ctx;
-													if (ctx) {
-														return runWithCtx(ctx, subValue[nextProp], thisArg, args);
-													} else {
-														return subValue[nextProp].apply(thisArg, args);
-													}
-												}
-												return subValue ? subValue[nextProp] : undefined;
-											});
-										}
-									});
-								},
-								apply(target, thisArg, args) {
-									
-									if (materialized) {
-										const value = materialized[prop];
-										if (value && typeof value[subProp] === "function") {
-											
-											return value[subProp].apply(thisArg, args);
-										}
-										return value ? value[subProp] : undefined;
-									}
-
-									
-									if (!inFlight) inFlight = _materialize();
-									return inFlight.then(
-										
-										function lazy_handleDeepResolvedValue(resolved) {
-											const value = resolved ? resolved[prop] : undefined;
-											if (value && typeof value[subProp] === "function") {
-												
-												const ctx = instance.boundapi?.__ctx;
-												if (ctx) {
-													return runWithCtx(ctx, value[subProp], thisArg, args);
-												} else {
-													return value[subProp].apply(thisArg, args);
-												}
-											}
-											return value ? value[subProp] : undefined;
-										}
-									);
-								}
-							}
-						);
-					}
-				}
-			);
-
-			
-			Object.defineProperty(propertyProxy, "__slothletPath", {
-				value: apiPath,
-				writable: false,
-				enumerable: false,
-				configurable: true
-			});
-
-			return propertyProxy;
-		},
-		has(_t, prop) {
-			if (materialized && (typeof materialized === "object" || typeof materialized === "function")) return prop in materialized;
-			return false;
-		},
-		ownKeys() {
-			const baseKeys = Reflect.ownKeys(lazy_lazyTarget); 
-			if (!materialized) return baseKeys;
-			if (typeof materialized === "object" || typeof materialized === "function") {
-				const matKeys = Reflect.ownKeys(materialized);
-				return Array.from(new Set([...baseKeys, ...matKeys]));
-			}
-			return baseKeys;
-		},
-		getOwnPropertyDescriptor(_t, prop) {
-			if (prop === "_materialize") {
-				
-				return Reflect.getOwnPropertyDescriptor(lazy_lazyTarget, "_materialize");
-			}
-			if (prop === "__materialized") {
-				return { configurable: true, enumerable: false, writable: true, value: materialized };
-			}
-			
-			if (prop === "__metadata" || prop === "__sourceFolder") {
-				return Reflect.getOwnPropertyDescriptor(lazy_lazyTarget, prop);
-			}
-			if (prop === "prototype") {
-				
-				return Object.getOwnPropertyDescriptor(lazy_lazyTarget, "prototype");
-			}
-			if (materialized && (typeof materialized === "object" || typeof materialized === "function")) {
-				const d = Object.getOwnPropertyDescriptor(materialized, prop);
-				if (d) return { ...d, configurable: true };
-			}
-			
-			const td = Object.getOwnPropertyDescriptor(lazy_lazyTarget, prop);
-			if (td) return { ...td, configurable: true };
-			return undefined;
-		}
-	});
-
-	return placeholder;
-}