Function usePersistentState

Persisted state hook backed by the current persistence context.

This works like useState, but:

• The value is persisted under namespace:key using the current store.
• With no stored value, it uses the provider's defaultValues[key] if present, otherwise defaultValue. Defaults are never written to the store; only values passed to setState are.
• Then it hydrates asynchronously from the configured store (memory, localStorage, IndexedDB, remote, etc.). Hydration is seeding: a value written with setState while the read is still in flight is newer, so it wins and the read is discarded.
• Writes are debounced according to debounceMs from the context.
• Optional versioning + migration lets you evolve stored shapes over time.

Optional persistence

If key is null, persistence is disabled and the hook behaves like a plain useState with the same defaultValue semantics:

• No reads or writes go to the persistence store.
• No cross-tab / cross-hook subscription is set up.
• clear() simply resets back to defaultValue (or undefined).