@microsoft/live-share-react 1.0.0-preview.8 → 1.0.1-preview.1

package/bin/shared-hooks/useDynamicDDS.js

@@ -1,68 +1,68 @@
-/*!
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-import React from "react";
-import { useFluidObjectsContext } from "../providers";
-/**
- * Hook to gets or creates a DDS that corresponds to a given uniqueKey string.
- * @template T Type of Fluid LoadableObjectClass type to load. Must conform to IFluidLoadable interface.
- * @param uniqueKey uniqueKey value for the data object
- * @param loadableObjectClass Fluid LoadableObjectClass<T> to create/load.
- * @param onFirstInitialize Optional. Callback function for when the DDS is first loaded
- * @returns the DDS object, which is of type T when loaded and undefined while loading
- */
-export function useDynamicDDS(uniqueKey, loadableObjectClass, onFirstInitialize) {
-    const [dds, setDDS] = React.useState();
-    const [error, setError] = React.useState();
-    /**
-     * Import container and DDS object register callbacks from AzureProvider.
-     */
-    const { container, clientRef, } = useFluidObjectsContext();
-    /**
-     * Once container is available, this effect will register the setter method so that the DDS loaded
-     * from `dynamicObjects` that matches `uniqueKey` can be passed back to this hook. If one does not yet exist,
-     * a new DDS is automatically created. If multiple users try to create a DDS at the same time when this component first
-     * mounts, `live-share-turbo` ensures it will ultimately self correct using last-writer wins.
-     */
-    React.useEffect(() => {
-        if (container === undefined)
-            return;
-        let mounted = true;
-        // Callback method to set the `initialData` into the map when the DDS is first created.
-        const onGetDDS = () => __awaiter(this, void 0, void 0, function* () {
-            try {
-                const dds = yield clientRef.current.getDDS(uniqueKey, loadableObjectClass, onFirstInitialize);
-                if (mounted) {
-                    setDDS(dds);
-                }
-            }
-            catch (error) {
-                if (error instanceof Error) {
-                    setError(error);
-                }
-                else {
-                    setError(new Error("useDynamicDDS: an unknown error occurred while getting the DDS"));
-                }
-            }
-        });
-        onGetDDS();
-        return () => {
-            mounted = false;
-        };
-    }, [container, uniqueKey, onFirstInitialize]);
-    return {
-        dds,
-        error,
-    };
-}
+/*!
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the Microsoft Live Share SDK License.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import React from "react";
+import { useFluidObjectsContext } from "../providers";
+/**
+ * Hook to gets or creates a DDS that corresponds to a given uniqueKey string.
+ * @template T Type of Fluid LoadableObjectClass type to load. Must conform to IFluidLoadable interface.
+ * @param uniqueKey uniqueKey value for the data object
+ * @param loadableObjectClass Fluid LoadableObjectClass<T> to create/load.
+ * @param onFirstInitialize Optional. Callback function for when the DDS is first loaded
+ * @returns the DDS object, which is of type T when loaded and undefined while loading
+ */
+export function useDynamicDDS(uniqueKey, loadableObjectClass, onFirstInitialize) {
+    const [dds, setDDS] = React.useState();
+    const [error, setError] = React.useState();
+    /**
+     * Import container and DDS object register callbacks from AzureProvider.
+     */
+    const { container, clientRef } = useFluidObjectsContext();
+    /**
+     * Once container is available, this effect will register the setter method so that the DDS loaded
+     * from `dynamicObjects` that matches `uniqueKey` can be passed back to this hook. If one does not yet exist,
+     * a new DDS is automatically created. If multiple users try to create a DDS at the same time when this component first
+     * mounts, `live-share-turbo` ensures it will ultimately self correct using last-writer wins.
+     */
+    React.useEffect(() => {
+        if (container === undefined)
+            return;
+        let mounted = true;
+        // Callback method to set the `initialData` into the map when the DDS is first created.
+        const onGetDDS = () => __awaiter(this, void 0, void 0, function* () {
+            try {
+                const dds = yield clientRef.current.getDDS(uniqueKey, loadableObjectClass, onFirstInitialize);
+                if (mounted) {
+                    setDDS(dds);
+                }
+            }
+            catch (error) {
+                if (error instanceof Error) {
+                    setError(error);
+                }
+                else {
+                    setError(new Error("useDynamicDDS: an unknown error occurred while getting the DDS"));
+                }
+            }
+        });
+        onGetDDS();
+        return () => {
+            mounted = false;
+        };
+    }, [container, uniqueKey, onFirstInitialize]);
+    return {
+        dds,
+        error,
+    };
+}
 //# sourceMappingURL=useDynamicDDS.js.map

