@fluid-experimental/tree 0.58.2002 → 0.59.1000

package/dist/id-compressor/persisted-types/0.0.1.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"0.0.1.js","sourceRoot":"","sources":["../../../src/id-compressor/persisted-types/0.0.1.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nimport type { Serializable } from '@fluidframework/datastore-definitions';\nimport type { FinalCompressedId, LocalCompressedId, OpSpaceCompressedId, SessionId } from '../../Identifiers';\n\n/**\n * Extensible attribution info associated with a session.\n */\nexport type AttributionInfo = Serializable;\n\n/**\n * A serialized ID allocation session for an `IdCompressor`.\n */\nexport type SerializedSessionData = readonly [\n\t/**\n\t * The ID of the session.\n\t */\n\tsessionId: SessionId,\n\n\t/**\n\t * The attribution info provided for the session\n\t */\n\tattributionInfo?: AttributionInfo\n];\n\nexport type SerializedClusterOverrides = readonly [\n\t/** The overridden final ID, represented as an index into the cluster's ID range */\n\toverriddenFinalIndex: number, // A cluster with base UUID '...beef' and an `overriddenFinalIndex` of 3 would correspond to '...bef2'\n\t/** The override string */\n\toverride: string,\n\t/** The first ID that was finalized and associated with this override, set only if different than the `overriddenFinalIndex` */\n\toverriddenId?: FinalCompressedId\n][];\n\n/**\n * A serialized final ID cluster.\n */\nexport type SerializedCluster = readonly [\n\t/**\n\t * Index into the serialized sessions array. Can be converted into a baseUuid via its order in `clusters`.\n\t * If negative, then this cluster was created by the local session.\n\t */\n\tsessionIndex: number,\n\n\t/**\n\t * The capacity of the cluster.\n\t */\n\tcapacity: number,\n\n\t/**\n\t * The number of IDs in the cluster. Omitted if count === capacity.\n\t * --OR--\n\t * The overrides in this cluster. Omitted if no overrides exist in the cluster.\n\t */\n\tcountOrOverrides?: number | SerializedClusterOverrides,\n\n\t/**\n\t * Overrides in this cluster. Omitted if no overrides exist in the cluster.\n\t */\n\toverrides?: SerializedClusterOverrides\n];\n\nexport type SerializedLocalOverrides = readonly [LocalCompressedId, string][];\n\nexport interface SerializedLocalState {\n\t/**\n\t * The total number of local IDs created by this session\n\t */\n\tlocalIdCount: number;\n\t/**\n\t * Overrides generated by this session. Omitted if no local overrides exist in the session.\n\t */\n\toverrides?: SerializedLocalOverrides;\n\n\t/**\n\t * Boolean to track whether attribution has been sent with an ID range yet.\n\t */\n\tsentAttributionInfo: boolean;\n\n\t/**\n\t * The most recent local ID in a range returned by `takeNextCreationRange`.\n\t */\n\tlastTakenLocalId: LocalCompressedId | undefined;\n}\n\n/**\n * The minimal required contents of a serialized IdCompressor.\n */\nexport interface VersionedSerializedIdCompressor {\n\treadonly _versionedSerializedIdCompressor: '8c73c57c-1cf4-4278-8915-6444cb4f6af5';\n\treadonly version: string;\n}\n\n/**\n * The serialized contents of an IdCompressor, suitable for persistence in a summary.\n */\nexport interface SerializedIdCompressor extends VersionedSerializedIdCompressor {\n\t/** The cluster capacity of this compressor */\n\treadonly clusterCapacity: number;\n\t/** The number of reserved IDs in this compressor */\n\treadonly reservedIdCount: number;\n\t/** All sessions except the local session. */\n\treadonly sessions: readonly SerializedSessionData[];\n\t/** All clusters in the compressor in the order they were created. */\n\treadonly clusters: readonly SerializedCluster[];\n}\n\n/**\n * The serialized contents of an IdCompressor, suitable for persistence in a summary.\n */\nexport interface SerializedIdCompressorWithNoSession extends SerializedIdCompressor {\n\treadonly _noLocalState: '3aa2e1e8-cc28-4ea7-bc1a-a11dc3f26dfb';\n}\n\n/**\n * The serialized contents of an IdCompressor, suitable for persistence in a summary.\n */\nexport interface SerializedIdCompressorWithOngoingSession extends SerializedIdCompressor {\n\treadonly _hasLocalState: '1281acae-6d14-47e7-bc92-71c8ee0819cb';\n\t/** The session ID of the local session, by index into `sessions`. */\n\treadonly localSessionIndex: number;\n\t/** This is only present if the local session made any IDs. */\n\treadonly localState?: SerializedLocalState;\n}\n\n/**\n * Data describing a range of session-local IDs (from a remote or local session).\n *\n * A range is composed of local IDs that were generated. Some of these may have overrides.\n *\n * @example\n * Suppose an IdCompressor generated a sequence of local IDs as follows:\n * ```\n * compressor.generateLocalId()\n * compressor.generateLocalId('0093cf29-9454-4034-8940-33b1077b41c3')\n * compressor.generateLocalId()\n * compressor.generateLocalId('0ed545f8-e97e-4dc1-acf9-c4a783258bdf')\n * compressor.generateLocalId()\n * compressor.generateLocalId()\n * compressor.takeNextCreationRange()\n * ```\n * This would result in the following range:\n * ```\n * {\n *     first: localId1,\n *     last: localId6,\n *     overrides: [[localId2, '0093cf29-9454-4034-8940-33b1077b41c3'], [localId4, '0ed545f8-e97e-4dc1-acf9-c4a783258bdf']]\n * }\n * ```\n */\nexport interface IdCreationRange {\n\treadonly sessionId: SessionId;\n\treadonly ids?: IdCreationRange.Ids;\n\treadonly attributionInfo?: AttributionInfo;\n}\n\nexport type UnackedLocalId = LocalCompressedId & OpSpaceCompressedId;\n\nexport namespace IdCreationRange {\n\texport type Ids =\n\t\t| {\n\t\t\t\treadonly first: UnackedLocalId;\n\t\t\t\treadonly last: UnackedLocalId;\n\t\t  }\n\t\t| ({\n\t\t\t\treadonly first?: UnackedLocalId;\n\t\t\t\treadonly last?: UnackedLocalId;\n\t\t  } & HasOverrides);\n\n\texport interface HasOverrides {\n\t\treadonly overrides: Overrides;\n\t}\n\n\texport type Override = readonly [id: UnackedLocalId, override: string];\n\texport type Overrides = readonly [Override, ...Override[]];\n}\n"]}

