@blac/react 2.0.20 → 2.0.22

package/dist/index.cjs

@@ -30,6 +30,7 @@ const ProvidedArgsContext = (0, react.createContext)(/* @__PURE__ */ new Map());
 *   <CartWidget />
 * </BlocProvider>
 * ```
+* @public
 */
 function BlocProvider({ bloc, args, children }) {
 	const parentMap = (0, react.useContext)(ProvidedArgsContext);
@@ -40,7 +41,7 @@ function BlocProvider({ bloc, args, children }) {
 	}, [
 		parentMap,
 		bloc,
-		args
+		(0, _blac_core.resolveInstanceKey)(bloc, args)
 	]);
 	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(ProvidedArgsContext.Provider, {
 		value: mergedMap,
@@ -52,69 +53,107 @@ function BlocProvider({ bloc, args, children }) {
 * bloc class, or `undefined` when called outside a matching provider.
 *
 * Used by `useBloc` to inherit provider args when no own `args` are given.
+* @public
 */
 function useProvidedArgs(BlocClass) {
 	return (0, react.useContext)(ProvidedArgsContext).get(BlocClass);
 }
 //#endregion
+//#region src/RegistryProvider.tsx
+/**
+* Internal context value: a registry to use in place of the module-global
+* default (`getRegistry()`), or `null` when no provider is present.
+*/
+const RegistryContext = (0, react.createContext)(null);
+/**
+* Scopes descendant `useBloc` calls to a specific registry instead of the
+* module-global default.
+*
+* Useful for test isolation, SSR isolation, and micro-frontends that must
+* not share bloc instances with the host page.
+*
+* @example
+* ```tsx
+* <RegistryProvider registry={new StateContainerRegistry()}>
+*   <App />
+* </RegistryProvider>
+* ```
+* @public
+*/
+function RegistryProvider({ registry, children }) {
+	return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(RegistryContext.Provider, {
+		value: registry,
+		children
+	});
+}
+//#endregion
 //#region src/buildTrackedProxy.ts
+function supportsTrackedState(value) {
+	return typeof value[_blac_core.WITH_TRACKED_STATE] === "function";
+}
+const gettersByProto = /* @__PURE__ */ new WeakMap();
+function collectGetters(proto) {
+	const cached = gettersByProto.get(proto);
+	if (cached !== void 0) return cached;
+	const getters = /* @__PURE__ */ new Map();
+	let p = proto;
+	while (p !== null && p !== Object.prototype) {
+		for (const key of Reflect.ownKeys(p)) {
+			const desc = Object.getOwnPropertyDescriptor(p, key);
+			if (desc?.get && !getters.has(key)) getters.set(key, desc.get);
+		}
+		p = Object.getPrototypeOf(p);
+	}
+	gettersByProto.set(proto, getters);
+	return getters;
+}
 /**
-* Build a per-consumer proxy pair for a bloc instance.
+* Build a per-consumer proxy for a bloc instance.
 *
-* Returns two proxies:
-* - `proxy` — the stable outer proxy returned to the consumer. Getter
-*   properties are invoked with `thisProxy` as `this` so that `this.state`
-*   reads inside getters are redirected to the current render's tracking
-*   proxy. Non-getter properties fall through to the live instance.
-* - `thisProxy` — the inner `this`-proxy used as the receiver for getter
-*   calls. Intercepts `state` to return `trackedStateRef.current` when a
-*   tracking context is active; otherwise falls through to the live value.
-*   When `onDepHandle` is supplied, a read off `this` whose value carries the
-*   `DEP_BRAND` symbol (i.e. a `depend()` handle) is routed through
-*   `onDepHandle`, which returns a per-consumer wrapper whose `.track()` opts
-*   the consumer into cross-bloc reactivity. Core stays decoupled — detection
-*   is purely by the `DEP_BRAND` symbol.
+* Getters run with `this` bound to the **real instance**, not a proxy, so ES
+* `#private` fields and methods work in user blocs. Path recording is done by
+* `[WITH_TRACKED_STATE]`, which makes the instance's own `state` getter report
+* the render's tracking proxy for the duration of the call; nested getter
+* chains stay tracked because the override is still set.
 *
