0.2.0

Changes in version 0.2.0

Python package

• Tightened the shared path grammar to a strict JSONPath subset without the
  $. prefix:
  • Root paths must start with an identifier.
  • Later segments may use dotted identifiers, bracketed integer indices, or
    bracketed string keys.
  • Bracketed string keys may use either single or double quotes; formatting
    stays canonical with double quotes.
  • Invalid paths now fail explicitly instead of silently returning a parsed
    prefix.
• Added format_path() as the public Python path formatter.
• Updated parser docstrings, README examples, and path tests to match the
  shared grammar.
• Added twine to dev-dependencies.
• Changed member names in the Service class:
  • init_app to _init_app
  • get_state to get
  • set_state to set
  • update_task to notify
• Added __version__ attribute to main package.
• Exposed the path submodule from the package root and moved Path,
  PathSegment, Property, and Index under remotestate.path.
• Changed the Store default factory API:
  • Renamed the keyword argument from default_value_factory to
    default_factory.
  • The factory now receives a parsed Path tuple instead of a path string.
• Changed store update notifications to emit only the exact paths written by
  Store.set(), instead of also including all parent prefixes.
• Broadcast Python-side Store.set() updates to connected WebSocket clients
  even when the mutation did not originate from a JavaScript action.
• Changed signature and behavior of serve() function:
  • Replaced open_browser and open_iframe with a generic display
    parameter.
  • serve() now returns a ServeResult with resolved server, WebSocket,
    and UI URLs.
  • Renamed iframe_heigh argument into height, and added width.
  • It is no longer using FastAPI/Uvicorn default
    logging. Instead, all server logs are written to server.log
    and logging to stdout/stderr is suppressed.

TypeScript package

• Tightened the shared path grammar to a strict JSONPath subset without the
  $. prefix:
  • Root paths must start with an identifier.
  • Later segments may use dotted identifiers, bracketed integer indices, or
    bracketed string keys.
  • Bracketed string keys may use either single or double quotes; formatting
    stays canonical with double quotes.
  • Invalid paths now fail explicitly instead of silently returning a parsed
    prefix.
• Added normalizePath() as the public path validator/normalizer.
• Updated parser docstrings, README examples, and path tests to match the
  shared grammar.
• Supporting optional remote backend with local state fallback:
  • Added fallback?: () => RemoteStateClient to RemoteStateProvider.
  • Added client?: RemoteStateClient support to RemoteStateProvider.
  • Removed active?: boolean from RemoteStateProvider.
  • Removed useOptionalRemoteStateClient<S>(); hooks now always require a
    provider with either url, client, or fallback.
  • createRemoteStateClient() now requires an explicit URL.
  • Added createLocalStateClient() to wrap local stores and
    action/query handlers as fallback clients.
  • Updated docs with:
    • a basic counter RemoteState usage example
    • an optional remote backend/local client fallback example
    • root README references to RemoteStateProvider
• Slimmed store update handling:
  • The client now accepts exact changed paths from action_result updates
    instead of requiring redundant parent-prefix payloads.
  • Cached parent and child snapshots are reconciled locally when related
    paths update.
  • Subscribed parent and child snapshots are now materialized from related
    exact-path updates so useRemoteStateValue() rerenders for subpath
    changes.
  • Store.subscribe() now takes a required path first:
    subscribe(path, listener).
• Improved TypeScript package build output:
  • Split library, Node/Vite config, and ESLint TypeScript projects.
  • Clean dist before rebuilding to prevent stale artifacts.
  • Keep API docs in the bundled .d.ts file while stripping JSDoc blocks
    from the bundled runtime JavaScript.
  • Ensure the library bundle externalizes React peer dependencies and avoids
    publishing test/dev-only artifacts.
• Refactorings:
  • Renamed RemoteState to RemoteStateClient.
  • Renamed RemoteStateOptions to RemoteStateClientOptions.
  • Renamed createRemoteState to createRemoteStateClient.
  • Renamed useRemoteState to useRemoteStateClient.

---

Full Changelog: v0.1.0...v0.2.0

0.1.0

Version 0.1.0

Initial release from 2026-06-09.