package/dist/id-compressor/persisted-types/index.d.ts

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

package/dist/id-compressor/persisted-types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/id-compressor/persisted-types/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,SAAS,CAAC"}

package/dist/id-compressor/persisted-types/index.js

@@ -0,0 +1,18 @@
+"use strict";
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[k]; } });
+}) : (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("./0.0.1"), exports);
+//# sourceMappingURL=index.js.map

package/dist/id-compressor/persisted-types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/id-compressor/persisted-types/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;AAEH,0CAAwB","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\nexport * from './0.0.1';\n"]}

package/dist/index.d.ts

@@ -13,15 +13,35 @@
  */
 export { initialTree } from './InitialTree';
 export { TreeNodeHandle } from './TreeNodeHandle';
-export { Delta } from './Forest';
-export { sharedTreeAssertionErrorType, isSharedTreeEvent, comparePayloads } from './Common';
-export * from './Identifiers';
-export { OrderedEditSet, EditLogSummary, EditHandle, EditChunkOrHandle } from './EditLog';
-export { NodeInTrait, PlaceIndex, SnapshotNode, Snapshot, TraitNodeIndex, SnapshotPlace, SnapshotRange, Side, } from './Snapshot';
-export { LogViewer, Revision } from './LogViewer';
+export { Delta, Forest, ForestNode, ParentData } from './Forest';
+export { sharedTreeAssertionErrorType, isSharedTreeEvent, Result } from './Common';
+export type { CompressedId, Definition, DetachedSequenceId, EditId, InternedStringId, FinalCompressedId, LocalCompressedId, NodeId, NodeIdBrand, StableNodeId, SessionSpaceCompressedId, SessionUnique, TraitLabel, UuidString, } from './Identifiers';
+export { isDetachedSequenceId } from './Identifiers';
+export type { OrderedEditSet, EditHandle } from './EditLog';
+export { LogViewer } from './LogViewer';
+export { Revision } from './RevisionValueCache';
 export { Checkout, CheckoutEvent, ICheckoutEvents, EditValidationResult } from './Checkout';
-export { BasicCheckout } from './BasicCheckout';
+export { LazyCheckout } from './LazyCheckout';
+export { EagerCheckout } from './EagerCheckout';
 export * from './ReconciliationPath';