package/bin/shared-hooks/useDynamicDDS.js.map

@@ -1 +1 @@
-{"version":3,"file":"useDynamicDDS.js","sourceRoot":"","sources":["../../src/shared-hooks/useDynamicDDS.ts"],"names":[],"mappings":"AAAA;;;GAGG;;;;;;;;;;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGtD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CACzB,SAAiB,EACjB,mBAA2C,EAC3C,iBAAoC;IAKpC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAK,CAAC;IAC1C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAS,CAAC;IAClD;;OAEG;IACH,MAAM,EACF,SAAS,EACT,SAAS,GACZ,GAAG,sBAAsB,EAAE,CAAC;IAE7B;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACjB,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO;QACpC,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,uFAAuF;QACvF,MAAM,QAAQ,GAAG,GAAS,EAAE;YACxB,IAAI;gBACA,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,CAAI,SAAS,EAAE,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;gBACjG,IAAI,OAAO,EAAE;oBACT,MAAM,CAAC,GAAG,CAAC,CAAC;iBACf;aACJ;YAAC,OAAO,KAAc,EAAE;gBACrB,IAAI,KAAK,YAAY,KAAK,EAAE;oBACxB,QAAQ,CAAC,KAAK,CAAC,CAAC;iBACnB;qBAAM;oBACH,QAAQ,CAAC,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC,CAAC;iBACzF;aACJ;QACL,CAAC,CAAA,CAAC;QACF,QAAQ,EAAE,CAAC;QACX,OAAO,GAAG,EAAE;YACR,OAAO,GAAG,KAAK,CAAC;QACpB,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAE9C,OAAO;QACH,GAAG;QACH,KAAK;KACR,CAAC;AACN,CAAC"}
+{"version":3,"file":"useDynamicDDS.js","sourceRoot":"","sources":["../../src/shared-hooks/useDynamicDDS.ts"],"names":[],"mappings":"AAAA;;;GAGG;;;;;;;;;;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGtD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAGzB,SAAiB,EACjB,mBAA2C,EAC3C,iBAAoC;IAKpC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAK,CAAC;IAC1C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,QAAQ,EAAS,CAAC;IAClD;;OAEG;IACH,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,sBAAsB,EAAE,CAAC;IAE1D;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACjB,IAAI,SAAS,KAAK,SAAS;YAAE,OAAO;QACpC,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,uFAAuF;QACvF,MAAM,QAAQ,GAAG,GAAS,EAAE;YACxB,IAAI;gBACA,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,MAAM,CACtC,SAAS,EACT,mBAAmB,EACnB,iBAAiB,CACpB,CAAC;gBACF,IAAI,OAAO,EAAE;oBACT,MAAM,CAAC,GAAG,CAAC,CAAC;iBACf;aACJ;YAAC,OAAO,KAAc,EAAE;gBACrB,IAAI,KAAK,YAAY,KAAK,EAAE;oBACxB,QAAQ,CAAC,KAAK,CAAC,CAAC;iBACnB;qBAAM;oBACH,QAAQ,CACJ,IAAI,KAAK,CACL,gEAAgE,CACnE,CACJ,CAAC;iBACL;aACJ;QACL,CAAC,CAAA,CAAC;QACF,QAAQ,EAAE,CAAC;QACX,OAAO,GAAG,EAAE;YACR,OAAO,GAAG,KAAK,CAAC;QACpB,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAE9C,OAAO;QACH,GAAG;QACH,KAAK;KACR,CAAC;AACN,CAAC"}

