@fluidframework/tree 2.0.0-dev-rc.1.0.0.224419

package/dist/events/events.d.ts

@@ -0,0 +1,187 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import type { IEvent } from "@fluidframework/core-interfaces";
+/**
+ * Convert a union of types to an intersection of those types. Useful for `TransformEvents`.
+ */
+export type UnionToIntersection<T> = (T extends any ? (k: T) => unknown : never) extends (k: infer U) => unknown ? U : never;
+/**
+ * `true` iff the given type is an acceptable shape for an event
+ * @beta
+ */
+export type IsEvent<Event> = Event extends (...args: any[]) => any ? true : false;
+/**
+ * Used to specify the kinds of events emitted by an {@link ISubscribable}.
+ *
+ * @remarks
+ *
+ * Any object type is a valid {@link Events}, but only the event-like properties of that
+ * type will be included.
+ *
+ * @example
+ *
+ * ```typescript
+ * interface MyEvents {
+ *   load: (user: string, data: IUserData) => void;
+ *   error: (errorCode: number) => void;
+ * }
+ * ```
+ *
+ * @beta
+ */
+export type Events<E> = {
+    [P in (string | symbol) & keyof E as IsEvent<E[P]> extends true ? P : never]: E[P];
+};
+/**
+ * Converts an `Events` type (i.e. the event registry for an {@link ISubscribable}) into a type consumable
+ * by an IEventProvider from `@fluidframework/core-interfaces`.
+ * @param E - the `Events` type to transform
+ * @param Target - an optional `IEvent` type that will be merged into the result along with the transformed `E`
+ *
+ * @example
+ *
+ * ```typescript
+ * interface MyEvents {
+ *   load: (user: string, data: IUserData) => void;
+ *   error: (errorCode: number) => void;
+ * }
+ *
+ * class MySharedObject extends SharedObject<TransformEvents<MyEvents, ISharedObjectEvents>> {
+ *    // ...
+ * }
+ * ```
+ */
+export type TransformEvents<E extends Events<E>, Target extends IEvent = IEvent> = {
+    [P in keyof Events<E>]: (event: P, listener: E[P]) => void;
+} extends Record<any, infer Z> ? UnionToIntersection<Z> & Target : never;
+/**
+ * An object which allows the registration of listeners so that subscribers can be notified when an event happens.
+ *
+ * {@link createEmitter} can help implement this interface via delegation.
+ * `EventEmitter` can be used as a base class to implement this via extension.
+ * @param E - All the events that this emitter supports
+ * @example
+ * ```ts
+ * type MyEventEmitter = IEventEmitter<{
+ *   load: (user: string, data: IUserData) => void;
+ *   error: (errorCode: number) => void;
+ * }>
+ * ```
+ * @beta
+ */
+export interface ISubscribable<E extends Events<E>> {
+    /**
+     * Register an event listener.
+     * @param eventName - the name of the event
+     * @param listener - the handler to run when the event is fired by the emitter
+     * @returns a function which will deregister the listener when run. This function has undefined behavior
+     * if called more than once.
+     */
+    on<K extends keyof Events<E>>(eventName: K, listener: E[K]): () => void;
+}
+/**
+ * Interface for an event emitter that can emit typed events to subscribed listeners.
+ * @internal
+ */
+export interface IEmitter<E extends Events<E>> {
+    /**
+     * Emits an event with the specified name and arguments, notifying all subscribers by calling their registered listener functions.
+     * @param eventName - the name of the event to fire
+     * @param args - the arguments passed to the event listener functions
+     */
+    emit<K extends keyof Events<E>>(eventName: K, ...args: Parameters<E[K]>): void;
+    /**
+     * Emits an event with the specified name and arguments, notifying all subscribers by calling their registered listener functions.
+     * It also collects the return values of all listeners into an array.
+     *
+     * Warning: This method should be used with caution. It deviates from the standard event-based integration pattern as creates substantial coupling between the emitter and its listeners.
+     * For the majority of use-cases it is recommended to use the standard {@link IEmitter.emit} functionality.
+     * @param eventName - the name of the event to fire
+     * @param args - the arguments passed to the event listener functions
+     * @returns An array of the return values of each listener, preserving the order listeners were called.
+     */
+    emitAndCollect<K extends keyof Events<E>>(eventName: K, ...args: Parameters<E[K]>): ReturnType<E[K]>[];
+}
+/**
+ * Create an {@link ISubscribable} that can be instructed to emit events via the {@link IEmitter} interface.
+ *
+ * A class can delegate handling {@link ISubscribable} to the returned value while using it to emit the events.
+ * See also `EventEmitter` which be used as a base class to implement {@link ISubscribable} via extension.
+ * @internal
+ */
+export declare function createEmitter<E extends Events<E>>(noListeners?: NoListenersCallback<E>): ISubscribable<E> & IEmitter<E> & HasListeners<E>;
+/**
+ * Called when the last listener for `eventName` is removed.
+ * Useful for determining when to clean up resources related to detecting when the event might occurs.
+ * @internal
+ */
+export type NoListenersCallback<E extends Events<E>> = (eventName: keyof Events<E>) => void;
+/**
+ * @internal
+ */
+export interface HasListeners<E extends Events<E>> {
+    /**
+     * When no `eventName` is provided, returns true iff there are any listeners.
+     *
+     * When `eventName` is provided, returns true iff there are listeners for that event.
+     *
+     * @remarks
+     * This can be used to know when its safe to cleanup data-structures which only exist to fire events for their listeners.
+     */
+    hasListeners(eventName?: keyof Events<E>): boolean;
+}
+/**
+ * Provides an API for subscribing to and listening to events.
+ *
+ * @remarks Classes wishing to emit events may either extend this class or compose over it.
+ *
+ * @example Extending this class
+ *
+ * ```typescript
+ * interface MyEvents {
+ *   "loaded": () => void;
+ * }
+ *
+ * class MyClass extends EventEmitter<MyEvents> {
+ *   private load() {
+ *     this.emit("loaded");
+ *   }
+ * }
+ * ```
+ *
+ * @example Composing over this class
+ *
+ * ```typescript
+ * class MyClass implements ISubscribable<MyEvents> {
+ *   private readonly events = EventEmitter.create<MyEvents>();
+ *
+ *   private load() {
+ *     this.events.emit("loaded");
+ *   }
+ *
+ *   public on<K extends keyof MyEvents>(eventName: K, listener: MyEvents[K]): () => void {
+ *     return this.events.on(eventName, listener);
+ *   }
+ * }
+ * ```
+ */
+export declare class EventEmitter<E extends Events<E>> implements ISubscribable<E>, HasListeners<E> {
+    private readonly noListeners?;
+    private readonly listeners;
+    protected constructor(noListeners?: NoListenersCallback<E> | undefined);
+    protected emit<K extends keyof Events<E>>(eventName: K, ...args: Parameters<E[K]>): void;
+    protected emitAndCollect<K extends keyof Events<E>>(eventName: K, ...args: Parameters<E[K]>): ReturnType<E[K]>[];
+    /**
+     * Register an event listener.
+     * @param eventName - the name of the event
+     * @param listener - the handler to run when the event is fired by the emitter
+     * @returns a function which will deregister the listener when run.
+     * This function will error if called more than once.
+     */
+    on<K extends keyof Events<E>>(eventName: K, listener: E[K]): () => void;
+    private off;
+    hasListeners(eventName?: keyof Events<E>): boolean;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/events/events.ts"],"names":[],"mappings":"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"}

package/dist/events/events.js

@@ -0,0 +1,124 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventEmitter = exports.createEmitter = void 0;
+const core_utils_1 = require("@fluidframework/core-utils");
+const util_1 = require("../util");
+/**
+ * Create an {@link ISubscribable} that can be instructed to emit events via the {@link IEmitter} interface.
+ *
+ * A class can delegate handling {@link ISubscribable} to the returned value while using it to emit the events.
+ * See also `EventEmitter` which be used as a base class to implement {@link ISubscribable} via extension.
+ * @internal
+ */
+function createEmitter(noListeners) {
+    return new ComposableEventEmitter(noListeners);
+}
+exports.createEmitter = createEmitter;
+/**
+ * Provides an API for subscribing to and listening to events.
+ *
+ * @remarks Classes wishing to emit events may either extend this class or compose over it.
+ *
+ * @example Extending this class
+ *
+ * ```typescript
+ * interface MyEvents {
+ *   "loaded": () => void;
+ * }
+ *
+ * class MyClass extends EventEmitter<MyEvents> {
+ *   private load() {
+ *     this.emit("loaded");
+ *   }
+ * }
+ * ```
+ *
+ * @example Composing over this class
+ *
+ * ```typescript
+ * class MyClass implements ISubscribable<MyEvents> {
+ *   private readonly events = EventEmitter.create<MyEvents>();
+ *
+ *   private load() {
+ *     this.events.emit("loaded");
+ *   }
+ *
+ *   public on<K extends keyof MyEvents>(eventName: K, listener: MyEvents[K]): () => void {
+ *     return this.events.on(eventName, listener);
+ *   }
+ * }
+ * ```
+ */
+class EventEmitter {
+    // Because this is protected and not public, calling this externally (not from a subclass) makes sending events to the constructed instance impossible.
+    // Instead, use the static `create` function to get an instance which allows emitting events.
+    constructor(noListeners) {
+        this.noListeners = noListeners;
+        this.listeners = new Map();
+    }
+    emit(eventName, ...args) {
+        const listeners = this.listeners.get(eventName);
+        if (listeners !== undefined) {
+            const argArray = args; // TODO: Current TS (4.5.5) cannot spread `args` into `listener()`, but future versions (e.g. 4.8.4) can.
+            for (const listener of listeners.values()) {
+                listener(...argArray);
+            }
+        }
+    }
+    emitAndCollect(eventName, ...args) {
+        const listeners = this.listeners.get(eventName);
+        if (listeners !== undefined) {
+            const argArray = args;
+            const resultArray = [];
+            for (const listener of listeners.values()) {
+                resultArray.push(listener(...argArray));
+            }
+            return resultArray;
+        }
+        return [];
+    }
+    /**
+     * Register an event listener.
+     * @param eventName - the name of the event
+     * @param listener - the handler to run when the event is fired by the emitter
+     * @returns a function which will deregister the listener when run.
+     * This function will error if called more than once.
+     */
+    on(eventName, listener) {
+        (0, util_1.getOrCreate)(this.listeners, eventName, () => new Set()).add(listener);
+        return () => this.off(eventName, listener);
+    }
+    off(eventName, listener) {
+        const listeners = this.listeners.get(eventName) ??
+            (0, util_1.fail)("Event has no listeners. Event deregistration functions may only be invoked once.");
+        (0, core_utils_1.assert)(listeners.delete(listener), 0x4c1 /* Listener does not exist. Event deregistration functions may only be invoked once. */);
+        if (listeners.size === 0) {
+            this.listeners.delete(eventName);
+            this.noListeners?.(eventName);
+        }
+    }
+    hasListeners(eventName) {
+        if (eventName === undefined) {
+            return this.listeners.size !== 0;
+        }
+        return this.listeners.has(eventName);
+    }
+}
+exports.EventEmitter = EventEmitter;
+// This class exposes the constructor and the `emit` method of `EventEmitter`, elevating them from protected to public
+class ComposableEventEmitter extends EventEmitter {
+    constructor(noListeners) {
+        super(noListeners);
+    }
+    emit(eventName, ...args) {
+        return super.emit(eventName, ...args);
+    }
+    emitAndCollect(eventName, ...args) {
+        return super.emitAndCollect(eventName, ...args);
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events/events.ts"],"names":[],"mappings":"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","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type { IEvent } from \"@fluidframework/core-interfaces\";\nimport { assert } from \"@fluidframework/core-utils\";\nimport { fail, getOrCreate } from \"../util\";\n\n/**\n * Convert a union of types to an intersection of those types. Useful for `TransformEvents`.\n */\nexport type UnionToIntersection<T> = (T extends any ? (k: T) => unknown : never) extends (\n\tk: infer U,\n) => unknown\n\t? U\n\t: never;\n\n/**\n * `true` iff the given type is an acceptable shape for an event\n * @beta\n */\nexport type IsEvent<Event> = Event extends (...args: any[]) => any ? true : false;\n\n/**\n * Used to specify the kinds of events emitted by an {@link ISubscribable}.\n *\n * @remarks\n *\n * Any object type is a valid {@link Events}, but only the event-like properties of that\n * type will be included.\n *\n * @example\n *\n * ```typescript\n * interface MyEvents {\n *   load: (user: string, data: IUserData) => void;\n *   error: (errorCode: number) => void;\n * }\n * ```\n *\n * @beta\n */\nexport type Events<E> = {\n\t[P in (string | symbol) & keyof E as IsEvent<E[P]> extends true ? P : never]: E[P];\n};\n\n/**\n * Converts an `Events` type (i.e. the event registry for an {@link ISubscribable}) into a type consumable\n * by an IEventProvider from `@fluidframework/core-interfaces`.\n * @param E - the `Events` type to transform\n * @param Target - an optional `IEvent` type that will be merged into the result along with the transformed `E`\n *\n * @example\n *\n * ```typescript\n * interface MyEvents {\n *   load: (user: string, data: IUserData) => void;\n *   error: (errorCode: number) => void;\n * }\n *\n * class MySharedObject extends SharedObject<TransformEvents<MyEvents, ISharedObjectEvents>> {\n *    // ...\n * }\n * ```\n */\nexport type TransformEvents<E extends Events<E>, Target extends IEvent = IEvent> = {\n\t[P in keyof Events<E>]: (event: P, listener: E[P]) => void;\n} extends Record<any, infer Z>\n\t? UnionToIntersection<Z> & Target\n\t: never;\n\n/**\n * An object which allows the registration of listeners so that subscribers can be notified when an event happens.\n *\n * {@link createEmitter} can help implement this interface via delegation.\n * `EventEmitter` can be used as a base class to implement this via extension.\n * @param E - All the events that this emitter supports\n * @example\n * ```ts\n * type MyEventEmitter = IEventEmitter<{\n *   load: (user: string, data: IUserData) => void;\n *   error: (errorCode: number) => void;\n * }>\n * ```\n * @beta\n */\nexport interface ISubscribable<E extends Events<E>> {\n\t/**\n\t * Register an event listener.\n\t * @param eventName - the name of the event\n\t * @param listener - the handler to run when the event is fired by the emitter\n\t * @returns a function which will deregister the listener when run. This function has undefined behavior\n\t * if called more than once.\n\t */\n\ton<K extends keyof Events<E>>(eventName: K, listener: E[K]): () => void;\n}\n\n/**\n * Interface for an event emitter that can emit typed events to subscribed listeners.\n * @internal\n */\nexport interface IEmitter<E extends Events<E>> {\n\t/**\n\t * Emits an event with the specified name and arguments, notifying all subscribers by calling their registered listener functions.\n\t * @param eventName - the name of the event to fire\n\t * @param args - the arguments passed to the event listener functions\n\t */\n\temit<K extends keyof Events<E>>(eventName: K, ...args: Parameters<E[K]>): void;\n\n\t/**\n\t * Emits an event with the specified name and arguments, notifying all subscribers by calling their registered listener functions.\n\t * It also collects the return values of all listeners into an array.\n\t *\n\t * Warning: This method should be used with caution. It deviates from the standard event-based integration pattern as creates substantial coupling between the emitter and its listeners.\n\t * For the majority of use-cases it is recommended to use the standard {@link IEmitter.emit} functionality.\n\t * @param eventName - the name of the event to fire\n\t * @param args - the arguments passed to the event listener functions\n\t * @returns An array of the return values of each listener, preserving the order listeners were called.\n\t */\n\temitAndCollect<K extends keyof Events<E>>(\n\t\teventName: K,\n\t\t...args: Parameters<E[K]>\n\t): ReturnType<E[K]>[];\n}\n\n/**\n * Create an {@link ISubscribable} that can be instructed to emit events via the {@link IEmitter} interface.\n *\n * A class can delegate handling {@link ISubscribable} to the returned value while using it to emit the events.\n * See also `EventEmitter` which be used as a base class to implement {@link ISubscribable} via extension.\n * @internal\n */\nexport function createEmitter<E extends Events<E>>(\n\tnoListeners?: NoListenersCallback<E>,\n): ISubscribable<E> & IEmitter<E> & HasListeners<E> {\n\treturn new ComposableEventEmitter<E>(noListeners);\n}\n\n/**\n * Called when the last listener for `eventName` is removed.\n * Useful for determining when to clean up resources related to detecting when the event might occurs.\n * @internal\n */\nexport type NoListenersCallback<E extends Events<E>> = (eventName: keyof Events<E>) => void;\n\n/**\n * @internal\n */\nexport interface HasListeners<E extends Events<E>> {\n\t/**\n\t * When no `eventName` is provided, returns true iff there are any listeners.\n\t *\n\t * When `eventName` is provided, returns true iff there are listeners for that event.\n\t *\n\t * @remarks\n\t * This can be used to know when its safe to cleanup data-structures which only exist to fire events for their listeners.\n\t */\n\thasListeners(eventName?: keyof Events<E>): boolean;\n}\n\n/**\n * Provides an API for subscribing to and listening to events.\n *\n * @remarks Classes wishing to emit events may either extend this class or compose over it.\n *\n * @example Extending this class\n *\n * ```typescript\n * interface MyEvents {\n *   \"loaded\": () => void;\n * }\n *\n * class MyClass extends EventEmitter<MyEvents> {\n *   private load() {\n *     this.emit(\"loaded\");\n *   }\n * }\n * ```\n *\n * @example Composing over this class\n *\n * ```typescript\n * class MyClass implements ISubscribable<MyEvents> {\n *   private readonly events = EventEmitter.create<MyEvents>();\n *\n *   private load() {\n *     this.events.emit(\"loaded\");\n *   }\n *\n *   public on<K extends keyof MyEvents>(eventName: K, listener: MyEvents[K]): () => void {\n *     return this.events.on(eventName, listener);\n *   }\n * }\n * ```\n */\nexport class EventEmitter<E extends Events<E>> implements ISubscribable<E>, HasListeners<E> {\n\tprivate readonly listeners = new Map<keyof E, Set<(...args: unknown[]) => any>>();\n\n\t// Because this is protected and not public, calling this externally (not from a subclass) makes sending events to the constructed instance impossible.\n\t// Instead, use the static `create` function to get an instance which allows emitting events.\n\tprotected constructor(private readonly noListeners?: NoListenersCallback<E>) {}\n\n\tprotected emit<K extends keyof Events<E>>(eventName: K, ...args: Parameters<E[K]>): void {\n\t\tconst listeners = this.listeners.get(eventName);\n\t\tif (listeners !== undefined) {\n\t\t\tconst argArray: unknown[] = args; // TODO: Current TS (4.5.5) cannot spread `args` into `listener()`, but future versions (e.g. 4.8.4) can.\n\t\t\tfor (const listener of listeners.values()) {\n\t\t\t\tlistener(...argArray);\n\t\t\t}\n\t\t}\n\t}\n\n\tprotected emitAndCollect<K extends keyof Events<E>>(\n\t\teventName: K,\n\t\t...args: Parameters<E[K]>\n\t): ReturnType<E[K]>[] {\n\t\tconst listeners = this.listeners.get(eventName);\n\t\tif (listeners !== undefined) {\n\t\t\tconst argArray: unknown[] = args;\n\t\t\tconst resultArray: ReturnType<E[K]>[] = [];\n\t\t\tfor (const listener of listeners.values()) {\n\t\t\t\tresultArray.push(listener(...argArray));\n\t\t\t}\n\t\t\treturn resultArray;\n\t\t}\n\t\treturn [];\n\t}\n\n\t/**\n\t * Register an event listener.\n\t * @param eventName - the name of the event\n\t * @param listener - the handler to run when the event is fired by the emitter\n\t * @returns a function which will deregister the listener when run.\n\t * This function will error if called more than once.\n\t */\n\tpublic on<K extends keyof Events<E>>(eventName: K, listener: E[K]): () => void {\n\t\tgetOrCreate(this.listeners, eventName, () => new Set()).add(listener);\n\t\treturn () => this.off(eventName, listener);\n\t}\n\n\tprivate off<K extends keyof Events<E>>(eventName: K, listener: E[K]): void {\n\t\tconst listeners =\n\t\t\tthis.listeners.get(eventName) ??\n\t\t\tfail(\n\t\t\t\t\"Event has no listeners. Event deregistration functions may only be invoked once.\",\n\t\t\t);\n\t\tassert(\n\t\t\tlisteners.delete(listener),\n\t\t\t0x4c1 /* Listener does not exist. Event deregistration functions may only be invoked once. */,\n\t\t);\n\t\tif (listeners.size === 0) {\n\t\t\tthis.listeners.delete(eventName);\n\t\t\tthis.noListeners?.(eventName);\n\t\t}\n\t}\n\n\tpublic hasListeners(eventName?: keyof Events<E>): boolean {\n\t\tif (eventName === undefined) {\n\t\t\treturn this.listeners.size !== 0;\n\t\t}\n\t\treturn this.listeners.has(eventName);\n\t}\n}\n\n// This class exposes the constructor and the `emit` method of `EventEmitter`, elevating them from protected to public\nclass ComposableEventEmitter<E extends Events<E>> extends EventEmitter<E> implements IEmitter<E> {\n\tpublic constructor(noListeners?: NoListenersCallback<E>) {\n\t\tsuper(noListeners);\n\t}\n\n\tpublic override emit<K extends keyof Events<E>>(eventName: K, ...args: Parameters<E[K]>): void {\n\t\treturn super.emit(eventName, ...args);\n\t}\n\n\tpublic override emitAndCollect<K extends keyof Events<E>>(\n\t\teventName: K,\n\t\t...args: Parameters<E[K]>\n\t): ReturnType<E[K]>[] {\n\t\treturn super.emitAndCollect(eventName, ...args);\n\t}\n}\n"]}

package/dist/events/index.d.ts

@@ -0,0 +1,6 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export { createEmitter, EventEmitter, Events, ISubscribable, IsEvent, TransformEvents, UnionToIntersection, IEmitter, NoListenersCallback, HasListeners, } from "./events";
+//# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,aAAa,EACb,YAAY,EACZ,MAAM,EACN,aAAa,EACb,OAAO,EACP,eAAe,EACf,mBAAmB,EACnB,QAAQ,EACR,mBAAmB,EACnB,YAAY,GACZ,MAAM,UAAU,CAAC"}

package/dist/events/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventEmitter = exports.createEmitter = void 0;
+var events_1 = require("./events");
+Object.defineProperty(exports, "createEmitter", { enumerable: true, get: function () { return events_1.createEmitter; } });
+Object.defineProperty(exports, "EventEmitter", { enumerable: true, get: function () { return events_1.EventEmitter; } });
+//# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,mCAWkB;AAVjB,uGAAA,aAAa,OAAA;AACb,sGAAA,YAAY,OAAA","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport {\n\tcreateEmitter,\n\tEventEmitter,\n\tEvents,\n\tISubscribable,\n\tIsEvent,\n\tTransformEvents,\n\tUnionToIntersection,\n\tIEmitter,\n\tNoListenersCallback,\n\tHasListeners,\n} from \"./events\";\n"]}

package/dist/external-utilities/index.d.ts

@@ -0,0 +1,6 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+export { typeboxValidator } from "./typeboxValidator";
+//# sourceMappingURL=index.d.ts.map

package/dist/external-utilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/external-utilities/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/external-utilities/index.js

@@ -0,0 +1,10 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typeboxValidator = void 0;
+var typeboxValidator_1 = require("./typeboxValidator");
+Object.defineProperty(exports, "typeboxValidator", { enumerable: true, get: function () { return typeboxValidator_1.typeboxValidator; } });
+//# sourceMappingURL=index.js.map

package/dist/external-utilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/external-utilities/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,uDAAsD;AAA7C,oHAAA,gBAAgB,OAAA","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport { typeboxValidator } from \"./typeboxValidator\";\n"]}

