@fluid-experimental/tree 2.0.0-internal.8.0.0 → 2.0.0-rc.1.0.0

package/dist/tree-untrimmed.d.ts

@@ -25,9 +25,8 @@ import { ITelemetryBaseEvent } from '@fluidframework/core-interfaces';
 import { ITelemetryContext } from '@fluidframework/runtime-definitions';
 import { ITelemetryLoggerExt } from '@fluidframework/telemetry-utils';
 import { ITelemetryProperties } from '@fluidframework/core-interfaces';
-import { ITree } from '@fluid-experimental/tree2';
+import { ITree } from '@fluidframework/tree';
 import { SharedObject } from '@fluidframework/shared-object-base';
-import { TreeFactory } from '@fluid-experimental/tree2';
 import { TypedEventEmitter } from '@fluid-internal/client-utils';
 
 /**
@@ -38,19 +37,19 @@ export declare function areRevisionViewsSemanticallyEqual(treeViewA: TreeView, i
 
 /**
  * An identifier associated with a session for the purpose of attributing its created content to some user/entity.
- * @internal
+ * @alpha
  */
 export declare type AttributionId = UuidString;
 
 /**
  * The result of validating a bad place.
- * @internal
+ * @alpha
  */
 export declare type BadPlaceValidationResult = Exclude<PlaceValidationResult, PlaceValidationResult.Valid>;
 
 /**
  * The result of validating a bad range.
- * @internal
+ * @alpha
  */
 export declare type BadRangeValidationResult = Exclude<RangeValidationResult, RangeValidationResultKind.Valid>;
 
@@ -60,7 +59,7 @@ export declare type BadRangeValidationResult = Exclude<RangeValidationResult, Ra
  *
  * Valid if (transitively) all DetachedSequenceId are used according to their rules (use here counts as a destination),
  * and all Nodes' identifiers are previously unused.