package/bin/shared-hooks/useSharedMap.d.ts

@@ -1,22 +1,22 @@
-/*!
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-import { IUseSharedMapResults, SharedMapInitialData } from "../types";
-/**
- * React hook for using a Fluid `SharedMap`.
- *
- * @remarks
- * The primary benefit of using the `useSharedMap` hook rather than the Fluid `SharedMap`
- * directly is that it integrates nicely with React state and automates repetitive tasks.
- * If you want to use `SharedMap` this hook creates directly, you can do that as well.
- *
- * @template TData Optional typing for objects stored in the SharedMap. Default is `object` type.
- * @param uniqueKey the unique key for the `SharedMap`. If one does not yet exist, a new `SharedMap`
- * will be created, otherwise it will use the existing one.
- * @param initialData a JS Map, entries array, or JSON object to insert into the `SharedMap` when creating
- * the DDS for the first time.
- * @returns stateful `map` entries, `setEntry` callback, `deleteEntry` callback, and the Fluid `sharedMap`.
- */
-export declare function useSharedMap<TData extends object = object>(uniqueKey: string, initialData?: SharedMapInitialData<TData>): IUseSharedMapResults<TData>;
+/*!
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the Microsoft Live Share SDK License.
+ */
+import { IUseSharedMapResults, SharedMapInitialData } from "../types";
+/**
+ * React hook for using a Fluid `SharedMap`.
+ *
+ * @remarks
+ * The primary benefit of using the `useSharedMap` hook rather than the Fluid `SharedMap`
+ * directly is that it integrates nicely with React state and automates repetitive tasks.
+ * If you want to use `SharedMap` this hook creates directly, you can do that as well.
+ *
+ * @template TData Optional typing for objects stored in the SharedMap. Default is `any` type.
+ * @param uniqueKey the unique key for the `SharedMap`. If one does not yet exist, a new `SharedMap`
+ * will be created, otherwise it will use the existing one.
+ * @param initialData a JS Map, entries array, or JSON object to insert into the `SharedMap` when creating
+ * the DDS for the first time.
+ * @returns stateful `map` entries, `setEntry` callback, `deleteEntry` callback, and the Fluid `sharedMap`.
+ */
+export declare function useSharedMap<TData = any>(uniqueKey: string, initialData?: SharedMapInitialData<TData>): IUseSharedMapResults<TData>;
 //# sourceMappingURL=useSharedMap.d.ts.map

