@automerge/automerge-repo-react-hooks 1.1.4 → 1.1.8

package/README.md

@@ -2,81 +2,23 @@
 
 These hooks are provided as helpers for using Automerge in your React project.
 
-#### [useBootstrap](./src/useBootstrap.ts)
-This hook is used to load a document based on the URL hash, for example `//myapp/#documentId=[document ID]`.
-It can also load the document ID from localStorage, or create a new document if none is specified.
-
 #### [useLocalAwareness](./src/useLocalAwareness.ts) & [useRemoteAwareness](./src/useRemoteAwareness.ts)
+
 These hooks implement ephemeral awareness/presence, similar to [Yjs Awareness](https://docs.yjs.dev/getting-started/adding-awareness).
-They allow temporary state to be shared, such as cursor positions or peer online/offline status. 
+They allow temporary state to be shared, such as cursor positions or peer online/offline status.
 
 Ephemeral messages are replicated between peers, but not saved to the Automerge doc, and are used for temporary updates that will be discarded.
 
 #### [useRepo/RepoContext](./src/useRepo.ts)
+
 Use RepoContext to set up react context for an Automerge repo.
 Use useRepo to lookup the repo from context.
 Most hooks depend on RepoContext being available.
 
-#### [useDocument](./src/useDocument.ts)
+#### [useDocument](useDocument.ts)
+
 Return a document & updater fn, by ID.
 
 #### [useHandle](./src/useHandle.ts)
-Return a handle, by ID.
-
-## Example usage
-
-### App Setup
-
-```ts
-import React, { StrictMode } from "react"
-import ReactDOM from "react-dom/client"
-
-import { Repo, DocCollection } from "@automerge/automerge-repo"
 
-import { BroadcastChannelNetworkAdapter } from "@automerge/automerge-repo-network-broadcastchannel"
-
-import App, { RootDocument } from "./App.js"
-import { RepoContext } from "@automerge/automerge-repo-react-hooks"
-
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-const sharedWorker = new SharedWorker(
-  new URL("./shared-worker.js", import.meta.url),
-  { type: "module", name: "@automerge/automerge-repo-shared-worker" }
-)
-
-async function getRepo(): Promise<DocCollection> {
-  return await Repo({
-    network: [
-      new BroadcastChannelNetworkAdapter(),
-    ],
-    sharePolicy: peerId => peerId.includes("shared-worker"),
-  })
-}
-
-const initFunction = (d: RootDocument) => {
-  d.items = []
-}
-
-const queryString = window.location.search // Returns:'?q=123'
-
-// Further parsing:
-const params = new URLSearchParams(queryString)
-const hostname = params.get("host") || "automerge-storage-demo.glitch.me"
-
-getRepo().then(repo => {
-  useBootstrap(repo, initFunction).then(rootDoc => {
-    const rootElem = document.getElementById("root")
-    if (!rootElem) {
-      throw new Error("The 'root' element wasn't found in the host HTML doc.")
-    }
-    const root = ReactDOM.createRoot(rootElem)
-    root.render(
-      <StrictMode>
-        <RepoContext.Provider value={repo}>
-          <App rootDocumentId={rootDoc.documentId} />
-        </RepoContext.Provider>
-      </StrictMode>
-    )
-  })
-})
-```
+Return a handle, by ID.

package/dist/index.d.ts

@@ -5,90 +5,29 @@
  *
  * These hooks are provided as helpers for using Automerge in your React project.
  *
- * #### {@link useBootstrap}
- * This hook is used to load a document based on the URL hash, for example `//myapp/#documentId=[document ID]`.
- * It can also load the document ID from localStorage, or create a new document if none is specified.
- *
- * #### {@link useLocalAwareness} & {@link useRemoteAwareness}
- * These hooks implement ephemeral awareness/presence, similar to [Yjs Awareness](https://docs.yjs.dev/getting-started/adding-awareness).
- * They allow temporary state to be shared, such as cursor positions or peer online/offline status.
- *
- * Ephemeral messages are replicated between peers, but not saved to the Automerge doc, and are used for temporary updates that will be discarded.
- *
  * #### {@link useRepo}/{@link RepoContext}
  * Use RepoContext to set up react context for an Automerge repo.
  * Use useRepo to lookup the repo from context.
  * Most hooks depend on RepoContext being available.
  *
- * #### {@link useDocument }
- * Return a document & updater fn, by ID.
- *
- * #### {@link useHandle }
- * Return a handle, by ID.
- *
- * ## Example usage
- *
- * ### App Setup
+ * #### {@link useDocument}
+ * Return the current state of a document (or undefined) and a change function.
  *
- * ```ts
- * import React, { StrictMode } from "react"
- * import ReactDOM from "react-dom/client"
+ * #### {@link useHandle}
+ * Return a DocHandle by passing in a DocumentURL.
  *
- * import { Repo, DocCollection } from "@automerge/automerge-repo"
- *
- * import { BroadcastChannelNetworkAdapter } from "@automerge/automerge-repo-network-broadcastchannel"
- *
- * import App, { RootDocument } from "./App.js"
- * import { RepoContext } from "@automerge/automerge-repo-react-hooks"
- *
- * // eslint-disable-next-line @typescript-eslint/no-unused-vars
- * const sharedWorker = new SharedWorker(
- *   new URL("./shared-worker.js", import.meta.url),
- *   { type: "module", name: "@automerge/automerge-repo-shared-worker" }
- * )
- *
- * async function getRepo(): Promise<DocCollection> {
- *   return await Repo({
- *     network: [
- *       new BroadcastChannelNetworkAdapter(),
- *     ],
- *     sharePolicy: peerId => peerId.includes("shared-worker"),
- *   })
- * }
- *
- * const initFunction = (d: RootDocument) => {
- *   d.items = []
- * }
- *
- * const queryString = window.location.search // Returns:'?q=123'
+ * #### {@link useLocalAwareness} & {@link useRemoteAwareness}
+ * These hooks implement ephemeral awareness/presence, similar to [Yjs Awareness](https://docs.yjs.dev/getting-started/adding-awareness).
+ * They allow temporary state to be shared, such as cursor positions or peer online/offline status.
  *
- * // Further parsing:
- * const params = new URLSearchParams(queryString)
- * const hostname = params.get("host") || "automerge-storage-demo.glitch.me"
+ * Ephemeral messages are replicated between peers, but not saved to the Automerge doc, and are used for temporary updates that will be discarded.
  *
- * getRepo().then(repo => {
- *   useBootstrap(repo, initFunction).then(rootDoc => {
- *     const rootElem = document.getElementById("root")
- *     if (!rootElem) {
- *       throw new Error("The 'root' element wasn't found in the host HTML doc.")
- *     }
- *     const root = ReactDOM.createRoot(rootElem)
- *     root.render(
- *       <StrictMode>
- *         <RepoContext.Provider value={repo}>
- *           <App rootDocumentId={rootDoc.documentId} />
- *         </RepoContext.Provider>
- *       </StrictMode>
- *     )
- *   })
- * })
- * ```
  */
-export { useDocument } from "./useDocument.js";
-export { useDocuments } from "./useDocuments.js";
-export { useBootstrap, type UseBootstrapOptions } from "./useBootstrap.js";
-export { useHandle } from "./useHandle.js";
-export { RepoContext, useRepo } from "./useRepo.js";
-export { useLocalAwareness, type UseLocalAwarenessProps, } from "./useLocalAwareness.js";
-export { useRemoteAwareness, type PeerStates, type Heartbeats, type UseRemoteAwarenessProps, } from "./useRemoteAwareness.js";
+export { useDocument } from './useDocument.js';
+export { useDocuments } from './useDocuments.js';
+export { useBootstrap, type UseBootstrapOptions } from './useBootstrap.js';
+export { useHandle } from './useHandle.js';
+export { RepoContext, useRepo } from './useRepo.js';
+export { useLocalAwareness, type UseLocalAwarenessProps, } from './useLocalAwareness.js';
+export { useRemoteAwareness, type PeerStates, type Heartbeats, type UseRemoteAwarenessProps, } from './useRemoteAwareness.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqFG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACnD,OAAO,EACL,iBAAiB,EACjB,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAA;AAC/B,OAAO,EACL,kBAAkB,EAClB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAA"}