@blac/core 2.0.0-rc.8 → 2.0.0-rc.9

package/dist/core/StateContainer.d.ts

@@ -146,7 +146,7 @@ export declare abstract class StateContainer<S> {
      * Create a new StateContainer
      */
     constructor(initialState: S);
-    initiConfig(config: StateContainerConfig): void;
+    initConfig(config: StateContainerConfig): void;
     /**
      * Get the current state
      */
@@ -168,6 +168,11 @@ export declare abstract class StateContainer<S> {
      * Emit a new state (with change detection)
      */
     protected emit(newState: S): void;
+    /**
+     * Enable stack trace capture in development
+     * Defaults to true, but can be disabled to improve performance
+     */
+    static enableStackTrace: boolean;
     /**
      * Capture stack trace for debugging
      * Can be overridden to disable in production

package/dist/index.cjs

@@ -398,6 +398,9 @@ function createBlocProxy(bloc) {
 				const value = getDescriptor(target, prop).get.call(target);
 				tracker.trackedValues.set(prop, value);
 				return value;
+			} catch (error$1) {
+				tracker.currentlyAccessing.delete(prop);
+				throw error$1;
 			} finally {
 				getterExecutionContext.tracker = prevContext.tracker;
 				getterExecutionContext.currentBloc = prevContext.currentBloc;
@@ -545,7 +548,7 @@ var StateContainerRegistry = class {
 		const config = { instanceId: instanceKey };
 		if (isolated) {
 			const instance$1 = new Type(constructorArgs);
-			instance$1.initiConfig(config);
+			instance$1.initConfig(config);
 			this.registerType(Type);
 			return instance$1;
 		}
@@ -556,7 +559,7 @@ var StateContainerRegistry = class {
 			return entry.instance;
 		}
 		const instance = new Type(constructorArgs);
-		instance.initiConfig(config);
+		instance.initConfig(config);
 		instances.set(instanceKey, {
 			instance,
 			refCount: 1
@@ -613,7 +616,7 @@ var StateContainerRegistry = class {
 		if (!entry) {
 			const instance = new Type(constructorArgs);
 			const config = { instanceId: instanceKey };
-			instance.initiConfig(config);
+			instance.initConfig(config);
 			entry = {
 				instance,
 				refCount: 1
@@ -919,7 +922,7 @@ var StateContainer = class StateContainer {
 		this.lastUpdateTimestamp = Date.now();
 		this._state = initialState;
 	}
-	initiConfig(config) {
+	initConfig(config) {
 		this.config = { ...config };
 		this.name = this.config.name || this.constructor.name;
 		this.debug = this.config.debug ?? false;
@@ -977,12 +980,15 @@ var StateContainer = class StateContainer {
 		StateContainer._registry.emit("stateChanged", this, previousState, newState, stackTrace);
 		this.lastUpdateTimestamp = Date.now();
 	}
+	static {
+		this.enableStackTrace = true;
+	}
 	/**
 	* Capture stack trace for debugging
 	* Can be overridden to disable in production
 	*/
 	captureStackTrace() {
-		if (typeof process !== "undefined" && process.env?.NODE_ENV === "production") return "";
+		if (!StateContainer.enableStackTrace || typeof process !== "undefined" && process.env?.NODE_ENV === "production") return "";
 		try {
 			const relevantLines = ((/* @__PURE__ */ new Error()).stack || "").split("\n").slice(1);
 			const formattedLines = [];
@@ -1360,6 +1366,13 @@ function hasInitHook(plugin) {
 //#endregion
 //#region src/tracking/proxy-tracker.ts
 /**
+* Functional proxy tracker for automatic dependency tracking
+*
+* This module provides a functional approach to proxy-based dependency tracking.
+* Unlike the class-based ProxyTracker, this uses a state object pattern that's
+* easier to integrate with functional programming patterns and framework hooks.
+*/
+/**
 * Check if a value can be proxied
 *
 * Returns true for plain objects and arrays only.
@@ -1687,284 +1700,6 @@ function hasTrackedData(tracker) {
 	return tracker.proxyTrackerState.trackedPaths.size > 0 || tracker.pathCache.size > 0 || tracker.previousRenderPaths.size > 0;
 }
 
-//#endregion
-//#region src/logging/Logger.ts
-let LogLevel = /* @__PURE__ */ function(LogLevel$1) {
-	LogLevel$1[LogLevel$1["ERROR"] = 0] = "ERROR";
-	LogLevel$1[LogLevel$1["WARN"] = 1] = "WARN";
-	LogLevel$1[LogLevel$1["INFO"] = 2] = "INFO";
-	LogLevel$1[LogLevel$1["DEBUG"] = 3] = "DEBUG";
-	return LogLevel$1;
-}({});
-/**
-* Creates a logger instance with given configuration
-*
-* @param config - Logger configuration
-* @returns Logger instance with debug, info, warn, error, and configure methods
-*
-* @example
-* ```ts
-* const logger = createLogger({
-*   enabled: true,
-*   level: LogLevel.DEBUG,
-*   output: (entry) => console.log(JSON.stringify(entry))
-* });
-* logger.debug('MyComponent', 'Rendering', { props: { foo: 'bar' } });
-* ```
-*/
-function createLogger(config) {
-	const shouldLog = (level) => {
-		return config.enabled && config.level >= level;
-	};
-	const log = (level, context, message, data) => {
-		try {
-			const entry = {
-				level,
-				context,
-				message,
-				timestamp: Date.now(),
-				...data !== void 0 && { data: serialize(data) }
-			};
-			config.output(entry);
-		} catch (e) {
-			console.error("[BlacLogger] Error logging:", e);
-		}
-	};
-	const serialize = (data) => {
-		try {
-			return JSON.parse(JSON.stringify(data));
-		} catch {
-			return String(data);
-		}
-	};
-	return {
-		debug: (context, message, data) => {
-			if (shouldLog(LogLevel.DEBUG)) log("DEBUG", context, message, data);
-		},
-		info: (context, message, data) => {
-			if (shouldLog(LogLevel.INFO)) log("INFO", context, message, data);
-		},
-		warn: (context, message, data) => {
-			if (shouldLog(LogLevel.WARN)) log("WARN", context, message, data);
-		},
-		error: (context, message, data) => {
-			if (shouldLog(LogLevel.ERROR)) log("ERROR", context, message, data);
-		},
-		configure: (opts) => {
-			Object.assign(config, opts);
-		}
-	};
-}
-let currentConfig = {
-	enabled: false,
-	level: LogLevel.INFO,
-	output: (entry) => console.log(JSON.stringify(entry))
-};
-let defaultLogger = createLogger(currentConfig);
-const debug = (context, message, data) => defaultLogger.debug(context, message, data);
-const info = (context, message, data) => defaultLogger.info(context, message, data);
-const warn = (context, message, data) => defaultLogger.warn(context, message, data);
-const error = (context, message, data) => defaultLogger.error(context, message, data);
-/**
-* Configuration function that recreates the default logger
-*
-* @param opts - Partial logger configuration
-*
-* @example
-* ```ts
-* configureLogger({ enabled: true, level: LogLevel.DEBUG });
-* ```
-*/
-function configureLogger(opts) {
-	currentConfig = {
-		...currentConfig,
-		...opts
-	};
-	defaultLogger = createLogger(currentConfig);
-}
-
-//#endregion
-//#region src/proxy/ProxyTracker.ts
-/**
-* ProxyTracker - Automatic dependency tracking through Proxies
-*
-* Tracks property access on state objects to automatically determine
-* which parts of the state a component depends on.
-*/
-/**
-* Check if a value is an object that can be proxied
-*/
-function isProxyable$1(value) {
-	return value !== null && typeof value === "object" && !(value instanceof Date) && !(value instanceof RegExp) && !(value instanceof Map) && !(value instanceof Set) && !(value instanceof WeakMap) && !(value instanceof WeakSet) && !(value instanceof Promise);
-}
-/**
-* Tracks property access on state objects
-*/
-var ProxyTracker = class {
-	constructor() {
-		this.trackedPaths = /* @__PURE__ */ new Set();
-		this.isTracking = false;
-		this.proxyCache = /* @__PURE__ */ new WeakMap();
-		this.maxDepth = 10;
-	}
-	/**
-	* Create a proxy that tracks property access
-	*/
-	createProxy(target, path = "", depth = 0) {
-		if (!this.isTracking || !isProxyable$1(target)) return target;
-		if (depth >= this.maxDepth) return target;
-		if (this.proxyCache.has(target)) return this.proxyCache.get(target);
-		if (Array.isArray(target)) return this.createArrayProxy(target, path, depth);
-		const proxy = new Proxy(target, {
-			get: (obj, prop) => {
-				const value = Reflect.get(obj, prop);
-				if (typeof value === "function") return value.bind(obj);
-				const fullPath = path ? `${path}.${String(prop)}` : String(prop);
-				if (isProxyable$1(value)) return this.createProxy(value, fullPath, depth + 1);
-				if (typeof prop === "string" && this.isTracking) {
-					if (!prop.startsWith("_") && !prop.startsWith("$$")) {
-						this.trackedPaths.add(fullPath);
-						debug("ProxyTracker", "Tracked property access", {
-							path: fullPath,
-							valueType: typeof value
-						});
-					}
-				}
-				return value;
-			},
-			has: (obj, prop) => {
-				if (typeof prop === "string" && this.isTracking) {
-					const fullPath = path ? `${path}.${prop}` : prop;
-					this.trackedPaths.add(fullPath);
-					debug("ProxyTracker", "Tracked \"in\" operator access", { path: fullPath });
-				}
-				return Reflect.has(obj, prop);
-			},
-			ownKeys: (obj) => {
-				if (this.isTracking && path) {
-					this.trackedPaths.add(path);
-					debug("ProxyTracker", "Tracked object keys iteration", { path });
-				}
-				return Reflect.ownKeys(obj);
-			}
-		});
-		this.proxyCache.set(target, proxy);
-		return proxy;
-	}
-	/**
-	* Create a proxy for arrays with special handling
-	*/
-	createArrayProxy(target, path, depth = 0) {
-		const proxy = new Proxy(target, { get: (arr, prop) => {
-			const value = Reflect.get(arr, prop);
-			if (typeof value === "function") {
-				if (this.isTracking && path && typeof prop === "string") {
-					this.trackedPaths.add(path);
-					debug("ProxyTracker", "Tracked array method access", {
-						path,
-						method: String(prop)
-					});
-				}
-				return value.bind(arr);
-			}
-			let fullPath;
-			if (prop === "length") fullPath = path ? `${path}.length` : "length";
-			else if (typeof prop === "string") {
-				const index = Number(prop);
-				if (!isNaN(index) && index >= 0) fullPath = path ? `${path}[${index}]` : `[${index}]`;
-				else fullPath = path ? `${path}.${prop}` : prop;
-			} else return value;
-			if (isProxyable$1(value)) return this.createProxy(value, fullPath, depth + 1);
-			if (this.isTracking) {
-				this.trackedPaths.add(fullPath);
-				debug("ProxyTracker", "Tracked array property access", {
-					path: fullPath,
-					valueType: typeof value
-				});
-			}
-			return value;
-		} });
-		this.proxyCache.set(target, proxy);
-		return proxy;
-	}
-	/**
-	* Start tracking property access
-	*/
-	startTracking() {
-		this.isTracking = true;
-		this.trackedPaths.clear();
-		debug("ProxyTracker", "Started tracking");
-	}
-	/**
-	* Stop tracking and return tracked paths
-	*/
-	stopTracking() {
-		this.isTracking = false;
-		debug("ProxyTracker", "Stopped tracking", {
-			pathCount: this.trackedPaths.size,
-			paths: Array.from(this.trackedPaths)
-		});
-		return new Set(this.trackedPaths);
-	}
-	/**
-	* Get currently tracked paths
-	*/
-	getTrackedPaths() {
-		return new Set(this.trackedPaths);
-	}
-	/**
-	* Check if currently tracking
-	*/
-	isCurrentlyTracking() {
-		return this.isTracking;
-	}
-	/**
-	* Clear proxy cache (useful for memory management)
-	*/
-	clearCache() {
-		this.proxyCache = /* @__PURE__ */ new WeakMap();
-	}
-	/**
-	* Set maximum tracking depth
-	*/
-	setMaxDepth(depth) {
-		this.maxDepth = Math.max(1, depth);
-	}
-	/**
-	* Add a path manually (useful for forcing dependencies)
-	*/
-	addPath(path) {
-		this.trackedPaths.add(path);
-	}
-	/**
-	* Remove a path manually
-	*/
-	removePath(path) {
-		this.trackedPaths.delete(path);
-	}
-	/**
-	* Clear all tracked paths
-	*/
-	clearPaths() {
-		this.trackedPaths.clear();
-	}
-};
-/**
-* Global proxy tracker instance for convenience
-*/
-const globalProxyTracker = new ProxyTracker();
-/**
-* Utility function to track property access in a callback
-*/
-function trackAccess(state, callback) {
-	const tracker = new ProxyTracker();
-	tracker.startTracking();
-	return {
-		result: callback(tracker.createProxy(state)),
-		trackedPaths: tracker.stopTracking()
-	};
-}
-
 //#endregion
 //#region src/adapter/framework-adapter.ts
 /**
@@ -2135,6 +1870,102 @@ function disableGetterTracking(adapterState, rawInstance) {
 	}
 }
 
+//#endregion
+//#region src/logging/Logger.ts
+let LogLevel = /* @__PURE__ */ function(LogLevel$1) {
+	LogLevel$1[LogLevel$1["ERROR"] = 0] = "ERROR";
+	LogLevel$1[LogLevel$1["WARN"] = 1] = "WARN";
+	LogLevel$1[LogLevel$1["INFO"] = 2] = "INFO";
+	LogLevel$1[LogLevel$1["DEBUG"] = 3] = "DEBUG";
+	return LogLevel$1;
+}({});
+/**
+* Creates a logger instance with given configuration
+*
+* @param config - Logger configuration
+* @returns Logger instance with debug, info, warn, error, and configure methods
+*
+* @example
+* ```ts
+* const logger = createLogger({
+*   enabled: true,
+*   level: LogLevel.DEBUG,
+*   output: (entry) => console.log(JSON.stringify(entry))
+* });
+* logger.debug('MyComponent', 'Rendering', { props: { foo: 'bar' } });
+* ```
+*/
+function createLogger(config) {
+	const shouldLog = (level) => {
+		return config.enabled && config.level >= level;
+	};
+	const log = (level, context, message, data) => {
+		try {
+			const entry = {
+				level,
+				context,
+				message,
+				timestamp: Date.now(),
+				...data !== void 0 && { data: serialize(data) }
+			};
+			config.output(entry);
+		} catch (e) {
+			console.error("[BlacLogger] Error logging:", e);
+		}
+	};
+	const serialize = (data) => {
+		try {
+			return JSON.parse(JSON.stringify(data));
+		} catch {
+			return String(data);
+		}
+	};
+	return {
+		debug: (context, message, data) => {
+			if (shouldLog(LogLevel.DEBUG)) log("DEBUG", context, message, data);
+		},
+		info: (context, message, data) => {
+			if (shouldLog(LogLevel.INFO)) log("INFO", context, message, data);
+		},
+		warn: (context, message, data) => {
+			if (shouldLog(LogLevel.WARN)) log("WARN", context, message, data);
+		},
+		error: (context, message, data) => {
+			if (shouldLog(LogLevel.ERROR)) log("ERROR", context, message, data);
+		},
+		configure: (opts) => {
+			Object.assign(config, opts);
+		}
+	};
+}
+let currentConfig = {
+	enabled: false,
+	level: LogLevel.INFO,
+	output: (entry) => console.log(JSON.stringify(entry))
+};
+let defaultLogger = createLogger(currentConfig);
+const debug = (context, message, data) => defaultLogger.debug(context, message, data);
+const info = (context, message, data) => defaultLogger.info(context, message, data);
+const warn = (context, message, data) => defaultLogger.warn(context, message, data);
+const error = (context, message, data) => defaultLogger.error(context, message, data);
+/**
+* Configuration function that recreates the default logger
+*
+* @param opts - Partial logger configuration
+*
+* @example
+* ```ts
+* configureLogger({ enabled: true, level: LogLevel.DEBUG });
+* ```
+*/
+function configureLogger(opts) {
+	currentConfig = {
+		...currentConfig,
+		...opts
+	};
+	defaultLogger = createLogger(currentConfig);
+}
+
 //#endregion
 exports.AuthVertex = AuthVertex;
 exports.BLAC_DEFAULTS = BLAC_DEFAULTS;
@@ -2151,7 +1982,6 @@ exports.LogLevel = LogLevel;
 exports.LoginEvent = LoginEvent;
 exports.LogoutEvent = LogoutEvent;
 exports.PluginManager = PluginManager;
-exports.ProxyTracker = ProxyTracker;
 exports.ResetEvent = ResetEvent;
 exports.StateContainer = StateContainer;
 exports.StateContainerRegistry = StateContainerRegistry;
@@ -2192,7 +2022,6 @@ exports.getGetterExecutionContext = getGetterExecutionContext;
 exports.getPluginManager = getPluginManager;
 exports.getStaticProp = getStaticProp;
 exports.getValueAtPath = getValueAtPath;
-exports.globalProxyTracker = globalProxyTracker;
 exports.globalRegistry = globalRegistry;
 exports.hasChanges = hasChanges;
 exports.hasGetterChanges = hasGetterChanges;
@@ -2216,6 +2045,5 @@ exports.shallowEqual = shallowEqual;
 exports.startProxyTracking = startProxyTracking;
 exports.startTracking = startTracking;
 exports.stopProxyTracking = stopProxyTracking;
-exports.trackAccess = trackAccess;
 exports.warn = warn;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -8,7 +8,6 @@ export type { BlacPlugin, BlacPluginWithInit, PluginContext, PluginConfig, Insta
 export { PluginManager, createPluginManager } from './plugin/PluginManager';
 export { hasInitHook } from './plugin/BlacPlugin';
 export * from './tracking';
-export * from './proxy/ProxyTracker';
 export * from './adapter';
 export type { Brand, BrandedId, InstanceId } from './types/branded';
 export type { BaseEvent } from './types/events';

package/dist/index.d.ts

@@ -8,7 +8,6 @@ export type { BlacPlugin, BlacPluginWithInit, PluginContext, PluginConfig, Insta
 export { PluginManager, createPluginManager } from './plugin/PluginManager';
 export { hasInitHook } from './plugin/BlacPlugin';
 export * from './tracking';
-export * from './proxy/ProxyTracker';
 export * from './adapter';
 export type { Brand, BrandedId, InstanceId } from './types/branded';
 export type { BaseEvent } from './types/events';