@microsoft/live-share-react 2.0.0-internal.18 → 2.0.0-internal.19

package/src/types/FluidMap.ts

@@ -0,0 +1,169 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED *AS IS*, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+// Copied from https://github.com/microsoft/FluidFramework/blob/main/packages/common/core-interfaces/src/fluidMap.ts
+// Fluid 2.x does not export these types. Keep this copy out of the package barrel.
+
+/**
+ * Like TypeScript's built-in `Iterable` type.
+ *
+ * @privateRemarks
+ * This exists to be unaffected by TypeScript's version and configuration options.
+ *
+ * @sealed @public
+ */
+export interface FluidIterable<T> {
+    /**
+     * Returns an iterator over the elements in this iterable.
+     *
+     * @remarks Works like the built-in {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/iterator | \[Symbol.iterator\]} protocol.
+     */
+    [Symbol.iterator](): FluidIterableIterator<T>;
+}
+
+/**
+ * Like TypeScript's built-in iterable iterator type.
+ *
+ * @privateRemarks
+ * The done branch uses `any` rather than `undefined` to match TypeScript's built-in IteratorReturnResult, which defaults to any for the same reason.
+ * Using `undefined` causes TypeScript to include it in type inference at call sites like `Array.from` which would infer `T | undefined` instead of `T`.
+ * The done value is rarely meaningful to callers since values are mainly consumed when done is false.
+ * Thus `any` is not particularly harmful here, and the unsafety is worth it as
+ * it interacts better with the existing TypeScript `IteratorResult` interfaces where `TReturn` defaults to any.
+ *
+ * @sealed @public
+ */
+export interface FluidIterableIterator<T> extends FluidIterable<T> {
+    /**
+     * Returns the next element in the iteration sequence.
+     *
+     * @remarks Works like the built-in {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols#the_iterator_protocol | Iterator.next} method.
+     * When there are remaining elements, returns `\{ value: T; done?: false \}`.
+     * When the iteration is complete, returns `\{ value: any; done: true \}`.
+     */
+    next(): { value: T; done?: false } | { value: any; done: true };
+}
+
+/**
+ * Like TypeScript's built in `ReadonlyMap` type.
+ * Unlike the built in `ReadonlyMap`, this interface includes Symbol.toStringTag.
+ *
+ * @privateRemarks
+ * This exists so that Fluid has a `ReadonlyMap` type which is unaffected by TypeScript's version and configuration options,
+ * and safe to implement without being broken by changes to TypeScript's default ReadonlyMap type.
+ * All behavior exposed through this interface should be compatible with the corresponding behavior of built in ReadonlyMaps,
+ * but it may lack some of the newer APIs,
+ * and might express the type slightly different from how TypeScript does in its `ReadonlyMap` type.
+ *
+ * @sealed @public
+ */
+export interface FluidReadonlyMap<K, V> {
+    /**
+     * Returns an iterable of entries in the map.
+     */
+    [Symbol.iterator](): FluidIterableIterator<[K, V]>;
+
+    /**
+     * The number of entries in the map.
+     */
+    readonly size: number;
+
+    /**
+     * Returns an iterable of key, value pairs for every entry in the map.
+     */
+    entries(): FluidIterableIterator<[K, V]>;
+
+    /**
+     * Executes the provided function once per each key/value pair in the map.
+     */
+    forEach(
+        callbackfn: (value: V, key: K, map: FluidReadonlyMap<K, V>) => void,
+        // Typing inherited from ReadonlyMap.
+        thisArg?: any
+    ): void;
+
+    /**
+     * Returns the value associated to the specified key, or undefined if there is none.
+     */
+    get(key: K): V | undefined;
+
+    /**
+     * Returns a boolean indicating whether an element with the specified key exists or not.
+     */
+    has(key: K): boolean;
+
+    /**
+     * Returns an iterable of keys in the map.
+     */
+    keys(): FluidIterableIterator<K>;
+
+    /**
+     * Returns an iterable of values in the map.
+     */
+    values(): FluidIterableIterator<V>;
+
+    /**
+     * {@link https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Symbol/toStringTag | Symbol.toStringTag}
+     */
+    readonly [Symbol.toStringTag]: string;
+}
+
+/**
+ * Like TypeScript's built in `Map` type.
+ *
+ * @privateRemarks
+ * This exists so that Fluid has a `Map` type which is unaffected by TypeScript's version and configuration options,
+ * and safe to implement without being broken by changes to TypeScript's default Map type.
+ * All behavior exposed through this interface should be compatible with the corresponding behavior of JavaScript Maps,
+ * but it may lack some of the newer APIs,
+ * and might express the type slightly different from how TypeScript does in its `Map` type.
+ *
+ * @sealed @public
+ */
+export interface FluidMap<K, V> extends FluidReadonlyMap<K, V> {
+    /**
+     * Removes the specified element from the map by its key.
+     *
+     * @remarks
+     * Unlike the built-in `Map.delete`, this returns `void` instead of a boolean.
+     * This is intentional: in a distributed system, the caller often cannot reliably know
+     * whether the element existed at the time of deletion.
+     * Subtypes may override this to return a boolean if appropriate.
+     */
+    delete(key: K): void;
+
+    /**
+     * Executes the provided function once per each key/value pair in the map.
+     */
+    forEach(
+        callbackfn: (value: V, key: K, map: FluidMap<K, V>) => void,
+        // Typing inherited from Map.
+        thisArg?: any
+    ): void;
+
+    /**
+     * Adds a new element with a specified key and value to the map.
+     * If an element with the same key already exists, the element will be updated.
+     */
+    set(key: K, value: V): void;
+}

