@yoltra/react 0.5.0 → 0.6.0

package/dist/types/hooks/createHooks.d.ts

@@ -1,4 +1,4 @@
-import { DeepReadonly, Dotted, Emit, Event, EventMapBase, EventPhase, PathValue, StoreInstance, WithGlob } from '@yoltra/core';
+import { DeepReadonly, Dotted, Emit, Event, EventMapBase, EventPhase, NotifiedPhase, PathValue, StoreInstance, WithGlob } from '@yoltra/core';
 import { UseSuspenseAtomicProp, UseSuspenseAtomicProps } from './suspense.js';
 import * as React from "react";
 /**
@@ -109,7 +109,7 @@ export type UseAtomicProps<R extends string, S extends Record<R, any>> = {
  *
  * @public
  */
-export type UseEvent<EM extends EventMapBase, S> = <C extends keyof EM & string, T extends keyof EM[C] & string>(channel: C, type: T, handler: (event: Event<EM, C, T>, getState: () => DeepReadonly<S>, emit: Emit<EM>, phase: "committed" | "uncommitted") => void | Promise<void>, phase?: EventPhase) => void;
+export type UseEvent<EM extends EventMapBase, S> = <C extends keyof EM & string, T extends keyof EM[C] & string>(channel: C, type: T, handler: (event: Event<EM, C, T>, getState: () => DeepReadonly<S>, emit: Emit<EM>, phase: NotifiedPhase) => void | Promise<void>, phase?: EventPhase) => void;
 /**
  * The bundle of fully-typed hooks returned by {@link createHooks} (and, with the
  * store and provider added, by {@link createYoltra}).

package/dist/types/hooks/hooks.d.ts

@@ -1,4 +1,4 @@
-import { DeepReadonly, Dotted, Emit, Event, EventMapBase, EventPhase, PathValue, StoreInstance, WithGlob } from '@yoltra/core';
+import { DeepReadonly, Dotted, Emit, Event, EventMapBase, EventPhase, NotifiedPhase, PathValue, StoreInstance, WithGlob } from '@yoltra/core';
 /**
  * Re-export of {@link PathValue} from `@yoltra/core`.
  *
@@ -243,4 +243,4 @@ export declare function useAtomicProps<R extends string, S extends Record<R, any
  *
  * @public
  */
-export declare function useEvent<EM extends EventMapBase, C extends keyof EM & string, T extends keyof EM[C] & string>(channel: C, type: T, handler: (event: Event<EM, C, T>, getState: () => DeepReadonly<any>, emit: Emit<EM>, phase: "committed" | "uncommitted") => void | Promise<void>, phase?: EventPhase): void;
+export declare function useEvent<EM extends EventMapBase, C extends keyof EM & string, T extends keyof EM[C] & string>(channel: C, type: T, handler: (event: Event<EM, C, T>, getState: () => DeepReadonly<any>, emit: Emit<EM>, phase: NotifiedPhase) => void | Promise<void>, phase?: EventPhase): void;

package/dist/types/hooks/suspense.d.ts

@@ -1,4 +1,22 @@
 import { Dotted, WithGlob } from '@yoltra/core';
+/**
+ * Backing store for the `useSuspense*` hooks.
+ *
+ * @remarks
+ * Documented because {@link suspenseCache} exports an instance of it: a type reachable
+ * through a published value is part of the surface whether or not it was meant to be.
+ * Its internals stay private; what is documented is what a consumer can actually call.
+ *
+ * @public
+ */
+declare class SuspenseCache {
+    private store;
+    /** Number of entries currently held. */
+    get size(): number;
+    read<T>(key: CacheKey, load: () => T | Promise<T>, staleTime: number | null, errorTtlMs: number | null | undefined): T;
+    invalidate(key: CacheKey): void;
+    clear(): void;
+}
 /**
  * Default Suspense cache instance shared by all `useSuspense*` hooks.
  *
@@ -7,9 +25,10 @@ import { Dotted, WithGlob } from '@yoltra/core';
  *
  * @public
  */