package/bin/shared-hooks/useSharedMap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSharedMap.d.ts","sourceRoot":"","sources":["../../src/shared-hooks/useSharedMap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAItE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,KAAK,SAAS,MAAM,GAAG,MAAM,EACtD,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,oBAAoB,CAAC,KAAK,CAAC,GAC1C,oBAAoB,CAAC,KAAK,CAAC,CA8E7B"}
+{"version":3,"file":"useSharedMap.d.ts","sourceRoot":"","sources":["../../src/shared-hooks/useSharedMap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAStE;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAAC,KAAK,GAAG,GAAG,EACpC,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,oBAAoB,CAAC,KAAK,CAAC,GAC1C,oBAAoB,CAAC,KAAK,CAAC,CAmG7B"}

package/bin/shared-hooks/useSharedMap.js

@@ -1,106 +1,113 @@
-/*!
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-import React from "react";
-import { isEntries, isJSON, isMap } from "../utils";
-import { useDynamicDDS } from "./useDynamicDDS";
-import { SharedMap } from "fluid-framework";
-/**
- * React hook for using a Fluid `SharedMap`.
- *
- * @remarks
- * The primary benefit of using the `useSharedMap` hook rather than the Fluid `SharedMap`
- * directly is that it integrates nicely with React state and automates repetitive tasks.
- * If you want to use `SharedMap` this hook creates directly, you can do that as well.
- *
- * @template TData Optional typing for objects stored in the SharedMap. Default is `object` type.
- * @param uniqueKey the unique key for the `SharedMap`. If one does not yet exist, a new `SharedMap`
- * will be created, otherwise it will use the existing one.
- * @param initialData a JS Map, entries array, or JSON object to insert into the `SharedMap` when creating
- * the DDS for the first time.
- * @returns stateful `map` entries, `setEntry` callback, `deleteEntry` callback, and the Fluid `sharedMap`.
- */
-export function useSharedMap(uniqueKey, initialData) {
-    /**
-     * Stateful readonly map (user facing) with most recent values from `SharedMap` and its setter method.
-     */
-    const [map, setMap] = React.useState(getInitialData(initialData));
-    const onFirstInitialize = React.useCallback((newDDS) => {
-        /**
-         * Callback method to set the `initialData` into the map when the `SharedMap` is first created.
-         * Only should be used as a prop to useDynamicDDS.
-         */
-        getInitialData(initialData).forEach((value, key) => {
-            newDDS.set(key, value);
-        });
-    }, [initialData]);
-    /**
-     * User facing: dynamically load the SharedMap DDS for the given unique key.
-     */
-    const { dds: sharedMap } = useDynamicDDS(uniqueKey, SharedMap, onFirstInitialize);
-    /**
-     * User facing: set a value to the Fluid `SharedMap`.
-     */
-    const setEntry = React.useCallback((key, value) => {
-        if (!sharedMap) {
-            console.error(new Error("Cannot call set when sharedMap is undefined"));
-            return;
-        }
-        sharedMap.set(key, value);
-    }, [sharedMap]);
-    /**
-     * User facing: delete a value from the Fluid `SharedMap`.
-     */
-    const deleteEntry = React.useCallback((key) => {
-        if (!sharedMap) {
-            console.error(new Error("Cannot call remove when sharedMap is undefined"));
-            return;
-        }
-        sharedMap.delete(key);
-    }, [sharedMap]);
-    // Setup change listeners, initial values, etc.
-    React.useEffect(() => {
-        if (!sharedMap)
-            return;
-        // Register valueChanged listener for `SharedMap`.
-        const onValueChanged = () => {
-            setMap(new Map(sharedMap.entries()));
-        };
-        sharedMap.on("valueChanged", onValueChanged);
-        // Get initial values from `SharedMap`.
-        onValueChanged();
-        return () => {
-            // Cleanup on component unmount.
-            sharedMap === null || sharedMap === void 0 ? void 0 : sharedMap.off("valueChanged", onValueChanged);
-        };
-    }, [sharedMap]);
-    return {
-        map,
-        setEntry,
-        deleteEntry,
-        sharedMap,
-    };
-}
-/**
- * Helper method for converting different initial data props into a Map<string, TData> to insert into the Fluid SharedMap
- * @template TData Optional typing for objects stored in the SharedMap. Default is `object` type.
- * @param initialData a JS Map, entries array, or JSON object.
- * @returns A Map<string, TData> with the entries provided.
- */
-function getInitialData(initialData) {
-    if (isMap(initialData)) {
-        return initialData;
-    }
-    else if (isEntries(initialData)) {
-        return new Map(initialData);
-    }
-    else if (isJSON(initialData)) {
-        const values = Object.keys(initialData).map((key) => {
-            return [key, initialData[key]];
-        });
-        return new Map(values);
-    }
-    return new Map();
-}
+/*!
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the Microsoft Live Share SDK License.
+ */
+import React from "react";
+import { isEntries, isJSON, isMap } from "../utils";
+import { useDynamicDDS } from "./useDynamicDDS";
+import { SharedMap } from "fluid-framework";
+import { useFluidObjectsContext } from "../providers";
+import { ActionContainerNotJoinedError, ActionLiveDataObjectUndefinedError, } from "../internal";
+/**
+ * React hook for using a Fluid `SharedMap`.
+ *
+ * @remarks
+ * The primary benefit of using the `useSharedMap` hook rather than the Fluid `SharedMap`
+ * directly is that it integrates nicely with React state and automates repetitive tasks.
+ * If you want to use `SharedMap` this hook creates directly, you can do that as well.
+ *
+ * @template TData Optional typing for objects stored in the SharedMap. Default is `any` type.
+ * @param uniqueKey the unique key for the `SharedMap`. If one does not yet exist, a new `SharedMap`
+ * will be created, otherwise it will use the existing one.
+ * @param initialData a JS Map, entries array, or JSON object to insert into the `SharedMap` when creating
+ * the DDS for the first time.
+ * @returns stateful `map` entries, `setEntry` callback, `deleteEntry` callback, and the Fluid `sharedMap`.
+ */
+export function useSharedMap(uniqueKey, initialData) {
+    /**
+     * Stateful readonly map (user facing) with most recent values from `SharedMap` and its setter method.
+     */
+    const [map, setMap] = React.useState(getInitialData(initialData));
+    const onFirstInitialize = React.useCallback((newDDS) => {
+        /**
+         * Callback method to set the `initialData` into the map when the `SharedMap` is first created.
+         * Only should be used as a prop to useDynamicDDS.
+         */
+        getInitialData(initialData).forEach((value, key) => {
+            newDDS.set(key, value);
+        });
+    }, [initialData]);
+    /**
+     * User facing: dynamically load the SharedMap DDS for the given unique key.
+     */
+    const { dds: sharedMap } = useDynamicDDS(uniqueKey, SharedMap, onFirstInitialize);
+    const { container } = useFluidObjectsContext();
+    /**
+     * User facing: set a value to the Fluid `SharedMap`.
+     */
+    const setEntry = React.useCallback((key, value) => {
+        if (!container) {
+            throw new ActionContainerNotJoinedError("sharedMap", "setEntry");
+        }
+        if (sharedMap === undefined) {
+            throw new ActionLiveDataObjectUndefinedError("sharedMap", "setEntry");
+        }
+        sharedMap.set(key, value);
+    }, [container, sharedMap]);
+    /**
+     * User facing: delete a value from the Fluid `SharedMap`.
+     */
+    const deleteEntry = React.useCallback((key) => {
+        if (!container) {
+            throw new ActionContainerNotJoinedError("sharedMap", "deleteEntry");
+        }
+        if (sharedMap === undefined) {
+            throw new ActionLiveDataObjectUndefinedError("sharedMap", "deleteEntry");
+        }
+        sharedMap.delete(key);
+    }, [container, sharedMap]);
+    // Setup change listeners, initial values, etc.
+    React.useEffect(() => {
+        if (!sharedMap)
+            return;
+        // Register valueChanged listener for `SharedMap`.
+        const onValueChanged = () => {
+            setMap(new Map(sharedMap.entries()));
+        };
+        sharedMap.on("valueChanged", onValueChanged);
+        // Get initial values from `SharedMap`.
+        onValueChanged();
+        return () => {
+            // Cleanup on component unmount.
+            sharedMap === null || sharedMap === void 0 ? void 0 : sharedMap.off("valueChanged", onValueChanged);
+        };
+    }, [sharedMap]);
+    return {
+        map,
+        setEntry,
+        deleteEntry,
+        sharedMap,
+    };
+}
+/**
+ * Helper method for converting different initial data props into a Map<string, TData> to insert into the Fluid SharedMap
+ * @template TData Optional typing for objects stored in the SharedMap. Default is `object` type.
+ * @param initialData a JS Map, entries array, or JSON object.
+ * @returns A Map<string, TData> with the entries provided.
+ */
+function getInitialData(initialData) {
+    if (isMap(initialData)) {
+        return initialData;
+    }
+    else if (isEntries(initialData)) {
+        return new Map(initialData);
+    }
+    else if (isJSON(initialData)) {
+        const values = Object.keys(initialData).map((key) => {
+            return [key, initialData[key]];
+        });
+        return new Map(values);
+    }
+    return new Map();
+}
 //# sourceMappingURL=useSharedMap.js.map

package/bin/shared-hooks/useSharedMap.js.map

@@ -1 +1 @@
-{"version":3,"file":"useSharedMap.js","sourceRoot":"","sources":["../../src/shared-hooks/useSharedMap.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,YAAY,CACxB,SAAiB,EACjB,WAAyC;IAEzC;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC,QAAQ,CAChC,cAAc,CAAQ,WAAW,CAAC,CACrC,CAAC;IAEF,MAAM,iBAAiB,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC,MAAiB,EAAQ,EAAE;QACpE;;;WAGG;QACH,cAAc,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;YAC/C,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;IAClB;;OAEG;IACH,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,aAAa,CAAY,SAAS,EAAE,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAE7F;;OAEG;IACH,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,CAC9B,CAAC,GAAW,EAAE,KAAY,EAAE,EAAE;QAC1B,IAAI,CAAC,SAAS,EAAE;YACZ,OAAO,CAAC,KAAK,CACT,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAC3D,CAAC;YACF,OAAO;SACV;QACD,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC,EACD,CAAC,SAAS,CAAC,CACd,CAAC;IAEF;;OAEG;IACH,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,CACjC,CAAC,GAAW,EAAE,EAAE;QACZ,IAAI,CAAC,SAAS,EAAE;YACZ,OAAO,CAAC,KAAK,CACT,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAC9D,CAAC;YACF,OAAO;SACV;QACD,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC,EACD,CAAC,SAAS,CAAC,CACd,CAAC;IAEF,+CAA+C;IAC/C,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACjB,IAAI,CAAC,SAAS;YAAE,OAAO;QAEvB,kDAAkD;QAClD,MAAM,cAAc,GAAG,GAAG,EAAE;YACxB,MAAM,CAAC,IAAI,GAAG,CAAgB,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACxD,CAAC,CAAC;QACF,SAAS,CAAC,EAAE,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QAC7C,uCAAuC;QACvC,cAAc,EAAE,CAAC;QAEjB,OAAO,GAAG,EAAE;YACR,gCAAgC;YAChC,SAAS,aAAT,SAAS,uBAAT,SAAS,CAAE,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QACnD,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,OAAO;QACH,GAAG;QACH,QAAQ;QACR,WAAW;QACX,SAAS;KACZ,CAAC;AACN,CAAC;AAED;;;;;GAKG;AACH,SAAS,cAAc,CACnB,WAAwC;IAExC,IAAI,KAAK,CAAC,WAAW,CAAC,EAAE;QACpB,OAAO,WAAW,CAAC;KACtB;SAAM,IAAI,SAAS,CAAC,WAAW,CAAC,EAAE;QAC/B,OAAO,IAAI,GAAG,CAAgB,WAAW,CAAC,CAAC;KAC9C;SAAM,IAAI,MAAM,CAAC,WAAW,CAAC,EAAE;QAC5B,MAAM,MAAM,GAAiC,MAAM,CAAC,IAAI,CACpD,WAAW,CACd,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACV,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,GAAG,CAAgB,MAAM,CAAC,CAAC;KACzC;IACD,OAAO,IAAI,GAAG,EAAiB,CAAC;AACpC,CAAC"}
+{"version":3,"file":"useSharedMap.js","sourceRoot":"","sources":["../../src/shared-hooks/useSharedMap.ts"],"names":[],"mappings":"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"}

package/bin/shared-hooks/useSharedState.d.ts

@@ -1,21 +1,21 @@
-/*!
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-import { DisposeSharedStateAction, SetSharedStateAction } from "../types";
-/**
- * Inspired by React's `useState` hook, `useSharedState` makes it easy to synchronize state in your app.
- *
- * @remarks
- * Values set through this state is automatically attached to a `SharedMap` that the `AzureProvider`
- * creates. If you are synchronizing complex data structures that multiple users will be setting simultaneously,
- * consider using an optimized hook for your data structure (e.g., `useSharedMap`, `useSharedString`, etc.).
- *
- * @template S Typing for objects stored associated with the `uniqueKey`.
- * @param uniqueKey the unique key for a `SharedMap`. If you use the same key for multiple components, those components will reference the same state.
- * @param initialState a default state for the `SharedMap`.
- *
- * @returns a stateful value, the function to update it, and an optional dispose method to delete it from the `SharedMap`.
- */
-export declare function useSharedState<S>(uniqueKey: string, initialState: S): [S, SetSharedStateAction<S>, DisposeSharedStateAction];
+/*!
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the Microsoft Live Share SDK License.
+ */
+import { DisposeSharedStateAction, SetSharedStateAction } from "../types";
+/**
+ * Inspired by React's `useState` hook, `useSharedState` makes it easy to synchronize state in your app.
+ *
+ * @remarks
+ * Values set through this state is automatically attached to a `SharedMap` that the `AzureProvider`
+ * creates. If you are synchronizing complex data structures that multiple users will be setting simultaneously,
+ * consider using an optimized hook for your data structure (e.g., `useSharedMap`, `useSharedString`, etc.).
+ *
+ * @template S Typing for objects stored associated with the `uniqueKey`.
+ * @param uniqueKey the unique key for a `SharedMap`. If you use the same key for multiple components, those components will reference the same state.
+ * @param initialState a default state for the `SharedMap`.
+ *
+ * @returns a stateful value, the function to update it, and an optional dispose method to delete it from the `SharedMap`.
+ */
+export declare function useSharedState<S = any>(uniqueKey: string, initialState: S): [S, SetSharedStateAction<S>, DisposeSharedStateAction];
 //# sourceMappingURL=useSharedState.d.ts.map

package/bin/shared-hooks/useSharedState.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSharedState.d.ts","sourceRoot":"","sources":["../../src/shared-hooks/useSharedState.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAG1E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAC5B,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,CAAC,GAChB,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,wBAAwB,CAAC,CAyDxD"}
+{"version":3,"file":"useSharedState.d.ts","sourceRoot":"","sources":["../../src/shared-hooks/useSharedState.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAI1E;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,CAAC,GAAG,GAAG,EAClC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,CAAC,GAChB,CAAC,CAAC,EAAE,oBAAoB,CAAC,CAAC,CAAC,EAAE,wBAAwB,CAAC,CAkExD"}

package/bin/shared-hooks/useSharedState.js

@@ -1,63 +1,73 @@
-/*!
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-import React from "react";
-import { useFluidObjectsContext } from "../providers";
-import { v4 as uuid } from "uuid";
-/**
- * Inspired by React's `useState` hook, `useSharedState` makes it easy to synchronize state in your app.
- *
- * @remarks
- * Values set through this state is automatically attached to a `SharedMap` that the `AzureProvider`
- * creates. If you are synchronizing complex data structures that multiple users will be setting simultaneously,
- * consider using an optimized hook for your data structure (e.g., `useSharedMap`, `useSharedString`, etc.).
- *
- * @template S Typing for objects stored associated with the `uniqueKey`.
- * @param uniqueKey the unique key for a `SharedMap`. If you use the same key for multiple components, those components will reference the same state.
- * @param initialState a default state for the `SharedMap`.
- *
- * @returns a stateful value, the function to update it, and an optional dispose method to delete it from the `SharedMap`.
- */
-export function useSharedState(uniqueKey, initialState) {
-    /**
-     * User facing: stateful value and non-user facing setter.
-     */
-    const [localState, setLocalState] = React.useState(initialState);
-    /**
-     * Unique ID reference for the component.
-     */
-    const componentIdRef = React.useRef(uuid());
-    /**
-     * Register set state callbacks from AzureProvider and update/delete callbacks for initial object's `stateMap`.
-     */
-    const { registerSharedSetStateAction, unregisterSharedSetStateAction, updateSharedState, deleteSharedState, } = useFluidObjectsContext();
-    /**
-     * User facing: callback to change the shared state.
-     */
-    const setSharedState = React.useCallback((updatedState) => {
-        setLocalState(updatedState);
-        updateSharedState(uniqueKey, updatedState);
-    }, [uniqueKey, setLocalState, updateSharedState]);
-    /**
-     * User facing: callback to dispose the shared state from the `stateMap`.
-     */
-    const disposeSharedState = React.useCallback(() => {
-        deleteSharedState(uniqueKey);
-    }, [uniqueKey, deleteSharedState]);
-    /**
-     * Once container is available, this effect will register the setter method so that the `S` value
-     * from `stateMap` that matches `uniqueKey` can be passed back to this hook whenever changed.
-     *
-     * @see registerSharedSetStateAction to see how new values from `stateMap` are passed to this hook.
-     * @see unregisterSharedSetStateAction to see how this component stops listening to changes in the `stateMap`.
-     */
-    React.useEffect(() => {
-        registerSharedSetStateAction(uniqueKey, componentIdRef.current, setLocalState);
-        return () => {
-            unregisterSharedSetStateAction(uniqueKey, componentIdRef.current);
-        };
-    }, [uniqueKey, registerSharedSetStateAction, unregisterSharedSetStateAction]);
-    return [localState, setSharedState, disposeSharedState];
-}
+/*!
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ * Licensed under the Microsoft Live Share SDK License.
+ */
+import React from "react";
+import { useFluidObjectsContext } from "../providers";
+import { v4 as uuid } from "uuid";
+import { isPrevStateCallback } from "../internal";
+/**
+ * Inspired by React's `useState` hook, `useSharedState` makes it easy to synchronize state in your app.
+ *
+ * @remarks
+ * Values set through this state is automatically attached to a `SharedMap` that the `AzureProvider`
+ * creates. If you are synchronizing complex data structures that multiple users will be setting simultaneously,
+ * consider using an optimized hook for your data structure (e.g., `useSharedMap`, `useSharedString`, etc.).
+ *
+ * @template S Typing for objects stored associated with the `uniqueKey`.
+ * @param uniqueKey the unique key for a `SharedMap`. If you use the same key for multiple components, those components will reference the same state.
+ * @param initialState a default state for the `SharedMap`.
+ *
+ * @returns a stateful value, the function to update it, and an optional dispose method to delete it from the `SharedMap`.
+ */
+export function useSharedState(uniqueKey, initialState) {
+    /**
+     * User facing: stateful value and non-user facing setter.
+     */
+    const [localState, setLocalState] = React.useState(initialState);
+    /**
+     * Unique ID reference for the component.
+     */
+    const componentIdRef = React.useRef(uuid());
+    /**
+     * Register set state callbacks from AzureProvider and update/delete callbacks for initial object's `stateMap`.
+     */
+    const { registerSharedSetStateAction, unregisterSharedSetStateAction, updateSharedState, deleteSharedState, } = useFluidObjectsContext();
+    /**
+     * User facing: callback to change the shared state.
+     */
+    const setSharedState = React.useCallback((state) => {
+        setLocalState((prevState) => {
+            const valueToSet = isPrevStateCallback(state)
+                ? state(prevState)
+                : state;
+            updateSharedState(uniqueKey, valueToSet);
+            return valueToSet;
+        });
+    }, [uniqueKey, setLocalState, updateSharedState]);
+    /**
+     * User facing: callback to dispose the shared state from the `stateMap`.
+     */
+    const disposeSharedState = React.useCallback(() => {
+        deleteSharedState(uniqueKey);
+    }, [uniqueKey, deleteSharedState]);
+    /**
+     * Once container is available, this effect will register the setter method so that the `S` value
+     * from `stateMap` that matches `uniqueKey` can be passed back to this hook whenever changed.
+     *
+     * @see registerSharedSetStateAction to see how new values from `stateMap` are passed to this hook.
+     * @see unregisterSharedSetStateAction to see how this component stops listening to changes in the `stateMap`.
+     */
+    React.useEffect(() => {
+        registerSharedSetStateAction(uniqueKey, componentIdRef.current, setLocalState);
+        return () => {
+            unregisterSharedSetStateAction(uniqueKey, componentIdRef.current);
+        };
+    }, [
+        uniqueKey,
+        registerSharedSetStateAction,
+        unregisterSharedSetStateAction,
+    ]);
+    return [localState, setSharedState, disposeSharedState];
+}
 //# sourceMappingURL=useSharedState.js.map