package/src/types/ResultTypes.ts

@@ -50,6 +50,7 @@ import {
     OnUpdateLivePresenceAction,
     SendLiveEventAction,
 } from "./ActionTypes.js";
+import type { FluidMap } from "./FluidMap.js";
 
 export interface IAzureContainerResults {
     /**
@@ -69,6 +70,16 @@ export interface ILiveShareContainerResults extends IAzureContainerResults {
     created: boolean;
 }
 
+/**
+ * A value-typed SharedMap compatible with Fluid 2.x and 3.x.
+ * Uses SharedMap's mutators without changing FluidMap's forEach callback type.
+ */
+export type TypedSharedMap<TData> = Omit<
+    FluidMap<string, TData>,
+    "delete" | "set"
+> &
+    SharedMap;
+
 /**
  * @deprecated use {@link useSharedTree} instead.
  *
@@ -77,8 +88,14 @@ export interface ILiveShareContainerResults extends IAzureContainerResults {
 export interface IUseSharedMapResults<TData> {
     /**
      * The Fluid `SharedMap` object.
+     *
+     * @remarks
+     * Uses a local FluidMap type for value-typed get, forEach, values, and entries across Fluid 2.x and 3.x,
+     * while preserving ISharedMap's boolean delete result and chainable set method.
+     * Fluid 3.x maps are not assignable to the built-in Map type; use new Map(sharedMap)
+     * when a built-in Map is required.
      */
-    sharedMap: (Map<string, TData> & SharedMap) | undefined;
+    sharedMap: TypedSharedMap<TData> | undefined;
     /**
      * Callback method to get entries in the `SharedMap`.
      */

package/tsconfig.json

@@ -3,11 +3,10 @@
         /* Visit https://aka.ms/tsconfig.json to read more about this file */
         /* Basic Options */
         // "incremental": true,                   /* Enable incremental compilation */
-        "target": "es6" /* Specify ECMAScript target version: 'ES3' (default), 'ES5', 'ES2015', 'ES2016', 'ES2017', 'ES2018', 'ES2019', 'ES2020', or 'ESNEXT'. */,
-        "module": "Node16" /* Specify module code generation: 'none', 'commonjs', 'amd', 'system', 'umd', 'es2015', 'es2020', or 'ESNext'. */,
-        "moduleResolution": "Node16",
+        "target": "ES2022" /* Specify ECMAScript target version. */,
+        "module": "Node16" /* Specify module code generation. */,
         "lib": [
-            "es2020",
+            "ES2022",
             "DOM"
         ] /* Specify library files to be included in the compilation. */,
         "allowJs": false /* Allow javascript files to be compiled. */,

package/bin/cjs/index.d.ts

@@ -1,7 +0,0 @@
-export * from "./providers/index.js";
-export * from "./shared-hooks/index.js";
-export * from "./live-hooks/index.js";
-export * from "./types/index.js";
-export * from "./providers/index.js";
-export * from "./interfaces/index.js";
-//# sourceMappingURL=index.d.ts.map

package/bin/cjs/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC"}

package/bin/cjs/index.js

@@ -1,23 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./providers/index.js"), exports);
-__exportStar(require("./shared-hooks/index.js"), exports);
-__exportStar(require("./live-hooks/index.js"), exports);
-__exportStar(require("./types/index.js"), exports);
-__exportStar(require("./providers/index.js"), exports);
-__exportStar(require("./interfaces/index.js"), exports);
-//# sourceMappingURL=index.js.map

package/bin/cjs/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,0DAAwC;AACxC,wDAAsC;AACtC,mDAAiC;AACjC,uDAAqC;AACrC,wDAAsC"}

package/bin/cjs/interfaces/LiveInterfaceExtensions.d.ts

@@ -1,26 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-/**
- * Object response for a received event
- */
-export interface IReceiveLiveEvent<TEvent = any> {
-    /**
-     * The value of the event that was sent
-     */
-    value: TEvent;
-    /**
-     * True if the local client was the one to send this event
-     */
-    local: boolean;
-    /**
-     * Client ID of the user that sent the event
-     */
-    clientId: string;
-    /**
-     * Server timestamp at which the event was sent
-     */
-    timestamp: number;
-}
-//# sourceMappingURL=LiveInterfaceExtensions.d.ts.map

package/bin/cjs/interfaces/LiveInterfaceExtensions.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"LiveInterfaceExtensions.d.ts","sourceRoot":"","sources":["../../../src/interfaces/LiveInterfaceExtensions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,MAAM,GAAG,GAAG;IAC3C;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACrB"}

package/bin/cjs/interfaces/LiveInterfaceExtensions.js

@@ -1,7 +0,0 @@
-"use strict";
-/*!
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=LiveInterfaceExtensions.js.map

package/bin/cjs/interfaces/LiveInterfaceExtensions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"LiveInterfaceExtensions.js","sourceRoot":"","sources":["../../../src/interfaces/LiveInterfaceExtensions.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/bin/cjs/interfaces/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./LiveInterfaceExtensions.js";
-//# sourceMappingURL=index.d.ts.map

package/bin/cjs/interfaces/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,8BAA8B,CAAC"}

package/bin/cjs/interfaces/index.js

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./LiveInterfaceExtensions.js"), exports);
-//# sourceMappingURL=index.js.map

package/bin/cjs/interfaces/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,+DAA6C"}

package/bin/cjs/internal/errors.d.ts

@@ -1,41 +0,0 @@
-/**
- * @hidden
- */
-declare class UseLiveDataObjectActionError extends Error {
-    constructor(ddsName: string, functionName: string, message: string);
-}
-/**
- * @hidden
- */
-export declare class ActionContainerNotJoinedError extends UseLiveDataObjectActionError {
-    constructor(ddsName: string, functionName: string);
-}
-/**
- * @hidden
- */
-export declare class ActionLiveDataObjectUndefinedError extends UseLiveDataObjectActionError {
-    constructor(ddsName: string, functionName: string);
-}
-/**
- * @hidden
- */
-export declare class ActionLiveDataObjectInitializedError extends UseLiveDataObjectActionError {
-    constructor(ddsName: string, functionName: string);
-}
-/**
- * @hidden
- */
-export interface ITeamsJsSdkError {
-    /**
-     * error code
-     */
-    errorCode: number;
-    /**
-     * Optional description for the error. This may contain useful information for web-app developers.
-     * This string will not be localized and is not for end-user consumption.
-     * App should not depend on the string content. The exact value may change. This is only for debugging purposes.
-     */
-    message?: string;
-}
-export {};
-//# sourceMappingURL=errors.d.ts.map

package/bin/cjs/internal/errors.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/internal/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAM,4BAA6B,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAIrE;AAED;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,4BAA4B;gBAC/D,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAOpD;AAED;;GAEG;AACH,qBAAa,kCAAmC,SAAQ,4BAA4B;gBACpE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAQpD;AAED;;GAEG;AACH,qBAAa,oCAAqC,SAAQ,4BAA4B;gBACtE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAQpD;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/bin/cjs/internal/errors.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ActionLiveDataObjectInitializedError = exports.ActionLiveDataObjectUndefinedError = exports.ActionContainerNotJoinedError = void 0;
-/**
- * @hidden
- */
-class UseLiveDataObjectActionError extends Error {
-    constructor(ddsName, functionName, message) {
-        const hookName = `use${toFirstLetterUppercase(ddsName)}`;
-        super(`${hookName} ${functionName}: ${message}`);
-    }
-}
-/**
- * @hidden
- */
-class ActionContainerNotJoinedError extends UseLiveDataObjectActionError {
-    constructor(ddsName, functionName) {
-        super(ddsName, functionName, "container has not yet been joined.\nTo fix this error, ensure `container` from `useFluidObjectsContext()` is defined before calling this function.\nIf using `<LiveShareProvider>`, you can instead check the `joined` response is true from `useLiveShareContext()` before calling this function.");
-    }
-}
-exports.ActionContainerNotJoinedError = ActionContainerNotJoinedError;
-/**
- * @hidden
- */
-class ActionLiveDataObjectUndefinedError extends UseLiveDataObjectActionError {
-    constructor(ddsName, functionName) {
-        const hookName = `use${toFirstLetterUppercase(ddsName)}`;
-        super(ddsName, functionName, `${ddsName} is undefined, which means it is still being dynamically created.\nTo fix this error, ensure that \`${ddsName}\` (found in the response of \`${hookName}\`) is defined before calling this function.`);
-    }
-}
-exports.ActionLiveDataObjectUndefinedError = ActionLiveDataObjectUndefinedError;
-/**
- * @hidden
- */
-class ActionLiveDataObjectInitializedError extends UseLiveDataObjectActionError {
-    constructor(ddsName, functionName) {
-        const hookName = `use${toFirstLetterUppercase(ddsName)}`;
-        super(ddsName, functionName, `${ddsName} is not yet initialized.\nTo fix this error, ensure that \`${ddsName}?.isInitialized\` is true (found in the response of \`${hookName}\`) before calling this function.`);
-    }
-}
-exports.ActionLiveDataObjectInitializedError = ActionLiveDataObjectInitializedError;
-/**
- * @hidden
- */
-function toFirstLetterUppercase(word) {
-    return word[0].toUpperCase() + word.substring(1);
-}
-//# sourceMappingURL=errors.js.map

package/bin/cjs/internal/errors.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/internal/errors.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAM,4BAA6B,SAAQ,KAAK;IAC5C,YAAY,OAAe,EAAE,YAAoB,EAAE,OAAe;QAC9D,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,KAAK,CAAC,GAAG,QAAQ,IAAI,YAAY,KAAK,OAAO,EAAE,CAAC,CAAC;IACrD,CAAC;CACJ;AAED;;GAEG;AACH,MAAa,6BAA8B,SAAQ,4BAA4B;IAC3E,YAAY,OAAe,EAAE,YAAoB;QAC7C,KAAK,CACD,OAAO,EACP,YAAY,EACZ,oSAAoS,CACvS,CAAC;IACN,CAAC;CACJ;AARD,sEAQC;AAED;;GAEG;AACH,MAAa,kCAAmC,SAAQ,4BAA4B;IAChF,YAAY,OAAe,EAAE,YAAoB;QAC7C,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,KAAK,CACD,OAAO,EACP,YAAY,EACZ,GAAG,OAAO,uGAAuG,OAAO,kCAAkC,QAAQ,8CAA8C,CACnN,CAAC;IACN,CAAC;CACJ;AATD,gFASC;AAED;;GAEG;AACH,MAAa,oCAAqC,SAAQ,4BAA4B;IAClF,YAAY,OAAe,EAAE,YAAoB;QAC7C,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC;QACzD,KAAK,CACD,OAAO,EACP,YAAY,EACZ,GAAG,OAAO,8DAA8D,OAAO,yDAAyD,QAAQ,mCAAmC,CACtL,CAAC;IACN,CAAC;CACJ;AATD,oFASC;AAkBD;;GAEG;AACH,SAAS,sBAAsB,CAAC,IAAY;IACxC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AACrD,CAAC"}

package/bin/cjs/internal/index.d.ts

@@ -1,3 +0,0 @@
-export * from "./errors.js";
-export * from "./type-guards.js";
-//# sourceMappingURL=index.d.ts.map

package/bin/cjs/internal/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC"}

package/bin/cjs/internal/index.js

@@ -1,19 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./errors.js"), exports);
-__exportStar(require("./type-guards.js"), exports);
-//# sourceMappingURL=index.js.map

package/bin/cjs/internal/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,mDAAiC"}

package/bin/cjs/internal/type-guards.d.ts

@@ -1,11 +0,0 @@
-import { ITeamsJsSdkError } from "./errors.js";
-/**
- * @hidden
- * Used for useLiveState and useSharedState for checking if a value is a prevState callback
- */
-export declare function isPrevStateCallback<TState>(value: any): value is (value: TState) => TState;
-/**
- * @hidden
- */
-export declare function isITeamsJsSdkError(value: any): value is ITeamsJsSdkError;
-//# sourceMappingURL=type-guards.d.ts.map

package/bin/cjs/internal/type-guards.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../../src/internal/type-guards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EACtC,KAAK,EAAE,GAAG,GACX,KAAK,IAAI,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAEpC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,gBAAgB,CAKxE"}

package/bin/cjs/internal/type-guards.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isPrevStateCallback = isPrevStateCallback;
-exports.isITeamsJsSdkError = isITeamsJsSdkError;
-/**
- * @hidden
- * Used for useLiveState and useSharedState for checking if a value is a prevState callback
- */
-function isPrevStateCallback(value) {
-    return typeof value === "function";
-}
-/**
- * @hidden
- */
-function isITeamsJsSdkError(value) {
-    if (!value)
-        return false;
-    if (typeof value.errorCode !== "number")
-        return false;
-    if (value.message === undefined)
-        return true;
-    return typeof value.message === "string";
-}
-//# sourceMappingURL=type-guards.js.map

package/bin/cjs/internal/type-guards.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"type-guards.js","sourceRoot":"","sources":["../../../src/internal/type-guards.ts"],"names":[],"mappings":";;AAMA,kDAIC;AAKD,gDAKC;AAlBD;;;GAGG;AACH,SAAgB,mBAAmB,CAC/B,KAAU;IAEV,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,KAAU;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAC7C,OAAO,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC;AAC7C,CAAC"}