+export type { SuspenseCache };
 export declare const suspenseCache: SuspenseCache;
 /**
- * Options for {@link useSuspenseAtomicProp}.
+ * Options for `useSuspenseAtomicProp`.
  *
  * @typeParam T - The resolved value type after loading.
  * @typeParam S - Store state record.
@@ -103,7 +122,7 @@ export declare function useSuspenseAtomicProp<R extends string, S extends Record
     property: string;
 }, options: SuspenseAtomicPropOptions<T, S>): T;
 /**
- * Options for {@link useSuspenseAtomicProps}.
+ * Options for `useSuspenseAtomicProps`.
  *
  * @typeParam T - The resolved value type after loading.
  * @typeParam S - Store state record.
@@ -227,7 +246,7 @@ export declare function clearSuspenseCache(): void;
 /**
  * Call signature for the typed `useSuspenseAtomicProp` returned by `createHooks`.
  *
- * Identical in behaviour to the package-level {@link useSuspenseAtomicProp}; the reducer union
+ * Identical in behaviour to the package-level `useSuspenseAtomicProp`; the reducer union
  * and state shape are fixed by the store the hooks were created for, so neither has to be
  * supplied at the call site.
  *

package/dist/types/index.d.ts

@@ -5,6 +5,7 @@ export { StoreContext } from './context/StoreContext.js';
 export { StoreProvider } from './context/StoreProvider.js';
 export { shallowEqual, useEmit, useEvent, useSelector, useStore } from './hooks/hooks.js';
 export { clearSuspenseCache, invalidateAtomicProp, invalidateAtomicPropsByReducer, suspenseCache, } from './hooks/suspense.js';
+export type { SuspenseCache } from './hooks/suspense.js';
 export { createHooks } from './hooks/createHooks.js';
 export type { UseAtomicProp, UseAtomicProps, UseEvent, YoltraHooks } from './hooks/createHooks.js';
 export type { UseSuspenseAtomicProp, UseSuspenseAtomicProps } from './hooks/suspense.js';

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@yoltra/react",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "React bindings for Yoltra",
   "license": "MIT",
   "author": {
     "name": "Manu Ramirez <@pixerael>",
-    "email": "manu@yoltra.dev"
+    "email": "opensource@yoltra.dev"
   },
   "maintainers": [],
   "homepage": "https://yoltra.dev",
@@ -40,7 +40,7 @@
     "node": ">=18.18"
   },
   "peerDependencies": {
-    "@yoltra/core": "^0.5.0",
+    "@yoltra/core": "^0.6.0",
     "react": "^18 || ^19"
   },
   "peerDependenciesMeta": {
@@ -64,7 +64,7 @@
     "@types/node": "^24.0.12",
     "@vitejs/plugin-react-swc": "^3.10.2",
     "@vitejs/plugin-react": "^5.0.0",
-    "@vitest/coverage-v8": "3.2.4",
+    "@vitest/coverage-v8": "3.2.7",
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-react-refresh": "^0.4.20",
     "vite-plugin-banner": "0.8.1",
@@ -73,7 +73,7 @@
     "jsdom": "^24.0.0",
     "react-dom": "19.1.1",
     "react": "19.1.1",
-    "rollup": "^4.16.0",
+    "rollup": "^4.62.4",
     "typescript-eslint": "^8.35.1",
     "typescript": "5.9.3",
     "typedoc": "^0.28.13",
@@ -81,9 +81,9 @@
     "typedoc-plugin-localization": "3.0.6",
     "vite-plugin-dts": "^4.5.4",
     "vite-tsconfig-paths": "^4.3.2",
-    "vite": "^7.1.11",
-    "vitest": "3.2.4",
-    "@yoltra/core": "0.5.0"
+    "vite": "^7.3.6",
+    "vitest": "3.2.7",
+    "@yoltra/core": "0.6.0"
   },
   "exports": {
     ".": {