package/dist/external-utilities/typeboxValidator.d.ts

@@ -0,0 +1,18 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import type { JsonValidator } from "../codec";
+/**
+ * A {@link JsonValidator} implementation which uses TypeBox's JSON schema validator.
+ *
+ * @privateRemarks Take care to not reference this validator directly in SharedTree code:
+ * the intent of factoring JSON validation into an interface is to make validation more pay-to-play
+ * (i.e. a JSON validator is only included in an application's bundle if that application references it).
+ *
+ * Defining this validator in its own file also helps to ensure it is tree-shakeable.
+ *
+ * @internal
+ */
+export declare const typeboxValidator: JsonValidator;
+//# sourceMappingURL=typeboxValidator.d.ts.map

package/dist/external-utilities/typeboxValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeboxValidator.d.ts","sourceRoot":"","sources":["../../src/external-utilities/typeboxValidator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAO9B,CAAC"}

package/dist/external-utilities/typeboxValidator.js

@@ -0,0 +1,30 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typeboxValidator = void 0;
+// This export is documented as supported in typebox's documentation.
+// eslint-disable-next-line import/no-internal-modules
+const compiler_1 = require("@sinclair/typebox/compiler");
+/**
+ * A {@link JsonValidator} implementation which uses TypeBox's JSON schema validator.
+ *
+ * @privateRemarks Take care to not reference this validator directly in SharedTree code:
+ * the intent of factoring JSON validation into an interface is to make validation more pay-to-play
+ * (i.e. a JSON validator is only included in an application's bundle if that application references it).
+ *
+ * Defining this validator in its own file also helps to ensure it is tree-shakeable.
+ *
+ * @internal
+ */
+exports.typeboxValidator = {
+    compile: (schema) => {
+        const compiledFormat = compiler_1.TypeCompiler.Compile(schema);
+        return {
+            check: (data) => compiledFormat.Check(data),
+        };
+    },
+};
+//# sourceMappingURL=typeboxValidator.js.map

