@lite-fsm/persist 1.0.3 → 1.0.4

package/README.md

@@ -22,7 +22,7 @@ npm install @lite-fsm/react @lite-fsm/persist
 import { createJsonStorage, persistManager } from "@lite-fsm/persist";
 import type { PersistController, PersistStorage, PersistStatus } from "@lite-fsm/persist";
 
-import { useIsPersistRestoring, usePersistStatus } from "@lite-fsm/persist/react";
+import { useIsPersistRestoring, usePersistStatuses } from "@lite-fsm/persist/react";
 ```
 
 ## Quick Example
@@ -83,7 +83,7 @@ import { FSMContextProvider } from "@lite-fsm/react";
 
 export function App() {
   return (
-    <FSMContextProvider machineManager={manager} persist={persist}>
+    <FSMContextProvider machineManager={manager} persist={[persist]}>
       <Page />
     </FSMContextProvider>
   );
@@ -93,19 +93,19 @@ export function App() {
 Read restore status from React with `@lite-fsm/persist/react`:
 
 ```tsx
-import { usePersistStatus } from "@lite-fsm/persist/react";
+import { usePersistStatuses } from "@lite-fsm/persist/react";
 
 function PersistStatusView() {
-  const status = usePersistStatus();
-  return <span>{status.phase}</span>;
+  const [status] = usePersistStatuses();
+  return <span>{status?.phase ?? "none"}</span>;
 }
 ```
 
-You can still pass a controller explicitly when the component is outside
-`FSMContextProvider` or when several persist controllers are active.
-`useIsPersistRestoring()` is exactly `usePersistStatus().phase === "restoring"`;
-blocking UI until the first restore settles should also treat the `"idle"`
-phase as loading.
+`usePersistStatuses()` returns an array with the same length and order as the
+provider `persist` array. Entries without `getStatus()` and `subscribeStatus()`
+are returned as `null`. `useIsPersistRestoring()` returns `true` when any
+non-null status has `phase === "restoring"`; blocking UI until the first restore
+settles should also treat the `"idle"` phase as loading.
 
 ## Documentation
 

package/dist/react.cjs

@@ -1 +1 @@
-"use strict";"use client";var P=Object.create;var o=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var x=Object.getPrototypeOf,m=Object.prototype.hasOwnProperty;var f=(t,s)=>{for(var e in s)o(t,e,{get:s[e],enumerable:!0})},u=(t,s,e,i)=>{if(s&&typeof s=="object"||typeof s=="function")for(let r of p(s))!m.call(t,r)&&r!==e&&o(t,r,{get:()=>s[r],enumerable:!(i=C(s,r))||i.enumerable});return t};var R=(t,s,e)=>(e=t!=null?P(x(t)):{},u(s||!t||!t.__esModule?o(e,"default",{value:t,enumerable:!0}):e,t)),b=t=>u(o({},"__esModule",{value:!0}),t);var T={};f(T,{useIsPersistRestoring:()=>d,usePersistStatus:()=>a});module.exports=b(T);var n=R(require("react"),1),S=require("use-sync-external-store/shim"),l=Symbol.for("@lite-fsm/react.persistContext"),g="Hooks from @lite-fsm/persist/react require a PersistController argument or FSMContextProvider persist context.",c=globalThis,E=c[l]??(c[l]=n.default.createContext(null)),y=t=>{let s=n.default.useContext(E),e=t??s;if(!e)throw new Error(g);return e},a=t=>{let s=y(t);return(0,S.useSyncExternalStore)(s.subscribeStatus,s.getStatus,s.getStatus)},d=t=>a(t).phase==="restoring";0&&(module.exports={useIsPersistRestoring,usePersistStatus});
+"use strict";"use client";var P=Object.create;var u=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var y=Object.getOwnPropertyNames;var E=Object.getPrototypeOf,b=Object.prototype.hasOwnProperty;var d=(t,s)=>{for(var e in s)u(t,e,{get:s[e],enumerable:!0})},S=(t,s,e,o)=>{if(s&&typeof s=="object"||typeof s=="function")for(let r of y(s))!b.call(t,r)&&r!==e&&u(t,r,{get:()=>s[r],enumerable:!(o=h(s,r))||o.enumerable});return t};var m=(t,s,e)=>(e=t!=null?P(E(t)):{},S(s||!t||!t.__esModule?u(e,"default",{value:t,enumerable:!0}):e,t)),g=t=>S(u({},"__esModule",{value:!0}),t);var I={};d(I,{useIsPersistRestoring:()=>v,usePersistStatuses:()=>p});module.exports=g(I);var a=m(require("react"),1),f=require("use-sync-external-store/shim"),i=Symbol.for("@lite-fsm/react.persistStatusesContext"),x="Hooks from @lite-fsm/persist/react require FSMContextProvider from @lite-fsm/react.",T=[],l=globalThis,R=l[i]??(l[i]=a.default.createContext(null)),c=t=>{if(t.length===0)return T;let s=[];for(let e of t)s.push(e===null?null:e.getStatus());return s},C=(t,s)=>{if(t.length!==s.length)return!1;for(let e=0;e<t.length;e+=1)if(!Object.is(t[e],s[e]))return!1;return!0},_=t=>{let s=c(t),e=()=>{let o=c(t);return C(s,o)?!1:(s=o,!0)};return{getSnapshot:()=>s,getServerSnapshot:()=>s,subscribe:o=>{let r=[];for(let n of t)n!==null&&r.push(n.subscribeStatus(()=>{e()&&o()}));return()=>{for(let n of r)n()}}}},p=()=>{let t=a.default.useContext(R);if(t===null)throw new Error(x);let s=a.default.useMemo(()=>_(t),[t]);return(0,f.useSyncExternalStore)(s.subscribe,s.getSnapshot,s.getServerSnapshot)},v=()=>p().some(s=>s?.phase==="restoring");0&&(module.exports={useIsPersistRestoring,usePersistStatuses});

package/dist/react.d.cts

@@ -1,3 +1,5 @@
-import type { PersistController, PersistStatus } from "./index";
-export declare const usePersistStatus: (controller?: PersistController) => PersistStatus;
-export declare const useIsPersistRestoring: (controller?: PersistController) => boolean;
+import type { PersistStatus } from "./index";
+type PersistStatusesSnapshot = readonly (PersistStatus | null)[];
+export declare const usePersistStatuses: () => PersistStatusesSnapshot;
+export declare const useIsPersistRestoring: () => boolean;
+export {};

package/dist/react.d.ts

@@ -1,3 +1,5 @@
-import type { PersistController, PersistStatus } from "./index";
-export declare const usePersistStatus: (controller?: PersistController) => PersistStatus;
-export declare const useIsPersistRestoring: (controller?: PersistController) => boolean;
+import type { PersistStatus } from "./index";
+type PersistStatusesSnapshot = readonly (PersistStatus | null)[];
+export declare const usePersistStatuses: () => PersistStatusesSnapshot;
+export declare const useIsPersistRestoring: () => boolean;
+export {};

package/dist/react.js

@@ -1 +1 @@
-"use client";import n from"react";import{useSyncExternalStore as i}from"use-sync-external-store/shim";var r=Symbol.for("@lite-fsm/react.persistContext"),u="Hooks from @lite-fsm/persist/react require a PersistController argument or FSMContextProvider persist context.",o=globalThis,l=o[r]??(o[r]=n.createContext(null)),c=t=>{let s=n.useContext(l),e=t??s;if(!e)throw new Error(u);return e},S=t=>{let s=c(t);return i(s.subscribeStatus,s.getStatus,s.getStatus)},C=t=>S(t).phase==="restoring";export{C as useIsPersistRestoring,S as usePersistStatus};
+"use client";import n from"react";import{useSyncExternalStore as l}from"use-sync-external-store/shim";var a=Symbol.for("@lite-fsm/react.persistStatusesContext"),c="Hooks from @lite-fsm/persist/react require FSMContextProvider from @lite-fsm/react.",f=[],S=globalThis,p=S[a]??(S[a]=n.createContext(null)),i=s=>{if(s.length===0)return f;let t=[];for(let e of s)t.push(e===null?null:e.getStatus());return t},P=(s,t)=>{if(s.length!==t.length)return!1;for(let e=0;e<s.length;e+=1)if(!Object.is(s[e],t[e]))return!1;return!0},h=s=>{let t=i(s),e=()=>{let r=i(s);return P(t,r)?!1:(t=r,!0)};return{getSnapshot:()=>t,getServerSnapshot:()=>t,subscribe:r=>{let u=[];for(let o of s)o!==null&&u.push(o.subscribeStatus(()=>{e()&&r()}));return()=>{for(let o of u)o()}}}},y=()=>{let s=n.useContext(p);if(s===null)throw new Error(c);let t=n.useMemo(()=>h(s),[s]);return l(t.subscribe,t.getSnapshot,t.getServerSnapshot)},d=()=>y().some(t=>t?.phase==="restoring");export{d as useIsPersistRestoring,y as usePersistStatuses};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lite-fsm/persist",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "type": "module",
   "description": "Persistence helpers for lite-fsm",
   "license": "MIT",
@@ -70,7 +70,7 @@
   },
   "dependencies": {
     "use-sync-external-store": ">=1.2.0",
-    "@lite-fsm/core": "2.0.3"
+    "@lite-fsm/core": "2.0.4"
   },
   "peerDependencies": {
     "react": ">=18.0.0"