@wooksjs/event-core 0.7.4 → 0.7.5

package/dist/index.cjs

@@ -116,6 +116,17 @@ var EventContext = class {
 		this.parent = options.parent;
 	}
 	/**
+	* Controls whether `get()`, `has()`, and `set()` traverse the parent chain
+	* for a given slot. Override in subclasses to isolate specific slots —
+	* returning `false` forces local computation/storage, preventing inheritance.
+	*
+	* @param _id - The numeric slot identifier (`accessor._id`)
+	* @returns `true` to allow parent traversal (default), `false` to block it
+	*/
+	_shouldTraverseParent(_id) {
+		return true;
+	}
+	/**
 	* Reads a value from a typed slot.
 	* - For `Key<T>`: returns the previously `set` value, checking parent chain if not found locally.
 	* - For `Cached<T>`: returns a cached result from this context or any parent. If not found
@@ -125,7 +136,7 @@ var EventContext = class {
 	get(accessor) {
 		const id = accessor._id;
 		let val = this.slots.get(id);
-		if (val === void 0 && this.parent) val = this.parent._findSlot(id);
+		if (val === void 0 && this.parent && this._shouldTraverseParent(id)) val = this.parent._findSlot(id);
 		if (val !== void 0) {
 			if (val === COMPUTING) throw new Error(`Circular dependency detected for "${accessor._name}"`);
 			if (val instanceof CachedError) throw val.error;
@@ -155,7 +166,7 @@ var EventContext = class {
 			this.slots.set(key$1._id, encoded);
 			return;
 		}
-		if (this.parent && this.parent._setIfExists(key$1._id, encoded)) return;
+		if (this.parent && this._shouldTraverseParent(key$1._id) && this.parent._setIfExists(key$1._id, encoded)) return;
 		this.slots.set(key$1._id, encoded);
 	}
 	/**
@@ -164,7 +175,8 @@ var EventContext = class {
 	has(accessor) {
 		const val = this.slots.get(accessor._id);
 		if (val !== void 0 && val !== COMPUTING) return true;
-		return this.parent?.has(accessor) ?? false;
+		if (this.parent && this._shouldTraverseParent(accessor._id)) return this.parent.has(accessor);
+		return false;
 	}
 	/**
 	* Reads a value from a typed slot in this context only, ignoring parents.
@@ -293,7 +305,7 @@ function resetContextInjector() {
 //#region packages/event-core/src/storage.ts
 const STORAGE_KEY = Symbol.for("wooks.core.asyncStorage");
 const VERSION_KEY = Symbol.for("wooks.core.asyncStorage.version");
-const CURRENT_VERSION = "0.7.3";
+const CURRENT_VERSION = "0.7.4";
 const _g = globalThis;
 if (_g[STORAGE_KEY]) {
 	if (_g[VERSION_KEY] !== CURRENT_VERSION) throw new Error(`[wooks] Incompatible versions of @wooksjs/event-core detected: existing v${_g[VERSION_KEY]}, loading v${CURRENT_VERSION}. All packages must use the same @wooksjs/event-core version.`);
@@ -460,7 +472,7 @@ function defineEventKind(name, schema) {
 * composables (`useRequest`, `useResponse`, `useCookies`, etc.) are created with `defineWook`.
 *
 * @param factory - Receives the `EventContext` and returns the composable's public API
-* @returns A composable function `(ctx?: EventContext) => T`
+* @returns A composable function with an exposed `_slot` for isolation
 *
 * @example
 * ```ts
@@ -478,8 +490,8 @@ function defineEventKind(name, schema) {
 * ```
 */
 function defineWook(factory) {
-	const slot$1 = cached(factory);
-	return (ctx) => (ctx ?? current()).get(slot$1);
+	const _slot = cached(factory);
+	return Object.assign((ctx) => (ctx ?? current()).get(_slot), { _slot });
 }
 
 //#endregion

package/dist/index.d.ts