package/dist/external-utilities/typeboxValidator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeboxValidator.js","sourceRoot":"","sources":["../../src/external-utilities/typeboxValidator.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,qEAAqE;AACrE,sDAAsD;AACtD,yDAA0D;AAI1D;;;;;;;;;;GAUG;AACU,QAAA,gBAAgB,GAAkB;IAC9C,OAAO,EAAE,CAAyB,MAAc,EAAE,EAAE;QACnD,MAAM,cAAc,GAAG,uBAAY,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACpD,OAAO;YACN,KAAK,EAAE,CAAC,IAAI,EAA0B,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC;SACnE,CAAC;IACH,CAAC;CACD,CAAC","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n// This export is documented as supported in typebox's documentation.\n// eslint-disable-next-line import/no-internal-modules\nimport { TypeCompiler } from \"@sinclair/typebox/compiler\";\nimport type { Static, TSchema } from \"@sinclair/typebox\";\nimport type { JsonValidator } from \"../codec\";\n\n/**\n * A {@link JsonValidator} implementation which uses TypeBox's JSON schema validator.\n *\n * @privateRemarks Take care to not reference this validator directly in SharedTree code:\n * the intent of factoring JSON validation into an interface is to make validation more pay-to-play\n * (i.e. a JSON validator is only included in an application's bundle if that application references it).\n *\n * Defining this validator in its own file also helps to ensure it is tree-shakeable.\n *\n * @internal\n */\nexport const typeboxValidator: JsonValidator = {\n\tcompile: <Schema extends TSchema>(schema: Schema) => {\n\t\tconst compiledFormat = TypeCompiler.Compile(schema);\n\t\treturn {\n\t\t\tcheck: (data): data is Static<Schema> => compiledFormat.Check(data),\n\t\t};\n\t},\n};\n"]}

