@weasel-js/prefs 1.9.3 → 1.10.0

package/README.md

@@ -18,3 +18,20 @@ repair stored values that no longer fit the schema without writing them back.
 `usePref(store, path)` and `usePrefsValues(store)` bind it to React. They
 live in `@weasel-js/prefs/react`, so the main entry never loads React.
 `usePrefsValues` returns the pieces `@weasel-js/ui`'s `PrefsForm` takes.
+
+`usePrefsStore(schema, { storage, prefix })` gives a component a store of its
+own: open from its first render, closed with its writes sent when it unmounts.
+It takes an adapter that reads synchronously, and components naming the same
+`storage`, `prefix`, and `schema` share one store. Components naming one
+`storage` and `prefix` with different schemas each get a store over the same
+records.
+
+## Ranges
+
+A number leaf's range is one scale: the low end is the least of what its label
+names and the high end the most. Do not give zero a second meaning such as
+"no limit" or "automatic" — on a slider it reads as the least, and the form
+draws it there. Put an unlimited setting at the end of the range it is nearest:
+a 0–100% limit is off at 100, and a scale with no such end takes `endless`,
+which adds a stop one step past the range that stores `Infinity` and reads the
+leaf's `infinity` word.