@@ -98,6 +98,15 @@ declare class EventContext {
     readonly parent?: EventContext;
     private slots;
     constructor(options: EventContextOptions);
+    /**
+     * Controls whether `get()`, `has()`, and `set()` traverse the parent chain
+     * for a given slot. Override in subclasses to isolate specific slots —
+     * returning `false` forces local computation/storage, preventing inheritance.
+     *
+     * @param _id - The numeric slot identifier (`accessor._id`)
+     * @returns `true` to allow parent traversal (default), `false` to block it
+     */
+    protected _shouldTraverseParent(_id: number): boolean;
     /**
      * Reads a value from a typed slot.
      * - For `Key<T>`: returns the previously `set` value, checking parent chain if not found locally.
@@ -230,6 +239,15 @@ declare function slot<T>(): SlotMarker<T>;
  */
 declare function defineEventKind<S extends Record<string, SlotMarker<any>>>(name: string, schema: S): EventKind<S>;
 
+/**
+ * A composable function created by {@link defineWook}. Callable as `(ctx?) => T`,
+ * with an exposed `_slot` for advanced use cases such as slot isolation in child contexts.
+ */
+interface WookComposable<T> {
+    (ctx?: EventContext): T;
+    /** The underlying `Cached` slot. Useful for building isolation lists in child contexts. */
+    readonly _slot: Cached<T>;
+}
 /**
  * Creates a composable with per-event caching. The factory runs once per
  * `EventContext`; subsequent calls within the same event return the cached result.
@@ -238,7 +256,7 @@ declare function defineEventKind<S extends Record<string, SlotMarker<any>>>(name
  * composables (`useRequest`, `useResponse`, `useCookies`, etc.) are created with `defineWook`.
  *
  * @param factory - Receives the `EventContext` and returns the composable's public API
- * @returns A composable function `(ctx?: EventContext) => T`
+ * @returns A composable function with an exposed `_slot` for isolation
  *
  * @example
  * ```ts
@@ -255,7 +273,7 @@ declare function defineEventKind<S extends Record<string, SlotMarker<any>>>(name
  * const { username, profile } = useCurrentUser()
  * ```
  */
-declare function defineWook<T>(factory: (ctx: EventContext) => T): (ctx?: EventContext) => T;
+declare function defineWook<T>(factory: (ctx: EventContext) => T): WookComposable<T>;
 
 /**
  * No-op base class for observability integration. Subclass and override
@@ -437,4 +455,4 @@ declare function createEventContext<R>(options: EventContextOptions, fn: () => R
 declare function createEventContext<S extends Record<string, any>, R>(options: EventContextOptions, kind: EventKind<S>, seeds: EventKindSeeds<EventKind<S>>, fn: () => R): R;
 
 export { ContextInjector, EventContext, cached, cachedBy, createEventContext, current, defineEventKind, defineWook, eventTypeKey, getContextInjector, key, replaceContextInjector, resetContextInjector, routeParamsKey, run, slot, tryGetCurrent, useEventId, useLogger, useRouteParams };
-export type { Accessor, Cached, EventContextOptions, EventKind, EventKindSeeds, Key, Logger, SlotMarker, TContextInjectorHooks };
+export type { Accessor, Cached, EventContextOptions, EventKind, EventKindSeeds, Key, Logger, SlotMarker, TContextInjectorHooks, WookComposable };

package/dist/index.mjs

@@ -93,6 +93,17 @@ var EventContext = class {
 		this.parent = options.parent;
 	}
 	/**
+	* Controls whether `get()`, `has()`, and `set()` traverse the parent chain
+	* for a given slot. Override in subclasses to isolate specific slots —
+	* returning `false` forces local computation/storage, preventing inheritance.
+	*
+	* @param _id - The numeric slot identifier (`accessor._id`)
+	* @returns `true` to allow parent traversal (default), `false` to block it
+	*/
+	_shouldTraverseParent(_id) {
+		return true;
+	}
+	/**
 	* Reads a value from a typed slot.
 	* - For `Key<T>`: returns the previously `set` value, checking parent chain if not found locally.
 	* - For `Cached<T>`: returns a cached result from this context or any parent. If not found
@@ -102,7 +113,7 @@ var EventContext = class {
 	get(accessor) {
 		const id = accessor._id;
 		let val = this.slots.get(id);
-		if (val === void 0 && this.parent) val = this.parent._findSlot(id);
+		if (val === void 0 && this.parent && this._shouldTraverseParent(id)) val = this.parent._findSlot(id);
 		if (val !== void 0) {
 			if (val === COMPUTING) throw new Error(`Circular dependency detected for "${accessor._name}"`);
 			if (val instanceof CachedError) throw val.error;
@@ -132,7 +143,7 @@ var EventContext = class {
 			this.slots.set(key$1._id, encoded);
 			return;
 		}
-		if (this.parent && this.parent._setIfExists(key$1._id, encoded)) return;
+		if (this.parent && this._shouldTraverseParent(key$1._id) && this.parent._setIfExists(key$1._id, encoded)) return;
 		this.slots.set(key$1._id, encoded);
 	}
 	/**
@@ -141,7 +152,8 @@ var EventContext = class {
 	has(accessor) {
 		const val = this.slots.get(accessor._id);
 		if (val !== void 0 && val !== COMPUTING) return true;
-		return this.parent?.has(accessor) ?? false;
+		if (this.parent && this._shouldTraverseParent(accessor._id)) return this.parent.has(accessor);
+		return false;
 	}
 	/**
 	* Reads a value from a typed slot in this context only, ignoring parents.
@@ -270,7 +282,7 @@ function resetContextInjector() {
 //#region packages/event-core/src/storage.ts
 const STORAGE_KEY = Symbol.for("wooks.core.asyncStorage");
 const VERSION_KEY = Symbol.for("wooks.core.asyncStorage.version");
-const CURRENT_VERSION = "0.7.3";
+const CURRENT_VERSION = "0.7.4";
 const _g = globalThis;
 if (_g[STORAGE_KEY]) {
 	if (_g[VERSION_KEY] !== CURRENT_VERSION) throw new Error(`[wooks] Incompatible versions of @wooksjs/event-core detected: existing v${_g[VERSION_KEY]}, loading v${CURRENT_VERSION}. All packages must use the same @wooksjs/event-core version.`);
@@ -437,7 +449,7 @@ function defineEventKind(name, schema) {
 * composables (`useRequest`, `useResponse`, `useCookies`, etc.) are created with `defineWook`.
 *
 * @param factory - Receives the `EventContext` and returns the composable's public API
-* @returns A composable function `(ctx?: EventContext) => T`
+* @returns A composable function with an exposed `_slot` for isolation
 *
 * @example
 * ```ts
@@ -455,8 +467,8 @@ function defineEventKind(name, schema) {
 * ```
 */
 function defineWook(factory) {
-	const slot$1 = cached(factory);
-	return (ctx) => (ctx ?? current()).get(slot$1);
+	const _slot = cached(factory);
+	return Object.assign((ctx) => (ctx ?? current()).get(_slot), { _slot });
 }
 
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wooksjs/event-core",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "description": "@wooksjs/event-core",
   "keywords": [
     "composables",