package/bin/cjs/live-hooks/index.d.ts

@@ -1,8 +0,0 @@
-export * from "./useLivePresence.js";
-export * from "./useLiveFollowMode.js";
-export * from "./useLiveState.js";
-export * from "./useMediaSynchronizer.js";
-export * from "./useLiveEvent.js";
-export * from "./useLiveCanvas.js";
-export * from "./useLiveTimer.js";
-//# sourceMappingURL=index.d.ts.map

package/bin/cjs/live-hooks/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/live-hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/bin/cjs/live-hooks/index.js

@@ -1,24 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./useLivePresence.js"), exports);
-__exportStar(require("./useLiveFollowMode.js"), exports);
-__exportStar(require("./useLiveState.js"), exports);
-__exportStar(require("./useMediaSynchronizer.js"), exports);
-__exportStar(require("./useLiveEvent.js"), exports);
-__exportStar(require("./useLiveCanvas.js"), exports);
-__exportStar(require("./useLiveTimer.js"), exports);
-//# sourceMappingURL=index.js.map

package/bin/cjs/live-hooks/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/live-hooks/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,yDAAuC;AACvC,oDAAkC;AAClC,4DAA0C;AAC1C,oDAAkC;AAClC,qDAAmC;AACnC,oDAAkC"}

package/bin/cjs/live-hooks/useLiveCanvas.d.ts

