use-everywhere 0.12.0 → 1.0.0

package/README.md

@@ -57,7 +57,7 @@ function CartBadge() {
   const send = shop.useSend();
 
   // Fires when any OTHER tab posts 'cart-updated'.
-  shop.useMessage('cart-updated', (payload) => setItems(payload.items));
+  shop.useOnMessage('cart-updated', (payload) => setItems(payload.items));
 
   const addToCart = () => {
     setItems(items + 1); // this tab
@@ -68,7 +68,7 @@ function CartBadge() {
 }
 ```
 
-The standalone hooks — `useChannel(name)`, `useMessage(channel, type,
+The standalone hooks — `useChannel(name)`, `useOnMessage(channel, type,
 handler)`, `useSend(channel)` — are the same machinery without the
 module-level binding, for one-off use.
 
@@ -84,20 +84,20 @@ function DuplicateTabWarning() {
 }
 ```
 
-## Cross-origin windows: `useOpenedWindow`
+## Cross-origin windows: `useWindowResult`
 
 Open a window on another domain, exchange typed messages, and await its
 result — the whole lifecycle folded into render state.
 
 ```tsx
-import { openWindow, useOpenedWindow } from 'use-everywhere';
+import { openWindow, useWindowResult } from 'use-everywhere';
 
 type ToPayment = { order: { orderId: string; amount: string } };
 type FromPayment = { progress: { step: string } };
 type Receipt = { receiptId: string; last4: string };
 
 function PayButton() {
-  const pay = useOpenedWindow<ToPayment, FromPayment, Receipt>(() =>
+  const pay = useWindowResult<ToPayment, FromPayment, Receipt>(() =>
     openWindow('https://pay.example.com/checkout', {
       peerOrigin: 'https://pay.example.com', // required — '*' throws
     }),

package/dist/{chunk-R7PBPLF7.js → chunk-YPQ6PLD5.js}

@@ -43,7 +43,7 @@ function warnOnInitialMismatch(storeName, key, initial) {
   if (comparable(first) && comparable(initial) && !Object.is(first, initial)) {
     devWarn(
       "UE2001",
-      `useSharedState('${key}') was called with different initial values (${String(first)} and ${String(initial)}). The first registration wins, so the second is ignored. Define the default once \u2014 defineStore, or a shared constant.`
+      `useSharedState('${key}') was called with different initial values (${String(first)} and ${String(initial)}). The first registration wins, so the second is ignored. Define the default once \u2014 createStoreHooks, or a shared constant.`
     );
   }
 }
@@ -127,7 +127,7 @@ function configureStore(name, scope, options) {
     if (process.env.NODE_ENV !== "production") {
       devWarn(
         "UE2002",
-        `defineStore('${name}') ran after that store was already created, with different options. The live store keeps the configuration it was built with. Move defineStore to module scope, before any component reads the store.`
+        `createStoreHooks('${name}') ran after that store was already created, with different options. The live store keeps the configuration it was built with. Move createStoreHooks to module scope, before any component reads the store.`
       );
     }
     return;

package/dist/devtools/index.js

@@ -2,7 +2,7 @@
 import {
   getSharedStore,
   usePeers
-} from "../chunk-R7PBPLF7.js";
+} from "../chunk-YPQ6PLD5.js";
 
 // src/devtools/inspector.tsx
 import { useState as useState2 } from "react";

package/dist/index.cjs

@@ -37,9 +37,9 @@ __export(src_exports, {
   createPresence: () => import_core4.createPresence,
   createSharedReducer: () => import_core4.createSharedReducer,
   createSharedStore: () => import_core4.createSharedStore,
+  createStoreHooks: () => createStoreHooks,
   defaultTransport: () => import_core4.defaultTransport,
   defineChannel: () => defineChannel,
-  defineStore: () => defineStore,
   enableDebug: () => import_core4.enableDebug,
   getBusNames: () => import_core4.getBusNames,
   getLeader: () => getLeader,
@@ -65,14 +65,14 @@ __export(src_exports, {
   useIsLeader: () => useIsLeader,
   useLeader: () => useLeader,
   useLeaderEffect: () => useLeaderEffect,
-  useMessage: () => useMessage,
-  useOpenedWindow: () => useOpenedWindow,
+  useOnMessage: () => useOnMessage,
   usePeers: () => usePeers,
   usePresenceMetadata: () => usePresenceMetadata,
   useSend: () => useSend,
   useSharedReducer: () => useSharedReducer,
+  useSharedSelector: () => useSharedSelector,
   useSharedState: () => useSharedState,
-  useSharedStore: () => useSharedStore,
+  useWindowResult: () => useWindowResult,
   webStorageAdapter: () => import_core4.webStorageAdapter
 });
 module.exports = __toCommonJS(src_exports);
@@ -112,7 +112,7 @@ function warnOnInitialMismatch(storeName, key, initial) {
   if (comparable(first) && comparable(initial) && !Object.is(first, initial)) {
     devWarn(
       "UE2001",
-      `useSharedState('${key}') was called with different initial values (${String(first)} and ${String(initial)}). The first registration wins, so the second is ignored. Define the default once \u2014 defineStore, or a shared constant.`
+      `useSharedState('${key}') was called with different initial values (${String(first)} and ${String(initial)}). The first registration wins, so the second is ignored. Define the default once \u2014 createStoreHooks, or a shared constant.`
     );
   }
 }
@@ -199,7 +199,7 @@ function configureStore(name, scope, options) {
     if (process.env.NODE_ENV !== "production") {
       devWarn(
         "UE2002",
-        `defineStore('${name}') ran after that store was already created, with different options. The live store keeps the configuration it was built with. Move defineStore to module scope, before any component reads the store.`
+        `createStoreHooks('${name}') ran after that store was already created, with different options. The live store keeps the configuration it was built with. Move createStoreHooks to module scope, before any component reads the store.`
       );
     }
     return;
@@ -325,7 +325,7 @@ function useSharedReducer(reducer, initial, options) {
 
 // src/use-shared-selector.ts
 var import_react3 = require("react");
-function useSharedStore(selector, options) {
+function useSharedSelector(selector, options) {
   const store = getStore(options?.store ?? import_core.DEFAULT_NAME, options?.scope ?? "everywhere");
   const equal = options?.equal ?? Object.is;
   const selectorRef = (0, import_react3.useRef)(selector);
@@ -359,12 +359,12 @@ function shallowEqual(a, b) {
   return keys.every((key) => Object.is(left[key], right[key]));
 }
 
-// src/use-message.ts
+// src/use-on-message.ts
 var import_react4 = require("react");
 function useChannel(name) {
   return getChannel(name);
 }
-function useMessage(channel, type, handler, options) {
+function useOnMessage(channel, type, handler, options) {
   const handlerRef = (0, import_react4.useRef)(handler);
   (0, import_react4.useEffect)(() => {
     handlerRef.current = handler;
@@ -398,16 +398,16 @@ function useAsk(channel) {
 function defineChannel(name, options) {
   if (options) configureChannel(name, options);
   const useBoundSend = () => useSend(useChannel(name));
-  const useBoundMessage = (type, handler) => useMessage(useChannel(name), type, handler);
+  const useBoundMessage = (type, handler) => useOnMessage(useChannel(name), type, handler);
   return {
     get: () => getChannel(name),
     useSend: useBoundSend,
-    useMessage: useBoundMessage
+    useOnMessage: useBoundMessage
   };
 }
 
-// src/define-store.ts
-function defineStore(name, options = {}) {
+// src/create-store-hooks.ts
+function createStoreHooks(name, options = {}) {
   const scope = options.scope ?? "everywhere";
   if (options.persist) {
     configureStore(name, scope, {
@@ -422,7 +422,7 @@ function defineStore(name, options = {}) {
     });
   }
   return {
-    get: () => getStore(name, scope),
+    store: () => getStore(name, scope),
     useSharedState: (key, initial) => useSharedState(key, initial, { store: name, scope })
   };
 }
@@ -512,11 +512,11 @@ function createNamespace(namespace) {
   const { busName } = core;
   return {
     ...core,
-    defineStore: (name, options) => defineStore(busName(name), options),
+    createStoreHooks: (name, options) => createStoreHooks(busName(name), options),
     defineChannel: (name, options) => defineChannel(busName(name), options),
     getSharedStore: (name, scope) => getSharedStore(busName(name), scope),
     useSharedState: (key, initial, options) => useSharedState(key, initial, { ...options, store: busName(options?.store) }),
-    useSharedStore: (selector, options) => useSharedStore(selector, { ...options, store: busName(options?.store) }),
+    useSharedSelector: (selector, options) => useSharedSelector(selector, { ...options, store: busName(options?.store) }),
     usePeers: (options) => usePeers({ ...options, name: busName(options?.name) }),
     usePresenceMetadata: (metadata, options) => usePresenceMetadata(metadata, { ...options, name: busName(options?.name) }),
     useHydrated: (options) => useHydrated({ ...options, store: busName(options?.store) }),
@@ -527,7 +527,7 @@ function createNamespace(namespace) {
   };
 }
 
-// src/use-opened-window.ts
+// src/use-window-result.ts
 var import_react8 = require("react");
 var import_core3 = require("@use-everywhere/core");
 var IDLE = Object.freeze({
@@ -535,7 +535,7 @@ var IDLE = Object.freeze({
   result: void 0,
   error: void 0
 });
-function useOpenedWindow(factory) {
+function useWindowResult(factory) {
   const [state, setState] = (0, import_react8.useState)(IDLE);
   const current = (0, import_react8.useRef)(null);
   const factoryRef = (0, import_react8.useRef)(factory);
@@ -604,9 +604,9 @@ var import_core4 = require("@use-everywhere/core");
   createPresence,
   createSharedReducer,
   createSharedStore,
+  createStoreHooks,
   defaultTransport,
   defineChannel,
-  defineStore,
   enableDebug,
   getBusNames,
   getLeader,
@@ -632,13 +632,13 @@ var import_core4 = require("@use-everywhere/core");
   useIsLeader,
   useLeader,
   useLeaderEffect,
-  useMessage,
-  useOpenedWindow,
+  useOnMessage,
   usePeers,
   usePresenceMetadata,
   useSend,
   useSharedReducer,
+  useSharedSelector,
   useSharedState,
-  useSharedStore,
+  useWindowResult,
   webStorageAdapter
 });

package/dist/index.d.cts

@@ -91,7 +91,7 @@ interface UseSharedSelectorOptions extends UseSharedStateOptions {
  * anything in it.
  *
  * ```tsx
- * const total = useSharedStore<Cart, number>(
+ * const total = useSharedSelector<Cart, number>(
  *   (cart) => cart.items.length + cart.saved.length,
  * );
  * ```
@@ -111,7 +111,7 @@ interface UseSharedSelectorOptions extends UseSharedStateOptions {
  * selector runs against `{}`, and its result is what the server-rendered markup
  * shows.
  */
-declare function useSharedStore<S extends Record<string, unknown>, T>(selector: (state: S) => T, options?: UseSharedSelectorOptions): T;
+declare function useSharedSelector<S extends Record<string, unknown>, T>(selector: (state: S) => T, options?: UseSharedSelectorOptions): T;
 /** Shallow equality over an object or array, for selectors that build one. */
 declare function shallowEqual(a: unknown, b: unknown): boolean;
 
@@ -130,7 +130,7 @@ declare function getLeader(name: string, options?: LeaderOptions): Leader;
 
 /** Get the page-wide typed channel for `name` (one instance per name). */
 declare function useChannel<M extends MessageMap, R extends ReplyMap<M> = Record<never, never>>(name: string): Channel<M, R>;
-interface UseMessageOptions {
+interface UseOnMessageOptions {
     /**
      * Subscribe at all. Default true.
      *
@@ -146,7 +146,7 @@ interface UseMessageOptions {
  * Subscribe to one message type. The handler is kept fresh without
  * resubscribing, so it may close over render state.
  */
-declare function useMessage<M extends MessageMap, R extends ReplyMap<M>, K extends keyof M & string>(channel: Channel<M, R>, type: K, handler: (payload: M[K], meta: MessageMeta) => void, options?: UseMessageOptions): void;
+declare function useOnMessage<M extends MessageMap, R extends ReplyMap<M>, K extends keyof M & string>(channel: Channel<M, R>, type: K, handler: (payload: M[K], meta: MessageMeta) => void, options?: UseOnMessageOptions): void;
 /**
  * Answer `ask`s of one type for as long as this component is mounted.
  *
@@ -173,14 +173,14 @@ interface ChannelHooks<M extends MessageMap> {
     useSend: () => Channel<M>['post'];
     /**
      * Subscribe to one message type. Same contract as the standalone
-     * `useMessage`: the handler is kept fresh without resubscribing.
+     * `useOnMessage`: the handler is kept fresh without resubscribing.
      */
-    useMessage: <K extends keyof M & string>(type: K, handler: (payload: M[K], meta: MessageMeta) => void) => void;
+    useOnMessage: <K extends keyof M & string>(type: K, handler: (payload: M[K], meta: MessageMeta) => void) => void;
 }
 
 /**
  * Bind a channel name and message map once, at module level, and get fully
- * typed hooks back. Sugar over useChannel/useMessage/useSend — the same
+ * typed hooks back. Sugar over useChannel/useOnMessage/useSend — the same
  * page-wide channel singleton is shared, so mixing bound and standalone
  * hooks for one name is safe.
  *
@@ -189,7 +189,7 @@ interface ChannelHooks<M extends MessageMap> {
  */
 declare function defineChannel<M extends MessageMap>(name: string, options?: ChannelOptions<M>): ChannelHooks<M>;
 
-interface DefineStoreOptions {
+interface CreateStoreHooksOptions {
     /** Restore this store from disk on first use, and write it back as it changes. */
     persist?: PersistAdapter;
     /** Persist only these keys. Default: every key that has been written. */
@@ -212,7 +212,7 @@ interface DefineStoreOptions {
 /** A store bound to a name and a shape: typed hooks with no per-call generics. */
 interface StoreHooks<S extends Record<string, unknown>> {
     /** The underlying store instance (the same one the hooks use) — for non-React code. */
-    get: () => AnyStore;
+    store: () => AnyStore;
     useSharedState: <K extends keyof S & string>(key: K, initial: S[K]) => [S[K], (next: S[K] | ((prev: S[K]) => S[K])) => void];
 }
 
@@ -222,7 +222,7 @@ interface StoreHooks<S extends Record<string, unknown>> {
  * Like defineChannel, this does not construct anything: it registers the
  * options the registry will use when the store is first needed, so importing
  * the module has no side effect. The store stays a singleton per name, so
- * `defineStore('settings', { persist })` and a bare
+ * `createStoreHooks('settings', { persist })` and a bare
  * `useSharedState('theme', 'dark', { store: 'settings' })` elsewhere resolve to
  * the same store, and both get persistence.
  *
@@ -230,7 +230,7 @@ interface StoreHooks<S extends Record<string, unknown>> {
  * so intended usage is automatic; if it does run late it throws rather than
  * quietly handing back a store with no persistence.
  */
-declare function defineStore<S extends Record<string, unknown> = Record<string, unknown>>(name: string, options?: DefineStoreOptions): StoreHooks<S>;
+declare function createStoreHooks<S extends Record<string, unknown> = Record<string, unknown>>(name: string, options?: CreateStoreHooksOptions): StoreHooks<S>;
 
 interface UsePeersOptions {
     /** Bus name. Default 'use-everywhere'. */
@@ -337,11 +337,11 @@ declare function useLeaderEffect(effect: () => void | (() => void), options?: Us
  * which namespace it lives in.
  */
 interface ReactNamespace extends Namespace {
-    defineStore<S extends Record<string, unknown> = Record<string, unknown>>(name: string, options?: DefineStoreOptions): StoreHooks<S>;
+    createStoreHooks<S extends Record<string, unknown> = Record<string, unknown>>(name: string, options?: CreateStoreHooksOptions): StoreHooks<S>;
     defineChannel<M extends MessageMap>(name?: string, options?: ChannelOptions<M>): ChannelHooks<M>;
     getSharedStore(name?: string, scope?: UseSharedStateOptions['scope']): AnyStore;
     useSharedState<T>(key: string, initial: T, options?: UseSharedStateOptions): [T, (next: T | ((prev: T) => T)) => void];
-    useSharedStore<S extends Record<string, unknown>, T>(selector: (state: S) => T, options?: UseSharedSelectorOptions): T;
+    useSharedSelector<S extends Record<string, unknown>, T>(selector: (state: S) => T, options?: UseSharedSelectorOptions): T;
     usePeers(options?: UsePeersOptions): readonly Peer[];
     usePresenceMetadata(metadata: unknown, options?: UsePeersOptions): void;
     useHydrated(options?: UseSharedStateOptions): boolean;
@@ -364,7 +364,7 @@ interface ReactNamespace extends Namespace {
  * const [items, setItems] = checkout.useSharedState('items', []);
  * ```
  *
- * Call it **at module scope**, like `defineStore` and `defineChannel`. It
+ * Call it **at module scope**, like `createStoreHooks` and `defineChannel`. It
  * builds a small object of bound functions, and rebuilding that on every render
  * would hand React a new `useSharedState` identity each time — harmless for the
  * hooks themselves, which key off the bus name, but pointless work and a
@@ -418,7 +418,7 @@ interface OpenedWindowControls<Out extends MessageMap, In extends MessageMap, R>
     post: OpenedWindow<Out, In, R>['post'];
     close: () => void;
 }
-type UseOpenedWindow<Out extends MessageMap, In extends MessageMap, R> = OpenedWindowState<R> & OpenedWindowControls<Out, In, R>;
+type UseWindowResult<Out extends MessageMap, In extends MessageMap, R> = OpenedWindowState<R> & OpenedWindowControls<Out, In, R>;
 
 /**
  * Drive an openWindow() flow from a component: the factory is called on
@@ -429,6 +429,6 @@ type UseOpenedWindow<Out extends MessageMap, In extends MessageMap, R> = OpenedW
  * because a route changed would lose the user's in-flight transaction. Call
  * close() if the component owns the window's lifetime.
  */
-declare function useOpenedWindow<Out extends MessageMap, In extends MessageMap, R = unknown>(factory: () => OpenedWindow<Out, In, R>): UseOpenedWindow<Out, In, R>;
+declare function useWindowResult<Out extends MessageMap, In extends MessageMap, R = unknown>(factory: () => OpenedWindow<Out, In, R>): UseWindowResult<Out, In, R>;
 
-export { type AnyStore, type ChannelHooks, type DefineStoreOptions, type OpenedWindowControls, type OpenedWindowState, type OpenedWindowStatus, type ReactNamespace, type ShareScope, type StoreHooks, type UseLeaderOptions, type UseMessageOptions, type UseOpenedWindow, type UsePeersOptions, type UseSharedReducerOptions, type UseSharedSelectorOptions, type UseSharedStateOptions, createNamespace, defineChannel, defineStore, getLeader, getSharedStore, shallowEqual, useAnswer, useAsk, useChannel, useClientId, useHydrated, useIsLeader, useLeader, useLeaderEffect, useMessage, useOpenedWindow, usePeers, usePresenceMetadata, useSend, useSharedReducer, useSharedState, useSharedStore };
+export { type AnyStore, type ChannelHooks, type CreateStoreHooksOptions, type OpenedWindowControls, type OpenedWindowState, type OpenedWindowStatus, type ReactNamespace, type ShareScope, type StoreHooks, type UseLeaderOptions, type UseOnMessageOptions, type UsePeersOptions, type UseSharedReducerOptions, type UseSharedSelectorOptions, type UseSharedStateOptions, type UseWindowResult, createNamespace, createStoreHooks, defineChannel, getLeader, getSharedStore, shallowEqual, useAnswer, useAsk, useChannel, useClientId, useHydrated, useIsLeader, useLeader, useLeaderEffect, useOnMessage, usePeers, usePresenceMetadata, useSend, useSharedReducer, useSharedSelector, useSharedState, useWindowResult };

package/dist/index.d.ts

@@ -91,7 +91,7 @@ interface UseSharedSelectorOptions extends UseSharedStateOptions {
  * anything in it.
  *
  * ```tsx
- * const total = useSharedStore<Cart, number>(
+ * const total = useSharedSelector<Cart, number>(
  *   (cart) => cart.items.length + cart.saved.length,
  * );
  * ```
@@ -111,7 +111,7 @@ interface UseSharedSelectorOptions extends UseSharedStateOptions {
  * selector runs against `{}`, and its result is what the server-rendered markup
  * shows.
  */
-declare function useSharedStore<S extends Record<string, unknown>, T>(selector: (state: S) => T, options?: UseSharedSelectorOptions): T;
+declare function useSharedSelector<S extends Record<string, unknown>, T>(selector: (state: S) => T, options?: UseSharedSelectorOptions): T;
 /** Shallow equality over an object or array, for selectors that build one. */
 declare function shallowEqual(a: unknown, b: unknown): boolean;
 
@@ -130,7 +130,7 @@ declare function getLeader(name: string, options?: LeaderOptions): Leader;
 
 /** Get the page-wide typed channel for `name` (one instance per name). */
 declare function useChannel<M extends MessageMap, R extends ReplyMap<M> = Record<never, never>>(name: string): Channel<M, R>;
-interface UseMessageOptions {
+interface UseOnMessageOptions {
     /**
      * Subscribe at all. Default true.
      *
@@ -146,7 +146,7 @@ interface UseMessageOptions {
  * Subscribe to one message type. The handler is kept fresh without
  * resubscribing, so it may close over render state.
  */
-declare function useMessage<M extends MessageMap, R extends ReplyMap<M>, K extends keyof M & string>(channel: Channel<M, R>, type: K, handler: (payload: M[K], meta: MessageMeta) => void, options?: UseMessageOptions): void;
+declare function useOnMessage<M extends MessageMap, R extends ReplyMap<M>, K extends keyof M & string>(channel: Channel<M, R>, type: K, handler: (payload: M[K], meta: MessageMeta) => void, options?: UseOnMessageOptions): void;
 /**
  * Answer `ask`s of one type for as long as this component is mounted.
  *
@@ -173,14 +173,14 @@ interface ChannelHooks<M extends MessageMap> {
     useSend: () => Channel<M>['post'];
     /**
      * Subscribe to one message type. Same contract as the standalone
-     * `useMessage`: the handler is kept fresh without resubscribing.
+     * `useOnMessage`: the handler is kept fresh without resubscribing.
      */
-    useMessage: <K extends keyof M & string>(type: K, handler: (payload: M[K], meta: MessageMeta) => void) => void;
+    useOnMessage: <K extends keyof M & string>(type: K, handler: (payload: M[K], meta: MessageMeta) => void) => void;
 }
 
 /**
  * Bind a channel name and message map once, at module level, and get fully
- * typed hooks back. Sugar over useChannel/useMessage/useSend — the same
+ * typed hooks back. Sugar over useChannel/useOnMessage/useSend — the same
  * page-wide channel singleton is shared, so mixing bound and standalone
  * hooks for one name is safe.
  *
@@ -189,7 +189,7 @@ interface ChannelHooks<M extends MessageMap> {
  */
 declare function defineChannel<M extends MessageMap>(name: string, options?: ChannelOptions<M>): ChannelHooks<M>;
 
-interface DefineStoreOptions {
+interface CreateStoreHooksOptions {
     /** Restore this store from disk on first use, and write it back as it changes. */
     persist?: PersistAdapter;
     /** Persist only these keys. Default: every key that has been written. */
@@ -212,7 +212,7 @@ interface DefineStoreOptions {
 /** A store bound to a name and a shape: typed hooks with no per-call generics. */
 interface StoreHooks<S extends Record<string, unknown>> {
     /** The underlying store instance (the same one the hooks use) — for non-React code. */
-    get: () => AnyStore;
+    store: () => AnyStore;
     useSharedState: <K extends keyof S & string>(key: K, initial: S[K]) => [S[K], (next: S[K] | ((prev: S[K]) => S[K])) => void];
 }
 
@@ -222,7 +222,7 @@ interface StoreHooks<S extends Record<string, unknown>> {
  * Like defineChannel, this does not construct anything: it registers the
  * options the registry will use when the store is first needed, so importing
  * the module has no side effect. The store stays a singleton per name, so
- * `defineStore('settings', { persist })` and a bare
+ * `createStoreHooks('settings', { persist })` and a bare
  * `useSharedState('theme', 'dark', { store: 'settings' })` elsewhere resolve to
  * the same store, and both get persistence.
  *
@@ -230,7 +230,7 @@ interface StoreHooks<S extends Record<string, unknown>> {
  * so intended usage is automatic; if it does run late it throws rather than
  * quietly handing back a store with no persistence.
  */
-declare function defineStore<S extends Record<string, unknown> = Record<string, unknown>>(name: string, options?: DefineStoreOptions): StoreHooks<S>;
+declare function createStoreHooks<S extends Record<string, unknown> = Record<string, unknown>>(name: string, options?: CreateStoreHooksOptions): StoreHooks<S>;
 
 interface UsePeersOptions {
     /** Bus name. Default 'use-everywhere'. */
@@ -337,11 +337,11 @@ declare function useLeaderEffect(effect: () => void | (() => void), options?: Us
  * which namespace it lives in.
  */
 interface ReactNamespace extends Namespace {
-    defineStore<S extends Record<string, unknown> = Record<string, unknown>>(name: string, options?: DefineStoreOptions): StoreHooks<S>;
+    createStoreHooks<S extends Record<string, unknown> = Record<string, unknown>>(name: string, options?: CreateStoreHooksOptions): StoreHooks<S>;
     defineChannel<M extends MessageMap>(name?: string, options?: ChannelOptions<M>): ChannelHooks<M>;
     getSharedStore(name?: string, scope?: UseSharedStateOptions['scope']): AnyStore;
     useSharedState<T>(key: string, initial: T, options?: UseSharedStateOptions): [T, (next: T | ((prev: T) => T)) => void];
-    useSharedStore<S extends Record<string, unknown>, T>(selector: (state: S) => T, options?: UseSharedSelectorOptions): T;
+    useSharedSelector<S extends Record<string, unknown>, T>(selector: (state: S) => T, options?: UseSharedSelectorOptions): T;
     usePeers(options?: UsePeersOptions): readonly Peer[];
     usePresenceMetadata(metadata: unknown, options?: UsePeersOptions): void;
     useHydrated(options?: UseSharedStateOptions): boolean;
@@ -364,7 +364,7 @@ interface ReactNamespace extends Namespace {
  * const [items, setItems] = checkout.useSharedState('items', []);
  * ```
  *
- * Call it **at module scope**, like `defineStore` and `defineChannel`. It
+ * Call it **at module scope**, like `createStoreHooks` and `defineChannel`. It
  * builds a small object of bound functions, and rebuilding that on every render
  * would hand React a new `useSharedState` identity each time — harmless for the
  * hooks themselves, which key off the bus name, but pointless work and a
@@ -418,7 +418,7 @@ interface OpenedWindowControls<Out extends MessageMap, In extends MessageMap, R>
     post: OpenedWindow<Out, In, R>['post'];
     close: () => void;
 }
-type UseOpenedWindow<Out extends MessageMap, In extends MessageMap, R> = OpenedWindowState<R> & OpenedWindowControls<Out, In, R>;
+type UseWindowResult<Out extends MessageMap, In extends MessageMap, R> = OpenedWindowState<R> & OpenedWindowControls<Out, In, R>;
 
 /**
  * Drive an openWindow() flow from a component: the factory is called on
@@ -429,6 +429,6 @@ type UseOpenedWindow<Out extends MessageMap, In extends MessageMap, R> = OpenedW
  * because a route changed would lose the user's in-flight transaction. Call
  * close() if the component owns the window's lifetime.
  */
-declare function useOpenedWindow<Out extends MessageMap, In extends MessageMap, R = unknown>(factory: () => OpenedWindow<Out, In, R>): UseOpenedWindow<Out, In, R>;
+declare function useWindowResult<Out extends MessageMap, In extends MessageMap, R = unknown>(factory: () => OpenedWindow<Out, In, R>): UseWindowResult<Out, In, R>;
 
-export { type AnyStore, type ChannelHooks, type DefineStoreOptions, type OpenedWindowControls, type OpenedWindowState, type OpenedWindowStatus, type ReactNamespace, type ShareScope, type StoreHooks, type UseLeaderOptions, type UseMessageOptions, type UseOpenedWindow, type UsePeersOptions, type UseSharedReducerOptions, type UseSharedSelectorOptions, type UseSharedStateOptions, createNamespace, defineChannel, defineStore, getLeader, getSharedStore, shallowEqual, useAnswer, useAsk, useChannel, useClientId, useHydrated, useIsLeader, useLeader, useLeaderEffect, useMessage, useOpenedWindow, usePeers, usePresenceMetadata, useSend, useSharedReducer, useSharedState, useSharedStore };
+export { type AnyStore, type ChannelHooks, type CreateStoreHooksOptions, type OpenedWindowControls, type OpenedWindowState, type OpenedWindowStatus, type ReactNamespace, type ShareScope, type StoreHooks, type UseLeaderOptions, type UseOnMessageOptions, type UsePeersOptions, type UseSharedReducerOptions, type UseSharedSelectorOptions, type UseSharedStateOptions, type UseWindowResult, createNamespace, createStoreHooks, defineChannel, getLeader, getSharedStore, shallowEqual, useAnswer, useAsk, useChannel, useClientId, useHydrated, useIsLeader, useLeader, useLeaderEffect, useOnMessage, usePeers, usePresenceMetadata, useSend, useSharedReducer, useSharedSelector, useSharedState, useWindowResult };

package/dist/index.js

@@ -12,7 +12,7 @@ import {
   usePeers,
   usePresenceMetadata,
   warnOnInitialMismatch
-} from "./chunk-R7PBPLF7.js";
+} from "./chunk-YPQ6PLD5.js";
 
 // src/use-shared-state.ts
 import { useCallback, useSyncExternalStore } from "react";
@@ -55,7 +55,7 @@ function useSharedReducer(reducer, initial, options) {
 
 // src/use-shared-selector.ts
 import { useCallback as useCallback3, useRef, useSyncExternalStore as useSyncExternalStore3 } from "react";
-function useSharedStore(selector, options) {
+function useSharedSelector(selector, options) {
   const store = getStore(options?.store ?? DEFAULT_NAME, options?.scope ?? "everywhere");
   const equal = options?.equal ?? Object.is;
   const selectorRef = useRef(selector);
@@ -89,12 +89,12 @@ function shallowEqual(a, b) {
   return keys.every((key) => Object.is(left[key], right[key]));
 }
 
-// src/use-message.ts
+// src/use-on-message.ts
 import { useEffect, useRef as useRef2 } from "react";
 function useChannel(name) {
   return getChannel(name);
 }
-function useMessage(channel, type, handler, options) {
+function useOnMessage(channel, type, handler, options) {
   const handlerRef = useRef2(handler);
   useEffect(() => {
     handlerRef.current = handler;
@@ -128,16 +128,16 @@ function useAsk(channel) {
 function defineChannel(name, options) {
   if (options) configureChannel(name, options);
   const useBoundSend = () => useSend(useChannel(name));
-  const useBoundMessage = (type, handler) => useMessage(useChannel(name), type, handler);
+  const useBoundMessage = (type, handler) => useOnMessage(useChannel(name), type, handler);
   return {
     get: () => getChannel(name),
     useSend: useBoundSend,
-    useMessage: useBoundMessage
+    useOnMessage: useBoundMessage
   };
 }
 
-// src/define-store.ts
-function defineStore(name, options = {}) {
+// src/create-store-hooks.ts
+function createStoreHooks(name, options = {}) {
   const scope = options.scope ?? "everywhere";
   if (options.persist) {
     configureStore(name, scope, {
@@ -152,7 +152,7 @@ function defineStore(name, options = {}) {
     });
   }
   return {
-    get: () => getStore(name, scope),
+    store: () => getStore(name, scope),
     useSharedState: (key, initial) => useSharedState(key, initial, { store: name, scope })
   };
 }
@@ -214,11 +214,11 @@ function createNamespace(namespace) {
   const { busName } = core;
   return {
     ...core,
-    defineStore: (name, options) => defineStore(busName(name), options),
+    createStoreHooks: (name, options) => createStoreHooks(busName(name), options),
     defineChannel: (name, options) => defineChannel(busName(name), options),
     getSharedStore: (name, scope) => getSharedStore(busName(name), scope),
     useSharedState: (key, initial, options) => useSharedState(key, initial, { ...options, store: busName(options?.store) }),
-    useSharedStore: (selector, options) => useSharedStore(selector, { ...options, store: busName(options?.store) }),
+    useSharedSelector: (selector, options) => useSharedSelector(selector, { ...options, store: busName(options?.store) }),
     usePeers: (options) => usePeers({ ...options, name: busName(options?.name) }),
     usePresenceMetadata: (metadata, options) => usePresenceMetadata(metadata, { ...options, name: busName(options?.name) }),
     useHydrated: (options) => useHydrated({ ...options, store: busName(options?.store) }),
@@ -229,7 +229,7 @@ function createNamespace(namespace) {
   };
 }
 
-// src/use-opened-window.ts
+// src/use-window-result.ts
 import { useCallback as useCallback5, useEffect as useEffect4, useRef as useRef4, useState as useState2 } from "react";
 import { WindowClosedError } from "@use-everywhere/core";
 var IDLE = Object.freeze({
@@ -237,7 +237,7 @@ var IDLE = Object.freeze({
   result: void 0,
   error: void 0
 });
-function useOpenedWindow(factory) {
+function useWindowResult(factory) {
   const [state, setState] = useState2(IDLE);
   const current = useRef4(null);
   const factoryRef = useRef4(factory);
@@ -336,9 +336,9 @@ export {
   createPresence,
   createSharedReducer,
   createSharedStore,
+  createStoreHooks,
   defaultTransport,
   defineChannel,
-  defineStore,
   enableDebug,
   getBusNames,
   getLeader,
@@ -364,13 +364,13 @@ export {
   useIsLeader,
   useLeader,
   useLeaderEffect,
-  useMessage,
-  useOpenedWindow,
+  useOnMessage,
   usePeers,
   usePresenceMetadata,
   useSend,
   useSharedReducer,
+  useSharedSelector,
   useSharedState,
-  useSharedStore,
+  useWindowResult,
   webStorageAdapter
 };

package/llms.txt

@@ -31,7 +31,7 @@ Open it in two tabs. Clicking in one updates both.
 
 ## The three mistakes to avoid
 
-**1. Calling `defineChannel` or `defineStore` inside a component.** They are
+**1. Calling `defineChannel` or `createStoreHooks` inside a component.** They are
 module-scope factories. Called in a render they build a new bus on every
 render, and the page syncs nothing while looking completely correct. Install
 `eslint-plugin-use-everywhere` — this is the mistake its `define-at-module-scope`
@@ -65,9 +65,9 @@ and symbols do not survive. Dates, Maps, Sets and typed arrays do. The
 | --- | --- | --- |
 | `useSharedState` | hook | "What is the current value?" — `useState` across every tab |
 | `useSharedReducer` | hook | The same, dispatch-shaped |
-| `useSharedStore` | hook | Subscribe to a slice of a store with a selector |
+| `useSharedSelector` | hook | Subscribe to a slice of a store with a selector |
 | `useChannel` | hook | The typed event channel for a name |
-| `useMessage` | hook | Run a handler when another tab posts an event |
+| `useOnMessage` | hook | Run a handler when another tab posts an event |
 | `useSend` | hook | A stable, typed `post` for a channel |
 | `useAsk` | hook | Request/response across tabs |
 | `useAnswer` | hook | Serve the other half of `useAsk` |
@@ -77,10 +77,10 @@ and symbols do not survive. Dates, Maps, Sets and typed arrays do. The
 | `useLeader` | hook | Elect exactly one tab to own a job |
 | `useIsLeader` | hook | Whether this tab currently holds the lease |
 | `useLeaderEffect` | hook | Run an effect only in the leader tab |
-| `useOpenedWindow` | hook | The cross-origin window lifecycle as render state |
+| `useWindowResult` | hook | The cross-origin window lifecycle as render state |
 | `useHydrated` | hook | Whether the first cross-tab sync has landed (SSR) |
 | `defineChannel` | factory | Bind a channel name + message map once, at module scope |
-| `defineStore` | factory | The same for a store, and where persistence is enabled |
+| `createStoreHooks` | factory | The same for a store, and where persistence is enabled |
 | `createNamespace` | factory | Prefix every bus name, for micro-frontends |
 | `Inspector` | component | Devtools panel; import from `use-everywhere/devtools` |
 
@@ -91,7 +91,7 @@ in `@use-everywhere/core` is re-exported from here too — see that package's
 ## Gotchas
 
 - **Shared state never crosses origins.** Two origins are two trust domains. For
-  that, open a window explicitly with `useOpenedWindow`, which is typed,
+  that, open a window explicitly with `useWindowResult`, which is typed,
   per-message and validated by origin.
 - **Last-writer-wins, per key.** Per-key `[counter, clientId]` clocks give a
   deterministic tie-break, not a merge. Two tabs editing the same key

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "use-everywhere",
-  "version": "0.12.0",
+  "version": "1.0.0",
   "description": "React hooks for state and messages shared across tabs, windows, and workers",
   "license": "MIT",
   "author": "Jonatan Kruszewski <jonakrusze@gmail.com>",
@@ -109,9 +109,9 @@
       "limit": "4.24 kB"
     },
     {
-      "name": "useSharedStore (selector)",
+      "name": "useSharedSelector",
       "path": "dist/index.js",
-      "import": "{ useSharedStore, shallowEqual }",
+      "import": "{ useSharedSelector, shallowEqual }",
       "limit": "4.40 kB"
     },
     {
@@ -121,9 +121,9 @@
       "limit": "4.21 kB"
     },
     {
-      "name": "useChannel + useMessage + useSend",
+      "name": "useChannel + useOnMessage + useSend",
       "path": "dist/index.js",
-      "import": "{ useChannel, useMessage, useSend }",
+      "import": "{ useChannel, useOnMessage, useSend }",
       "limit": "3.07 kB"
     },
     {
@@ -133,9 +133,9 @@
       "limit": "2.77 kB"
     },
     {
-      "name": "useOpenedWindow + openWindow",
+      "name": "useWindowResult + openWindow",
       "path": "dist/index.js",
-      "import": "{ useOpenedWindow, openWindow }",
+      "import": "{ useWindowResult, openWindow }",
       "limit": "1.47 kB"
     },
     {
@@ -145,9 +145,9 @@
       "limit": "3.65 kB"
     },
     {
-      "name": "defineStore (persisted)",
+      "name": "createStoreHooks (persisted)",
       "path": "dist/index.js",
-      "import": "{ defineStore, localStorageAdapter }",
+      "import": "{ createStoreHooks, localStorageAdapter }",
       "limit": "4.67 kB"
     },
     {
@@ -170,7 +170,7 @@
     }
   ],
   "dependencies": {
-    "@use-everywhere/core": "0.11.2"
+    "@use-everywhere/core": "1.0.0"
   },
   "peerDependencies": {
     "react": ">=18",
@@ -187,7 +187,7 @@
     "@testing-library/react": "^16.3.2",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
-    "@vitest/coverage-v8": "^4.1.10",
+    "@vitest/coverage-v8": "^4.1.11",
     "happy-dom": "^20.11.15",
     "publint": "^0.3.24",
     "react": "^19.2.8",
@@ -195,7 +195,7 @@
     "size-limit": "^13.0.3",
     "tsup": "^8.5.1",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.10"
+    "vitest": "^4.1.11"
   },
   "typesVersions": {
     "*": {