- * @internal
+ * @alpha
  */
 export declare interface Build {
     readonly destination: number;
@@ -70,7 +69,7 @@ export declare interface Build {
 
 /**
  * {@inheritdoc Build}
- * @internal
+ * @alpha
  */
 export declare interface BuildInternal extends Omit<BuildInternal_0_0_2, 'source'> {
     readonly source: TreeNodeSequence<BuildNodeInternal>;
@@ -78,7 +77,7 @@ export declare interface BuildInternal extends Omit<BuildInternal_0_0_2, 'source
 
 /**
  * {@inheritdoc Build}
- * @internal
+ * @alpha
  */
 export declare interface BuildInternal_0_0_2 {
     /** {@inheritdoc Build.destination } */
@@ -92,19 +91,19 @@ export declare interface BuildInternal_0_0_2 {
 /**
  * Node or a detached sequence of nodes (referred to by a detached sequence ID) for use in a Build change.
  * See `BuildTreeNode` for more.
- * @internal
+ * @alpha
  */
 export declare type BuildNode = BuildTreeNode | number;
 
 /**
  * {@inheritdoc BuildNode}
- * @internal
+ * @alpha
  */
 export declare type BuildNodeInternal = TreeNode<BuildNodeInternal, NodeId> | DetachedSequenceId;
 
 /**
  * {@inheritdoc BuildNode}
- * @internal
+ * @alpha
  */
 export declare type BuildNodeInternal_0_0_2 = TreeNode<BuildNodeInternal_0_0_2, StableNodeId> | DetachedSequenceId;
 
@@ -115,7 +114,7 @@ export declare type BuildNodeInternal_0_0_2 = TreeNode<BuildNodeInternal_0_0_2,
  * BuildTreeNode can be observed. If `identifier` is not supplied, one will be generated for it in an especially efficient manner
  * that allows for compact storage and transmission and thus this property should be omitted if convenient.
  * See the SharedTree readme for more on the tree format.
- * @internal
+ * @alpha
  */
 export declare interface BuildTreeNode extends HasVariadicTraits<BuildNode> {
     definition: string;
@@ -135,12 +134,12 @@ export declare interface BuildTreeNode extends HasVariadicTraits<BuildNode> {
  * ```typescript
  * Change.insert(sourceId, destination)
  * ```
- * @internal
+ * @alpha
  */
 export declare type Change = Insert | Detach | Build | SetValue | Constraint;
 
 /**
- * @internal
+ * @alpha
  */
 export declare const Change: {
     build: (source: BuildNode | TreeNodeSequence<BuildNode>, destination: number) => Build;
@@ -166,12 +165,12 @@ export declare const Change: {
 
 /**
  * {@inheritdoc (Change:type)}
- * @internal
+ * @alpha
  */
 export declare type ChangeInternal = InsertInternal | DetachInternal | BuildInternal | SetValueInternal | ConstraintInternal;
 
 /**
- * @internal
+ * @alpha
  */
 export declare const ChangeInternal: {
     build: (source: TreeNodeSequence<BuildNodeInternal>, destination: DetachedSequenceId) => BuildInternal;
@@ -196,7 +195,7 @@ export declare type ChangeNode = TreeNode<ChangeNode, NodeId>;
 
 /**
  * JSON-compatible Node type. Objects of this type will be persisted in internal change objects (under Edits) in the SharedTree history.
- * @internal
+ * @alpha
  */
 export declare type ChangeNode_0_0_2 = TreeNode<ChangeNode_0_0_2, StableNodeId>;
 
@@ -208,7 +207,7 @@ export declare type ChangeResult = Result<TransactionView, TransactionFailure>;
 
 /**
  * The type of a Change
- * @internal
+ * @alpha
  */
 export declare enum ChangeType {
     Insert = 0,
@@ -220,7 +219,7 @@ export declare enum ChangeType {
 
 /**
  * {@inheritdoc ChangeType}
- * @internal
+ * @alpha
  */
 export declare enum ChangeTypeInternal {
     Insert = 0,
@@ -244,7 +243,7 @@ export declare enum ChangeTypeInternal {
  * Events emitted by `Checkout` are documented in {@link CheckoutEvent}.
  * Exceptions thrown during event handling will be emitted as error events, which are automatically surfaced as error events on the
  * `SharedTree` used at construction time.
- * @internal
+ * @alpha
  */
 export declare abstract class Checkout extends EventEmitterWithErrorHandling<ICheckoutEvents> implements IDisposable {
     /**
@@ -400,7 +399,7 @@ export declare abstract class Checkout extends EventEmitterWithErrorHandling<ICh
 
 /**
  * An event emitted by a `Checkout` to indicate a state change. See {@link ICheckoutEvents} for event argument information.
- * @internal
+ * @alpha
  */
 export declare enum CheckoutEvent {
     /**
@@ -443,13 +442,13 @@ export declare enum CheckoutEvent {
  * IFluidHandle instances (detected via JavaScript feature detection pattern) are only compared by absolutePath.
  *
  * TODO:#54095: Is there a better way to do this comparison?
- * @internal
+ * @alpha
  */
 export declare function comparePayloads(a: Payload, b: Payload): boolean;
 
 /**
  * An identifier (UUID) that has been shortened by a distributed compression algorithm.
- * @internal
+ * @alpha
  */
 export declare type CompressedId = FinalCompressedId | LocalCompressedId;
 
@@ -459,7 +458,7 @@ export declare type CompressedId = FinalCompressedId | LocalCompressedId;
  * non-semantic ways. It is processed in order like any other Change in an Edit. It can cause an edit to fail if the
  * various constraints are not met at the time of evaluation (ex: the parentNode has changed due to concurrent editing).
  * Does not modify the document.
- * @internal
+ * @alpha
  */
 export declare interface Constraint {
     /**
@@ -510,7 +509,7 @@ export declare interface Constraint {
 
 /**
  * What to do when a Constraint is violated.
- * @internal
+ * @alpha
  */
 export declare enum ConstraintEffect {
     /**
@@ -531,7 +530,7 @@ export declare enum ConstraintEffect {
 
 /**
  * {@inheritdoc Constraint}
- * @internal
+ * @alpha
  */
 export declare interface ConstraintInternal extends Omit<ConstraintInternal_0_0_2, 'toConstrain' | 'parentNode'> {
     /** {@inheritdoc Constraint.toConstrain } */
@@ -542,7 +541,7 @@ export declare interface ConstraintInternal extends Omit<ConstraintInternal_0_0_
 
 /**
  * {@inheritdoc Constraint}
- * @internal
+ * @alpha
  */
 export declare interface ConstraintInternal_0_0_2 {
     /** {@inheritdoc Constraint.toConstrain } */
@@ -566,7 +565,7 @@ export declare interface ConstraintInternal_0_0_2 {
 /**
  * Definition.
  * A full (Uuid) persistable definition.
- * @internal
+ * @alpha
  */
 export declare type Definition = UuidString & {
     readonly Definition: 'c0ef9488-2a78-482d-aeed-37fba996354c';
@@ -574,7 +573,7 @@ export declare type Definition = UuidString & {
 
 /**
  * Differences from one forest to another.
- * @internal
+ * @alpha
  */
 export declare interface Delta<NodeId> {
     /**
@@ -596,7 +595,7 @@ export declare interface Delta<NodeId> {
  * If a destination is specified, the detached sequence is associated with that ID and held for possible reuse
  * by later changes in this same Edit (such as by an Insert).
  * A Detach without a destination is a deletion of the specified sequence, as is a Detach with a destination that is not used later.
- * @internal
+ * @alpha
  */
 export declare interface Detach {
     readonly destination?: number;
@@ -610,7 +609,7 @@ export declare interface Detach {
  * Within a given Edit, any DetachedSequenceId must be a source at most once, and a destination at most once.
  * If used as a source, it must be after it is used as a destination.
  * If this is violated, the Edit is considered malformed.
- * @internal
+ * @alpha
  */
 export declare type DetachedSequenceId = number & {
     readonly DetachedSequenceId: 'f7d7903a-194e-45e7-8e82-c9ef4333577d';
@@ -618,7 +617,7 @@ export declare type DetachedSequenceId = number & {
 
 /**
  * {@inheritdoc Detach}
- * @internal
+ * @alpha
  */
 export declare interface DetachInternal extends Omit<DetachInternal_0_0_2, 'source'> {
     /** {@inheritdoc Detach.source } */
@@ -627,7 +626,7 @@ export declare interface DetachInternal extends Omit<DetachInternal_0_0_2, 'sour
 
 /**
  * {@inheritdoc Detach}
- * @internal
+ * @alpha
  */
 export declare interface DetachInternal_0_0_2 {
     /** {@inheritdoc Detach.destination } */
@@ -642,7 +641,7 @@ export declare interface DetachInternal_0_0_2 {
  * Checkout that always stays up to date with the SharedTree.
  * This means that {@link EagerCheckout.waitForPendingUpdates} is always a no-op since EagerCheckout is always up to date.
  * @sealed
- * @internal
+ * @alpha
  */
 export declare class EagerCheckout extends Checkout {
     /**
@@ -657,7 +656,7 @@ export declare class EagerCheckout extends Checkout {
 /**
  * A collection of changes to the tree that are applied atomically along with a unique identifier for the edit.
  * If any individual change fails to apply, the entire Edit will fail to apply.
- * @internal
+ * @alpha
  */
 export declare interface Edit<TChange> extends EditBase<TChange> {
     /**
@@ -669,7 +668,7 @@ export declare interface Edit<TChange> extends EditBase<TChange> {
 
 /**
  * The outcome of an edit.
- * @internal
+ * @alpha
  */
 export declare type EditApplicationOutcome = {
     /**
@@ -693,7 +692,7 @@ export declare type EditApplicationOutcome = {
 
 /**
  * The information included in an edit.
- * @internal
+ * @alpha
  */
 export declare interface EditBase<TChange> {
     /**
@@ -710,7 +709,7 @@ export declare interface EditBase<TChange> {
 
 /**
  * The arguments included when the EditCommitted SharedTreeEvent is emitted.
- * @internal
+ * @alpha
  */
 export declare interface EditCommittedEventArguments {
     /** The ID of the edit committed. */
@@ -723,7 +722,7 @@ export declare interface EditCommittedEventArguments {
 
 /**
  * Expected type for a handler of the `EditCommitted` event.
- * @internal
+ * @alpha
  */
 export declare type EditCommittedHandler = (args: EditCommittedEventArguments) => void;
 
@@ -740,7 +739,7 @@ export declare interface EditHandle<TChange> {
 
 /**
  * Edit identifier
- * @internal
+ * @alpha
  */
 export declare type EditId = UuidString & {
     readonly EditId: '56897beb-53e4-4e66-85da-4bf5cd5d0d49';
@@ -754,7 +753,7 @@ export declare type EditingResult = FailedEditingResult | ValidEditingResult;
 
 /**
  * Basic result of applying a transaction.
- * @internal
+ * @alpha
  */
 export declare interface EditingResultBase {
     /**
@@ -803,7 +802,7 @@ export declare interface EditLogSummary<TChange, THandle> {
 
 /**
  * The status code of an attempt to apply the changes in an Edit.
- * @internal
+ * @alpha
  */
 export declare enum EditStatus {
     /**
@@ -825,7 +824,7 @@ export declare enum EditStatus {
 
 /**
  * The result of validation of an Edit.
- * @internal
+ * @alpha
  */
 export declare enum EditValidationResult {
     /**
@@ -906,7 +905,7 @@ export declare interface FailingTransactionState extends TransactionFailure {
  * A compressed ID that is local to a document. Stable across all revisions of a document starting from the one in which it was created.
  * It should not be persisted outside of the history as it can only be decompressed in the context of the originating document.
  * If external persistence is needed (e.g. by a client), a StableId should be used instead.
- * @internal
+ * @alpha
  */
 export declare type FinalCompressedId = number & {
     readonly FinalCompressedId: '5d83d1e2-98b7-4e4e-a889-54c855cfa73d';
@@ -928,7 +927,7 @@ export declare interface FluidEditHandle {
 /**
  * An immutable forest of ForestNode.
  * Enforces single parenting, and allows querying the parent.
- * @internal
+ * @alpha
  */
 export declare class Forest {
     /**
@@ -1039,7 +1038,7 @@ export declare class Forest {
 
 /**
  * A node that can be contained within a Forest
- * @internal
+ * @alpha
  */
 export declare interface ForestNode extends NodeData<NodeId> {
     readonly traits: ReadonlyMap<TraitLabel, readonly NodeId[]>;
@@ -1168,7 +1167,7 @@ export declare function getTraitLocationOfRange(view: TreeView, range: StableRan
 
 /**
  * An object which may have traits with children of the given type underneath it
- * @internal
+ * @alpha
  */
 export declare interface HasTraits<TChild> {
     readonly traits: TraitMap<TChild>;
@@ -1176,7 +1175,7 @@ export declare interface HasTraits<TChild> {
 
 /**
  * An object which may have traits with children of the given type underneath it
- * @internal
+ * @alpha
  */
 export declare interface HasVariadicTraits<TChild> {
     readonly traits?: {
@@ -1186,7 +1185,7 @@ export declare interface HasVariadicTraits<TChild> {
 
 /**
  * Events which may be emitted by `Checkout`. See {@link CheckoutEvent} for documentation of event semantics.
- * @internal
+ * @alpha
  */
 export declare interface ICheckoutEvents extends IErrorEvent {
     (event: 'viewChange', listener: (before: TreeView, after: TreeView) => void): any;
@@ -1206,14 +1205,14 @@ export declare interface IMigrationEvent extends IEvent {
 
 /**
  * The initial tree.
- * @internal
+ * @alpha
  */
 export declare const initialTree: ChangeNode_0_0_2;
 
 /**
  * Inserts a sequence of nodes at the specified destination.
  * The source can be constructed either by a Build (used to insert new nodes) or a Detach (amounts to a "move" operation).
- * @internal
+ * @alpha
  */
 export declare interface Insert {
     readonly destination: StablePlace;
@@ -1223,7 +1222,7 @@ export declare interface Insert {
 
 /**
  * {@inheritdoc (Insert:interface)}
- * @internal
+ * @alpha
  */
 export declare interface InsertInternal extends Omit<InsertInternal_0_0_2, 'destination'> {
     /** {@inheritdoc (Insert:interface).destination } */
@@ -1232,7 +1231,7 @@ export declare interface InsertInternal extends Omit<InsertInternal_0_0_2, 'dest
 
 /**
  * {@inheritdoc (Insert:interface)}
- * @internal
+ * @alpha
  */
 export declare interface InsertInternal_0_0_2 {
     /** {@inheritdoc (Insert:interface).destination } */
@@ -1247,7 +1246,7 @@ export declare interface InsertInternal_0_0_2 {
  * This type should be used as an opaque handle in the public API for `ChangeInternal` objects.
  * This is useful for supporting public APIs which involve working with a tree's edit history,
  * which will involve changes that have already been internalized.
- * @internal
+ * @alpha
  */
 export declare interface InternalizedChange {
     InternalChangeBrand: '2cae1045-61cf-4ef7-a6a3-8ad920cb7ab3';
@@ -1269,7 +1268,7 @@ export declare function isDetachedSequenceId(node: DetachedSequenceId | object):
 
 /**
  * Events which may be emitted by `SharedTree`. See {@link SharedTreeEvent} for documentation of event semantics.
- * @internal
+ * @alpha
  */
 export declare interface ISharedTreeEvents extends ISharedObjectEvents {
     (event: 'committedEdit', listener: EditCommittedHandler): any;
@@ -1315,7 +1314,7 @@ export declare class LazyCheckout extends Checkout {
  * A compressed ID that is local to a session (can only be decompressed when paired with a SessionId).
  * It should not be persisted outside of the history as it can only be decompressed in the context of the originating session.
  * If external persistence is needed (e.g. by a client), a StableId should be used instead.
- * @internal
+ * @alpha
  */
 export declare type LocalCompressedId = number & {
     readonly LocalCompressedId: '6fccb42f-e2a4-4243-bd29-f13d12b9c6d1';
@@ -1323,7 +1322,7 @@ export declare type LocalCompressedId = number & {
 
 /**
  * Creates `RevisionView`s for the revisions in an `EditLog`
- * @internal
+ * @alpha
  */
 export declare interface LogViewer {
     /**
@@ -1539,7 +1538,7 @@ export declare class MigrationShim extends EventEmitterWithErrorHandling<IMigrat
     private readonly legacyTreeFactory;
     private readonly newTreeFactory;
     private readonly populateNewSharedObjectFn;
-    constructor(id: string, runtime: IFluidDataStoreRuntime, legacyTreeFactory: SharedTreeFactory, newTreeFactory: TreeFactory, populateNewSharedObjectFn: (legacyTree: SharedTree, newTree: ITree) => void);
+    constructor(id: string, runtime: IFluidDataStoreRuntime, legacyTreeFactory: SharedTreeFactory, newTreeFactory: IChannelFactory, populateNewSharedObjectFn: (legacyTree: SharedTree, newTree: ITree) => void);
     private readonly processMigrateOp;
     private readonly migrationDeltaHandler;
     private services?;
@@ -1607,7 +1606,7 @@ export declare class MigrationShimFactory implements IChannelFactory {
     private readonly oldFactory;
     private readonly newFactory;
     private readonly populateNewChannelFn;
-    constructor(oldFactory: SharedTreeFactory, newFactory: TreeFactory, populateNewChannelFn: (oldChannel: SharedTree, newChannel: ITree) => void);
+    constructor(oldFactory: SharedTreeFactory, newFactory: IChannelFactory, populateNewChannelFn: (oldChannel: SharedTree, newChannel: ITree) => void);
     /**
      * This factory takes over the type of the oldFactory to load in its place.  The user must not include the MigrationShimFactory and the oldFactory in the same registry to avoid conflict.
      *
@@ -1639,7 +1638,7 @@ export declare class MigrationShimFactory implements IChannelFactory {
 
 /**
  * The fields required by a node in a tree
- * @internal
+ * @alpha
  */
 export declare interface NodeData<TId> {
     /**
@@ -1661,12 +1660,12 @@ export declare interface NodeData<TId> {
 /**
  * Node identifier.
  * Identifies a node within a document.
- * @internal
+ * @alpha
  */
 export declare type NodeId = number & SessionSpaceCompressedId & NodeIdBrand;
 
 /**
- * @internal
+ * @alpha
  */
 export declare interface NodeIdBrand {
     readonly NodeId: 'e53e7d6b-c8b9-431a-8805-4843fc639342';
@@ -1674,14 +1673,14 @@ export declare interface NodeIdBrand {
 
 /**
  * An object which can generate node IDs and convert node IDs between compressed and stable variants
- * @internal
+ * @alpha
  */
 export declare interface NodeIdContext extends NodeIdGenerator, NodeIdConverter {
 }
 
 /**
  * An object which can convert node IDs between compressed and stable variants
- * @internal
+ * @alpha
  */
 export declare interface NodeIdConverter {
     /**
@@ -1717,7 +1716,7 @@ export declare interface NodeIdConverter {
 
 /**
  * An object which can generate node IDs
- * @internal
+ * @alpha
  */
 export declare interface NodeIdGenerator {
     /**
@@ -1747,7 +1746,7 @@ export declare interface NodeInTrait {
  * An ordered set of Edits associated with a SharedTree.
  * Supports fast lookup of edits by ID and enforces idempotence.
  * @sealed
- * @internal
+ * @alpha
  */
 export declare interface OrderedEditSet<TChange = unknown> {
     /**
@@ -1797,7 +1796,7 @@ export declare interface OrderedEditSet<TChange = unknown> {
 
 /**
  * Information about a ForestNode's parent
- * @internal
+ * @alpha
  */
 export declare interface ParentData {
     readonly parentId: NodeId;
@@ -1812,7 +1811,7 @@ export declare interface ParentData {
  * See {@link comparePayloads} for equality semantics and related details (like what is allowed to be lost when serializing)
  *
  * TODO:#51984: Allow opting into heuristic blobbing in snapshots with a special IFluid key.
- * @internal
+ * @alpha
  */
 export declare type Payload = any;
 
@@ -1833,7 +1832,7 @@ export declare type PlaceholderTree<TPlaceholder = never> = TreeNode<Placeholder
  * 0 = before all nodes,
  * 1 = after first node,
  * etc.
- * @internal
+ * @alpha
  */
 export declare type PlaceIndex = number & {
     readonly PlaceIndex: unique symbol;
@@ -1841,7 +1840,7 @@ export declare type PlaceIndex = number & {
 
 /**
  * The result of validating a place.
- * @internal
+ * @alpha
  */
 export declare enum PlaceValidationResult {
     Valid = "Valid",
@@ -1859,7 +1858,7 @@ export declare function rangeFromStableRange(view: TreeView, range: StableRange)
 
 /**
  * The result of validating a range.
- * @internal
+ * @alpha
  */
 export declare type RangeValidationResult = RangeValidationResultKind.Valid | RangeValidationResultKind.PlacesInDifferentTraits | RangeValidationResultKind.Inverted | {
     kind: RangeValidationResultKind.BadPlace;
@@ -1869,7 +1868,7 @@ export declare type RangeValidationResult = RangeValidationResultKind.Valid | Ra
 
 /**
  * The kinds of result of validating a range.
- * @internal
+ * @alpha
  */
 export declare enum RangeValidationResultKind {
     Valid = "Valid",
@@ -1880,7 +1879,7 @@ export declare enum RangeValidationResultKind {
 
 /**
  * A change in the `ReconciliationPath`.
- * @internal
+ * @alpha
  */
 export declare interface ReconciliationChange {
     /**
@@ -1896,7 +1895,7 @@ export declare interface ReconciliationChange {
 
 /**
  * An edit in the `ReconciliationPath`.
- * @internal
+ * @alpha
  */
 export declare interface ReconciliationEdit {
     /**
@@ -1923,7 +1922,7 @@ export declare interface ReconciliationEdit {
  * change is actually applied.
  * The path only contains edits that were successfully applied.
  * This path is always empty for a change that has no concurrent edits.
- * @internal
+ * @alpha
  */
 export declare interface ReconciliationPath {
     /**
@@ -2024,13 +2023,13 @@ export declare namespace Result {
  * - revision 0 corresponds to the initialRevision.
  *
  * - revision 1 corresponds to the output of editLog[0] applied to the initialRevision.
- * @internal
+ * @alpha
  */
 export declare type Revision = number;
 
 /**
  * An immutable view of a distributed tree.
- * @internal
+ * @alpha
  */
 export declare class RevisionView extends TreeView {
     /**
@@ -2053,7 +2052,7 @@ export declare class RevisionView extends TreeView {
 
 /**
  * The arguments included when the {@link SharedTreeEvent.SequencedEditApplied} SharedTreeEvent is emitted.
- * @internal
+ * @alpha
  */
 export declare interface SequencedEditAppliedEventArguments {
     /** The ID of the edit committed. */
@@ -2072,7 +2071,7 @@ export declare interface SequencedEditAppliedEventArguments {
 
 /**
  * Expected type for a handler of the {@link SharedTreeEvent.SequencedEditApplied} event.
- * @internal
+ * @alpha
  */
 export declare type SequencedEditAppliedHandler = (args: SequencedEditAppliedEventArguments) => void;
 
@@ -2080,13 +2079,13 @@ export declare type SequencedEditAppliedHandler = (args: SequencedEditAppliedEve
  * A compressed ID that has been normalized into "session space" (see `IdCompressor` for more).
  * Consumer-facing APIs and data structures should use session-space IDs as their lifetime and equality is stable and tied to the
  * compressor that produced them.
- * @internal
+ * @alpha
  */
 export declare type SessionSpaceCompressedId = CompressedId & SessionUnique;
 
 /**
  * A brand for identity types that are unique within a particular session (SharedTree instance).
- * @internal
+ * @alpha
  */
 export declare interface SessionUnique {
     readonly SessionUnique: 'cea55054-6b82-4cbf-ad19-1fa645ea3b3e';
@@ -2100,7 +2099,7 @@ export declare function setTrait(trait: TraitLocation, nodes: BuildNode | TreeNo
 
 /**
  * Modifies the payload of a node.
- * @internal
+ * @alpha
  */
 export declare interface SetValue {
     readonly nodeToModify: NodeId;
@@ -2116,7 +2115,7 @@ export declare interface SetValue {
 
 /**
  * {@inheritdoc SetValue}
- * @internal
+ * @alpha
  */
 export declare interface SetValueInternal extends Omit<SetValueInternal_0_0_2, 'nodeToModify'> {
     /** {@inheritdoc SetValue.nodeToModify } */
@@ -2125,7 +2124,7 @@ export declare interface SetValueInternal extends Omit<SetValueInternal_0_0_2, '
 
 /**
  * {@inheritdoc SetValue}
- * @internal
+ * @alpha
  */
 export declare interface SetValueInternal_0_0_2 {
     /** {@inheritdoc SetValue.nodeToModify } */
@@ -2138,7 +2137,7 @@ export declare interface SetValueInternal_0_0_2 {
 
 /**
  * A [distributed tree](../Readme.md).
- * @internal
+ * @alpha
  */
 export declare class SharedTree extends SharedObject<ISharedTreeEvents> implements NodeIdContext {
     private writeFormat;
@@ -2439,7 +2438,7 @@ export declare class SharedTree extends SharedObject<ISharedTreeEvents> implemen
 
 /**
  * The write format and associated options used to construct a `SharedTree`
- * @internal
+ * @alpha
  */
 export declare type SharedTreeArgs<WF extends WriteFormat = WriteFormat> = [writeFormat: WF, options?: SharedTreeOptions<WF>];
 
@@ -2455,7 +2454,7 @@ export declare const sharedTreeAssertionErrorType = "SharedTreeAssertion";
 
 /**
  * Configuration options for SharedTree that are independent of write format versions.
- * @internal
+ * @alpha
  */
 export declare interface SharedTreeBaseOptions {
     /**
@@ -2523,7 +2522,7 @@ export declare enum SharedTreeDiagnosticEvent {
 /**
  * An event emitted by a `SharedTree` to indicate a state change. See {@link ISharedTreeEvents} for event
  * argument information.
- * @internal
+ * @alpha
  */
 export declare enum SharedTreeEvent {
     /**
@@ -2565,7 +2564,7 @@ export declare enum SharedTreeEvent {
 /**
  * Factory for SharedTree.
  * Includes history in the summary.
- * @internal
+ * @alpha
  */
 export declare class SharedTreeFactory implements IChannelFactory {
     /**
@@ -2671,13 +2670,13 @@ export declare class SharedTreeMergeHealthTelemetryHeartbeat {
 
 /**
  * The type of shared tree options for a given write format
- * @internal
+ * @alpha
  */
 export declare type SharedTreeOptions<WF extends WriteFormat, HistoryCompatibility extends 'Forwards' | 'None' = 'Forwards'> = SharedTreeBaseOptions & Omit<WF extends WriteFormat.v0_0_2 ? SharedTreeOptions_0_0_2 : WF extends WriteFormat.v0_1_1 ? SharedTreeOptions_0_1_1 : never, HistoryCompatibility extends 'Forwards' ? 'summarizeHistory' : never>;
 
 /**
  * Configuration options for a SharedTree with write format 0.0.2
- * @internal
+ * @alpha
  */
 export declare interface SharedTreeOptions_0_0_2 {
     /**
@@ -2699,7 +2698,7 @@ export declare interface SharedTreeOptions_0_0_2 {
 
 /**
  * Configuration options for a SharedTree with write format 0.1.1
- * @internal
+ * @alpha
  */
 export declare interface SharedTreeOptions_0_1_1 {
     /**
@@ -2737,8 +2736,8 @@ export declare interface SharedTreeOptions_0_1_1 {
 export declare class SharedTreeShim implements IShim {
     readonly id: string;
     readonly runtime: IFluidDataStoreRuntime;
-    readonly sharedTreeFactory: TreeFactory;
-    constructor(id: string, runtime: IFluidDataStoreRuntime, sharedTreeFactory: TreeFactory);
+    readonly sharedTreeFactory: IChannelFactory;
+    constructor(id: string, runtime: IFluidDataStoreRuntime, sharedTreeFactory: IChannelFactory);
     private readonly newTreeShimDeltaHandler;
     private services?;
     private _currentTree?;
@@ -2771,7 +2770,7 @@ export declare class SharedTreeShim implements IShim {
  */
 export declare class SharedTreeShimFactory implements IChannelFactory {
     private readonly factory;
-    constructor(factory: TreeFactory);
+    constructor(factory: IChannelFactory);
     /**
      * Can only load the new SharedTree - this allows our snapshots to be simple. We do not have to consider any new
      * unique snapshot formats and how to load from them.
@@ -2803,7 +2802,7 @@ export declare class SharedTreeShimFactory implements IChannelFactory {
 
 /**
  * The minimal information on a SharedTree summary. Contains the summary format version.
- * @internal
+ * @alpha
  */
 export declare interface SharedTreeSummaryBase {
     /**
@@ -2829,7 +2828,7 @@ export declare interface SharedTreeSummaryBase {
  * Each place can be specified, (aka 'anchored') in two ways (relative to the sibling before or after):
  * the choice of which way to anchor a place only matters when the kept across an edit, and thus evaluated in multiple contexts where the
  * two place description may no longer evaluate to the same place.
- * @internal
+ * @alpha
  */
 export declare enum Side {
     Before = 0,
@@ -2839,7 +2838,7 @@ export declare enum Side {
 /**
  * Globally unique node identifier.
  * Uniquely identifies a node within and across documents. Can be used across SharedTree instances.
- * @internal
+ * @alpha
  */
 export declare type StableNodeId = string & {
     readonly StableNodeId: 'a0843b38-699d-4bb2-aa7a-16c502a71151';
@@ -2867,7 +2866,7 @@ export declare type StableNodeId = string & {
  * StablePlace.before(node)
  * StablePlace.atStartOf(trait)
  * ```
- * @internal
+ * @alpha
  */
 export declare interface StablePlace {
     /**
@@ -2889,7 +2888,7 @@ export declare interface StablePlace {
 }
 
 /**
- * @internal
+ * @alpha
  */
 export declare const StablePlace: {
     /**
@@ -2912,7 +2911,7 @@ export declare const StablePlace: {
 
 /**
  * {@inheritdoc (StablePlace:interface) }
- * @internal
+ * @alpha
  */
 export declare interface StablePlaceInternal extends Omit<StablePlaceInternal_0_0_2, 'referenceSibling' | 'referenceTrait'> {
     /**
@@ -2926,7 +2925,7 @@ export declare interface StablePlaceInternal extends Omit<StablePlaceInternal_0_
 }
 
 /**
- * @internal
+ * @alpha
  */
 export declare const StablePlaceInternal: {
     /**
@@ -2949,7 +2948,7 @@ export declare const StablePlaceInternal: {
 
 /**
  * {@inheritdoc (StablePlace:interface) }
- * @internal
+ * @alpha
  */
 export declare interface StablePlaceInternal_0_0_2 {
     /**
@@ -2981,7 +2980,7 @@ export declare interface StablePlaceInternal_0_0_2 {
  * ```typescript
  * StableRange.from(StablePlace.before(startNode)).to(StablePlace.after(endNode))
  * ```
- * @internal
+ * @alpha
  */
 export declare interface StableRange {
     readonly start: StablePlace;
@@ -2989,7 +2988,7 @@ export declare interface StableRange {
 }
 
 /**
- * @internal
+ * @alpha
  */
 export declare const StableRange: {
     /**
@@ -3019,7 +3018,7 @@ export declare const StableRange: {
 
 /**
  * {@inheritdoc (StableRange:interface) }
- * @internal
+ * @alpha
  */
 export declare interface StableRangeInternal {
     /** {@inheritdoc (StableRange:interface).start } */
@@ -3029,7 +3028,7 @@ export declare interface StableRangeInternal {
 }
 
 /**
- * @internal
+ * @alpha
  */
 export declare const StableRangeInternal: {
     /**
@@ -3059,7 +3058,7 @@ export declare const StableRangeInternal: {
 
 /**
  * {@inheritdoc (StableRange:interface) }
- * @internal
+ * @alpha
  */
 export declare interface StableRangeInternal_0_0_2 {
     /** {@inheritdoc (StableRange:interface).start } */
@@ -3070,7 +3069,7 @@ export declare interface StableRangeInternal_0_0_2 {
 
 /**
  * Contains information resulting from processing stashed shared tree ops
- * @internal
+ * @alpha
  */
 export declare interface StashedLocalOpMetadata {
     /** A modified version of the edit in an edit op that should be resubmitted rather than the original edit */
@@ -3089,7 +3088,7 @@ export declare interface StringInterner {
 
 /**
  * The state of a transaction that has not encountered an error.
- * @internal
+ * @alpha
  */
 export declare interface SucceedingTransactionState {
     /**
@@ -3113,7 +3112,7 @@ export declare interface SucceedingTransactionState {
 /**
  * Definition.
  * A full (Uuid) persistable label for a trait.
- * @internal
+ * @alpha
  */
 export declare type TraitLabel = UuidString & {
     readonly TraitLabel: '613826ed-49cc-4df3-b2b8-bfc6866af8e3';
@@ -3121,7 +3120,7 @@ export declare type TraitLabel = UuidString & {
 
 /**
  * Specifies the location of a trait (a labeled sequence of nodes) within the tree.
- * @internal
+ * @alpha
  */
 export declare interface TraitLocation {
     readonly parent: NodeId;
@@ -3130,7 +3129,7 @@ export declare interface TraitLocation {
 
 /**
  * Specifies the location of a trait (a labeled sequence of nodes) within the tree.
- * @internal
+ * @alpha
  */
 export declare interface TraitLocationInternal extends Omit<TraitLocationInternal_0_0_2, 'parent'> {
     readonly parent: NodeId;
@@ -3138,7 +3137,7 @@ export declare interface TraitLocationInternal extends Omit<TraitLocationInterna
 
 /**
  * Specifies the location of a trait (a labeled sequence of nodes) within the tree.
- * @internal
+ * @alpha
  */
 export declare interface TraitLocationInternal_0_0_2 {
     readonly parent: StableNodeId;
@@ -3149,7 +3148,7 @@ export declare interface TraitLocationInternal_0_0_2 {
  * Json compatible map as object.
  * Keys are TraitLabels,
  * Values are the content of the trait specified by the key.
- * @internal
+ * @alpha
  */
 export declare interface TraitMap<TChild> {
     readonly [key: string]: TreeNodeSequence<TChild>;
@@ -3160,7 +3159,7 @@ export declare interface TraitMap<TChild> {
  * 0 = first node,
  * 1 = second node,
  * etc.
- * @internal
+ * @alpha
  */
 export declare type TraitNodeIndex = number & {
     readonly TraitNodeIndex: unique symbol;
@@ -3169,7 +3168,7 @@ export declare type TraitNodeIndex = number & {
 /**
  * Buffers changes to be applied to an isolated view of a `SharedTree` over time before applying them directly to the tree itself as a
  * single edit
- * @internal
+ * @alpha
  */
 export declare class Transaction extends TypedEventEmitter<TransactionEvents> {
     readonly tree: SharedTree;
@@ -3214,7 +3213,7 @@ export declare class Transaction extends TypedEventEmitter<TransactionEvents> {
 
 /**
  * An event emitted by a `Transaction` to indicate a state change. See {@link TransactionEvents} for event argument information.
- * @internal
+ * @alpha
  */
 export declare enum TransactionEvent {
     /**
@@ -3225,7 +3224,7 @@ export declare enum TransactionEvent {
 
 /**
  * Events which may be emitted by `Transaction`
- * @internal
+ * @alpha
  */
 export declare interface TransactionEvents extends IErrorEvent {
     (event: TransactionEvent.ViewChange, listener: (before: TreeView, after: TreeView) => void): any;
@@ -3258,7 +3257,7 @@ export declare interface TransactionFailure {
  *
  * No data outside the Transaction is modified by Transaction:
  * the results from `close` must be used to actually submit an `Edit`.
- * @internal
+ * @alpha
  */
 export declare namespace TransactionInternal {
     /**
@@ -3315,7 +3314,7 @@ export declare namespace TransactionInternal {
     }
     /**
      * The kinds of failures that a transaction might encounter.
-     * @internal
+     * @alpha
      */
     export enum FailureKind {
         /**
@@ -3357,12 +3356,12 @@ export declare namespace TransactionInternal {
     }
     /**
      * A failure encountered by a transaction.
-     * @internal
+     * @alpha
      */
     export type Failure = UnusedDetachedSequenceFailure | DetachedSequenceIdAlreadyInUseFailure | DetachedSequenceNotFoundFailure | DuplicateIdInBuildFailure | IdAlreadyInUseFailure | UnknownIdFailure | BadPlaceFailure | BadRangeFailure | ConstraintViolationFailure;
     /**
      * Error returned when a transaction is closed while there is an unused detached sequence.
-     * @internal
+     * @alpha
      */
     export interface UnusedDetachedSequenceFailure {
         /**
@@ -3376,7 +3375,7 @@ export declare namespace TransactionInternal {
     }
     /**
      * Error thrown when a transaction encounters a build operation using an already in use DetachedSequenceID.
-     * @internal
+     * @alpha
      */
     export interface DetachedSequenceIdAlreadyInUseFailure {
         /**
@@ -3394,7 +3393,7 @@ export declare namespace TransactionInternal {
     }
     /**
      * Error thrown when a transaction tries to operate on an unknown DetachedSequenceID
-     * @internal
+     * @alpha
      */
     export interface DetachedSequenceNotFoundFailure {
         /**
@@ -3412,7 +3411,7 @@ export declare namespace TransactionInternal {
     }
     /**
      * Error thrown when a build uses a duplicated NodeId
-     * @internal
+     * @alpha
      */
     export interface DuplicateIdInBuildFailure {
         /**
@@ -3430,7 +3429,7 @@ export declare namespace TransactionInternal {
     }
     /**
      * Error thrown when a build node ID is already used in the current state
-     * @internal
+     * @alpha
      */
     export interface IdAlreadyInUseFailure {
         /**
@@ -3448,7 +3447,7 @@ export declare namespace TransactionInternal {
     }
     /**
      * Error thrown when a change is attempted on an unknown NodeId
-     * @internal
+     * @alpha
      */
     export interface UnknownIdFailure {
         /**
@@ -3466,7 +3465,7 @@ export declare namespace TransactionInternal {
     }
     /**
      * Error thrown when an insert change uses an invalid Place
-     * @internal
+     * @alpha
      */
     export interface BadPlaceFailure {
         /**
@@ -3488,7 +3487,7 @@ export declare namespace TransactionInternal {
     }
     /**
      * Error thrown when a detach operation is given an invalid or malformed Range
-     * @internal
+     * @alpha
      */
     export interface BadRangeFailure {
         /**
@@ -3510,7 +3509,7 @@ export declare namespace TransactionInternal {
     }
     /**
      * Error thrown when a constraint fails to apply
-     * @internal
+     * @alpha
      */
     export interface ConstraintViolationFailure {
         /**
@@ -3528,7 +3527,7 @@ export declare namespace TransactionInternal {
     }
     /**
      * The details of what kind of constraint was violated and caused a ConstraintViolationFailure error to occur
-     * @internal
+     * @alpha
      */
     export type ConstraintViolationResult = {
         readonly kind: ConstraintViolationKind.BadRange;
@@ -3545,7 +3544,7 @@ export declare namespace TransactionInternal {
     };
     /**
      * Enum of possible kinds of constraint violations that can be encountered
-     * @internal
+     * @alpha
      */
     export enum ConstraintViolationKind {
         /**
@@ -3576,7 +3575,7 @@ export declare type TransactionState = SucceedingTransactionState | FailingTrans
 
 /**
  * An view of a distributed tree that is part of an ongoing transaction between `RevisionView`s.
- * @internal
+ * @alpha
  */
 export declare class TransactionView extends TreeView {
     /** Conclude a transaction by generating an immutable `RevisionView` from this view */
@@ -3610,7 +3609,7 @@ export declare class TransactionView extends TreeView {
 
 /**
  * Satisfies `NodeData` and may contain children under traits (which may or may not be `TreeNodes`)
- * @internal
+ * @alpha
  */
 export declare interface TreeNode<TChild, TId> extends NodeData<TId>, HasTraits<TChild> {
 }
@@ -3638,13 +3637,13 @@ export declare class TreeNodeHandle implements TreeNode<TreeNodeHandle, NodeId>
 
 /**
  * A sequence of Nodes that make up a trait under a Node
- * @internal
+ * @alpha
  */
 export declare type TreeNodeSequence<TChild> = readonly TChild[];
 
 /**
  * A view of a distributed tree.
- * @internal
+ * @alpha
  */
 export declare abstract class TreeView {
     readonly root: NodeId;
@@ -3738,7 +3737,7 @@ export declare abstract class TreeView {
 
 /**
  * An immutable view of a distributed tree node.
- * @internal
+ * @alpha
  */
 export declare interface TreeViewNode extends NodeData<NodeId> {
     /** The IDs of the children under this node */
@@ -3750,7 +3749,7 @@ export declare interface TreeViewNode extends NodeData<NodeId> {
 /**
  * A place within a particular `TreeView` that is anchored relative to a specific node in the tree, or relative to the outside of the trait.
  * Valid iff 'trait' is valid and, if provided, sibling is in the Location specified by 'trait'.
- * @internal
+ * @alpha
  */
 export declare interface TreeViewPlace {
     readonly sibling?: NodeId;
@@ -3761,7 +3760,7 @@ export declare interface TreeViewPlace {
 /**
  * Specifies the range of nodes from `start` to `end` within a trait within a particular `TreeView`.
  * Valid iff start and end are valid and are within the same trait.
- * @internal
+ * @alpha
  */
 export declare interface TreeViewRange {
     readonly start: TreeViewPlace;
@@ -3785,7 +3784,7 @@ export declare function useFailedSequencedEditTelemetry(tree: SharedTree): {
  * A 128-bit Universally Unique IDentifier. Represented here
  * with a string of the form xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx,
  * where x is a lowercase hex digit.
- * @internal
+ * @alpha
  */
 export declare type UuidString = string & {
     readonly UuidString: '9d40d0ae-90d9-44b1-9482-9f55d59d5465';
@@ -3793,7 +3792,7 @@ export declare type UuidString = string & {
 
 /**
  * Result of applying a valid transaction.
- * @internal
+ * @alpha
  */
 export declare interface ValidEditingResult extends EditingResultBase {
     /**
@@ -3808,7 +3807,7 @@ export declare interface ValidEditingResult extends EditingResultBase {
 
 /**
  * Format versions that SharedTree supports writing. Changes to op or summary formats necessitate updates.
- * @internal
+ * @alpha
  */
 export declare enum WriteFormat {
     /** Stores all edits in their raw format. */