@@ -1,80 +0,0 @@
-/*!
- * Copyright (c) Microsoft Corporation. All rights reserved.
- * Licensed under the Microsoft Live Share SDK License.
- */
-import React from "react";
-import { IUseLiveCanvasOptionalProps, IUseLiveCanvasResults } from "../types/index.js";
-/**
- * React hook for using a Live Share Canvas `LiveCanvas` and `InkingManager`.
- *
- * @remarks
- * Use this hook to set up an `LiveCanvas` object, which is used for collaborative inking. It takes several input parameters, including a unique key,
- * a reference to a canvas element, and various settings for the inking tool, brush, and canvas offset and scale.
- * This hook can only be used in a child component of `<LiveShareProvider>` or `<AzureProvider>`.
- *
- * @param uniqueKey the unique key for the `LiveCanvas`. If one does not yet exist, a new one.
- * @param canvasElementRef the HTML div element ref or document ID that `InkingManager` will use for canvas-based collaboration.
- * @param props Optional. Other optional props.
- * @param props.active Optional. Stateful boolean that will activate/de-activate `InkingManager` accordingly.
- * @param props.tool Optional. Stateful enum for what tool to use in the `InkingManager`.
- * @param props.lineBrush Optional. Stateful lineBrush object for the selected lineBrush options to use in `InkingManager`.
- * @param props.offset Optional. Stateful offset point to use in the `InkingManager`. Gets the viewport offset. Defaults to 0,0.
- * @param props.scale Optional. Stateful scale number to use in the `InkingManager`. Defaults to 1 and must be greater than 0.
- * @param props.referencePoint Optional. Stateful reference point enum to use in the `InkingManger`. Defaults to "center".
- * @param props.isCursorShared Optional. Stateful boolean flag for whether cursor should be shared in `LiveCanvas`. Defaults to false.
- * @param props.localUserPictureUrl Optional. url string for the local user to display alongside their cursor. Defaults to undefined.
- * @param props.node Optional. A Fluid `LiveCanvasTree` `TreeNode` instance to swap out the underlying storage solution for strokes.
- * To learn more, look at Fluid's [SharedTree](https://fluidframework.com/docs/data-structures/tree/) documentation.
- * @param allowedRoles Optional. The user roles that are allowed to start/stop/pause the timer.
- *
- * @returns `IUseLiveCanvasResults` object that contains the `liveCanvas` data object and `inkingManager`.
- *
- * @example
- ```jsx
-import { useLiveCanvas } from "@microsoft/live-share-react";
-import { InkingTool } from "@microsoft/live-share-canvas";
-import { useRef } from "react";
-
-// Unique identifier that distinguishes this useLiveCanvas from others in your app
-const UNIQUE_KEY = "CUSTOM-LIVE-CANVAS";
-
-// Example component
-export function ExampleLiveCanvas() {
-    const liveCanvasRef = useRef(null);
-    const { liveCanvas, inkingManager } = useLiveCanvas(
-        "CUSTOM-LIVE-CANVAS",
-        liveCanvasRef,
-    );
-
-    return (
-        <div style={{ position: "absolute"}}>
-            <div
-                ref={liveCanvasRef}
-                // Best practice is to not define inline styles
-                style={{ width: "556px", height: "224px" }}
-            />
-            {!!liveCanvas && (
-                <div>
-                    <button
-                        onClick={() => {
-                            inkingManager.tool = InkingTool.pen;
-                        }}
-                    >
-                        {"Pen"}
-                    </button>
-                    <button
-                        onClick={() => {
-                            inkingManager.tool = InkingTool.laserPointer;
-                        }}
-                    >
-                        {"Laser pointer"}
-                    </button>
-                </div>
-            )}
-        </div>
-    );
-};
- ```
- */
-export declare function useLiveCanvas(uniqueKey: string, canvasElementRef: React.RefObject<HTMLElement | null> | string, props?: IUseLiveCanvasOptionalProps): IUseLiveCanvasResults;
-//# sourceMappingURL=useLiveCanvas.d.ts.map

package/bin/cjs/live-hooks/useLiveCanvas.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"useLiveCanvas.d.ts","sourceRoot":"","sources":["../../../src/live-hooks/useLiveCanvas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EACH,2BAA2B,EAC3B,qBAAqB,EACxB,MAAM,mBAAmB,CAAC;AAK3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuEG;AACH,wBAAgB,aAAa,CACzB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,MAAM,EAC9D,KAAK,CAAC,EAAE,2BAA2B,GACpC,qBAAqB,CA0KvB"}