-* Both allocations happen exactly once per bloc acquisition (inside `useMemo`)
-* so the proxies are stable across renders.
+* One allocation per bloc acquisition (inside `useMemo`), so the proxy is
+* stable across renders.
 *
-* @param onDepHandle - Optional callback invoked when a getter reads a branded
-*   dep handle off `this`. Receives the original handle and returns the value
-*   to expose in its place (the session-bound wrapper). The callback is
-*   responsible for caching wrappers per handle to avoid re-allocation.
+* @param onDepHandle - Optional callback invoked when a read returns a branded
+*   dep handle. Receives the original handle and returns the value to expose in
+*   its place (the session-bound wrapper). The callback is responsible for
+*   caching wrappers per handle to avoid re-allocation.
 */
 function buildTrackedProxy(instance, trackedStateRef, onDepHandle) {
-	const getterDescs = /* @__PURE__ */ new Map();
-	let proto = Object.getPrototypeOf(instance);
-	while (proto && proto !== Object.prototype) {
-		const keys = [...Object.getOwnPropertyNames(proto), ...Object.getOwnPropertySymbols(proto)];
-		for (const key of keys) {
-			const desc = Object.getOwnPropertyDescriptor(proto, key);
-			if (desc?.get && !getterDescs.has(key)) getterDescs.set(key, desc);
-		}
-		proto = Object.getPrototypeOf(proto);
-	}
-	const thisProxy = new Proxy(instance, { get(t, k, r) {
-		if (k === "state") return trackedStateRef.current ?? Reflect.get(t, k, r);
-		const value = Reflect.get(t, k, r);
+	const getters = collectGetters(Object.getPrototypeOf(instance));
+	const tracksState = supportsTrackedState(instance);
+	const boundMethods = /* @__PURE__ */ new Map();
+	const wrapDepHandle = (value) => {
 		if (onDepHandle !== void 0 && (typeof value === "function" || typeof value === "object") && value !== null && value[_blac_core.DEP_BRAND] !== void 0) return onDepHandle(value);
 		return value;
-	} });
-	return {
-		proxy: new Proxy(instance, { get(target, key, receiver) {
-			const desc = getterDescs.get(key);
-			if (desc?.get) return desc.get.call(thisProxy);
-			return Reflect.get(target, key, receiver);
-		} }),
-		thisProxy
 	};
+	return { proxy: new Proxy(instance, { get(target, key) {
+		const getter = getters.get(key);
+		if (getter !== void 0) {
+			const tracked = trackedStateRef.current;
+			return wrapDepHandle(tracked == null || !tracksState ? getter.call(target) : target[_blac_core.WITH_TRACKED_STATE](tracked, getter, onDepHandle));
+		}
+		const value = Reflect.get(target, key, target);
+		if (typeof value === "function") {
+			let bound = boundMethods.get(key);
+			if (bound === void 0) {
+				bound = value.bind(target);
+				boundMethods.set(key, bound);
+			}
+			return wrapDepHandle(bound);
+		}
+		return wrapDepHandle(value);
+	} }) };
 }
 //#endregion
 //#region src/useBloc.ts
 let nextConsumerId = 0;
 const ARGS_UNSET = Symbol("blac.argsKeyUnset");
-const primaryRefId = (consumerId) => `useBloc@${consumerId}`;
-const depRefId = (consumerId) => `useBloc@${consumerId}:dep`;
 /**
 * React hook that connects a component to a state container with automatic
 * re-render on state changes.
@@ -123,7 +162,7 @@ const depRefId = (consumerId) => `useBloc@${consumerId}:dep`;
 * - **Auto-tracking** (default): the returned state value is a proxy that
 *   records read paths during render. The component re-renders when any
 *   recorded path changes. Backed by `@dirtytalk/structural`'s
-*   {@link trackRender} + the container's path-scoped `DirtyChannel`.
+*   `trackRender` + the container's path-scoped `DirtyChannel`.
 * - **Manual select**: pass `options.select` to opt out of auto-tracking.
 *   The hook re-renders only when the returned array's elements change
 *   (per-index `Object.is`).
@@ -143,7 +182,7 @@ const depRefId = (consumerId) => `useBloc@${consumerId}:dep`;
 * const [state, bloc] = useBloc(MyBloc, { args: { _id: id } });
 * ```
 *
-* @template T - The state container constructor type (inferred from BlocClass)
+* @typeParam T - The state container constructor type (inferred from BlocClass)
 * @param BlocClass - The state container class to connect to
 * @param options - Configuration options
 * @returns Tuple of `[state, bloc, ref]`
@@ -164,68 +203,49 @@ const depRefId = (consumerId) => `useBloc@${consumerId}:dep`;
 * ```ts
 * const [state, bloc] = useBloc(UserBloc, { args: { userId: 'alice' } });
 * ```
+* @public
 */
 function useBloc(BlocClass, options) {
-	const componentRef = (0, react.useRef)({});
-	const consumerIdRef = (0, react.useRef)(null);
-	if (consumerIdRef.current === null) consumerIdRef.current = `useBloc-${nextConsumerId++}`;
-	const consumerId = consumerIdRef.current;
-	(0, react.useId)();
-	const selectRef = (0, react.useRef)(options?.select);
-	selectRef.current = options?.select;
-	const onMountRef = (0, react.useRef)(options?.onMount);
-	onMountRef.current = options?.onMount;
-	const onUnmountRef = (0, react.useRef)(options?.onUnmount);
-	onUnmountRef.current = options?.onUnmount;
+	const registry = (0, react.useContext)(RegistryContext) ?? (0, _blac_core.getRegistry)();
+	const consumerRef = (0, react.useRef)(null);
+	const consumer = consumerRef.current ??= createConsumer();
+	const consumerId = consumer.id;
+	consumer.select = options?.select;
+	consumer.onMount = options?.onMount;
+	consumer.onUnmount = options?.onUnmount;
 	const ownArgs = options?.args;
-	const ownArgsRef = (0, react.useRef)(ownArgs);
-	ownArgsRef.current = ownArgs;
-	const ownArgsKeyRef = (0, react.useRef)({
-		ref: ARGS_UNSET,
-		key: void 0
-	});
-	if (!Object.is(ownArgsKeyRef.current.ref, ownArgs)) ownArgsKeyRef.current = {
-		ref: ownArgs,
-		key: ownArgs === void 0 ? void 0 : JSON.stringify(ownArgs)
-	};
-	const ownArgsKey = ownArgsKeyRef.current.key;
+	consumer.ownArgs = ownArgs;
+	if (!Object.is(consumer.ownArgsKeyFor, ownArgs)) {
+		consumer.ownArgsKeyFor = ownArgs;
+		consumer.ownArgsKey = ownArgs === void 0 ? void 0 : JSON.stringify(ownArgs);
+	}
+	const ownArgsKey = consumer.ownArgsKey;
 	const providerArgs = useProvidedArgs(BlocClass);
-	const providerArgsRef = (0, react.useRef)(providerArgs);
-	providerArgsRef.current = providerArgs;
-	const providerArgsKeyRef = (0, react.useRef)({
-		ref: ARGS_UNSET,
-		key: void 0
-	});
-	if (!Object.is(providerArgsKeyRef.current.ref, providerArgs)) providerArgsKeyRef.current = {
-		ref: providerArgs,
-		key: providerArgs === void 0 ? void 0 : JSON.stringify(providerArgs)
-	};
-	const providerArgsKey = providerArgsKeyRef.current.key;
-	const trackedStateRef = (0, react.useRef)(null);
-	const sessionRef = (0, react.useRef)(/* @__PURE__ */ new Map());
-	const depSubsRef = (0, react.useRef)(/* @__PURE__ */ new Map());
-	const depWrapperCacheRef = (0, react.useRef)(/* @__PURE__ */ new Map());
-	const proxyCacheRef = (0, react.useRef)(new _dirtytalk_structural.ProxyCache());
-	const lastReconcileRef = (0, react.useRef)(null);
-	const [rebindNonce, bumpRebind] = (0, react.useReducer)((x) => x + 1, 0);
-	const ownedBlocRef = (0, react.useRef)(null);
+	consumer.providerArgs = providerArgs;
+	if (!Object.is(consumer.providerArgsKeyFor, providerArgs)) {
+		consumer.providerArgsKeyFor = providerArgs;
+		consumer.providerArgsKey = providerArgs === void 0 ? void 0 : JSON.stringify(providerArgs);
+	}
+	const providerArgsKey = consumer.providerArgsKey;
+	const rebindNonce = consumer.rebindNonce;
 	const { bloc, instanceKey, trackedBloc } = (0, react.useMemo)(() => {
-		const effectiveArgs = ownArgsRef.current !== void 0 ? ownArgsRef.current : providerArgsRef.current;
+		const effectiveArgs = resolveEffectiveArgs(consumer);
 		const resolvedKey = (0, _blac_core.resolveInstanceKey)(BlocClass, effectiveArgs);
-		const instance = (0, _blac_core.getRegistry)().acquire(BlocClass, resolvedKey, {
+		const instance = registry.acquire(BlocClass, resolvedKey, {
 			canCreate: true,
 			countRef: false,
-			args: effectiveArgs
+			args: effectiveArgs,
+			sweepIfUnowned: true
 		});
 		const onDepHandle = (handle) => {
-			const cache = depWrapperCacheRef.current;
+			const cache = consumer.depWrappers ??= /* @__PURE__ */ new Map();
 			const cached = cache.get(handle);
 			if (cached !== void 0) return cached;
-			const wrapper = makeDepWrapper(handle, consumerId, trackedStateRef, sessionRef, onDepHandle);
+			const wrapper = makeDepWrapper(handle, registry, consumer, onDepHandle);
 			cache.set(handle, wrapper);
 			return wrapper;
 		};
-		const { proxy } = buildTrackedProxy(instance, trackedStateRef, onDepHandle);
+		const { proxy } = buildTrackedProxy(instance, consumer.tracked, onDepHandle);
 		return {
 			bloc: instance,
 			instanceKey: resolvedKey,
@@ -235,101 +255,98 @@ function useBloc(BlocClass, options) {
 		BlocClass,
 		ownArgsKey,
 		providerArgsKey,
-		rebindNonce
+		rebindNonce,
+		registry
 	]);
-	const [, force] = (0, react.useReducer)((x) => x + 1, 0);
-	const pathRef = (0, react.useRef)((0, _dirtytalk_structural.emptyPathSet)());
-	const expandedInterestRef = (0, react.useRef)((0, _dirtytalk_structural.emptyPathSet)());
-	const lastSelectionRef = (0, react.useRef)(null);
-	const renderStateRef = (0, react.useRef)(void 0);
-	const prevBlocRef = (0, react.useRef)(null);
-	(0, react.useEffect)(() => {
-		const channel = bloc.channel;
-		if (selectRef.current !== void 0) {
-			const unsub = channel.subscribe(() => _dirtytalk_structural.ALL_PATHS, () => {
-				const select = selectRef.current;
-				if (!select) {
-					force();
-					return;
-				}
-				const next = select(bloc.state, bloc);
-				const prev = lastSelectionRef.current;
-				if (prev !== null && shallowArrayEqual(prev, next)) return;
-				lastSelectionRef.current = next;
-				force();
-			});
-			const select = selectRef.current;
-			if (select) {
-				const next = select(bloc.state, bloc);
-				const prev = lastSelectionRef.current;
-				if (prev === null || !shallowArrayEqual(prev, next)) {
-					lastSelectionRef.current = next;
-					force();
+	consumer.container = bloc;
+	(0, react.useSyncExternalStore)((0, react.useMemo)(() => (onStoreChange) => {
+		consumer.notify = onStoreChange;
+		const container = consumer.container;
+		const unsubscribe = container.channel.subscribe(() => consumer.interest, () => {
+			if (consumer.isSelectMode) {
+				const select = consumer.select;
+				if (select) {
+					const next = select(container.state, container);
+					const prev = consumer.selection;
+					if (prev !== null && shallowArrayEqual(prev, next)) return;
+					consumer.selection = next;
 				}
 			}
-			return unsub;
-		}
-		const unsub = channel.subscribe(() => expandedInterestRef.current, () => force());
-		bloc.registerConsumerPaths(consumerId, pathRef.current);
-		if (bloc.state !== renderStateRef.current) force();
+			consumer.bump();
+		});
+		container.registerConsumerPaths(consumerId, consumer.paths);
 		return () => {
-			unsub();
-			bloc.unregisterConsumer(consumerId);
+			consumer.notify = noop;
+			unsubscribe();
+			container.unregisterConsumer(consumerId);
 		};
-	}, [bloc, consumerId]);
+	}, [
+		BlocClass,
+		instanceKey,
+		consumerId,
+		rebindNonce
+	]), consumer.getSnapshot, consumer.getServerSnapshot);
 	(0, react.useLayoutEffect)(() => {
-		const registry = (0, _blac_core.getRegistry)();
 		const live = registry.acquire(BlocClass, instanceKey, {
 			canCreate: true,
 			countRef: true,
-			refId: primaryRefId(consumerId)
+			refId: consumer.primaryRefId,
+			args: resolveEffectiveArgs(consumer)
 		});
-		ownedBlocRef.current = live;
-		onMountRef.current?.(live);
-		if (live !== bloc) bumpRebind();
+		consumer.ownedBloc = live;
+		consumer.onMount?.(live);
+		if (live !== bloc) {
+			consumer.rebindNonce++;
+			consumer.bump();
+		}
 		return () => {
-			onUnmountRef.current?.(ownedBlocRef.current ?? bloc);
-			registry.release(BlocClass, instanceKey, false, primaryRefId(consumerId));
+			consumer.onUnmount?.(consumer.ownedBloc ?? bloc);
+			registry.release(BlocClass, instanceKey, false, consumer.primaryRefId);
 		};
 	}, [
 		BlocClass,
 		instanceKey,
-		consumerId
+		consumerId,
+		registry
 	]);
-	const rawState = bloc.state;
-	renderStateRef.current = rawState;
-	if (prevBlocRef.current !== bloc) {
-		prevBlocRef.current = bloc;
-		lastSelectionRef.current = null;
-	}
+	const container = consumer.container;
+	const rawState = container.state;
+	const select = consumer.select;
+	consumer.isSelectMode = select !== void 0;
 	let state;
-	if (selectRef.current !== void 0) {
+	if (select !== void 0) {
 		state = rawState;
-		if (lastSelectionRef.current === null) lastSelectionRef.current = selectRef.current(rawState, bloc);
+		if (consumer.selection === null) consumer.selection = select(rawState, bloc);
+		consumer.interest = _dirtytalk_structural.ALL_PATHS;
 	} else {
-		const tracked = (0, _dirtytalk_structural.trackRender)(rawState, bloc.interner, proxyCacheRef.current);
+		const tracked = (0, _dirtytalk_structural.trackRender)(rawState, container.interner, consumer.proxyCache ??= new _dirtytalk_structural.ProxyCache());
 		state = tracked.value;
-		trackedStateRef.current = tracked.value;
-		pathRef.current = tracked.paths;
-		const session = sessionRef.current;
+		consumer.tracked.current = tracked.value;
+		consumer.paths = tracked.paths;
+		consumer.disarm = tracked.disarm;
+		const session = consumer.session;
 		session.clear();
-		session.set(bloc, {
+		session.set(container, {
 			kind: "primary",
 			paths: tracked.paths
 		});
-		queueMicrotask(tracked.disarm);
 	}
 	(0, react.useLayoutEffect)(() => {
-		trackedStateRef.current = null;
-		if (selectRef.current !== void 0) {
-			lastReconcileRef.current = null;
+		consumer.tracked.current = null;
+		const disarm = consumer.disarm;
+		if (disarm !== null) {
+			consumer.disarm = null;
+			disarm();
+		}
+		if (consumer.isSelectMode) {
+			consumer.lastReconcile = null;
 			return;
 		}
-		const container = bloc;
-		const paths = pathRef.current;
-		const session = sessionRef.current;
-		const last = lastReconcileRef.current;
-		if (last !== null && last.primaryContainer === container && (0, _dirtytalk_structural.pathSetEquals)(last.primaryPaths, paths)) {
+		const primary = consumer.container;
+		const paths = consumer.paths;
+		const session = consumer.session;
+		const last = consumer.lastReconcile;
+		if (last !== null && last.primaryContainer === primary && (0, _dirtytalk_structural.pathSetEquals)(last.primaryPaths, paths)) {
 			let unchanged = last.deps.size === session.size - 1;
 			if (unchanged) for (const [depContainer, entry] of session) {
 				if (entry.kind === "primary") continue;
@@ -341,13 +358,13 @@ function useBloc(BlocClass, options) {
 			}
 			if (unchanged) return;
 		}
-		container.registerConsumerPaths(consumerId, paths);
-		expandedInterestRef.current = expandWithAncestors(paths, container.interner);
-		const subs = depSubsRef.current;
+		primary.registerConsumerPaths(consumerId, paths);
+		consumer.interest = expandWithAncestors(paths, primary.interner);
+		const subs = consumer.depSubs;
 		for (const [depContainer, sub] of subs) if (!session.has(depContainer)) {
 			sub.unsubscribe();
 			depContainer.unregisterConsumer(consumerId);
-			(0, _blac_core.getRegistry)().release(sub.Type, sub.key, false, sub.refId);
+			registry.release(sub.Type, sub.key, false, sub.refId);
 			subs.delete(depContainer);
 		}
 		for (const [depContainer, entry] of session) {
@@ -359,14 +376,14 @@ function useBloc(BlocClass, options) {
 				existing.interestRef.current = interest;
 				continue;
 			}
-			(0, _blac_core.getRegistry)().acquire(entry.Type, entry.key, {
+			registry.acquire(entry.Type, entry.key, {
 				canCreate: true,
 				countRef: true,
 				refId: entry.refId,
 				args: entry.args
 			});
 			const interestRef = { current: interest };
-			const unsubscribe = depContainer.channel.subscribe(() => interestRef.current, () => force());
+			const unsubscribe = depContainer.channel.subscribe(() => interestRef.current, () => consumer.bump());
 			subs.set(depContainer, {
 				unsubscribe,
 				interestRef,
@@ -386,35 +403,73 @@ function useBloc(BlocClass, options) {
 				args: entry.args
 			});
 		}
-		lastReconcileRef.current = {
-			primaryContainer: container,
+		consumer.lastReconcile = {
+			primaryContainer: primary,
 			primaryPaths: paths,
 			deps: depsSignature
 		};
 	});
 	(0, react.useEffect)(() => {
-		const subs = depSubsRef.current;
+		const subs = consumer.depSubs;
 		return () => {
 			for (const [depContainer, sub] of subs) {
 				sub.unsubscribe();
 				depContainer.unregisterConsumer(consumerId);
-				(0, _blac_core.getRegistry)().release(sub.Type, sub.key, false, sub.refId);
+				registry.release(sub.Type, sub.key, false, sub.refId);
 			}
 			subs.clear();
 		};
-	}, [consumerId]);
-	return [
-		state,
-		trackedBloc,
-		componentRef
-	];
+	}, [consumerId, registry]);
+	return [state, trackedBloc];
+}
+const noop = () => {};
+function createConsumer() {
+	const id = `useBloc-${nextConsumerId++}`;
+	const consumer = {
+		id,
+		primaryRefId: `useBloc@${id}`,
+		depRefId: `useBloc@${id}:dep`,
+		container: null,
+		version: 0,
+		notify: noop,
+		bump: () => {
+			consumer.version++;
+			consumer.notify();
+		},
+		getSnapshot: () => consumer.version,
+		getServerSnapshot: () => consumer.version,
+		interest: (0, _dirtytalk_structural.emptyPathSet)(),
+		paths: (0, _dirtytalk_structural.emptyPathSet)(),
+		isSelectMode: false,
+		selection: null,
+		session: /* @__PURE__ */ new Map(),
+		depSubs: /* @__PURE__ */ new Map(),
+		lastReconcile: null,
+		select: void 0,
+		onMount: void 0,
+		onUnmount: void 0,
+		ownArgs: void 0,
+		ownArgsKeyFor: ARGS_UNSET,
+		ownArgsKey: void 0,
+		providerArgs: void 0,
+		providerArgsKeyFor: ARGS_UNSET,
+		providerArgsKey: void 0,
+		tracked: { current: null },
+		disarm: null,
+		proxyCache: null,
+		depWrappers: null,
+		rebindNonce: 0,
+		ownedBloc: null
+	};
+	return consumer;
 }
+const resolveEffectiveArgs = (consumer) => consumer.ownArgs !== void 0 ? consumer.ownArgs : consumer.providerArgs;
 /**
 * Build the per-consumer wrapper that replaces a branded dep handle inside a
 * tracked getter's `this`. The wrapper exposes the same accessors as the core
 * handle and overrides `.track()`:
 *
-* - **Inside a render** (`trackedStateRef.current != null`): resolve (ENSURE,
+* - **Inside a render** (`consumer.tracked.current != null`): resolve (ENSURE,
 *   no ref) the dep, `trackRender` its state, merge the recorded paths into the
 *   session entry, build/reuse a tracked proxy for the dep so its OWN getters
 *   track too, and return `[trackedValue, depProxy]`. The ownership ref is taken
@@ -431,10 +486,9 @@ function useBloc(BlocClass, options) {
 * the dep already has a non-primary session entry this render, reuse its proxy
 * + union its paths instead of re-acquiring.
 */
-function makeDepWrapper(handle, consumerId, trackedStateRef, sessionRef, onDepHandle) {
+function makeDepWrapper(handle, registry, consumer, onDepHandle) {
 	const brand = handle[_blac_core.DEP_BRAND];
-	const refId = depRefId(consumerId);
-	const registry = (0, _blac_core.getRegistry)();
+	const refId = consumer.depRefId;
 	const perDep = /* @__PURE__ */ new Map();
 	const proxyCache = new _dirtytalk_structural.ProxyCache();
 	const resolve = (options) => {
@@ -450,8 +504,8 @@ function makeDepWrapper(handle, consumerId, trackedStateRef, sessionRef, onDepHa
 		untracked: (options) => resolve(options).dep,
 		track: (options) => {
 			const { dep, key, args } = resolve(options);
-			if (trackedStateRef.current == null) return [dep.state, dep];
-			const session = sessionRef.current;
+			if (consumer.tracked.current == null) return [dep.state, dep];
+			const session = consumer.session;
 			const existing = session.get(dep);
 			const tracked = (0, _dirtytalk_structural.trackRender)(dep.state, dep.interner, proxyCache);
 			let cache = perDep.get(dep);
@@ -507,7 +561,7 @@ const shallowArrayEqual = (a, b) => {
 * would miss a `patch`-triggered atomic-replacement of `items`.
 *
 * Ancestors are added under the interner's *ancestor-watch* lane
-* (`internAncestor`), NOT as normal ids. The source emits a matching
+* (`ancestorWatchIds`), NOT as normal ids. The source emits a matching
 * ancestor-watch mark only for paths it replaces atomically — never for a
 * plain-object structural pulse-up. So `{'items.length'}` wakes when the array
 * `items` is replaced, but `{'user.email'}` does NOT wake when a sibling
@@ -517,38 +571,57 @@ const shallowArrayEqual = (a, b) => {
 * Example: leaf `'a.b.c'` adds ancestor-watch ids for `'a.b'` and `'a'` (but
 * NOT the `''` root — a root change is covered by `ALL_PATHS` from the source,
 * and `''` would wake this consumer on every field change).
+*
+* Returns `paths` itself when no leaf has an ancestor (top-level fields only);
+* the set is frozen by then (see `Consumer.disarm`), so sharing it is safe.
 */
 function expandWithAncestors(paths, interner) {
 	if (paths === _dirtytalk_structural.ALL_PATHS) return _dirtytalk_structural.ALL_PATHS;
 	const leafPaths = paths;
-	if (leafPaths.size === 0) return paths;
-	const expanded = new Set(leafPaths);
+	let expanded;
 	for (const id of leafPaths) {
-		const str = interner.lookup(id);
-		let idx = str.lastIndexOf(".");
-		while (idx > 0) {
-			const ancestor = str.slice(0, idx);
-			expanded.add(interner.internAncestor(ancestor));
-			idx = ancestor.lastIndexOf(".");
-		}
+		const watch = interner.ancestorWatchIds(id);
+		if (watch.length === 0) continue;
+		expanded ??= new Set(leafPaths);
+		for (let i = 0; i < watch.length; i++) expanded.add(watch[i]);
 	}
-	return expanded;
+	return expanded ?? paths;
 }
-let globalConfig = {};
+//#endregion
+//#region src/useBlocDeps.ts
 /**
-* Configure global defaults for `@blac/react` hooks.
+* Feed live values from the component into a bloc's `deps` lane.
+*
+* Each calling component is one owner: its slice is shallow-merged into the
+* bloc's merged `deps` view, and withdrawn when the component unmounts. The
+* bloc observes changes through `onDepsChanged`.
+*
+* ```tsx
+* const [state, bloc] = useBloc(CanvasCubit);
+* useBlocDeps(bloc, { canvas, onTick });
+* ```
 *
-* @param config - Partial configuration to merge with current globals
+* Use this for values a bloc must *read* but should not own — DOM handles,
+* callbacks, values from other hooks. Pass identity-stable values (`useMemo` /
+* `useCallback`) as you would to any hook; a new function identity each render
+* counts as a change.
 */
-function configureBlacReact(config) {
-	globalConfig = {
-		...globalConfig,
-		...config
-	};
+function useBlocDeps(bloc, slice) {
+	const ownerId = (0, react.useId)();
+	const latest = (0, react.useRef)(slice);
+	latest.current = slice;
+	(0, react.useEffect)(() => {
+		bloc[_blac_core.APPLY_DEPS](ownerId, latest.current);
+	});
+	(0, react.useEffect)(() => {
+		return () => {
+			bloc[_blac_core.REMOVE_DEPS_OWNER](ownerId);
+		};
+	}, [bloc, ownerId]);
 }
 //#endregion
 exports.BlocProvider = BlocProvider;
-exports.configureBlacReact = configureBlacReact;
+exports.RegistryProvider = RegistryProvider;
 Object.defineProperty(exports, "untracked", {
 	enumerable: true,
 	get: function() {
@@ -556,6 +629,7 @@ Object.defineProperty(exports, "untracked", {
 	}
 });
 exports.useBloc = useBloc;
+exports.useBlocDeps = useBlocDeps;
 exports.useProvidedArgs = useProvidedArgs;
 
 //# sourceMappingURL=index.cjs.map