package/dist/feature-libraries/chunked-forest/basicChunk.d.ts

@@ -0,0 +1,111 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import { FieldKey, TreeNodeSchemaIdentifier, CursorLocationType, FieldUpPath, UpPath, TreeValue, Value, TreeType, PathRootPrefix } from "../../core";
+import { ReferenceCountedBase } from "../../util";
+import { SynchronousCursor } from "../treeCursorUtils";
+import { ChunkedCursor, cursorChunk, TreeChunk } from "./chunk";
+/**
+ * General purpose one node chunk.
+ */
+export declare class BasicChunk extends ReferenceCountedBase implements TreeChunk {
+    type: TreeNodeSchemaIdentifier;
+    fields: Map<FieldKey, TreeChunk[]>;
+    value?: TreeValue | undefined;
+    readonly topLevelLength: number;
+    /**
+     * Create a tree chunk with ref count 1.
+     *
+     * @param fields - provides exclusive deep ownership of this map to this object (which might mutate it in the future).
+     * The caller must have already accounted for this reference to the children in this map (via `referenceAdded`),
+     * and any edits to this must update child reference counts.
+     * @param value - the value on this node, if any.
+     */
+    constructor(type: TreeNodeSchemaIdentifier, fields: Map<FieldKey, TreeChunk[]>, value?: TreeValue | undefined);
+    clone(): BasicChunk;
+    cursor(): ChunkedCursor;
+    protected dispose(): void;
+}
+export type SiblingsOrKey = readonly TreeChunk[] | readonly FieldKey[];
+/**
+ * Cursor over basic chunks.
+ *
+ * @remarks This implementation is similar to StackCursor, however it is distinct because:
+ * 1. The children are chunks, which might have a top level length that greater than 1.
+ * 2. It needs to be able to delegate to cursors of other chunk formats it does not natively understand (See TODO below).
+ *
+ * TODO:
+ * This cursor currently only handles child chunks which are BasicChunks:
+ * BasicChunks should be an optimized fast path, and arbitrary chunk formats,
+ * like UniformChunk, should be supported by delegating to their cursor implementations.
+ */
+export declare class BasicChunkCursor extends SynchronousCursor implements ChunkedCursor {
+    protected root: readonly TreeChunk[];
+    protected readonly siblingStack: SiblingsOrKey[];
+    protected readonly indexStack: number[];
+    protected readonly indexOfChunkStack: number[];
+    protected readonly indexWithinChunkStack: number[];
+    protected siblings: SiblingsOrKey;
+    protected index: number;
+    protected indexOfChunk: number;
+    protected indexWithinChunk: number;
+    protected nestedCursor: ChunkedCursor | undefined;
+    /**
+     * Starts at root field which might be a detached sequence.
+     *
+     * @param root - sequence of BasicChunk which make up the contents of the root sequence.
+     * Since this cursor starts in `Fields` mode at the root, the siblings array when in fields mode is just the field keys,
+     * this is needed to get the actual root nodes when entering nodes of the root field.
+     * @param siblingStack - Stack of collections of siblings along the path through the tree:
+     * does not include current level (which is stored in `siblings`).
+     * Even levels in the stack (starting from 0) are keys and odd levels are sequences of nodes.
+     * @param indexStack - Stack of indices into the corresponding levels in `siblingStack`.
+     * @param indexOfChunkStack - Index of chunk in array of chunks. Only for Node levels.
+     * @param indexWithinChunkStack - Index within chunk selected by indexOfChunkStack. Only for Node levels.
+     * @param siblings - Siblings at the current level (not included in `siblingStack`).
+     * @param index - Index into `siblings`.
+     * @param indexOfChunk - Index of chunk in array of chunks. Only for Nodes mode.
+     * @param indexWithinChunk - Index within chunk selected by indexOfChunkStack. Only for Nodes mode.
+     * @param nestedCursor - When the outer cursor (this `BasicChunkCursor` cursor)
+     * navigates into a chunk it does not natively understand (currently anything other than `BasicChunk`s)
+     * it creates the `nestedCursor` over that chunk, and delegates all operations to it.
+     */
+    constructor(root: readonly TreeChunk[], siblingStack: SiblingsOrKey[], indexStack: number[], indexOfChunkStack: number[], indexWithinChunkStack: number[], siblings: SiblingsOrKey, index: number, indexOfChunk: number, indexWithinChunk: number, nestedCursor: ChunkedCursor | undefined);
+    get [cursorChunk](): TreeChunk | undefined;
+    atChunkRoot(): boolean;
+    fork(): BasicChunkCursor;
+    get mode(): CursorLocationType;
+    getFieldKey(): FieldKey;
+    private getStackedFieldKey;
+    private getStackedNodeIndex;
+    private getStackedNode;
+    getFieldLength(): number;
+    enterNode(index: number): void;
+    getPath(prefix?: PathRootPrefix): UpPath;
+    private nestedPathPrefix;
+    getFieldPath(prefix?: PathRootPrefix): FieldUpPath;
+    private getOffsetPath;
+    enterField(key: FieldKey): void;
+    nextField(): boolean;
+    firstField(): boolean;
+    seekNodes(offset: number): boolean;
+    firstNode(): boolean;
+    nextNode(): boolean;
+    private initNestedCursor;
+    exitField(): void;
+    exitNode(): void;
+    private getNode;
+    private getField;
+    get value(): Value;
+    get type(): TreeType;
+    get fieldIndex(): number;
+    /**
+     * Within the field that `nestedCursor` is nested in:
+     * returns the index within that field of the first node that is part of the chunk nestedCursor traverses.
+     */
+    private nestedOffset;
+    get chunkStart(): number;
+    get chunkLength(): number;
+}
+//# sourceMappingURL=basicChunk.d.ts.map

package/dist/feature-libraries/chunked-forest/basicChunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basicChunk.d.ts","sourceRoot":"","sources":["../../../src/feature-libraries/chunked-forest/basicChunk.ts"],"names":[],"mappings":"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"}