@yoltra/react 0.6.0 → 0.7.0

package/README.es.md

@@ -3,7 +3,7 @@
 # @yoltra/react
 
 > 👉 🇲🇽 Versión en Español  |
->  [ 🇺🇸 English Version](./README.md) 
+>  [ 🇺🇸 English Versión](./README.md) 
 
 ![npm downloads](https://badgen.net/npm/dm/@yoltra/react)
 ![License](https://badgen.net/npm/license/@yoltra/react)
@@ -11,14 +11,14 @@
 **Hooks de React para [yoltra](../../README.md) con
 suscripciones de grano fino por ruta.**
 
-Suscribete a `"items.0.title"` o `"items.*.done"` -- el componente se re-renderiza solo cuando
-esa ruta exacta cambia. Sin selectores, sin memoizacion, sin optimizacion manual.
+Suscríbete a `"items.0.title"` o `"items.*.done"`. El componente se re-renderiza solo cuando
+esa ruta exacta cambia. Sin selectores, sin memoización, sin optimización manual.
 
-[Ver la comparacion de flamegraph (Redux vs yoltra).](https://github.com/yoltra/yoltra/blob/main/examples/v0/yoltra-in-react/redux-yoltra-profiler.md)
+[Ver la comparación de flamegraph (Redux vs yoltra).](https://github.com/yoltra/yoltra/blob/main/examples/v0/yoltra-in-react/redux-yoltra-profiler.md)
 
 ---
 
-## Instalacion
+## Instalación
 
 ```bash
 npm install @yoltra/core @yoltra/react
@@ -28,11 +28,11 @@ npm install @yoltra/core @yoltra/react
 
 ---
 
-## Configuracion con `createYoltra` (recomendado)
+## Configuración con `createYoltra` (recomendado)
 
-`createYoltra` crea el store **y** todos los hooks tipados en una sola llamada — sin archivo de
-context aparte, sin cableado de `createHooks`, sin provider obligatorio. Todos los parametros de
-tipo se infieren de tu reducer, asi que los componentes no necesitan generics explicitos.
+`createYoltra` crea el store **y** todos los hooks tipados en una sola llamada, sin archivo de
+context aparte, sin cableado de `createHooks`, sin provider obligatorio. Todos los parámetros de
+tipo se infieren de tu reducer, así que los componentes no necesitan generics explícitos.
 
 ### 1. Crea el store y los hooks
 
@@ -74,10 +74,10 @@ export const { store, useAtomicProp, useEmit, StoreProvider } = createYoltra({
 });
 ```
 
-### 2. Usa los hooks — sin provider
+### 2. Usa los hooks, sin provider
 
-Los hooks usan por defecto el store de arriba, asi que puedes renderizar componentes directamente.
-Suscribete con una spec **`{ reducer, property }`**: el `property` con puntos nombra la ruta exacta
+Los hooks usan por defecto el store de arriba, así que puedes renderizar componentes directamente.
+Suscríbete con una spec **`{ reducer, property }`**: el `property` con puntos nombra la ruta exacta
 a leer.
 
 ```tsx
@@ -85,7 +85,7 @@ a leer.
 import { useAtomicProp, useEmit } from "./yoltra";
 
 export function Counter() {
-  // Forma objeto — se re-renderiza solo cuando counter.value cambia. Sin selectores, sin memo.
+  // Forma objeto: se re-renderiza solo cuando counter.value cambia. Sin selectores, sin memo.
   const value = useAtomicProp({ reducer: "counter", property: "value" });
   const emit = useEmit();
 
@@ -101,13 +101,13 @@ export function Counter() {
 ```
 
 Un `<StoreProvider>` solo se necesita para acotar una instancia **diferente** del store a un
-subarbol (p. ej. un store nuevo por test) — `createYoltra` devuelve uno justo para eso.
+subarbol (p. ej. un store nuevo por test). `createYoltra` devuelve uno justo para eso.
 
 ---
 
 ## Avanzado: cableado manual con `createHooks`
 
-Cuando necesites un mismo conjunto de hooks compartido entre varias instancias de store a traves
+Cuando necesites un mismo conjunto de hooks compartido entre varias instancias de store a través
 de tu propio context de React, vinculalos tu mismo con `createHooks(context)`. `createYoltra` es
 este mismo cableado colapsado en una sola llamada.
 
@@ -135,7 +135,7 @@ export const {
 } = createHooks(AppStoreContext);
 ```
 
-Provee el store con `<AppStoreContext.Provider value={store}>` en tu raiz.
+Provee el store con `<AppStoreContext.Provider value={store}>` en tu raíz.
 
 ---
 
@@ -143,21 +143,21 @@ Provee el store con `<AppStoreContext.Provider value={store}>` en tu raiz.
 
 ### `useAtomicProp({ reducer, property }, map?, isEqual?)`
 
-Selector de ruta unica con grano fino. Se re-renderiza solo cuando la hoja especificada cambia. El
-`property` con puntos nombra la ruta exacta — incluyendo rutas dinamicas
+Selector de ruta única con grano fino. Se re-renderiza solo cuando la hoja especificada cambia. El
+`property` con puntos nombra la ruta exacta, incluyendo rutas dinámicas
 (`` `items.${id}.title` ``) y con comodines.
 
 ```tsx
-// Forma objeto (recomendada) — suscribete a la ruta exacta
+// Forma objeto (recomendada): suscribete a la ruta exacta
 const title = useAtomicProp({ reducer: "todos", property: "items.0.title" });
 
-// Ruta dinamica — interpola la clave
+// Ruta dinamica: interpola la clave
 const byId = useAtomicProp({ reducer: "todos", property: `items.${id}.title` });
 
-// Con mapper — derivar un valor de la ruta
+// Con mapper: derivar un valor de la ruta
 const count = useAtomicProp({ reducer: "todos", property: "items" }, (items) => items.length);
 
-// Patron wildcard — se re-renderiza cuando cualquier item cambia
+// Patron wildcard: se re-renderiza cuando cualquier item cambia
 const allTitles = useAtomicProp(
   { reducer: "todos", property: "items.**" },
   (state) => state.items.map((t) => t.title),
@@ -165,20 +165,20 @@ const allTitles = useAtomicProp(
 );
 ```
 
-> Tambien existe una sobrecarga con accessor tipado — `useAtomicProp("todos", (s) => s.items[0].title)`
-> — para rutas estaticas; autocompleta la forma del estado e infiere el tipo de retorno.
+> También existe una sobrecarga con accessor tipado, `useAtomicProp("todos", (s) => s.items[0].title)`,
+> para rutas estáticas; autocompleta la forma del estado e infiere el tipo de retorno.
 
 **Patrones soportados:**
 
-- `"items.0.title"` -- ruta exacta (incluyendo indices numericos de array)
-- `"items.*.title"` -- `*` coincide con un segmento
-- `"items.**"` -- `**` coincide con cero o mas segmentos
+- `"items.0.title"`: ruta exacta (incluyendo índices numéricos de array)
+- `"items.*.title"`: `*` coincide con un segmento
+- `"items.**"`: `**` coincide con cero o más segmentos
 
 ---
 
 ### `useAtomicProps(specs, selector, isEqual?)`
 
-Selector de multiples rutas. Se suscribe a varias rutas y recalcula cuando alguna cambia.
+Selector de múltiples rutas. Se suscribe a varias rutas y recalcula cuando alguna cambia.
 
 ```tsx
 const filtered = useAtomicProps(
@@ -195,16 +195,15 @@ const filtered = useAtomicProps(
 
 ### `useEvent(channel, type, handler, phase?)`
 
-Suscribete a eventos del store desde un componente. No afecta el flujo de eventos --
-fire-and-forget.
+Suscríbete a eventos del store desde un componente. No afecta el flujo de eventos. Es fire-and-forget.
 
 ```tsx
-// Eventos confirmados (por defecto) — eventos que pasaron el middleware
+// Eventos confirmados (por defecto): eventos que pasaron el middleware
 useEvent("ui", "save", (event) => {
   showToast("Saved!");
 });
 
-// Eventos no confirmados — eventos rechazados por el middleware
+// Eventos no confirmados: eventos rechazados por el middleware
 useEvent(
   "ui",
   "delete",
@@ -214,7 +213,7 @@ useEvent(
   "uncommitted",
 );
 
-// Todos los eventos — distinguir por fase
+// Todos los eventos: distinguir por fase
 useEvent(
   "ui",
   "action",
@@ -227,15 +226,15 @@ useEvent(
 
 **Fases:**
 
-- `'committed'` (por defecto) -- eventos que pasaron el middleware y llegaron a los reducers
-- `'uncommitted'` -- eventos rechazados por el middleware
-- `'all'` -- ambos, con parametro `phase` para distinguir
+- `'committed'` (por defecto): eventos que pasaron el middleware y llegaron a los reducers
+- `'uncommitted'`: eventos rechazados por el middleware
+- `'all'`: ambos, con parámetro `phase` para distinguir
 
 ---
 
 ### `useEmit()`
 
-Retorna la funcion `emit` tipada del store (referencia estable).
+Retorna la función `emit` tipada del store (referencia estable).
 
 ```tsx
 const emit = useEmit();
@@ -246,7 +245,7 @@ await emit("counter", "increment", 1);
 
 ### `useSelector(selector, isEqual?)`
 
-Selector de grano grueso via `useSyncExternalStore`. Se re-renderiza cuando el valor
+Selector de grano grueso vía `useSyncExternalStore`. Se re-renderiza cuando el valor
 seleccionado cambia.
 
 ```tsx
@@ -270,7 +269,7 @@ const value = store.getState().counter.value;
 ```
 
 `getState()` es una lectura, no una suscripción. Llamado durante el render, el componente se
-renderiza una vez con ese valor y nunca más — nada le avisó de que el valor cambió. Parece que
+renderiza una vez con ese valor y nunca más, porque nada le avisó de que el valor cambió. Parece que
 funciona hasta que el estado cambia y la pantalla no. Lee con `useAtomicProp` o `useSelector` lo
 que vayas a renderizar, y deja `getState()` para callbacks y efectos, que es para lo que es.
 
@@ -280,8 +279,8 @@ que vayas a renderizar, y deja `getState()` para callbacks y efectos, que es par
 
 ### `useSuspenseAtomicProp(spec, options)`
 
-Version compatible con Suspense de `useAtomicProp`. Lanza una promesa mientras carga, capturada
-por el boundary `<Suspense>` mas cercano.
+Versión compatible con Suspense de `useAtomicProp`. Lanza una promesa mientras carga, capturada
+por el boundary `<Suspense>` más cercano.
 
 ```tsx
 function UserName({ userId }: { userId: string }) {
@@ -303,7 +302,7 @@ function UserName({ userId }: { userId: string }) {
 
 ### `useSuspenseAtomicProps(specs, options)`
 
-Selector Suspense de multiples rutas.
+Selector Suspense de múltiples rutas.
 
 ```tsx
 const stats = useSuspenseAtomicProps(
@@ -318,11 +317,11 @@ const stats = useSuspenseAtomicProps(
 ### Importalos de tu conjunto de hooks, no del barrel
 
 `createYoltra` y `createHooks` devuelven estos dos junto con el resto, ligados al mismo contexto.
-Deliberadamente **no** se exportan desde el barrel del paquete: una copia a nivel de paquete seria
-identica en forma y aun asi lanzaria `useStore must be used inside <StoreProvider>` en tiempo de
-ejecucion cuando el contexto que lee nunca se lleno — un error que los tipos no podian atrapar.
+Deliberadamente **no** se exportan desde el barrel del paquete: una copia a nivel de paquete sería
+idéntica en forma y aun así lanzaría `useStore must be used inside <StoreProvider>` en tiempo de
+ejecución cuando el contexto que lee nunca se lleno, un error que los tipos no podian atrapar.
 Importarlos desde cualquier sitio que no sea el resultado de tu propio `createYoltra`/`createHooks`
-es ahora un error de compilacion, que es el mismo aviso llegando en el momento correcto.
+es ahora un error de compilación, que es el mismo aviso llegando en el momento correcto.
 
 ```tsx
 // store.ts
@@ -332,8 +331,8 @@ export const { store, useAtomicProp, useSuspenseAtomicProp } = createYoltra({ ..
 import { useSuspenseAtomicProp } from "./store";   // ✅ conoce el store
 ```
 
-Los valores en cache tienen alcance por store, asi que dos stores que compartan nombre de reducer
-y ruta mantienen entradas separadas; las utilidades de invalidacion de abajo reciben una ruta y la
+Los valores en cache tienen alcance por store, así que dos stores que compartan nombre de reducer
+y ruta mantienen entradas separadas; las utilidades de invalidación de abajo reciben una ruta y la
 limpian en todos los stores que la hayan cacheado.
 
 ### Utilidades de cache
@@ -359,7 +358,7 @@ clearSuspenseCache();
 
 ## `shallowEqual`
 
-Comparador de igualdad superficial de objetos. Usalo como argumento `isEqual` cuando tu valor
+Comparador de igualdad superficial de objetos. Úsalo como argumento `isEqual` cuando tu valor
 derivado es un objeto plano:
 
 ```tsx
@@ -372,7 +371,7 @@ const todos = useAtomicProp(
 
 ---
 
-## Rendimiento: Antes y Despues
+## Rendimiento: Antes y Después
 
 ### Antes (grano grueso)
 
@@ -384,7 +383,7 @@ function TodoList() {
 }
 ```
 
-### Despues (grano fino con yoltra)
+### Después (grano fino con yoltra)
 
 ```tsx
 // Cada TodoItem se re-renderiza SOLO cuando sus propios datos cambian
@@ -401,14 +400,14 @@ function TodoItem({ index }: { index: number }) {
 }
 ```
 
-[Ver la comparacion completa de flamegraph.](https://github.com/yoltra/yoltra/blob/main/examples/v0/yoltra-in-react/redux-yoltra-profiler.md)
+[Ver la comparación completa de flamegraph.](https://github.com/yoltra/yoltra/blob/main/examples/v0/yoltra-in-react/redux-yoltra-profiler.md)
 
 ---
 
 ## Compatibilidad con React 18+
 
 - **Concurrent Mode:** Totalmente compatible. Todos los hooks usan `useSyncExternalStore`.
-- **Strict Mode:** La deduplicacion de eventos previene el doble procesamiento.
+- **Strict Mode:** La deduplicación de eventos previene el doble procesamiento.
 - **Suspense:** `useSuspenseAtomicProp` y `useSuspenseAtomicProps` lanzan promesas para
   boundaries `<Suspense>`.
 
@@ -416,37 +415,37 @@ function TodoItem({ index }: { index: number }) {
 
 ## Ejemplos
 
-- **[App de Tareas con Profiler](../../examples/v0/yoltra-in-react)** -- CRUD completo con
-  comparacion de flamegraph · [▶ Abrir la demo en vivo](https://yoltra.dev/es/demos/in-react)
-- **[Logo Cinetico (3000 particulas)](../../examples/v0/yoltra-kinetic-logo)** -- Suscripciones
+- **[App de Tareas con Profiler](../../examples/v0/yoltra-in-react)**: CRUD completo con
+  comparación de flamegraph · [▶ Abrir la demo en vivo](https://yoltra.dev/es/demos/in-react)
+- **[Logo Cinético (3000 particulas)](../../examples/v0/yoltra-kinetic-logo)**: Suscripciones
   independientes por circulo SVG · [▶ Abrir la demo en vivo](https://yoltra.dev/es/demos/kinetic-logo)
-- **[Next.js (Pages Router)](../../examples/v0/yoltra-in-nextjs)** -- estado de cliente + cambio de tema · [▶ Abrir la demo en vivo](https://yoltra.dev/es/demos/in-nextjs)
+- **[Next.js (Pages Router)](../../examples/v0/yoltra-in-nextjs)**: estado de cliente + cambio de tema · [▶ Abrir la demo en vivo](https://yoltra.dev/es/demos/in-nextjs)
 
 ---
 
-## Documentacion
+## Documentación
 
-- **[README raiz de yoltra](../../README.md)** --
-  Descripcion general y configuracion rapida
-- **[API de @yoltra/core](../core/README.md)**
-  -- Store, middleware, efectos, matchers `When`
-- **[Guia de Inicio Rapido](https://github.com/yoltra/yoltra/blob/main/docs/en/QUICK_START_GUIDE.md)**
-  -- Cinco pasos hacia una app funcional
-- **[Comparacion de Bibliotecas](https://github.com/yoltra/yoltra/blob/main/docs/en/design/state-management-library-comparison.md)**
-  -- Comparacion arquitectonica
+- **[README raíz de yoltra](../../README.md)**:
+  Descripción general y configuración rápida
+- **[API de @yoltra/core](../core/README.md)**:
+  Store, middleware, efectos, matchers `When`
+- **[Guia de Inicio Rápido](https://github.com/yoltra/yoltra/blob/main/docs/en/QUICK_START_GUIDE.md)**:
+  Cinco pasos hacia una app funcional
+- **[Comparación de Bibliotecas](https://github.com/yoltra/yoltra/blob/main/docs/en/design/state-management-library-comparison.md)**:
+  Comparación arquitectónica
 
 ---
 
 ## Contribuir
 
-- [Raiz del Monorepo](../../)
-- [Guia de Contribucion](../../CONTRIBUTING.md)
+- [Raíz del Monorepo](../../)
+- [Guia de Contribución](../../CONTRIBUTING.md)
 
 ---
 
 ## Estado
 
-**Release Candidate** -- Las APIs son estables, usadas en produccion, cambios menores posibles
+**Release Candidate**. Las APIs son estables, usadas en producción, cambios menores posibles
 antes de v1.0.0.
 
 ---
@@ -454,7 +453,7 @@ antes de v1.0.0.
 ## Colecciones normalizadas
 
 `useEntityIds`, `useEntity` y `useEntityField` se emparejan con `createEntityAdapter` de
-`@yoltra/core`. Son envoltorios delgados sobre `useAtomicProp`; el valor esta en que la ruta viene
+`@yoltra/core`. Son envoltorios delgados sobre `useAtomicProp`; el valor está en que la ruta viene
 del adapter en vez de escribirse a mano en un componente, donde nada la verifica.
 
 ```tsx
@@ -472,4 +471,4 @@ function Row({ id }: { id: string }) {
 
 ## Licencia
 
-**MIT** -- Libre para usar en proyectos comerciales y de codigo abierto.
+**MIT**. Libre para usar en proyectos comerciales y de código abierto.

package/README.md

@@ -11,7 +11,7 @@
 **React hooks for [yoltra](../../README.md) with
 fine-grained path subscriptions.**
 
-Subscribe to `"items.0.title"` or `"items.*.done"` — the component re-renders only when that
+Subscribe to `"items.0.title"` or `"items.*.done"`. The component re-renders only when that
 exact path changes. No selectors, no memoization, no manual optimization.
 
 [See the flamegraph comparison (Redux vs yoltra).](https://github.com/yoltra/yoltra/blob/main/examples/v0/yoltra-in-react/redux-yoltra-profiler.md)
@@ -30,7 +30,7 @@ npm install @yoltra/core @yoltra/react
 
 ## Setup with `createYoltra` (recommended)
 
-`createYoltra` creates the store **and** every fully-typed hook in one call — no separate context
+`createYoltra` creates the store **and** every fully-typed hook in one call, with no separate context
 file, no `createHooks` wiring, no required provider. All type parameters are inferred from your
 reducer, so components need no explicit generics.
 
@@ -74,7 +74,7 @@ export const { store, useAtomicProp, useEmit, StoreProvider } = createYoltra({
 });
 ```
 
-### 2. Use the hooks — no provider required
+### 2. Use the hooks, no provider required
 
 The hooks default to the store above, so you can render components directly. Subscribe with a
 **`{ reducer, property }`** spec: the dotted `property` names the exact path to read.
@@ -84,7 +84,7 @@ The hooks default to the store above, so you can render components directly. Sub
 import { useAtomicProp, useEmit } from "./yoltra";
 
 export function Counter() {
-  // Object form — re-renders only when counter.value changes. No selectors, no memo.
+  // Object form: re-renders only when counter.value changes. No selectors, no memo.
   const value = useAtomicProp({ reducer: "counter", property: "value" });
   const emit = useEmit();
 
@@ -100,7 +100,7 @@ export function Counter() {
 ```
 
 A `<StoreProvider>` is only needed to scope a **different** store instance to a subtree (e.g. a
-fresh store per test) — `createYoltra` returns one for exactly that.
+fresh store per test). `createYoltra` returns one for exactly that.
 
 ---
 
@@ -143,19 +143,19 @@ Provide the store with `<AppStoreContext.Provider value={store}>` at your root.
 ### `useAtomicProp({ reducer, property }, map?, isEqual?)`
 
 Fine-grained single-path selector. Re-renders only when the specified leaf changes. The dotted
-`property` names the exact path — including dynamic (`` `items.${id}.title` ``) and wildcard paths.
+`property` names the exact path, including dynamic (`` `items.${id}.title` ``) and wildcard paths.
 
 ```tsx
-// Object form (recommended) — subscribe to the exact path
+// Object form (recommended): subscribe to the exact path
 const title = useAtomicProp({ reducer: "todos", property: "items.0.title" });
 
-// Dynamic path — interpolate the key
+// Dynamic path: interpolate the key
 const byId = useAtomicProp({ reducer: "todos", property: `items.${id}.title` });
 
-// With mapper — derive a value from the path
+// With mapper: derive a value from the path
 const count = useAtomicProp({ reducer: "todos", property: "items" }, (items) => items.length);
 
-// Wildcard pattern — re-renders when any item changes
+// Wildcard pattern: re-renders when any item changes
 const allTitles = useAtomicProp(
   { reducer: "todos", property: "items.**" },
   (state) => state.items.map((t) => t.title),
@@ -163,14 +163,14 @@ const allTitles = useAtomicProp(
 );
 ```
 
-> A typed-accessor overload — `useAtomicProp("todos", (s) => s.items[0].title)` — is also available
+> A typed-accessor overload, `useAtomicProp("todos", (s) => s.items[0].title)`, is also available
 > for static paths; it autocompletes the state shape and infers the return type.
 
 **Supported patterns:**
 
-- `"items.0.title"` — exact path (including numeric array indices)
-- `"items.*.title"` — `*` matches one segment
-- `"items.**"` — `**` matches zero or more segments
+- `"items.0.title"`: exact path (including numeric array indices)
+- `"items.*.title"`: `*` matches one segment
+- `"items.**"`: `**` matches zero or more segments
 
 ---
 
@@ -193,15 +193,15 @@ const filtered = useAtomicProps(
 
 ### `useEvent(channel, type, handler, phase?)`
 
-Subscribe to store events from a component. Does not affect event flow — fire-and-forget.
+Subscribe to store events from a component. Does not affect event flow. Fire-and-forget.
 
 ```tsx
-// Committed events (default) — events that passed middleware
+// Committed events (default): events that passed middleware
 useEvent("ui", "save", (event) => {
   showToast("Saved!");
 });
 
-// Uncommitted events — events rejected by middleware
+// Uncommitted events: events rejected by middleware
 useEvent(
   "ui",
   "delete",
@@ -211,7 +211,7 @@ useEvent(
   "uncommitted",
 );
 
-// All events — distinguish by phase
+// All events: distinguish by phase
 useEvent(
   "ui",
   "action",
@@ -224,9 +224,9 @@ useEvent(
 
 **Phases:**
 
-- `'committed'` (default) — events that passed middleware and reached reducers
-- `'uncommitted'` — events rejected by middleware
-- `'all'` — both, with `phase` parameter to distinguish
+- `'committed'` (default): events that passed middleware and reached reducers
+- `'uncommitted'`: events rejected by middleware
+- `'all'`: both, with `phase` parameter to distinguish
 
 ---
 
@@ -266,7 +266,7 @@ const value = store.getState().counter.value;
 ```
 
 `getState()` is a read, not a subscription. Called while rendering, the component renders once
-with that value and never again — nothing told it the value moved. It looks like it works right
+with that value and never again, because nothing told it the value moved. It looks like it works right
 up until the state changes and the screen does not. Read what you render with `useAtomicProp` or
 `useSelector`, and keep `getState()` for callbacks and effects, which is what it is for.
 
@@ -316,7 +316,7 @@ const stats = useSuspenseAtomicProps(
 `createYoltra` and `createHooks` return these two alongside the rest, bound to the same context.
 They are deliberately **not** exported from the package barrel: a package-level copy would be
 identical in shape and still throw `useStore must be used inside <StoreProvider>` at runtime
-whenever the context it reads was never filled — a mistake the types could not catch. Importing
+whenever the context it reads was never filled, a mistake the types could not catch. Importing
 them from anywhere but your own `createYoltra`/`createHooks` result is now a compile error,
 which is the same warning arriving at the right time.
 
@@ -430,24 +430,24 @@ function Row({ id }: { id: string }) {
 
 ## Examples
 
-- **[Todo App with Profiler](../../examples/v0/yoltra-in-react)** — Full CRUD with flamegraph
+- **[Todo App with Profiler](../../examples/v0/yoltra-in-react)**: Full CRUD with flamegraph
   comparison · [▶ Open the live demo](https://yoltra.dev/en/demos/in-react)
-- **[Kinetic Logo (3000 particles)](../../examples/v0/yoltra-kinetic-logo)** — Independent
+- **[Kinetic Logo (3000 particles)](../../examples/v0/yoltra-kinetic-logo)**: Independent
   subscriptions per circle · [▶ Open the live demo](https://yoltra.dev/en/demos/kinetic-logo)
-- **[Next.js (Pages Router)](../../examples/v0/yoltra-in-nextjs)** — client-side state + theme switcher · [▶ Open the live demo](https://yoltra.dev/en/demos/in-nextjs)
+- **[Next.js (Pages Router)](../../examples/v0/yoltra-in-nextjs)**: client-side state + theme switcher · [▶ Open the live demo](https://yoltra.dev/en/demos/in-nextjs)
 
 ---
 
 ## Documentation
 
-- **[yoltra Root README](../../README.md)** — Overview and
+- **[yoltra Root README](../../README.md)**: Overview and
   quick start
-- **[@yoltra/core API](../core/README.md)** —
+- **[@yoltra/core API](../core/README.md)**:
   Store, middleware, effects, `When` matchers
-- **[Quick Start Guide](https://github.com/yoltra/yoltra/blob/main/docs/en/QUICK_START_GUIDE.md)**
-  — Five steps to a working app
-- **[Library Comparison](https://github.com/yoltra/yoltra/blob/main/docs/en/design/state-management-library-comparison.md)**
-  — Architectural comparison
+- **[Quick Start Guide](https://github.com/yoltra/yoltra/blob/main/docs/en/QUICK_START_GUIDE.md)**:
+  Five steps to a working app
+- **[Library Comparison](https://github.com/yoltra/yoltra/blob/main/docs/en/design/state-management-library-comparison.md)**:
+  Architectural comparison
 
 ---
 
@@ -460,11 +460,11 @@ function Row({ id }: { id: string }) {
 
 ## Status
 
-**Release Candidate** — APIs are stable, used in production, minor changes possible before
+**Release Candidate**. APIs are stable, used in production, minor changes possible before
 v1.0.0.
 
 ---
 
 ## License
 
-**MIT** — Free to use in commercial and open-source projects.
+**MIT**. Free to use in commercial and open-source projects.

package/dist/index.cjs

@@ -1,16 +1,11 @@
 /*!
- * @yoltra/react v0.6.0
+ * @yoltra/react v0.7.0
  * (c) 2026 Manu Ramirez <@pixerael>
- * License: MIT
- * Homepage: https://yoltra.dev
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree
- */
-"use strict";var Ee=Object.defineProperty;var Re=(t,e,n)=>e in t?Ee(t,e,{enumerable:!0,configurable:!0,writable:!0,value:n}):t[e]=n;var ce=(t,e,n)=>Re(t,typeof e!="symbol"?e+"":e,n);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const u=require("react"),Ae=require("@yoltra/core"),K=u.createContext(null);var W={exports:{}},D={};var ue;function Pe(){if(ue)return D;ue=1;var t=Symbol.for("react.transitional.element"),e=Symbol.for("react.fragment");function n(o,s,c){var a=null;if(c!==void 0&&(a=""+c),s.key!==void 0&&(a=""+s.key),"key"in s){c={};for(var h in s)h!=="key"&&(c[h]=s[h])}else c=s;return s=c.ref,{$$typeof:t,type:o,key:a,ref:s!==void 0?s:null,props:c}}return D.Fragment=e,D.jsx=n,D.jsxs=n,D}var F={};var ae;function ge(){return ae||(ae=1,process.env.NODE_ENV!=="production"&&(function(){function t(r){if(r==null)return null;if(typeof r=="function")return r.$$typeof===V?null:r.displayName||r.name||null;if(typeof r=="string")return r;switch(r){case y:return"Fragment";case k:return"Profiler";case b:return"StrictMode";case $:return"Suspense";case I:return"SuspenseList";case O:return"Activity"}if(typeof r=="object")switch(typeof r.tag=="number"&&console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),r.$$typeof){case v:return"Portal";case P:return(r.displayName||"Context")+".Provider";case _:return(r._context.displayName||"Context")+".Consumer";case j:var i=r.render;return r=r.displayName,r||(r=i.displayName||i.name||"",r=r!==""?"ForwardRef("+r+")":"ForwardRef"),r;case M:return i=r.displayName||null,i!==null?i:t(r.type)||"Memo";case A:i=r._payload,r=r._init;try{return t(r(i))}catch{}}return null}function e(r){return""+r}function n(r){try{e(r);var i=!1}catch{i=!0}if(i){i=console;var p=i.error,E=typeof Symbol=="function"&&Symbol.toStringTag&&r[Symbol.toStringTag]||r.constructor.name||"Object";return p.call(i,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",E),e(r)}}function o(r){if(r===y)return"<>";if(typeof r=="object"&&r!==null&&r.$$typeof===A)return"<...>";try{var i=t(r);return i?"<"+i+">":"<...>"}catch{return"<...>"}}function s(){var r=w.A;return r===null?null:r.getOwner()}function c(){return Error("react-stack-top-frame")}function a(r){if(B.call(r,"key")){var i=Object.getOwnPropertyDescriptor(r,"key").get;if(i&&i.isReactWarning)return!1}return r.key!==void 0}function h(r,i){function p(){te||(te=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",i))}p.isReactWarning=!0,Object.defineProperty(r,"key",{get:p,configurable:!0})}function S(){var r=t(this.type);return re[r]||(re[r]=!0,console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")),r=this.props.ref,r!==void 0?r:null}function g(r,i,p,E,C,x,X,H){return p=x.ref,r={$$typeof:f,type:r,key:i,props:x,_owner:C},(p!==void 0?p:null)!==null?Object.defineProperty(r,"ref",{enumerable:!1,get:S}):Object.defineProperty(r,"ref",{enumerable:!1,value:null}),r._store={},Object.defineProperty(r._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(r,"_debugInfo",{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(r,"_debugStack",{configurable:!1,enumerable:!1,writable:!0,value:X}),Object.defineProperty(r,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:H}),Object.freeze&&(Object.freeze(r.props),Object.freeze(r)),r}function d(r,i,p,E,C,x,X,H){var R=i.children;if(R!==void 0)if(E)if(J(R)){for(E=0;E<R.length;E++)l(R[E]);Object.freeze&&Object.freeze(R)}else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else l(R);if(B.call(i,"key")){R=t(r);var Y=Object.keys(i).filter(function(be){return be!=="key"});E=0<Y.length?"{key: someKey, "+Y.join(": ..., ")+": ...}":"{key: someKey}",se[R+E]||(Y=0<Y.length?"{"+Y.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
+ * License: MIT */
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("react"),be=require("@yoltra/core"),K=c.createContext(null);var W={exports:{}},D={};var ue;function Ee(){if(ue)return D;ue=1;var t=Symbol.for("react.transitional.element"),e=Symbol.for("react.fragment");function o(n,s,u){var a=null;if(u!==void 0&&(a=""+u),s.key!==void 0&&(a=""+s.key),"key"in s){u={};for(var m in s)m!=="key"&&(u[m]=s[m])}else u=s;return s=u.ref,{$$typeof:t,type:n,key:a,ref:s!==void 0?s:null,props:u}}return D.Fragment=e,D.jsx=o,D.jsxs=o,D}var F={};var ce;function Re(){return ce||(ce=1,process.env.NODE_ENV!=="production"&&(function(){function t(r){if(r==null)return null;if(typeof r=="function")return r.$$typeof===U?null:r.displayName||r.name||null;if(typeof r=="string")return r;switch(r){case h:return"Fragment";case k:return"Profiler";case P:return"StrictMode";case $:return"Suspense";case I:return"SuspenseList";case O:return"Activity"}if(typeof r=="object")switch(typeof r.tag=="number"&&console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),r.$$typeof){case v:return"Portal";case A:return(r.displayName||"Context")+".Provider";case _:return(r._context.displayName||"Context")+".Consumer";case j:var i=r.render;return r=r.displayName,r||(r=i.displayName||i.name||"",r=r!==""?"ForwardRef("+r+")":"ForwardRef"),r;case M:return i=r.displayName||null,i!==null?i:t(r.type)||"Memo";case R:i=r._payload,r=r._init;try{return t(r(i))}catch{}}return null}function e(r){return""+r}function o(r){try{e(r);var i=!1}catch{i=!0}if(i){i=console;var p=i.error,b=typeof Symbol=="function"&&Symbol.toStringTag&&r[Symbol.toStringTag]||r.constructor.name||"Object";return p.call(i,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",b),e(r)}}function n(r){if(r===h)return"<>";if(typeof r=="object"&&r!==null&&r.$$typeof===R)return"<...>";try{var i=t(r);return i?"<"+i+">":"<...>"}catch{return"<...>"}}function s(){var r=w.A;return r===null?null:r.getOwner()}function u(){return Error("react-stack-top-frame")}function a(r){if(V.call(r,"key")){var i=Object.getOwnPropertyDescriptor(r,"key").get;if(i&&i.isReactWarning)return!1}return r.key!==void 0}function m(r,i){function p(){te||(te=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",i))}p.isReactWarning=!0,Object.defineProperty(r,"key",{get:p,configurable:!0})}function y(){var r=t(this.type);return re[r]||(re[r]=!0,console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")),r=this.props.ref,r!==void 0?r:null}function g(r,i,p,b,C,x,X,H){return p=x.ref,r={$$typeof:f,type:r,key:i,props:x,_owner:C},(p!==void 0?p:null)!==null?Object.defineProperty(r,"ref",{enumerable:!1,get:y}):Object.defineProperty(r,"ref",{enumerable:!1,value:null}),r._store={},Object.defineProperty(r._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(r,"_debugInfo",{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(r,"_debugStack",{configurable:!1,enumerable:!1,writable:!0,value:X}),Object.defineProperty(r,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:H}),Object.freeze&&(Object.freeze(r.props),Object.freeze(r)),r}function d(r,i,p,b,C,x,X,H){var E=i.children;if(E!==void 0)if(b)if(B(E)){for(b=0;b<E.length;b++)l(E[b]);Object.freeze&&Object.freeze(E)}else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else l(E);if(V.call(i,"key")){E=t(r);var Y=Object.keys(i).filter(function(ve){return ve!=="key"});b=0<Y.length?"{key: someKey, "+Y.join(": ..., ")+": ...}":"{key: someKey}",se[E+b]||(Y=0<Y.length?"{"+Y.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
   let props = %s;
   <%s {...props} />
 React keys must be passed directly to JSX without using spread:
   let props = %s;
-  <%s key={someKey} {...props} />`,E,R,Y,R),se[R+E]=!0)}if(R=null,p!==void 0&&(n(p),R=""+p),a(i)&&(n(i.key),R=""+i.key),"key"in i){p={};for(var Z in i)Z!=="key"&&(p[Z]=i[Z])}else p=i;return R&&h(p,typeof r=="function"?r.displayName||r.name||"Unknown":r),g(r,R,x,C,s(),p,X,H)}function l(r){typeof r=="object"&&r!==null&&r.$$typeof===f&&r._store&&(r._store.validated=1)}var m=u,f=Symbol.for("react.transitional.element"),v=Symbol.for("react.portal"),y=Symbol.for("react.fragment"),b=Symbol.for("react.strict_mode"),k=Symbol.for("react.profiler"),_=Symbol.for("react.consumer"),P=Symbol.for("react.context"),j=Symbol.for("react.forward_ref"),$=Symbol.for("react.suspense"),I=Symbol.for("react.suspense_list"),M=Symbol.for("react.memo"),A=Symbol.for("react.lazy"),O=Symbol.for("react.activity"),V=Symbol.for("react.client.reference"),w=m.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,B=Object.prototype.hasOwnProperty,J=Array.isArray,q=console.createTask?console.createTask:function(){return null};m={react_stack_bottom_frame:function(r){return r()}};var te,re={},ne=m.react_stack_bottom_frame.bind(m,c)(),oe=q(o(c)),se={};F.Fragment=y,F.jsx=function(r,i,p,E,C){var x=1e4>w.recentlyCreatedOwnerStacks++;return d(r,i,p,!1,E,C,x?Error("react-stack-top-frame"):ne,x?q(o(r)):oe)},F.jsxs=function(r,i,p,E,C){var x=1e4>w.recentlyCreatedOwnerStacks++;return d(r,i,p,!0,E,C,x?Error("react-stack-top-frame"):ne,x?q(o(r)):oe)}})()),F}var ie;function _e(){return ie||(ie=1,process.env.NODE_ENV==="production"?W.exports=Pe():W.exports=ge()),W.exports}var de=_e();const we=({store:t,children:e})=>de.jsx(K.Provider,{value:t,children:e}),le=new Set;function xe(t,e){process.env.NODE_ENV!=="production"&&(le.has(t)||(le.add(t),console.warn(e)))}function G(t){return t.includes("*")}function T(t){return t.replace(/^\./,"")}function Te(t){return T(t).split(".").filter(Boolean)}function ke(t){const e=n=>`${n.length}:${n}`;return t.map(n=>{const o=Array.isArray(n.property)?n.property:[n.property];return e(n.reducer)+e(String(o.length))+o.map(e).join("")}).join("")}const me=Symbol("yoltra.pathSegments");function he(t){const e=()=>{};return new Proxy(e,{get(n,o){if(o===me)return t;if(typeof o!="symbol")return he([...t,String(o)])},apply(){throw new Error(`[yoltra] A typed path accessor called a method (near "${t.join(".")}"). The accessor must be a plain member chain like \`p => p.items[0].title\` — it cannot call functions such as \`.map()\` or \`.toString()\`. Compute derived values in the component or a selector, or use the \`{ reducer, property }\` string form.`)}})}function je(t){const e=t(he([])),n=e!=null?e[me]:void 0,s=(Array.isArray(n)?n:[]).join(".");return s===""&&xe("yoltra.toDottedPath.empty","[yoltra] A typed path accessor recorded no property access, so it subscribed to the slice root. That fires only when the slice's whole value is replaced — which for a slice holding an object means never, since its changes are reported at their leaves. The accessor must be a plain member chain like `p => p.items[0].title` and cannot return a computed value or a default. For a dynamic subscription, or for a slice whose state is a single value, use the `{ reducer, property }` string form instead."),s}function L(t,e){if(!e)return t;let n=t;for(const o of Te(e)){if(n==null)return;n=n[o]}return n}function U(t,e,n){const o=u.useRef(t);o.current=t;const s=u.useRef(e);s.current=e;const c=u.useMemo(()=>({has:!1,value:void 0}),n);return u.useCallback(()=>{const a=o.current();return(!c.has||!s.current(c.value,a))&&(c.has=!0,c.value=a),c.value},[c])}function ye(t,e){if(Object.is(t,e))return!0;if(!t||!e)return!1;const n=Object.keys(t),o=Object.keys(e);if(n.length!==o.length)return!1;for(const s of n)if(!Object.is(t[s],e[s]))return!1;return!0}function z(){const t=u.useContext(K);if(!t)throw new Error("useStore must be used inside <StoreProvider>");return t}function Oe(){return z().emit}function Ce(t,e=Object.is){const n=z(),o=u.useMemo(()=>c=>n.subscribe(c),[n]),s=U(()=>t(n.getState()),e,[n]);return u.useSyncExternalStore(o,s,s)}function Ne(t,e,n=Object.is){const o=z(),s=u.useMemo(()=>{const S=T(t.property);return{reducer:t.reducer,property:S}},[t.reducer,t.property]),c=u.useMemo(()=>S=>o.connect({reducer:s.reducer,property:s.property},()=>S()),[o,s]),a=G(s.property),h=U(()=>{const g=o.getState()[s.reducer];return a?g:L(g,s.property)},n,[o,s]);return u.useSyncExternalStore(c,h,h)}function Q(t,e,n=Object.is){return Ne(t,e,n)}function Me(t,e,n,o="committed"){const s=z(),c=u.useRef(n);c.current=n,u.useEffect(()=>s.onEvent(t,e,(a,h,S,g)=>{c.current(a,h,S,g)},o),[s,t,e,o])}function $e(t){return t==null||t<=0?null:Date.now()+t}function Ie(t){return t===null?null:t===void 0||t<=0?0:Date.now()+t}const Ye=2e3;class De{constructor(){ce(this,"store",new Map)}touch(e){this.store.has(e)&&this.store.delete(e)}evict(){for(;this.store.size>Ye;){const e=this.store.keys().next();if(e.done===!0)return;const n=this.store.get(e.value);if((n==null?void 0:n.status)==="pending"){this.store.delete(e.value),this.store.set(e.value,n);continue}this.store.delete(e.value)}}get size(){return this.store.size}read(e,n,o,s){const c=Date.now(),a=this.store.get(e);if(a&&a.status==="ready"&&(a.expiresAt==null||a.expiresAt>c))return this.touch(e),this.store.set(e,a),a.value;if(a&&a.status==="pending")throw a.promise;if(a&&a.status==="error"){if(a.delivered!==!0)throw this.store.set(e,{...a,delivered:!0}),a.error;if(a.expiresAt===null||a.expiresAt>c)throw a.error;this.store.delete(e)}const h=Promise.resolve().then(n).then(S=>{this.store.set(e,{status:"ready",value:S,expiresAt:$e(o)})}).catch(S=>{this.store.set(e,{status:"error",error:S,expiresAt:Ie(s)})});throw this.store.set(e,{status:"pending",promise:h,expiresAt:null}),this.evict(),h}invalidate(e){this.store.delete(e)}invalidatePathKey(e){for(const n of this.store.keys())pe(n)===e&&this.store.delete(n)}invalidateReducer(e){const n=`${e}::`;for(const o of this.store.keys())pe(o).split("||").some(s=>s.startsWith(n))&&this.store.delete(o)}clear(){this.store.clear()}}const N=new De,fe=new WeakMap;let Fe=0;function Se(t){let e=fe.get(t);return e===void 0&&(e=`s${++Fe}`,fe.set(t,e)),e}function pe(t){return t.slice(t.indexOf("::")+2)}function ee(t,e,n){const o=Array.isArray(e)?e.map(T).sort().join("|"):T(e);return n?`${t}::${o}::${n}`:`${t}::${o}`}function ze(t,e,n){const o=t(),s=e.reducer,c=T(e.property),a=`${Se(o)}::${ee(s,c,n.key)}`,h=u.useMemo(()=>l=>o.connect({reducer:s,property:c},()=>{N.invalidate(a),l()}),[o,s,c,a]),S=u.useRef(n);S.current=n;const g=u.useMemo(()=>{const l=G(c);return()=>{var b;const f=o.getState()[s],v=l?f:L(f,c),y=S.current;return N.read(a,()=>y.load(v,f),(b=y.staleTime)!=null?b:0,y.errorTtlMs)}},[o,s,c,a]),d=u.useMemo(()=>{const l=G(c);return()=>{const f=o.getState()[s];return l?f:L(f,c)}},[o,s,c]);return u.useSyncExternalStore(h,g,d)}function We(t,e,n){const o=t(),s=u.useMemo(()=>e.map(d=>({reducer:d.reducer,property:Array.isArray(d.property)?d.property.map(l=>T(l)):T(d.property)})),[JSON.stringify(e)]),c=u.useMemo(()=>{const d=s.map(l=>ee(l.reducer,l.property)).sort().join("||");return`${Se(o)}::${n.key?`${d}::${n.key}`:d}`},[o,s,n.key]),a=u.useMemo(()=>d=>{const l=()=>{N.invalidate(c),d()},m=s.map(f=>o.connect(f,l));return()=>{for(const f of m)f()}},[o,s,c]),h=u.useRef(n);h.current=n;const S=u.useMemo(()=>()=>{var m;const d=o.getState(),l=h.current;return N.read(c,()=>l.load(d),(m=l.staleTime)!=null?m:0,l.errorTtlMs)},[o,c]),g=()=>{const d=h.current.load(o.getState());return d instanceof Promise?void 0:d};return u.useSyncExternalStore(a,S,g)}function Ge(t,e,n){N.invalidatePathKey(ee(t,e,n))}function Le(t){N.invalidateReducer(t)}function Ue(){N.clear()}function Ve(t){return{useSuspenseAtomicProp:(o,s)=>ze(t,o,s),useSuspenseAtomicProps:(o,s)=>We(t,o,s)}}function ve(t){function e(){const l=u.useContext(t);if(!l)throw new Error("[yoltra] No store in context. Wrap your tree in <StoreProvider store={...}>, or use the hooks returned by createYoltra (which default to their own store).");return l}function n(){return e().emit}function o(l,m=Object.is){const f=e(),v=u.useMemo(()=>b=>f.subscribe(b),[f]),y=U(()=>l(f.getState()),m,[f]);return u.useSyncExternalStore(v,y,y)}const c=(l,m,f)=>{const v=e(),y=typeof l=="string",b=y?l:l.reducer,k=y?je(m):l.property,_=y?void 0:m,P=u.useMemo(()=>({reducer:b,property:T(k)}),[b,k]),j=u.useMemo(()=>M=>v.connect({reducer:P.reducer,property:P.property},()=>M()),[v,P]),$=G(P.property),I=U(()=>{const A=v.getState()[P.reducer],O=$?A:L(A,P.property);return _?_(O):O},f!=null?f:Object.is,[v,P]);return u.useSyncExternalStore(j,I,I)},h=(l,m,f=Object.is)=>{const v=e(),y=u.useRef(0),b=u.useRef(void 0),k=u.useRef(-1),_=u.useRef(!1),P=u.useRef(m);P.current=m;const j=u.useRef(f);j.current=f;const $=u.useMemo(()=>l.map(A=>({reducer:A.reducer,property:Array.isArray(A.property)?A.property.map(O=>T(O)):T(A.property)})),[ke(l)]),I=u.useMemo(()=>A=>{const O=()=>{y.current++,A()},V=$.flatMap(w=>(Array.isArray(w.property)?w.property:[w.property]).map(J=>v.connect({reducer:w.reducer,property:J},O)));return()=>{for(const w of V)w()}},[v,$]),M=u.useCallback(()=>{if(k.current!==y.current||!_.current){const A=P.current(v.getState());(!_.current||!j.current(b.current,A))&&(b.current=A,_.current=!0),k.current=y.current}return b.current},[v]);return u.useSyncExternalStore(I,M,M)},S=(l,m,f,v="committed")=>{const y=e(),b=u.useRef(f);b.current=f,u.useEffect(()=>y.onEvent(l,m,(k,_,P,j)=>{b.current(k,_,P,j)},v),[y,l,m,v])},{useSuspenseAtomicProp:g,useSuspenseAtomicProps:d}=Ve(e);return{useStore:e,useEmit:n,useSelector:o,useAtomicProp:c,useAtomicProps:h,useEvent:S,useSuspenseAtomicProp:g,useSuspenseAtomicProps:d,shallowEqual:ye}}function Be(t){const e=Ae.createStore(t),n=u.createContext(e),o=ve(n);return{store:e,StoreContext:n,StoreProvider:({store:c,children:a})=>de.jsx(n.Provider,{value:c!=null?c:e,children:a}),...o}}function Je(t,e){return Q({reducer:t,property:e.idsPath})}function qe(t,e,n){return Q({reducer:t,property:e.pathTo(n)})}function Xe(t,e,n,o){return Q({reducer:t,property:e.pathTo(n,o)})}exports.StoreContext=K;exports.StoreProvider=we;exports.clearSuspenseCache=Ue;exports.createHooks=ve;exports.createYoltra=Be;exports.invalidateAtomicProp=Ge;exports.invalidateAtomicPropsByReducer=Le;exports.shallowEqual=ye;exports.suspenseCache=N;exports.useEmit=Oe;exports.useEntity=qe;exports.useEntityField=Xe;exports.useEntityIds=Je;exports.useEvent=Me;exports.useSelector=Ce;exports.useStore=z;
+  <%s key={someKey} {...props} />`,b,E,Y,E),se[E+b]=!0)}if(E=null,p!==void 0&&(o(p),E=""+p),a(i)&&(o(i.key),E=""+i.key),"key"in i){p={};for(var Z in i)Z!=="key"&&(p[Z]=i[Z])}else p=i;return E&&m(p,typeof r=="function"?r.displayName||r.name||"Unknown":r),g(r,E,x,C,s(),p,X,H)}function l(r){typeof r=="object"&&r!==null&&r.$$typeof===f&&r._store&&(r._store.validated=1)}var S=c,f=Symbol.for("react.transitional.element"),v=Symbol.for("react.portal"),h=Symbol.for("react.fragment"),P=Symbol.for("react.strict_mode"),k=Symbol.for("react.profiler"),_=Symbol.for("react.consumer"),A=Symbol.for("react.context"),j=Symbol.for("react.forward_ref"),$=Symbol.for("react.suspense"),I=Symbol.for("react.suspense_list"),M=Symbol.for("react.memo"),R=Symbol.for("react.lazy"),O=Symbol.for("react.activity"),U=Symbol.for("react.client.reference"),w=S.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,V=Object.prototype.hasOwnProperty,B=Array.isArray,J=console.createTask?console.createTask:function(){return null};S={react_stack_bottom_frame:function(r){return r()}};var te,re={},oe=S.react_stack_bottom_frame.bind(S,u)(),ne=J(n(u)),se={};F.Fragment=h,F.jsx=function(r,i,p,b,C){var x=1e4>w.recentlyCreatedOwnerStacks++;return d(r,i,p,!1,b,C,x?Error("react-stack-top-frame"):oe,x?J(n(r)):ne)},F.jsxs=function(r,i,p,b,C){var x=1e4>w.recentlyCreatedOwnerStacks++;return d(r,i,p,!0,b,C,x?Error("react-stack-top-frame"):oe,x?J(n(r)):ne)}})()),F}var ae;function Ae(){return ae||(ae=1,process.env.NODE_ENV==="production"?W.exports=Ee():W.exports=Re()),W.exports}var pe=Ae();const Pe=({store:t,children:e})=>pe.jsx(K.Provider,{value:t,children:e}),ie=new Set;function ge(t,e){process.env.NODE_ENV!=="production"&&(ie.has(t)||(ie.add(t),console.warn(e)))}function q(t){return t.includes("*")}function T(t){return t.replace(/^\./,"")}function _e(t){return T(t).split(".").filter(Boolean)}function we(t){const e=o=>`${o.length}:${o}`;return t.map(o=>{const n=Array.isArray(o.property)?o.property:[o.property];return e(o.reducer)+e(String(n.length))+n.map(e).join("")}).join("")}const de=Symbol("yoltra.pathSegments");function me(t){const e=()=>{};return new Proxy(e,{get(o,n){if(n===de)return t;if(typeof n!="symbol")return me([...t,String(n)])},apply(){throw new Error(`[yoltra] A typed path accessor called a method (near "${t.join(".")}"). The accessor must be a plain member chain like \`p => p.items[0].title\` — it cannot call functions such as \`.map()\` or \`.toString()\`. Compute derived values in the component or a selector, or use the \`{ reducer, property }\` string form.`)}})}function xe(t){const e=t(me([])),o=e?.[de],s=(Array.isArray(o)?o:[]).join(".");return s===""&&ge("yoltra.toDottedPath.empty","[yoltra] A typed path accessor recorded no property access, so it subscribed to the slice root. That fires only when the slice's whole value is replaced — which for a slice holding an object means never, since its changes are reported at their leaves. The accessor must be a plain member chain like `p => p.items[0].title` and cannot return a computed value or a default. For a dynamic subscription, or for a slice whose state is a single value, use the `{ reducer, property }` string form instead."),s}function G(t,e){if(!e)return t;let o=t;for(const n of _e(e)){if(o==null)return;o=o[n]}return o}function L(t,e,o){const n=c.useRef(t);n.current=t;const s=c.useRef(e);s.current=e;const u=c.useMemo(()=>({has:!1,value:void 0}),o);return c.useCallback(()=>{const a=n.current();return(!u.has||!s.current(u.value,a))&&(u.has=!0,u.value=a),u.value},[u])}function he(t,e){if(Object.is(t,e))return!0;if(!t||!e)return!1;const o=Object.keys(t),n=Object.keys(e);if(o.length!==n.length)return!1;for(const s of o)if(!Object.is(t[s],e[s]))return!1;return!0}function z(){const t=c.useContext(K);if(!t)throw new Error("useStore must be used inside <StoreProvider>");return t}function Te(){return z().emit}function ke(t,e=Object.is){const o=z(),n=c.useMemo(()=>u=>o.subscribe(u),[o]),s=L(()=>t(o.getState()),e,[o]);return c.useSyncExternalStore(n,s,s)}function je(t,e,o=Object.is){const n=z(),s=c.useMemo(()=>{const y=T(t.property);return{reducer:t.reducer,property:y}},[t.reducer,t.property]),u=c.useMemo(()=>y=>n.connect({reducer:s.reducer,property:s.property},()=>y()),[n,s]),a=q(s.property),m=L(()=>{const g=n.getState()[s.reducer];return a?g:G(g,s.property)},o,[n,s]);return c.useSyncExternalStore(u,m,m)}function Q(t,e,o=Object.is){return je(t,e,o)}function Oe(t,e,o,n="committed"){const s=z(),u=c.useRef(o);u.current=o,c.useEffect(()=>s.onEvent(t,e,(a,m,y,g)=>{u.current(a,m,y,g)},n),[s,t,e,n])}function Ce(t){return t==null||t<=0?null:Date.now()+t}function Ne(t){return t===null?null:t===void 0||t<=0?0:Date.now()+t}const Me=2e3;class $e{store=new Map;touch(e){this.store.has(e)&&this.store.delete(e)}evict(){for(;this.store.size>Me;){const e=this.store.keys().next();if(e.done===!0)return;const o=this.store.get(e.value);if(o?.status==="pending"){this.store.delete(e.value),this.store.set(e.value,o);continue}this.store.delete(e.value)}}get size(){return this.store.size}read(e,o,n,s){const u=Date.now(),a=this.store.get(e);if(a&&a.status==="ready"&&(a.expiresAt==null||a.expiresAt>u))return this.touch(e),this.store.set(e,a),a.value;if(a&&a.status==="pending")throw a.promise;if(a&&a.status==="error"){if(a.delivered!==!0)throw this.store.set(e,{...a,delivered:!0}),a.error;if(a.expiresAt===null||a.expiresAt>u)throw a.error;this.store.delete(e)}const m=Promise.resolve().then(o).then(y=>{this.store.set(e,{status:"ready",value:y,expiresAt:Ce(n)})}).catch(y=>{this.store.set(e,{status:"error",error:y,expiresAt:Ne(s)})});throw this.store.set(e,{status:"pending",promise:m,expiresAt:null}),this.evict(),m}invalidate(e){this.store.delete(e)}invalidatePathKey(e){for(const o of this.store.keys())fe(o)===e&&this.store.delete(o)}invalidateReducer(e){const o=`${e}::`;for(const n of this.store.keys())fe(n).split("||").some(s=>s.startsWith(o))&&this.store.delete(n)}clear(){this.store.clear()}}const N=new $e,le=new WeakMap;let Ie=0;function ye(t){let e=le.get(t);return e===void 0&&(e=`s${++Ie}`,le.set(t,e)),e}function fe(t){return t.slice(t.indexOf("::")+2)}function ee(t,e,o){const n=Array.isArray(e)?e.map(T).sort().join("|"):T(e);return o?`${t}::${n}::${o}`:`${t}::${n}`}function Ye(t,e,o){const n=t(),s=e.reducer,u=T(e.property),a=`${ye(n)}::${ee(s,u,o.key)}`,m=c.useMemo(()=>l=>n.connect({reducer:s,property:u},()=>{N.invalidate(a),l()}),[n,s,u,a]),y=c.useRef(o);y.current=o;const g=c.useMemo(()=>{const l=q(u);return()=>{const f=n.getState()[s],v=l?f:G(f,u),h=y.current;return N.read(a,()=>h.load(v,f),h.staleTime??0,h.errorTtlMs)}},[n,s,u,a]),d=c.useMemo(()=>{const l=q(u);return()=>{const f=n.getState()[s];return l?f:G(f,u)}},[n,s,u]);return c.useSyncExternalStore(m,g,d)}function De(t,e,o){const n=t(),s=c.useMemo(()=>e.map(d=>({reducer:d.reducer,property:Array.isArray(d.property)?d.property.map(l=>T(l)):T(d.property)})),[JSON.stringify(e)]),u=c.useMemo(()=>{const d=s.map(l=>ee(l.reducer,l.property)).sort().join("||");return`${ye(n)}::${o.key?`${d}::${o.key}`:d}`},[n,s,o.key]),a=c.useMemo(()=>d=>{const l=()=>{N.invalidate(u),d()},S=s.map(f=>n.connect(f,l));return()=>{for(const f of S)f()}},[n,s,u]),m=c.useRef(o);m.current=o;const y=c.useMemo(()=>()=>{const d=n.getState(),l=m.current;return N.read(u,()=>l.load(d),l.staleTime??0,l.errorTtlMs)},[n,u]),g=()=>{const d=m.current.load(n.getState());return d instanceof Promise?void 0:d};return c.useSyncExternalStore(a,y,g)}function Fe(t,e,o){N.invalidatePathKey(ee(t,e,o))}function ze(t){N.invalidateReducer(t)}function We(){N.clear()}function qe(t){return{useSuspenseAtomicProp:(n,s)=>Ye(t,n,s),useSuspenseAtomicProps:(n,s)=>De(t,n,s)}}function Se(t){function e(){const l=c.useContext(t);if(!l)throw new Error("[yoltra] No store in context. Wrap your tree in <StoreProvider store={...}>, or use the hooks returned by createYoltra (which default to their own store).");return l}function o(){return e().emit}function n(l,S=Object.is){const f=e(),v=c.useMemo(()=>P=>f.subscribe(P),[f]),h=L(()=>l(f.getState()),S,[f]);return c.useSyncExternalStore(v,h,h)}const u=(l,S,f)=>{const v=e(),h=typeof l=="string",P=h?l:l.reducer,k=h?xe(S):l.property,_=h?void 0:S,A=c.useMemo(()=>({reducer:P,property:T(k)}),[P,k]),j=c.useMemo(()=>M=>v.connect({reducer:A.reducer,property:A.property},()=>M()),[v,A]),$=q(A.property),I=L(()=>{const R=v.getState()[A.reducer],O=$?R:G(R,A.property);return _?_(O):O},f??Object.is,[v,A]);return c.useSyncExternalStore(j,I,I)},m=(l,S,f=Object.is)=>{const v=e(),h=c.useRef(0),P=c.useRef(void 0),k=c.useRef(-1),_=c.useRef(!1),A=c.useRef(S);A.current=S;const j=c.useRef(f);j.current=f;const $=c.useMemo(()=>l.map(R=>({reducer:R.reducer,property:Array.isArray(R.property)?R.property.map(O=>T(O)):T(R.property)})),[we(l)]),I=c.useMemo(()=>R=>{const O=()=>{h.current++,R()},U=$.flatMap(w=>(Array.isArray(w.property)?w.property:[w.property]).map(B=>v.connect({reducer:w.reducer,property:B},O)));return()=>{for(const w of U)w()}},[v,$]),M=c.useCallback(()=>{if(k.current!==h.current||!_.current){const R=A.current(v.getState());(!_.current||!j.current(P.current,R))&&(P.current=R,_.current=!0),k.current=h.current}return P.current},[v]);return c.useSyncExternalStore(I,M,M)},y=(l,S,f,v="committed")=>{const h=e(),P=c.useRef(f);P.current=f,c.useEffect(()=>h.onEvent(l,S,(k,_,A,j)=>{P.current(k,_,A,j)},v),[h,l,S,v])},{useSuspenseAtomicProp:g,useSuspenseAtomicProps:d}=qe(e);return{useStore:e,useEmit:o,useSelector:n,useAtomicProp:u,useAtomicProps:m,useEvent:y,useSuspenseAtomicProp:g,useSuspenseAtomicProps:d,shallowEqual:he}}function Ge(t){const e=be.createStore(t),o=c.createContext(e),n=Se(o);return{store:e,StoreContext:o,StoreProvider:({store:u,children:a})=>pe.jsx(o.Provider,{value:u??e,children:a}),...n}}function Le(t,e){return Q({reducer:t,property:e.idsPath})}function Ue(t,e,o){return Q({reducer:t,property:e.pathTo(o)})}function Ve(t,e,o,n){return Q({reducer:t,property:e.pathTo(o,n)})}exports.StoreContext=K;exports.StoreProvider=Pe;exports.clearSuspenseCache=We;exports.createHooks=Se;exports.createYoltra=Ge;exports.invalidateAtomicProp=Fe;exports.invalidateAtomicPropsByReducer=ze;exports.shallowEqual=he;exports.suspenseCache=N;exports.useEmit=Te;exports.useEntity=Ue;exports.useEntityField=Ve;exports.useEntityIds=Le;exports.useEvent=Oe;exports.useSelector=ke;exports.useStore=z;
 //# sourceMappingURL=index.cjs.map