chizu 0.2.62 → 0.2.63

package/README.md

@@ -113,7 +113,19 @@ actions.useAction(Actions.Search, async (context) => {
 
 For more details, see the [referential equality recipe](./recipes/referential-equality.md).
 
-If your component doesn't need local state but still needs to dispatch or listen to actions, pass `void` as the model type. No initial model is required:
+Both the model and actions type parameters default to `void`, so you can call `useActions()` with no generics at all when neither is needed:
+
+```tsx
+import { useActions, Lifecycle } from "chizu";
+
+const actions = useActions();
+
+actions.useAction(Lifecycle.Mount, () => {
+  console.log("Mounted!");
+});
+```
+
+If your component doesn't need local state but still needs to dispatch or listen to typed actions, pass `void` as the model type. No initial model is required:
 
 ```tsx
 import { useActions, Action, Lifecycle } from "chizu";

package/dist/hooks/index.d.ts

@@ -39,5 +39,5 @@ export { With } from './utils.ts';
  * );
  * ```
  */
-export declare function useActions<_M extends void, A extends Actions, D extends Props = Props>(getData?: Data<D>): UseActions<void, A, D>;
-export declare function useActions<M extends Model, A extends Actions, D extends Props = Props>(initialModel: M, getData?: Data<D>): UseActions<M, A, D>;
+export declare function useActions<_M extends void = void, A extends Actions | void = void, D extends Props = Props>(getData?: Data<D>): UseActions<void, A, D>;
+export declare function useActions<M extends Model, A extends Actions | void = void, D extends Props = Props>(initialModel: M, getData?: Data<D>): UseActions<M, A, D>;

package/dist/hooks/types.d.ts

@@ -25,13 +25,13 @@ export type References<M extends Model | void> = {
  * @template AC - The actions class type
  * @template D - The data props type
  */
-export type Handler<M extends Model | void = Model, AC extends Actions = Actions, D extends Props = Props> = (context: HandlerContext<M, AC, D>, payload: unknown) => void | Promise<void> | AsyncGenerator | Generator;
+export type Handler<M extends Model | void = Model, AC extends Actions | void = Actions, D extends Props = Props> = (context: HandlerContext<M, AC, D>, payload: unknown) => void | Promise<void> | AsyncGenerator | Generator;
 /**
  * Entry for an action handler with a reactive channel getter.
  * When getChannel returns undefined, the handler fires for all dispatches.
  * When getChannel returns a channel, dispatches must match.
  */
-export type HandlerEntry<M extends Model | void = Model, AC extends Actions = Actions, D extends Props = Props> = {
+export type HandlerEntry<M extends Model | void = Model, AC extends Actions | void = Actions, D extends Props = Props> = {
     handler: Handler<M, AC, D>;
     getChannel: () => Filter | undefined;
 };
@@ -43,7 +43,7 @@ export type HandlerEntry<M extends Model | void = Model, AC extends Actions = Ac
  * @template AC - The actions class type
  * @template D - The data props type
  */
-export type Scope<M extends Model | void = Model, AC extends Actions = Actions, D extends Props = Props> = {
+export type Scope<M extends Model | void = Model, AC extends Actions | void = Actions, D extends Props = Props> = {
     /** All handlers for each action, with optional channels */
     handlers: Map<ActionId, Set<HandlerEntry<M, AC, D>>>;
 };

package/dist/hooks/utils.d.ts

@@ -68,7 +68,7 @@ export declare function useData<P extends Props>(props: P): P;
  * actions.useAction(Actions.Visitor, With("name")); // Country -> string ✗
  * ```
  */
-export declare function With<K extends string>(key: K): <M extends Model, AC extends Actions, D extends Props, P extends K extends keyof M ? M[K] : never>(context: HandlerContext<M, AC, D>, payload: P) => void;
+export declare function With<K extends string>(key: K): <M extends Model, AC extends Actions | void, D extends Props, P extends K extends keyof M ? M[K] : never>(context: HandlerContext<M, AC, D>, payload: P) => void;
 export { isChanneledAction, getActionSymbol };
 /**
  * Return type for useActionSets hook.
@@ -139,7 +139,7 @@ export declare function useActionSets(): ActionSets;
  *
  * @internal
  */
-export declare function useRegisterHandler<M extends Model | void, AC extends Actions, D extends Props>(scope: React.RefObject<Scope<M, AC, D>>, action: ActionId | HandlerPayload | ChanneledAction, handler: (context: HandlerContext<M, AC, D>, payload: unknown) => void | Promise<void> | AsyncGenerator | Generator): void;
+export declare function useRegisterHandler<M extends Model | void, AC extends Actions | void, D extends Props>(scope: React.RefObject<Scope<M, AC, D>>, action: ActionId | HandlerPayload | ChanneledAction, handler: (context: HandlerContext<M, AC, D>, payload: unknown) => void | Promise<void> | AsyncGenerator | Generator): void;
 /**
  * Manages captured DOM nodes for a model type.
  * Returns refs for nodes, pending captures, and last emitted nodes.

package/dist/types/index.d.ts

@@ -440,7 +440,7 @@ export type Actions = object;
 export type Result = {
     processes: Set<Process>;
 };
-export type HandlerContext<M extends Model | void, _AC extends Actions, D extends Props = Props> = {
+export type HandlerContext<M extends Model | void, _AC extends Actions | void, D extends Props = Props> = {
     readonly model: Readonly<M>;
     /**
      * The current lifecycle phase of the component.
@@ -658,7 +658,7 @@ export type HandlerContext<M extends Model | void, _AC extends Actions, D extend
  *
  * @see {@link Handlers} for the recommended HKT pattern
  */
-export type Handler<M extends Model | void, AC extends Actions, K extends keyof AC, D extends Props = Props> = (context: HandlerContext<M, AC, D>, payload: Payload<AC[K] & HandlerPayload<unknown>>) => void | Promise<void> | AsyncGenerator | Generator;
+export type Handler<M extends Model | void, AC extends Actions | void, K extends keyof AC & string, D extends Props = Props> = (context: HandlerContext<M, AC, D>, payload: Payload<AC[K] & HandlerPayload<unknown>>) => void | Promise<void> | AsyncGenerator | Generator;
 /**
  * Resolves the action value at a (possibly dot-notated) path within an actions object.
  * For a simple key like `"SetName"`, returns `AC["SetName"]`.
@@ -719,10 +719,10 @@ type FlattenKeys<AC, Prefix extends string = never> = {
  * export const handlePaymentSent: H["Broadcast.PaymentSent"] = (context) => { ... };
  * ```
  */
-export type Handlers<M extends Model | void, AC extends Actions, D extends Props = Props> = {
+export type Handlers<M extends Model | void, AC extends Actions | void, D extends Props = Props> = {
     [K in FlattenKeys<AC>]: (context: HandlerContext<M, AC, D>, payload: Payload<DeepAction<AC, K> & HandlerPayload<unknown>>) => void | Promise<void> | AsyncGenerator | Generator;
 };
-export type UseActions<M extends Model | void, AC extends Actions, D extends Props = Props> = [
+export type UseActions<M extends Model | void, AC extends Actions | void, D extends Props = Props> = [
     Readonly<M>,
     {
         /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chizu",
-  "version": "0.2.62",
+  "version": "0.2.63",
   "type": "module",
   "license": "MIT",
   "packageManager": "yarn@1.22.22",