@manyducks.co/dolla 2.0.0-alpha.32 → 2.0.0-alpha.33

package/dist/core/context.d.ts

@@ -2,7 +2,7 @@ import type { Emitter } from "@manyducks.co/emitter";
 import type { Dolla } from "./dolla";
 import type { Store, StoreFunction } from "./store";
 interface ContextEmitterEvents {
-    [eventName: string | symbol]: [ContextEvent<any>];
+    [eventName: string | symbol]: [ContextEvent, ...args: any[]];
 }
 export interface ElementContext {
     /**
@@ -39,7 +39,7 @@ export interface ElementContext {
  * Wrapping listeners is necessary because the context API's `.on` method does not pass the event name to "*" listeners while the emitter does.
  * ContextEvent objects already have the event name stored as `event.type`.
  */
-export type WildcardListenerMap = Map<(event: ContextEvent<any>) => void, (eventName: string | symbol, event: ContextEvent<any>) => void>;
+export type WildcardListenerMap = Map<(event: ContextEvent, ...args: any[]) => void, (eventName: string | symbol, event: ContextEvent, ...args: any[]) => void>;
 export interface ComponentContext {
     /**
      * Sets a context variable and returns its value.
@@ -50,53 +50,52 @@ export interface ComponentContext {
      */
     get<T>(key: string | symbol): T | null;
     /**
-     * Adds a listener to be called when `eventName` is emitted.
+     * Adds a listener to be called when an event with a matching `type` is emitted.
      */
-    on<T = unknown>(eventName: string, listener: (event: ContextEvent<T>) => void): void;
+    on<T = unknown>(type: string, listener: (event: ContextEvent, ...args: any[]) => void): void;
     /**
-     * Removes a listener from the list to be called when `eventName` is emitted.
+     * Removes a listener from the list to be called when an event with a matching `type` is emitted.
      */
-    off<T = unknown>(eventName: string, listener: (event: ContextEvent<T>) => void): void;
+    off<T = unknown>(type: string, listener: (event: ContextEvent, ...args: any[]) => void): void;
     /**
-     * Adds a listener to be called when `eventName` is emitted. The listener is immediately removed after being called once.
+     * Adds a listener to be called when an event with a matching `type` is emitted. The listener is immediately removed after being called once.
      */
-    once<T = unknown>(eventName: string, listener: (event: ContextEvent<T>) => void): void;
+    once<T = unknown>(type: string, listener: (event: ContextEvent, ...args: any[]) => void): void;
     /**
      * Emits a new event to all listeners.
      */
-    emit<T = unknown>(eventName: string, detail: T): boolean;
+    emit<T = unknown>(type: string, ...args: any[]): boolean;
 }
 /**
  * A context capable of hosting stores.
  */
 export interface StorableContext extends ComponentContext {
     /**
-     * Attaches a new store to this context.
+     * Attaches a new store to this context and returns it.
      */
-    attachStore(store: StoreFunction<{}, any>): void;
+    provide<Value>(store: StoreFunction<{}, Value>): Value;
     /**
-     * Attaches a new store to this context.
+     * Attaches a new store to this context and returns it.
      */
-    attachStore(store: StoreFunction<undefined, any>): void;
+    provide<Value>(store: StoreFunction<undefined, Value>): Value;
     /**
-     * Attaches a new store to this context.
+     * Attaches a new store to this context and returns it.
      */
-    attachStore<Options>(store: StoreFunction<Options, any>, options: Options): void;
+    provide<Options, Value>(store: StoreFunction<Options, Value>, options: Options): Value;
     /**
      * Gets the closest instance of a store. Throws an error if the store isn't provided higher in the tree.
      */
-    useStore<Value>(store: StoreFunction<any, Value>): Value;
+    use<Value>(store: StoreFunction<any, Value>): Value;
 }
 /**
  * An event emitted from and received by a Dolla context. These are separate from DOM events.
  */
-export declare class ContextEvent<T> {
+export declare class ContextEvent {
     #private;
-    type: string;
-    detail: T;
-    get propagationStopped(): boolean;
-    constructor(type: string, detail: T);
-    stopPropagation(): void;
+    constructor(type: string);
+    get type(): string;
+    get isStopped(): boolean;
+    stop(): void;
     get [Symbol.toStringTag](): string;
 }
 export {};

package/dist/core/dolla.d.ts

@@ -97,37 +97,37 @@ export declare class Dolla implements StorableContext {
      * Returns an object of all context variables stored at the app level.
      */
     /**
-     * Adds a listener to be called when `eventName` is emitted.
+     * Adds a listener to be called when an event with a matching `type` is emitted.
      */
-    on<T = unknown>(eventName: string, listener: (event: ContextEvent<T>) => void): void;
+    on<T = unknown>(type: string, listener: (event: ContextEvent, ...args: any[]) => void): void;
     /**
-     * Removes a listener from the list to be called when `eventName` is emitted.
+     * Removes a listener from the list to be called when an event with a matching `type` is emitted.
      */
-    off<T = unknown>(eventName: string, listener: (event: ContextEvent<T>) => void): void;
+    off<T = unknown>(type: string, listener: (event: ContextEvent, ...args: any[]) => void): void;
     /**
-     * Adds a listener to be called when `eventName` is emitted. The listener is immediately removed after being called once.
+     * Adds a listener to be called when an event with a matching `type` is emitted. The listener is immediately removed after being called once.
      */
-    once<T = unknown>(eventName: string, listener: (event: ContextEvent<T>) => void): void;
+    once<T = unknown>(type: string, listener: (event: ContextEvent, ...args: any[]) => void): void;
     /**
      * Emits a new event to all listeners.
      */
-    emit<T = unknown>(eventName: string, detail: T): boolean;
+    emit<T = unknown>(type: string, ...args: any[]): boolean;
     /**
      * Attaches a new store to this context.
      */
-    attachStore(store: StoreFunction<{}, any>): void;
+    provide<Value>(store: StoreFunction<{}, Value>): Value;
     /**
      * Attaches a new store to this context.
      */
-    attachStore(store: StoreFunction<undefined, any>): void;
+    provide<Value>(store: StoreFunction<undefined, Value>): Value;
     /**
      * Attaches a new store to this context.
      */
-    attachStore<Options>(store: StoreFunction<Options, any>, options: Options): void;
+    provide<Options, Value>(store: StoreFunction<Options, Value>, options: Options): Value;
     /**
      * Gets the nearest instance of a store. Throws an error if the store isn't provided higher in the tree.
      */
-    useStore<Value>(store: StoreFunction<any, Value>): Value;
+    use<Value>(store: StoreFunction<any, Value>): Value;
     mount(selector: string, router: Router): Promise<void>;
     mount(selector: string, view: ViewFunction<any>): Promise<void>;
     mount(element: Element, router: Router): Promise<void>;