-export { SharedTree, SharedTreeEditor, ChangeType, Change, Build, Insert, Detach, SetValue, Constraint, ConstraintEffect, Delete, Move, StablePlace, StableRange, SharedTreeFactory, revert, setTrait, validateStablePlace, validateStableRange, rangeFromStableRange, placeFromStablePlace, Transaction, isDetachedSequenceId, } from './default-edits';
-export { EditCommittedHandler, EditCommittedEventArguments, ISharedTreeEvents, GenericSharedTree, SharedTreeEvent, SharedTreeDiagnosticEvent, Edit, newEdit, EditWithoutId, EditBase, TraitMap, TreeNodeSequence, Payload, NodeData, TreeNode, ChangeNode, BuildNode, EditStatus, TraitLocation, GenericTransaction, EditingResult, ValidEditingResult, SharedTreeSummarizer, SharedTreeSummary, SharedTreeSummaryBase, } from './generic';
+export * from './MergeHealth';
+export * from './TreeViewUtilities';
+export { StringInterner } from './StringInterner';
+export { Side, EditStatus, TreeNode, TreeNodeSequence, Payload, ConstraintEffect, Edit, ChangeInternal, ChangeNode, ChangeNode_0_0_2, EditLogSummary, FluidEditHandle, SharedTreeSummaryBase, EditWithoutId, PlaceholderTree, EditBase, HasTraits, InsertInternal, DetachInternal, BuildInternal, SetValueInternal, ConstraintInternal, BuildNodeInternal, StablePlaceInternal_0_0_2, StableRangeInternal_0_0_2, NodeData, TraitMap, ChangeTypeInternal, TraitLocationInternal_0_0_2, WriteFormat, ConstraintInternal_0_0_2, StablePlaceInternal, StableRangeInternal, BuildNodeInternal_0_0_2, BuildInternal_0_0_2, InsertInternal_0_0_2, DetachInternal_0_0_2, SetValueInternal_0_0_2, TraitLocationInternal, } from './persisted-types';
+export { SharedTreeFactory, SharedTree, EditCommittedHandler, SequencedEditAppliedHandler, EditCommittedEventArguments, SequencedEditAppliedEventArguments, EditApplicationOutcome, ISharedTreeEvents, } from './SharedTree';
+export * from './EventTypes';
+export { setTrait, areRevisionViewsSemanticallyEqual, BadPlaceValidationResult, BadRangeValidationResult, PlaceValidationResult, RangeValidationResult, RangeValidationResultKind, } from './EditUtilities';
+export { comparePayloads } from './PayloadUtilities';
+export { TransactionInternal, GenericTransaction, GenericTransactionPolicy, EditingResult, EditingResultBase, FailedEditingResult, ValidEditingResult, TransactionState, TransactionFailure, SucceedingTransactionState, FailingTransactionState, ChangeResult, } from './TransactionInternal';
+export { NodeInTrait, PlaceIndex, TreeViewNode, TreeView, TraitNodeIndex, TreeViewPlace, TreeViewRange, TraitLocation, } from './TreeView';
+export { RevisionView, TransactionView } from './RevisionView';
+export { NodeIdContext, NodeIdGenerator, NodeIdConverter } from './NodeIdUtilities';
+export { Transaction } from './Transaction';
+/**
+ * TODO:#61413: Publish test utilities from a separate test package
+ */
+export { 
+/** @deprecated Use `getSerializedUploadedEditChunkContents` instead. */
+getSerializedUploadedEditChunkContents as getUploadedEditChunkContents, getSerializedUploadedEditChunkContents, } from './SummaryTestUtilities';
+export * from './ChangeTypes';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;GAIG;AAEH;;;GAGG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AACjC,OAAO,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC5F,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC1F,OAAO,EACN,WAAW,EACX,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,aAAa,EACb,aAAa,EACb,IAAI,GACJ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC5F,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACN,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,MAAM,EACN,KAAK,EACL,MAAM,EACN,MAAM,EACN,QAAQ,EACR,UAAU,EACV,gBAAgB,EAChB,MAAM,EACN,IAAI,EACJ,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,MAAM,EACN,QAAQ,EACR,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,EACpB,WAAW,EACX,oBAAoB,GACpB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACN,oBAAoB,EACpB,2BAA2B,EAC3B,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,yBAAyB,EACzB,IAAI,EACJ,OAAO,EACP,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,gBAAgB,EAChB,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,SAAS,EACT,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACrB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -14,7 +14,7 @@ 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 });
-exports.GenericTransaction = exports.EditStatus = exports.newEdit = exports.SharedTreeDiagnosticEvent = exports.SharedTreeEvent = exports.GenericSharedTree = exports.isDetachedSequenceId = exports.Transaction = exports.placeFromStablePlace = exports.rangeFromStableRange = exports.validateStableRange = exports.validateStablePlace = exports.setTrait = exports.revert = exports.SharedTreeFactory = exports.StableRange = exports.StablePlace = exports.Move = exports.Delete = exports.ConstraintEffect = exports.Insert = exports.Change = exports.ChangeType = exports.SharedTreeEditor = exports.SharedTree = exports.BasicCheckout = exports.EditValidationResult = exports.CheckoutEvent = exports.Checkout = exports.Side = exports.Snapshot = exports.comparePayloads = exports.isSharedTreeEvent = exports.sharedTreeAssertionErrorType = exports.TreeNodeHandle = exports.initialTree = void 0;
+exports.getSerializedUploadedEditChunkContents = exports.getUploadedEditChunkContents = exports.Transaction = exports.TransactionView = exports.RevisionView = exports.TreeView = exports.GenericTransaction = exports.TransactionInternal = exports.comparePayloads = exports.RangeValidationResultKind = exports.PlaceValidationResult = exports.areRevisionViewsSemanticallyEqual = exports.setTrait = exports.SharedTree = exports.SharedTreeFactory = exports.StableRangeInternal = exports.StablePlaceInternal = exports.WriteFormat = exports.ChangeTypeInternal = exports.ChangeInternal = exports.ConstraintEffect = exports.EditStatus = exports.Side = exports.EagerCheckout = exports.LazyCheckout = exports.EditValidationResult = exports.CheckoutEvent = exports.Checkout = exports.isDetachedSequenceId = exports.Result = exports.isSharedTreeEvent = exports.sharedTreeAssertionErrorType = exports.Forest = exports.TreeNodeHandle = exports.initialTree = void 0;
 /**
  * Fluid DDS storing a tree.
  *
@@ -29,46 +29,61 @@ var InitialTree_1 = require("./InitialTree");
 Object.defineProperty(exports, "initialTree", { enumerable: true, get: function () { return InitialTree_1.initialTree; } });
 var TreeNodeHandle_1 = require("./TreeNodeHandle");
 Object.defineProperty(exports, "TreeNodeHandle", { enumerable: true, get: function () { return TreeNodeHandle_1.TreeNodeHandle; } });
+var Forest_1 = require("./Forest");
+Object.defineProperty(exports, "Forest", { enumerable: true, get: function () { return Forest_1.Forest; } });
 var Common_1 = require("./Common");
 Object.defineProperty(exports, "sharedTreeAssertionErrorType", { enumerable: true, get: function () { return Common_1.sharedTreeAssertionErrorType; } });
 Object.defineProperty(exports, "isSharedTreeEvent", { enumerable: true, get: function () { return Common_1.isSharedTreeEvent; } });
-Object.defineProperty(exports, "comparePayloads", { enumerable: true, get: function () { return Common_1.comparePayloads; } });
-__exportStar(require("./Identifiers"), exports);
-var Snapshot_1 = require("./Snapshot");
-Object.defineProperty(exports, "Snapshot", { enumerable: true, get: function () { return Snapshot_1.Snapshot; } });
-Object.defineProperty(exports, "Side", { enumerable: true, get: function () { return Snapshot_1.Side; } });
+Object.defineProperty(exports, "Result", { enumerable: true, get: function () { return Common_1.Result; } });
+var Identifiers_1 = require("./Identifiers");
+Object.defineProperty(exports, "isDetachedSequenceId", { enumerable: true, get: function () { return Identifiers_1.isDetachedSequenceId; } });
 var Checkout_1 = require("./Checkout");
 Object.defineProperty(exports, "Checkout", { enumerable: true, get: function () { return Checkout_1.Checkout; } });
 Object.defineProperty(exports, "CheckoutEvent", { enumerable: true, get: function () { return Checkout_1.CheckoutEvent; } });
 Object.defineProperty(exports, "EditValidationResult", { enumerable: true, get: function () { return Checkout_1.EditValidationResult; } });
-var BasicCheckout_1 = require("./BasicCheckout");
-Object.defineProperty(exports, "BasicCheckout", { enumerable: true, get: function () { return BasicCheckout_1.BasicCheckout; } });
+var LazyCheckout_1 = require("./LazyCheckout");
+Object.defineProperty(exports, "LazyCheckout", { enumerable: true, get: function () { return LazyCheckout_1.LazyCheckout; } });
+var EagerCheckout_1 = require("./EagerCheckout");
+Object.defineProperty(exports, "EagerCheckout", { enumerable: true, get: function () { return EagerCheckout_1.EagerCheckout; } });
 __exportStar(require("./ReconciliationPath"), exports);
-var default_edits_1 = require("./default-edits");
-Object.defineProperty(exports, "SharedTree", { enumerable: true, get: function () { return default_edits_1.SharedTree; } });
-Object.defineProperty(exports, "SharedTreeEditor", { enumerable: true, get: function () { return default_edits_1.SharedTreeEditor; } });
-Object.defineProperty(exports, "ChangeType", { enumerable: true, get: function () { return default_edits_1.ChangeType; } });
-Object.defineProperty(exports, "Change", { enumerable: true, get: function () { return default_edits_1.Change; } });
-Object.defineProperty(exports, "Insert", { enumerable: true, get: function () { return default_edits_1.Insert; } });
-Object.defineProperty(exports, "ConstraintEffect", { enumerable: true, get: function () { return default_edits_1.ConstraintEffect; } });
-Object.defineProperty(exports, "Delete", { enumerable: true, get: function () { return default_edits_1.Delete; } });
-Object.defineProperty(exports, "Move", { enumerable: true, get: function () { return default_edits_1.Move; } });
-Object.defineProperty(exports, "StablePlace", { enumerable: true, get: function () { return default_edits_1.StablePlace; } });
-Object.defineProperty(exports, "StableRange", { enumerable: true, get: function () { return default_edits_1.StableRange; } });
-Object.defineProperty(exports, "SharedTreeFactory", { enumerable: true, get: function () { return default_edits_1.SharedTreeFactory; } });
-Object.defineProperty(exports, "revert", { enumerable: true, get: function () { return default_edits_1.revert; } });
-Object.defineProperty(exports, "setTrait", { enumerable: true, get: function () { return default_edits_1.setTrait; } });
-Object.defineProperty(exports, "validateStablePlace", { enumerable: true, get: function () { return default_edits_1.validateStablePlace; } });
-Object.defineProperty(exports, "validateStableRange", { enumerable: true, get: function () { return default_edits_1.validateStableRange; } });
-Object.defineProperty(exports, "rangeFromStableRange", { enumerable: true, get: function () { return default_edits_1.rangeFromStableRange; } });
-Object.defineProperty(exports, "placeFromStablePlace", { enumerable: true, get: function () { return default_edits_1.placeFromStablePlace; } });
-Object.defineProperty(exports, "Transaction", { enumerable: true, get: function () { return default_edits_1.Transaction; } });
-Object.defineProperty(exports, "isDetachedSequenceId", { enumerable: true, get: function () { return default_edits_1.isDetachedSequenceId; } });
-var generic_1 = require("./generic");
-Object.defineProperty(exports, "GenericSharedTree", { enumerable: true, get: function () { return generic_1.GenericSharedTree; } });
-Object.defineProperty(exports, "SharedTreeEvent", { enumerable: true, get: function () { return generic_1.SharedTreeEvent; } });
-Object.defineProperty(exports, "SharedTreeDiagnosticEvent", { enumerable: true, get: function () { return generic_1.SharedTreeDiagnosticEvent; } });
-Object.defineProperty(exports, "newEdit", { enumerable: true, get: function () { return generic_1.newEdit; } });
-Object.defineProperty(exports, "EditStatus", { enumerable: true, get: function () { return generic_1.EditStatus; } });
-Object.defineProperty(exports, "GenericTransaction", { enumerable: true, get: function () { return generic_1.GenericTransaction; } });
+__exportStar(require("./MergeHealth"), exports);
+__exportStar(require("./TreeViewUtilities"), exports);
+var persisted_types_1 = require("./persisted-types");
+Object.defineProperty(exports, "Side", { enumerable: true, get: function () { return persisted_types_1.Side; } });
+Object.defineProperty(exports, "EditStatus", { enumerable: true, get: function () { return persisted_types_1.EditStatus; } });
+Object.defineProperty(exports, "ConstraintEffect", { enumerable: true, get: function () { return persisted_types_1.ConstraintEffect; } });
+Object.defineProperty(exports, "ChangeInternal", { enumerable: true, get: function () { return persisted_types_1.ChangeInternal; } });
+Object.defineProperty(exports, "ChangeTypeInternal", { enumerable: true, get: function () { return persisted_types_1.ChangeTypeInternal; } });
+Object.defineProperty(exports, "WriteFormat", { enumerable: true, get: function () { return persisted_types_1.WriteFormat; } });
+Object.defineProperty(exports, "StablePlaceInternal", { enumerable: true, get: function () { return persisted_types_1.StablePlaceInternal; } });
+Object.defineProperty(exports, "StableRangeInternal", { enumerable: true, get: function () { return persisted_types_1.StableRangeInternal; } });
+var SharedTree_1 = require("./SharedTree");
+Object.defineProperty(exports, "SharedTreeFactory", { enumerable: true, get: function () { return SharedTree_1.SharedTreeFactory; } });
+Object.defineProperty(exports, "SharedTree", { enumerable: true, get: function () { return SharedTree_1.SharedTree; } });
+__exportStar(require("./EventTypes"), exports);
+var EditUtilities_1 = require("./EditUtilities");
+Object.defineProperty(exports, "setTrait", { enumerable: true, get: function () { return EditUtilities_1.setTrait; } });
+Object.defineProperty(exports, "areRevisionViewsSemanticallyEqual", { enumerable: true, get: function () { return EditUtilities_1.areRevisionViewsSemanticallyEqual; } });
+Object.defineProperty(exports, "PlaceValidationResult", { enumerable: true, get: function () { return EditUtilities_1.PlaceValidationResult; } });
+Object.defineProperty(exports, "RangeValidationResultKind", { enumerable: true, get: function () { return EditUtilities_1.RangeValidationResultKind; } });
+var PayloadUtilities_1 = require("./PayloadUtilities");
+Object.defineProperty(exports, "comparePayloads", { enumerable: true, get: function () { return PayloadUtilities_1.comparePayloads; } });
+var TransactionInternal_1 = require("./TransactionInternal");
+Object.defineProperty(exports, "TransactionInternal", { enumerable: true, get: function () { return TransactionInternal_1.TransactionInternal; } });
+Object.defineProperty(exports, "GenericTransaction", { enumerable: true, get: function () { return TransactionInternal_1.GenericTransaction; } });
+var TreeView_1 = require("./TreeView");
+Object.defineProperty(exports, "TreeView", { enumerable: true, get: function () { return TreeView_1.TreeView; } });
+var RevisionView_1 = require("./RevisionView");
+Object.defineProperty(exports, "RevisionView", { enumerable: true, get: function () { return RevisionView_1.RevisionView; } });
+Object.defineProperty(exports, "TransactionView", { enumerable: true, get: function () { return RevisionView_1.TransactionView; } });
+var Transaction_1 = require("./Transaction");
+Object.defineProperty(exports, "Transaction", { enumerable: true, get: function () { return Transaction_1.Transaction; } });
+/**
+ * TODO:#61413: Publish test utilities from a separate test package
+ */
+var SummaryTestUtilities_1 = require("./SummaryTestUtilities");
+/** @deprecated Use `getSerializedUploadedEditChunkContents` instead. */
+Object.defineProperty(exports, "getUploadedEditChunkContents", { enumerable: true, get: function () { return SummaryTestUtilities_1.getSerializedUploadedEditChunkContents; } });
+Object.defineProperty(exports, "getSerializedUploadedEditChunkContents", { enumerable: true, get: function () { return SummaryTestUtilities_1.getSerializedUploadedEditChunkContents; } });
+__exportStar(require("./ChangeTypes"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;AAEH;;;;GAIG;AAEH;;;GAGG;AAEH,cAAc;AAEd,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAEvB,mCAA4F;AAAnF,sHAAA,4BAA4B,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,yGAAA,eAAe,OAAA;AACzE,gDAA8B;AAE9B,uCASoB;AALnB,oGAAA,QAAQ,OAAA;AAIR,gGAAA,IAAI,OAAA;AAGL,uCAA4F;AAAnF,oGAAA,QAAQ,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAmB,gHAAA,oBAAoB,OAAA;AACvE,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,uDAAqC;AACrC,iDAwByB;AAvBxB,2GAAA,UAAU,OAAA;AACV,iHAAA,gBAAgB,OAAA;AAChB,2GAAA,UAAU,OAAA;AACV,uGAAA,MAAM,OAAA;AAEN,uGAAA,MAAM,OAAA;AAIN,iHAAA,gBAAgB,OAAA;AAChB,uGAAA,MAAM,OAAA;AACN,qGAAA,IAAI,OAAA;AACJ,4GAAA,WAAW,OAAA;AACX,4GAAA,WAAW,OAAA;AACX,kHAAA,iBAAiB,OAAA;AACjB,uGAAA,MAAM,OAAA;AACN,yGAAA,QAAQ,OAAA;AACR,oHAAA,mBAAmB,OAAA;AACnB,oHAAA,mBAAmB,OAAA;AACnB,qHAAA,oBAAoB,OAAA;AACpB,qHAAA,oBAAoB,OAAA;AACpB,4GAAA,WAAW,OAAA;AACX,qHAAA,oBAAoB,OAAA;AAErB,qCA0BmB;AAtBlB,4GAAA,iBAAiB,OAAA;AACjB,0GAAA,eAAe,OAAA;AACf,oHAAA,yBAAyB,OAAA;AAEzB,kGAAA,OAAO,OAAA;AAUP,qGAAA,UAAU,OAAA;AAEV,6GAAA,kBAAkB,OAAA","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n/**\n * Fluid DDS storing a tree.\n *\n * @packageDocumentation\n */\n\n/**\n * This file represents the public API. Consumers of this package will not see exported modules unless they are enumerated here.\n * Removing / editing existing exports here will often indicate a breaking change, so please be cognizant of changes made here.\n */\n\n// API Exports\n\nexport { initialTree } from './InitialTree';\nexport { TreeNodeHandle } from './TreeNodeHandle';\nexport { Delta } from './Forest';\nexport { sharedTreeAssertionErrorType, isSharedTreeEvent, comparePayloads } from './Common';\nexport * from './Identifiers';\nexport { OrderedEditSet, EditLogSummary, EditHandle, EditChunkOrHandle } from './EditLog';\nexport {\n\tNodeInTrait,\n\tPlaceIndex,\n\tSnapshotNode,\n\tSnapshot,\n\tTraitNodeIndex,\n\tSnapshotPlace,\n\tSnapshotRange,\n\tSide,\n} from './Snapshot';\nexport { LogViewer, Revision } from './LogViewer';\nexport { Checkout, CheckoutEvent, ICheckoutEvents, EditValidationResult } from './Checkout';\nexport { BasicCheckout } from './BasicCheckout';\nexport * from './ReconciliationPath';\nexport {\n\tSharedTree,\n\tSharedTreeEditor,\n\tChangeType,\n\tChange,\n\tBuild,\n\tInsert,\n\tDetach,\n\tSetValue,\n\tConstraint,\n\tConstraintEffect,\n\tDelete,\n\tMove,\n\tStablePlace,\n\tStableRange,\n\tSharedTreeFactory,\n\trevert,\n\tsetTrait,\n\tvalidateStablePlace,\n\tvalidateStableRange,\n\trangeFromStableRange,\n\tplaceFromStablePlace,\n\tTransaction,\n\tisDetachedSequenceId,\n} from './default-edits';\nexport {\n\tEditCommittedHandler,\n\tEditCommittedEventArguments,\n\tISharedTreeEvents,\n\tGenericSharedTree,\n\tSharedTreeEvent,\n\tSharedTreeDiagnosticEvent,\n\tEdit,\n\tnewEdit,\n\tEditWithoutId,\n\tEditBase,\n\tTraitMap,\n\tTreeNodeSequence,\n\tPayload,\n\tNodeData,\n\tTreeNode,\n\tChangeNode,\n\tBuildNode,\n\tEditStatus,\n\tTraitLocation,\n\tGenericTransaction,\n\tEditingResult,\n\tValidEditingResult,\n\tSharedTreeSummarizer,\n\tSharedTreeSummary,\n\tSharedTreeSummaryBase,\n} from './generic';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;AAEH;;;;GAIG;AAEH;;;GAGG;AAEH,cAAc;AAEd,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AACpB,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AACvB,mCAAiE;AAAjD,gGAAA,MAAM,OAAA;AACtB,mCAAmF;AAA1E,sHAAA,4BAA4B,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,gGAAA,MAAM,OAAA;AAiBhE,6CAAqD;AAA5C,mHAAA,oBAAoB,OAAA;AAI7B,uCAA4F;AAAnF,oGAAA,QAAQ,OAAA;AAAE,yGAAA,aAAa,OAAA;AAAmB,gHAAA,oBAAoB,OAAA;AACvE,+CAA8C;AAArC,4GAAA,YAAY,OAAA;AACrB,iDAAgD;AAAvC,8GAAA,aAAa,OAAA;AACtB,uDAAqC;AACrC,gDAA8B;AAC9B,sDAAoC;AAEpC,qDAwC2B;AAvC1B,uGAAA,IAAI,OAAA;AACJ,6GAAA,UAAU,OAAA;AAIV,mHAAA,gBAAgB,OAAA;AAEhB,iHAAA,cAAc,OAAA;AAoBd,qHAAA,kBAAkB,OAAA;AAElB,8GAAA,WAAW,OAAA;AAEX,sHAAA,mBAAmB,OAAA;AACnB,sHAAA,mBAAmB,OAAA;AAQpB,2CASsB;AARrB,+GAAA,iBAAiB,OAAA;AACjB,wGAAA,UAAU,OAAA;AAQX,+CAA6B;AAC7B,iDAQyB;AAPxB,yGAAA,QAAQ,OAAA;AACR,kIAAA,iCAAiC,OAAA;AAGjC,sHAAA,qBAAqB,OAAA;AAErB,0HAAA,yBAAyB,OAAA;AAE1B,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AACxB,6DAa+B;AAZ9B,0HAAA,mBAAmB,OAAA;AACnB,yHAAA,kBAAkB,OAAA;AAYnB,uCASoB;AALnB,oGAAA,QAAQ,OAAA;AAMT,+CAA+D;AAAtD,4GAAA,YAAY,OAAA;AAAE,+GAAA,eAAe,OAAA;AAEtC,6CAA4C;AAAnC,0GAAA,WAAW,OAAA;AAEpB;;GAEG;AACH,+DAIgC;AAH/B,wEAAwE;AACxE,oIAAA,sCAAsC,OAAgC;AACtE,8IAAA,sCAAsC,OAAA;AAGvC,gDAA8B","sourcesContent":["/*!\n * Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n */\n\n/**\n * Fluid DDS storing a tree.\n *\n * @packageDocumentation\n */\n\n/**\n * This file represents the public API. Consumers of this package will not see exported modules unless they are enumerated here.\n * Removing / editing existing exports here will often indicate a breaking change, so please be cognizant of changes made here.\n */\n\n// API Exports\n\nexport { initialTree } from './InitialTree';\nexport { TreeNodeHandle } from './TreeNodeHandle';\nexport { Delta, Forest, ForestNode, ParentData } from './Forest';\nexport { sharedTreeAssertionErrorType, isSharedTreeEvent, Result } from './Common';\nexport type {\n\tCompressedId,\n\tDefinition,\n\tDetachedSequenceId,\n\tEditId,\n\tInternedStringId,\n\tFinalCompressedId,\n\tLocalCompressedId,\n\tNodeId,\n\tNodeIdBrand,\n\tStableNodeId,\n\tSessionSpaceCompressedId,\n\tSessionUnique,\n\tTraitLabel,\n\tUuidString,\n} from './Identifiers';\nexport { isDetachedSequenceId } from './Identifiers';\nexport type { OrderedEditSet, EditHandle } from './EditLog';\nexport { LogViewer } from './LogViewer';\nexport { Revision } from './RevisionValueCache';\nexport { Checkout, CheckoutEvent, ICheckoutEvents, EditValidationResult } from './Checkout';\nexport { LazyCheckout } from './LazyCheckout';\nexport { EagerCheckout } from './EagerCheckout';\nexport * from './ReconciliationPath';\nexport * from './MergeHealth';\nexport * from './TreeViewUtilities';\nexport { StringInterner } from './StringInterner';\nexport {\n\tSide,\n\tEditStatus,\n\tTreeNode,\n\tTreeNodeSequence,\n\tPayload,\n\tConstraintEffect,\n\tEdit,\n\tChangeInternal,\n\tChangeNode,\n\tChangeNode_0_0_2,\n\tEditLogSummary,\n\tFluidEditHandle,\n\tSharedTreeSummaryBase,\n\tEditWithoutId,\n\tPlaceholderTree,\n\tEditBase,\n\tHasTraits,\n\tInsertInternal,\n\tDetachInternal,\n\tBuildInternal,\n\tSetValueInternal,\n\tConstraintInternal,\n\tBuildNodeInternal,\n\tStablePlaceInternal_0_0_2,\n\tStableRangeInternal_0_0_2,\n\tNodeData,\n\tTraitMap,\n\tChangeTypeInternal,\n\tTraitLocationInternal_0_0_2,\n\tWriteFormat,\n\tConstraintInternal_0_0_2,\n\tStablePlaceInternal,\n\tStableRangeInternal,\n\tBuildNodeInternal_0_0_2,\n\tBuildInternal_0_0_2,\n\tInsertInternal_0_0_2,\n\tDetachInternal_0_0_2,\n\tSetValueInternal_0_0_2,\n\tTraitLocationInternal,\n} from './persisted-types';\nexport {\n\tSharedTreeFactory,\n\tSharedTree,\n\tEditCommittedHandler,\n\tSequencedEditAppliedHandler,\n\tEditCommittedEventArguments,\n\tSequencedEditAppliedEventArguments,\n\tEditApplicationOutcome,\n\tISharedTreeEvents,\n} from './SharedTree';\nexport * from './EventTypes';\nexport {\n\tsetTrait,\n\tareRevisionViewsSemanticallyEqual,\n\tBadPlaceValidationResult,\n\tBadRangeValidationResult,\n\tPlaceValidationResult,\n\tRangeValidationResult,\n\tRangeValidationResultKind,\n} from './EditUtilities';\nexport { comparePayloads } from './PayloadUtilities';\nexport {\n\tTransactionInternal,\n\tGenericTransaction,\n\tGenericTransactionPolicy,\n\tEditingResult,\n\tEditingResultBase,\n\tFailedEditingResult,\n\tValidEditingResult,\n\tTransactionState,\n\tTransactionFailure,\n\tSucceedingTransactionState,\n\tFailingTransactionState,\n\tChangeResult,\n} from './TransactionInternal';\nexport {\n\tNodeInTrait,\n\tPlaceIndex,\n\tTreeViewNode,\n\tTreeView,\n\tTraitNodeIndex,\n\tTreeViewPlace,\n\tTreeViewRange,\n\tTraitLocation,\n} from './TreeView';\nexport { RevisionView, TransactionView } from './RevisionView';\nexport { NodeIdContext, NodeIdGenerator, NodeIdConverter } from './NodeIdUtilities';\nexport { Transaction } from './Transaction';\n\n/**\n * TODO:#61413: Publish test utilities from a separate test package\n */\nexport {\n\t/** @deprecated Use `getSerializedUploadedEditChunkContents` instead. */\n\tgetSerializedUploadedEditChunkContents as getUploadedEditChunkContents,\n\tgetSerializedUploadedEditChunkContents,\n} from './SummaryTestUtilities';\n\nexport * from './ChangeTypes';\n"]}

package/dist/persisted-types/0.0.2.d.ts

@@ -0,0 +1,385 @@
+/*!
+ * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
+ * Licensed under the MIT License.
+ */
+import type { Serializable } from '@fluidframework/datastore-definitions';
+import type { EditId, Definition, NodeId, StableNodeId, TraitLabel, DetachedSequenceId, UuidString } from '../Identifiers';
+/**
+ * Defines a place relative to sibling.
+ * The "outside" of a trait is the `undefined` sibling,
+ * so After `undefined` is the beginning of the trait, and before `undefined` is the end.
+ *
+ * For this purpose, traits look like:
+ *
+ * `{undefined} - {Node 0} - {Node 1} - ... - {Node N} - {undefined}`
+ *
+ * Each `{value}` in the diagram is a possible sibling, which is either a Node or undefined.
+ * Each `-` in the above diagram is a `Place`, and can be describe as being `After` a particular `{sibling}` or `Before` it.
+ * This means that `After` `{undefined}` means the same `Place` as before the first node
+ * and `Before` `{undefined}` means the `Place` after the last Node.
+ *
+ * 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.
+ * @public
+ */
+export declare enum Side {
+    Before = 0,
+    After = 1
+}
+/**
+ * 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.
+ * @public
+ */
+export interface Edit<TChange> extends EditBase<TChange> {
+    /**
+     * Unique identifier for this edit. Must never be reused.
+     * Used for referencing and de-duplicating edits.
+     */
+    readonly id: EditId;
+}
+/**
+ * A collection of changes to the tree that are applied atomically. If any individual change fails to apply,
+ * the entire Edit will fail to apply.
+ * @public
+ */
+export interface EditWithoutId<TChange> extends EditBase<TChange> {
+    /**
+     * Used to explicitly state that EditWithoutId cannot contain an id and prevents type Edit from being assigned to type EditWithoutId.
+     */
+    readonly id?: never;
+}
+/**
+ * The information included in an edit.
+ * @public
+ */
+export interface EditBase<TChange> {
+    /**
+     * Actual changes to apply.
+     * Applied in order as part of a single transaction.
+     */
+    readonly changes: readonly TChange[];
+    /**
+     * For edits which are being re-issued due to a conflict, the number of times this edit has already been attempted.
+     * Undefined means 0.
+     */
+    readonly pastAttemptCount?: number;
+}
+/**
+ * Json compatible representation of a payload storing arbitrary Serializable data.
+ *
+ * Keys starting with "IFluid" are reserved for special use such as the JavaScript feature detection pattern and should not be used.
+ *
+ * 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.
+ *
+ * @public
+ */
+export declare type Payload = Serializable;
+/**
+ * Json compatible map as object.
+ * Keys are TraitLabels,
+ * Values are the content of the trait specified by the key.
+ * @public
+ */
+export interface TraitMap<TChild> {
+    readonly [key: string]: TreeNodeSequence<TChild>;
+}
+/**
+ * A sequence of Nodes that make up a trait under a Node
+ * @public
+ */
+export declare type TreeNodeSequence<TChild> = readonly TChild[];
+/**
+ * An object which may have traits with children of the given type underneath it
+ * @public
+ */
+export interface HasTraits<TChild> {
+    readonly traits: TraitMap<TChild>;
+}
+/**
+ * The fields required by a node in a tree
+ * @public
+ */
+export interface NodeData<TId> {
+    /**
+     * A payload of arbitrary serializable data
+     */
+    readonly payload?: Payload;
+    /**
+     * The meaning of this node.
+     * Provides contexts/semantics for this node and its content.
+     * Typically use to associate a node with metadata (including a schema) and source code (types, behaviors, etc).
+     */
+    readonly definition: Definition;
+    /**
+     * Identifier which can be used to refer to this Node.
+     */
+    readonly identifier: TId;
+}
+/**
+ * Satisfies `NodeData` and may contain children under traits (which may or may not be `TreeNodes`)
+ * @public
+ */
+export interface TreeNode<TChild, TId> extends NodeData<TId>, HasTraits<TChild> {
+}
+/**
+ * A tree whose nodes are either TreeNodes or a placeholder
+ */
+export declare type PlaceholderTree<TPlaceholder = never> = TreeNode<PlaceholderTree<TPlaceholder>, NodeId> | TPlaceholder;
+/**
+ * Specifies the location of a trait (a labeled sequence of nodes) within the tree.
+ * @public
+ */
+export interface TraitLocationInternal_0_0_2 {
+    readonly parent: StableNodeId;
+    readonly label: TraitLabel;
+}
+/**
+ * JSON-compatible Node type. Objects of this type will be persisted in internal change objects (under Edits) in the SharedTree history.
+ * @public
+ */
+export declare type ChangeNode_0_0_2 = TreeNode<ChangeNode_0_0_2, StableNodeId>;
+/**
+ * The status code of an attempt to apply the changes in an Edit.
+ * @public
+ */
+export declare enum EditStatus {
+    /**
+     * The edit contained one or more malformed changes (e.g. was missing required fields such as `id`),
+     * or contained a sequence of changes that could not possibly be applied sequentially without error
+     * (e.g. an edit which tries to insert the same detached node twice).
+     */
+    Malformed = 0,
+    /**
+     * The edit contained a well-formed sequence of changes that couldn't be applied to the current view,
+     * generally because concurrent changes caused one or more merge conflicts.
+     */
+    Invalid = 1,
+    /**
+     * The edit was applied to the current view successfully.
+     */
+    Applied = 2
+}
+/**
+ * Types of ops handled by SharedTree.
+ */
+export declare enum SharedTreeOpType {
+    /** An op that includes edit information. */
+    Edit = 0,
+    /** Includes a Fluid handle that corresponds to an edit chunk. */
+    Handle = 1,
+    /** An op that does not affect the tree's state. */
+    NoOp = 2,
+    /** Signals that SharedTree contents should be updated to match a new write format. */
+    Update = 3
+}
+/**
+ * SharedTreeOp containing a version stamp marking the write format of the tree which submitted it.
+ */
+export interface VersionedOp<Version extends WriteFormat = WriteFormat> {
+    /** The supported SharedTree write version, see {@link WriteFormat}. */
+    readonly version: Version;
+}
+/**
+ * Requirements for SharedTree ops.
+ */
+export declare type SharedTreeOp_0_0_2 = SharedTreeEditOp_0_0_2 | SharedTreeNoOp | SharedTreeUpdateOp;
+/**
+ * Op which has no application semantics. This op can be useful for triggering other
+ */
+export interface SharedTreeNoOp extends VersionedOp {
+    readonly type: SharedTreeOpType.NoOp;
+}
+/**
+ * Op indicating this SharedTree should upgrade its write format to the specified version.
+ * The `version` field of this op reflects the version which should be upgraded to, not
+ * the current version.
+ * See docs/Breaking-Change-Migration.md for more details on the semantics of this op.
+ */
+export interface SharedTreeUpdateOp extends VersionedOp {
+    readonly type: SharedTreeOpType.Update;
+}
+/**
+ * A SharedTree op that includes edit information, and optionally a list of interned strings.
+ */
+export interface SharedTreeEditOp_0_0_2 extends VersionedOp<WriteFormat.v0_0_2> {
+    readonly type: SharedTreeOpType.Edit;
+    /** The collection of changes to apply. */
+    readonly edit: Edit<ChangeInternal_0_0_2>;
+}
+/**
+ * Format versions that SharedTree supports writing. Changes to op or summary formats necessitate updates.
+ * @public
+ */
+export declare enum WriteFormat {
+    /** Stores all edits in their raw format. */
+    v0_0_2 = "0.0.2",
+    /** Supports history virtualization, tree compression, string interning, and makes currentView optional. */
+    v0_1_1 = "0.1.1"
+}
+/**
+ * The minimal information on a SharedTree summary. Contains the summary format version.
+ */
+export interface SharedTreeSummaryBase {
+    /**
+     * Field on summary under which version is stored.
+     */
+    readonly version: WriteFormat;
+}
+/**
+ * Legacy summary format currently still used for writing.
+ * TODO:#49901: Remove export when this format is no longer written.
+ * @internal
+ */
+export interface SharedTreeSummary_0_0_2 extends SharedTreeSummaryBase {
+    readonly version: WriteFormat.v0_0_2;
+    readonly currentTree: ChangeNode_0_0_2;
+    /**
+     * A list of edits.
+     */
+    readonly sequencedEdits: readonly Edit<ChangeInternal_0_0_2>[];
+}
+/**
+ * {@inheritdoc ChangeType}
+ * @public
+ */
+export declare enum ChangeTypeInternal {
+    Insert = 0,
+    Detach = 1,
+    Build = 2,
+    SetValue = 3,
+    Constraint = 4,
+    CompressedBuild = 5
+}
+/**
+ * {@inheritdoc (Change:type)}
+ * @public
+ */
+export declare type ChangeInternal_0_0_2 = InsertInternal_0_0_2 | DetachInternal_0_0_2 | BuildInternal_0_0_2 | SetValueInternal_0_0_2 | ConstraintInternal_0_0_2;
+/**
+ * {@inheritdoc BuildNode}
+ * @public
+ */
+export declare type BuildNodeInternal_0_0_2 = TreeNode<BuildNodeInternal_0_0_2, StableNodeId> | DetachedSequenceId;
+/**
+ * {@inheritdoc Build}
+ * @public
+ */
+export interface BuildInternal_0_0_2 {
+    /** {@inheritdoc Build.destination } */
+    readonly destination: DetachedSequenceId;
+    /** {@inheritdoc Build.source } */
+    readonly source: TreeNodeSequence<BuildNodeInternal_0_0_2>;
+    /** {@inheritdoc Build."type" } */
+    readonly type: typeof ChangeTypeInternal.Build;
+}
+/**
+ * {@inheritdoc (Insert:interface)}
+ * @public
+ */
+export interface InsertInternal_0_0_2 {
+    /** {@inheritdoc (Insert:interface).destination } */
+    readonly destination: StablePlaceInternal_0_0_2;
+    /** {@inheritdoc (Insert:interface).source } */
+    readonly source: DetachedSequenceId;
+    /** {@inheritdoc (Insert:interface)."type" } */
+    readonly type: typeof ChangeTypeInternal.Insert;
+}
+/**
+ * {@inheritdoc Detach}
+ * @public
+ */
+export interface DetachInternal_0_0_2 {
+    /** {@inheritdoc Detach.destination } */
+    readonly destination?: DetachedSequenceId;
+    /** {@inheritdoc Detach.source } */
+    readonly source: StableRangeInternal_0_0_2;
+    /** {@inheritdoc Detach."type" } */
+    readonly type: typeof ChangeTypeInternal.Detach;
+}
+/**
+ * {@inheritdoc SetValue}
+ * @public
+ */
+export interface SetValueInternal_0_0_2 {
+    /** {@inheritdoc SetValue.nodeToModify } */
+    readonly nodeToModify: StableNodeId;
+    /** {@inheritdoc SetValue.payload } */
+    readonly payload: Payload | null;
+    /** {@inheritdoc SetValue."type" } */
+    readonly type: typeof ChangeTypeInternal.SetValue;
+}
+/**
+ * What to do when a Constraint is violated.
+ * @public
+ */
+export declare enum ConstraintEffect {
+    /**
+     * Discard Edit.
+     */
+    InvalidAndDiscard = 0,
+    /**
+     * Discard Edit, but record metadata that application may want to try and recover this change by recreating it.
+     * Should this be the default policy for when another (non Constraint) change is invalid?
+     */
+    InvalidRetry = 1,
+    /**
+     * Apply the change, but flag it for possible reconsideration by the app
+     * (applying it is better than not, but perhaps the high level logic could produce something better).
+     */
+    ValidRetry = 2
+}
+/**
+ * {@inheritdoc Constraint}
+ * @public
+ */
+export interface ConstraintInternal_0_0_2 {
+    /** {@inheritdoc Constraint.toConstrain } */
+    readonly toConstrain: StableRangeInternal_0_0_2;
+    /** {@inheritdoc Constraint.identityHash } */
+    readonly identityHash?: UuidString;
+    /** {@inheritdoc Constraint.length } */
+    readonly length?: number;
+    /** {@inheritdoc Constraint.contentHash } */
+    readonly contentHash?: UuidString;
+    /** {@inheritdoc Constraint.parentNode } */
+    readonly parentNode?: StableNodeId;
+    /** {@inheritdoc Constraint.label } */
+    readonly label?: TraitLabel;
+    /** {@inheritdoc Constraint.effect } */
+    readonly effect: ConstraintEffect;
+    /** {@inheritdoc Constraint."type" } */
+    readonly type: typeof ChangeTypeInternal.Constraint;
+}
+/**
+ * {@inheritdoc (StablePlace:interface) }
+ * @public
+ */
+export interface StablePlaceInternal_0_0_2 {
+    /**
+     * {@inheritdoc (StablePlace:interface).side }
+     */
+    readonly side: Side;
+    /**
+     * {@inheritdoc (StablePlace:interface).referenceSibling }
+     */
+    readonly referenceSibling?: StableNodeId;
+    /**
+     * {@inheritdoc (StablePlace:interface).referenceTrait }
+     */
+    readonly referenceTrait?: TraitLocationInternal_0_0_2;
+}
+/**
+ * {@inheritdoc (StableRange:interface) }
+ * @public
+ */
+export interface StableRangeInternal_0_0_2 {
+    /** {@inheritdoc (StableRange:interface).start } */
+    readonly start: StablePlaceInternal_0_0_2;
+    /** {@inheritdoc (StableRange:interface).end } */
+    readonly end: StablePlaceInternal_0_0_2;
+}
+//# sourceMappingURL=0.0.2.d.ts.map