fluid-framework 2.0.0-dev-rc.5.0.0.270987 → 2.0.0-dev-rc.5.0.0.271262

package/api-report/fluid-framework.alpha.api.md

@@ -105,6 +105,12 @@ export abstract class ErasedType<out Name = unknown> {
 // @public
 type ExtractItemType<Item extends LazyItem> = Item extends () => infer Result ? Result : Item;
 
+// @public
+export type FieldHasDefault<T extends ImplicitFieldSchema> = T extends FieldSchema<FieldKind.Optional | FieldKind.Identifier> ? true : false;
+
+// @public
+export type FieldHasDefaultUnsafe<T extends Unenforced<ImplicitFieldSchema>> = T extends FieldSchemaUnsafe<FieldKind.Optional | FieldKind.Identifier, Unenforced<ImplicitAllowedTypes>> ? true : false;
+
 // @public
 export enum FieldKind {
     Identifier = 2,
@@ -134,6 +140,11 @@ export interface FieldSchemaUnsafe<out Kind extends FieldKind, out Types extends
     readonly kind: Kind;
 }
 
+// @public
+type FlattenKeys<T> = [{
+    [Property in keyof T]: T[Property];
+}][_InlineTrick];
+
 // @public
 export type FlexList<Item = unknown> = readonly LazyItem<Item>[];
 
@@ -510,13 +521,20 @@ export type InitialObjects<T extends ContainerSchema> = {
 };
 
 // @public
-export type InsertableObjectFromSchemaRecord<T extends RestrictiveReadonlyRecord<string, ImplicitFieldSchema>> = {
-    readonly [Property in keyof T]: InsertableTreeFieldFromImplicitField<T[Property]>;
-};
+type _InlineTrick = 0;
+
+// @public
+export type InsertableObjectFromSchemaRecord<T extends RestrictiveReadonlyRecord<string, ImplicitFieldSchema>> = InternalUtilTypes.FlattenKeys<{
+    readonly [Property in keyof T]?: InsertableTreeFieldFromImplicitField<T[Property]>;
+} & {
+    readonly [Property in keyof T as FieldHasDefault<T[Property]> extends false ? Property : never]: InsertableTreeFieldFromImplicitField<T[Property]>;
+}>;
 
 // @public
 export type InsertableObjectFromSchemaRecordUnsafe<T extends Unenforced<RestrictiveReadonlyRecord<string, ImplicitFieldSchema>>> = {
-    readonly [Property in keyof T]: InsertableTreeFieldFromImplicitFieldUnsafe<T[Property]>;
+    readonly [Property in keyof T as FieldHasDefaultUnsafe<T[Property]> extends false ? Property : never]: InsertableTreeFieldFromImplicitFieldUnsafe<T[Property]>;
+} & {
+    readonly [Property in keyof T as FieldHasDefaultUnsafe<T[Property]> extends true ? Property : never]?: InsertableTreeFieldFromImplicitFieldUnsafe<T[Property]>;
 };
 
 // @public
@@ -568,6 +586,14 @@ export { InternalSimpleTreeTypes }
 export interface InternalTreeNode extends ErasedType<"@fluidframework/tree.InternalTreeNode"> {
 }
 
+declare namespace InternalUtilTypes {
+    export {
+        _InlineTrick,
+        FlattenKeys
+    }
+}
+export { InternalUtilTypes }
+
 // @alpha
 export interface IntervalIndex<TInterval extends ISerializableInterval> {
     add(interval: TInterval): void;
@@ -803,7 +829,9 @@ export interface ITrace {
 
 // @public
 export interface ITree extends IFluidLoadable {
+    // @deprecated
     schematize<TRoot extends ImplicitFieldSchema>(config: TreeConfiguration<TRoot>): TreeView<TRoot>;
+    viewWith<TRoot extends ImplicitFieldSchema>(config: TreeViewConfiguration<TRoot>): TreeView<TRoot>;
 }
 
 // @public
@@ -811,6 +839,12 @@ export interface ITreeConfigurationOptions {
     enableSchemaValidation?: boolean;
 }
 
+// @public
+export interface ITreeViewConfiguration<TSchema extends ImplicitFieldSchema = ImplicitFieldSchema> {
+    readonly enableSchemaValidation?: boolean;
+    readonly schema: TSchema;
+}
+
 // @alpha @sealed
 export interface IValueChanged {
     readonly key: string;
@@ -930,6 +964,14 @@ export interface RunTransaction {
     readonly rollback: typeof rollback;
 }
 
+// @public
+export interface SchemaCompatibilityStatus {
+    readonly canInitialize: boolean;
+    readonly canUpgrade: boolean;
+    readonly canView: boolean;
+    readonly isEquivalent: boolean;
+}
+
 // @public @sealed
 export class SchemaFactory<out TScope extends string | undefined = string | undefined, TName extends number | string = string> {
     constructor(scope: TScope);
@@ -952,7 +994,7 @@ export class SchemaFactory<out TScope extends string | undefined = string | unde
     readonly null: TreeNodeSchema<"com.fluidframework.leaf.null", NodeKind.Leaf, null, null>;
     readonly number: TreeNodeSchema<"com.fluidframework.leaf.number", NodeKind.Leaf, number, number>;
     object<const Name extends TName, const T extends RestrictiveReadonlyRecord<string, ImplicitFieldSchema>>(name: Name, fields: T): TreeNodeSchemaClass<ScopedSchemaName<TScope, Name>, NodeKind.Object, TreeObjectNode<T, ScopedSchemaName<TScope, Name>>, object & InsertableObjectFromSchemaRecord<T>, true, T>;
-    objectRecursive<const Name extends TName, const T extends Unenforced<RestrictiveReadonlyRecord<string, ImplicitFieldSchema>>>(name: Name, t: T): TreeNodeSchemaClass<ScopedSchemaName<TScope, Name>, NodeKind.Object, TreeObjectNodeUnsafe<T, ScopedSchemaName<TScope, Name>>, object & InsertableObjectFromSchemaRecordUnsafe<T>, false, T>;
+    objectRecursive<const Name extends TName, const T extends Unenforced<RestrictiveReadonlyRecord<string, ImplicitFieldSchema>>>(name: Name, t: T): TreeNodeSchemaClass<ScopedSchemaName<TScope, Name>, NodeKind.Object, TreeObjectNodeUnsafe<T, ScopedSchemaName<TScope, Name>>, object & { readonly [Property in keyof T as FieldHasDefaultUnsafe<T[Property]> extends false ? Property : never]: InsertableTreeFieldFromImplicitFieldUnsafe<T[Property]>; } & { readonly [Property_1 in keyof T as FieldHasDefaultUnsafe<T[Property_1]> extends true ? Property_1 : never]?: InsertableTreeFieldFromImplicitFieldUnsafe<T[Property_1]> | undefined; }, false, T>;
     optional<const T extends ImplicitAllowedTypes>(t: T, props?: Omit<FieldProps, "defaultProvider">): FieldSchema<FieldKind.Optional, T>;
     optionalRecursive<const T extends Unenforced<ImplicitAllowedTypes>>(t: T, props?: Omit<FieldProps, "defaultProvider">): FieldSchemaUnsafe<FieldKind.Optional, T>;
     required<const T extends ImplicitAllowedTypes>(t: T, props?: Omit<FieldProps, "defaultProvider">): FieldSchema<FieldKind.Required, T>;
@@ -962,11 +1004,6 @@ export class SchemaFactory<out TScope extends string | undefined = string | unde
     readonly string: TreeNodeSchema<"com.fluidframework.leaf.string", NodeKind.Leaf, string, string>;
 }
 
-// @public
-export interface SchemaIncompatible {
-    readonly canUpgrade: boolean;
-}
-
 // @public
 export type ScopedSchemaName<TScope extends string | undefined, TName extends number | string> = TScope extends undefined ? `${TName}` : `${TScope}.${TName}`;
 
@@ -1141,12 +1178,12 @@ export interface TreeChangeEvents {
     treeChanged(): void;
 }
 
-// @public
+// @public @deprecated
 export class TreeConfiguration<TSchema extends ImplicitFieldSchema = ImplicitFieldSchema> {
     constructor(schema: TSchema, initialTree: () => InsertableTreeFieldFromImplicitField<TSchema>, options?: ITreeConfigurationOptions);
+    readonly enableSchemaValidation: boolean;
     // (undocumented)
     readonly initialTree: () => InsertableTreeFieldFromImplicitField<TSchema>;
-    readonly options: Required<ITreeConfigurationOptions>;
     // (undocumented)
     readonly schema: TSchema;
 }
@@ -1240,18 +1277,27 @@ export enum TreeStatus {
 
 // @public
 export interface TreeView<TSchema extends ImplicitFieldSchema> extends IDisposable {
-    readonly error?: SchemaIncompatible;
+    readonly compatibility: SchemaCompatibilityStatus;
     readonly events: Listenable<TreeViewEvents>;
+    initialize(content: InsertableTreeFieldFromImplicitField<TSchema>): void;
     get root(): TreeFieldFromImplicitField<TSchema>;
     set root(newRoot: InsertableTreeFieldFromImplicitField<TSchema>);
     upgradeSchema(): void;
 }
 
+// @public
+export class TreeViewConfiguration<TSchema extends ImplicitFieldSchema = ImplicitFieldSchema> implements Required<ITreeViewConfiguration<TSchema>> {
+    constructor(props: ITreeViewConfiguration<TSchema>);
+    readonly enableSchemaValidation: boolean;
+    readonly schema: TSchema;
+}
+
 // @public
 export interface TreeViewEvents {
     afterBatch(): void;
     commitApplied(data: CommitMetadata, getRevertible?: RevertibleFactory): void;
     rootChanged(): void;
+    schemaChanged(): void;
 }
 
 // @public

package/api-report/fluid-framework.beta.api.md

@@ -102,6 +102,12 @@ export abstract class ErasedType<out Name = unknown> {
 // @public
 type ExtractItemType<Item extends LazyItem> = Item extends () => infer Result ? Result : Item;
 
+// @public
+export type FieldHasDefault<T extends ImplicitFieldSchema> = T extends FieldSchema<FieldKind.Optional | FieldKind.Identifier> ? true : false;
+
+// @public
+export type FieldHasDefaultUnsafe<T extends Unenforced<ImplicitFieldSchema>> = T extends FieldSchemaUnsafe<FieldKind.Optional | FieldKind.Identifier, Unenforced<ImplicitAllowedTypes>> ? true : false;
+
 // @public
 export enum FieldKind {
     Identifier = 2,
@@ -131,6 +137,11 @@ export interface FieldSchemaUnsafe<out Kind extends FieldKind, out Types extends
     readonly kind: Kind;
 }
 
+// @public
+type FlattenKeys<T> = [{
+    [Property in keyof T]: T[Property];
+}][_InlineTrick];
+
 // @public
 export type FlexList<Item = unknown> = readonly LazyItem<Item>[];
 
@@ -410,13 +421,20 @@ export type InitialObjects<T extends ContainerSchema> = {
 };
 
 // @public
-export type InsertableObjectFromSchemaRecord<T extends RestrictiveReadonlyRecord<string, ImplicitFieldSchema>> = {
-    readonly [Property in keyof T]: InsertableTreeFieldFromImplicitField<T[Property]>;
-};
+type _InlineTrick = 0;
+
+// @public
+export type InsertableObjectFromSchemaRecord<T extends RestrictiveReadonlyRecord<string, ImplicitFieldSchema>> = InternalUtilTypes.FlattenKeys<{
+    readonly [Property in keyof T]?: InsertableTreeFieldFromImplicitField<T[Property]>;
+} & {
+    readonly [Property in keyof T as FieldHasDefault<T[Property]> extends false ? Property : never]: InsertableTreeFieldFromImplicitField<T[Property]>;
+}>;
 
 // @public
 export type InsertableObjectFromSchemaRecordUnsafe<T extends Unenforced<RestrictiveReadonlyRecord<string, ImplicitFieldSchema>>> = {
-    readonly [Property in keyof T]: InsertableTreeFieldFromImplicitFieldUnsafe<T[Property]>;
+    readonly [Property in keyof T as FieldHasDefaultUnsafe<T[Property]> extends false ? Property : never]: InsertableTreeFieldFromImplicitFieldUnsafe<T[Property]>;
+} & {
+    readonly [Property in keyof T as FieldHasDefaultUnsafe<T[Property]> extends true ? Property : never]?: InsertableTreeFieldFromImplicitFieldUnsafe<T[Property]>;
 };
 
 // @public
@@ -460,6 +478,14 @@ export { InternalSimpleTreeTypes }
 export interface InternalTreeNode extends ErasedType<"@fluidframework/tree.InternalTreeNode"> {
 }
 
+declare namespace InternalUtilTypes {
+    export {
+        _InlineTrick,
+        FlattenKeys
+    }
+}
+export { InternalUtilTypes }
+
 // @public (undocumented)
 export interface IProvideFluidLoadable {
     // (undocumented)
@@ -497,7 +523,9 @@ export class IterableTreeArrayContent<T> implements Iterable<T> {
 
 // @public
 export interface ITree extends IFluidLoadable {
+    // @deprecated
     schematize<TRoot extends ImplicitFieldSchema>(config: TreeConfiguration<TRoot>): TreeView<TRoot>;
+    viewWith<TRoot extends ImplicitFieldSchema>(config: TreeViewConfiguration<TRoot>): TreeView<TRoot>;
 }
 
 // @public
@@ -505,6 +533,12 @@ export interface ITreeConfigurationOptions {
     enableSchemaValidation?: boolean;
 }
 
+// @public
+export interface ITreeViewConfiguration<TSchema extends ImplicitFieldSchema = ImplicitFieldSchema> {
+    readonly enableSchemaValidation?: boolean;
+    readonly schema: TSchema;
+}
+
 // @public
 export type LazyItem<Item = unknown> = Item | (() => Item);
 
@@ -618,6 +652,14 @@ export interface RunTransaction {
     readonly rollback: typeof rollback;
 }
 
+// @public
+export interface SchemaCompatibilityStatus {
+    readonly canInitialize: boolean;
+    readonly canUpgrade: boolean;
+    readonly canView: boolean;
+    readonly isEquivalent: boolean;
+}
+
 // @public @sealed
 export class SchemaFactory<out TScope extends string | undefined = string | undefined, TName extends number | string = string> {
     constructor(scope: TScope);
@@ -640,7 +682,7 @@ export class SchemaFactory<out TScope extends string | undefined = string | unde
     readonly null: TreeNodeSchema<"com.fluidframework.leaf.null", NodeKind.Leaf, null, null>;
     readonly number: TreeNodeSchema<"com.fluidframework.leaf.number", NodeKind.Leaf, number, number>;
     object<const Name extends TName, const T extends RestrictiveReadonlyRecord<string, ImplicitFieldSchema>>(name: Name, fields: T): TreeNodeSchemaClass<ScopedSchemaName<TScope, Name>, NodeKind.Object, TreeObjectNode<T, ScopedSchemaName<TScope, Name>>, object & InsertableObjectFromSchemaRecord<T>, true, T>;
-    objectRecursive<const Name extends TName, const T extends Unenforced<RestrictiveReadonlyRecord<string, ImplicitFieldSchema>>>(name: Name, t: T): TreeNodeSchemaClass<ScopedSchemaName<TScope, Name>, NodeKind.Object, TreeObjectNodeUnsafe<T, ScopedSchemaName<TScope, Name>>, object & InsertableObjectFromSchemaRecordUnsafe<T>, false, T>;
+    objectRecursive<const Name extends TName, const T extends Unenforced<RestrictiveReadonlyRecord<string, ImplicitFieldSchema>>>(name: Name, t: T): TreeNodeSchemaClass<ScopedSchemaName<TScope, Name>, NodeKind.Object, TreeObjectNodeUnsafe<T, ScopedSchemaName<TScope, Name>>, object & { readonly [Property in keyof T as FieldHasDefaultUnsafe<T[Property]> extends false ? Property : never]: InsertableTreeFieldFromImplicitFieldUnsafe<T[Property]>; } & { readonly [Property_1 in keyof T as FieldHasDefaultUnsafe<T[Property_1]> extends true ? Property_1 : never]?: InsertableTreeFieldFromImplicitFieldUnsafe<T[Property_1]> | undefined; }, false, T>;
     optional<const T extends ImplicitAllowedTypes>(t: T, props?: Omit<FieldProps, "defaultProvider">): FieldSchema<FieldKind.Optional, T>;
     optionalRecursive<const T extends Unenforced<ImplicitAllowedTypes>>(t: T, props?: Omit<FieldProps, "defaultProvider">): FieldSchemaUnsafe<FieldKind.Optional, T>;
     required<const T extends ImplicitAllowedTypes>(t: T, props?: Omit<FieldProps, "defaultProvider">): FieldSchema<FieldKind.Required, T>;
@@ -650,11 +692,6 @@ export class SchemaFactory<out TScope extends string | undefined = string | unde
     readonly string: TreeNodeSchema<"com.fluidframework.leaf.string", NodeKind.Leaf, string, string>;
 }
 
-// @public
-export interface SchemaIncompatible {
-    readonly canUpgrade: boolean;
-}
-
 // @public
 export type ScopedSchemaName<TScope extends string | undefined, TName extends number | string> = TScope extends undefined ? `${TName}` : `${TScope}.${TName}`;
 
@@ -731,12 +768,12 @@ export interface TreeChangeEvents {
     treeChanged(): void;
 }
 
-// @public
+// @public @deprecated
 export class TreeConfiguration<TSchema extends ImplicitFieldSchema = ImplicitFieldSchema> {
     constructor(schema: TSchema, initialTree: () => InsertableTreeFieldFromImplicitField<TSchema>, options?: ITreeConfigurationOptions);
+    readonly enableSchemaValidation: boolean;
     // (undocumented)
     readonly initialTree: () => InsertableTreeFieldFromImplicitField<TSchema>;
-    readonly options: Required<ITreeConfigurationOptions>;
     // (undocumented)
     readonly schema: TSchema;
 }
@@ -830,18 +867,27 @@ export enum TreeStatus {
 
 // @public
 export interface TreeView<TSchema extends ImplicitFieldSchema> extends IDisposable {
-    readonly error?: SchemaIncompatible;
+    readonly compatibility: SchemaCompatibilityStatus;
     readonly events: Listenable<TreeViewEvents>;
+    initialize(content: InsertableTreeFieldFromImplicitField<TSchema>): void;
     get root(): TreeFieldFromImplicitField<TSchema>;
     set root(newRoot: InsertableTreeFieldFromImplicitField<TSchema>);
     upgradeSchema(): void;
 }
 
+// @public
+export class TreeViewConfiguration<TSchema extends ImplicitFieldSchema = ImplicitFieldSchema> implements Required<ITreeViewConfiguration<TSchema>> {
+    constructor(props: ITreeViewConfiguration<TSchema>);
+    readonly enableSchemaValidation: boolean;
+    readonly schema: TSchema;
+}
+
 // @public
 export interface TreeViewEvents {
     afterBatch(): void;
     commitApplied(data: CommitMetadata, getRevertible?: RevertibleFactory): void;
     rootChanged(): void;
+    schemaChanged(): void;
 }
 
 // @public

package/api-report/fluid-framework.public.api.md

@@ -102,6 +102,12 @@ export abstract class ErasedType<out Name = unknown> {
 // @public
 type ExtractItemType<Item extends LazyItem> = Item extends () => infer Result ? Result : Item;
 
+// @public
+export type FieldHasDefault<T extends ImplicitFieldSchema> = T extends FieldSchema<FieldKind.Optional | FieldKind.Identifier> ? true : false;
+
+// @public
+export type FieldHasDefaultUnsafe<T extends Unenforced<ImplicitFieldSchema>> = T extends FieldSchemaUnsafe<FieldKind.Optional | FieldKind.Identifier, Unenforced<ImplicitAllowedTypes>> ? true : false;
+
 // @public
 export enum FieldKind {
     Identifier = 2,
@@ -131,6 +137,11 @@ export interface FieldSchemaUnsafe<out Kind extends FieldKind, out Types extends
     readonly kind: Kind;
 }
 
+// @public
+type FlattenKeys<T> = [{
+    [Property in keyof T]: T[Property];
+}][_InlineTrick];
+
 // @public
 export type FlexList<Item = unknown> = readonly LazyItem<Item>[];
 
@@ -410,13 +421,20 @@ export type InitialObjects<T extends ContainerSchema> = {
 };
 
 // @public
-export type InsertableObjectFromSchemaRecord<T extends RestrictiveReadonlyRecord<string, ImplicitFieldSchema>> = {
-    readonly [Property in keyof T]: InsertableTreeFieldFromImplicitField<T[Property]>;
-};
+type _InlineTrick = 0;
+
+// @public
+export type InsertableObjectFromSchemaRecord<T extends RestrictiveReadonlyRecord<string, ImplicitFieldSchema>> = InternalUtilTypes.FlattenKeys<{
+    readonly [Property in keyof T]?: InsertableTreeFieldFromImplicitField<T[Property]>;
+} & {
+    readonly [Property in keyof T as FieldHasDefault<T[Property]> extends false ? Property : never]: InsertableTreeFieldFromImplicitField<T[Property]>;
+}>;
 
 // @public
 export type InsertableObjectFromSchemaRecordUnsafe<T extends Unenforced<RestrictiveReadonlyRecord<string, ImplicitFieldSchema>>> = {
-    readonly [Property in keyof T]: InsertableTreeFieldFromImplicitFieldUnsafe<T[Property]>;
+    readonly [Property in keyof T as FieldHasDefaultUnsafe<T[Property]> extends false ? Property : never]: InsertableTreeFieldFromImplicitFieldUnsafe<T[Property]>;
+} & {
+    readonly [Property in keyof T as FieldHasDefaultUnsafe<T[Property]> extends true ? Property : never]?: InsertableTreeFieldFromImplicitFieldUnsafe<T[Property]>;
 };
 
 // @public
@@ -460,6 +478,14 @@ export { InternalSimpleTreeTypes }
 export interface InternalTreeNode extends ErasedType<"@fluidframework/tree.InternalTreeNode"> {
 }
 
+declare namespace InternalUtilTypes {
+    export {
+        _InlineTrick,
+        FlattenKeys
+    }
+}
+export { InternalUtilTypes }
+
 // @public (undocumented)
 export interface IProvideFluidLoadable {
     // (undocumented)
@@ -497,7 +523,9 @@ export class IterableTreeArrayContent<T> implements Iterable<T> {
 
 // @public
 export interface ITree extends IFluidLoadable {
+    // @deprecated
     schematize<TRoot extends ImplicitFieldSchema>(config: TreeConfiguration<TRoot>): TreeView<TRoot>;
+    viewWith<TRoot extends ImplicitFieldSchema>(config: TreeViewConfiguration<TRoot>): TreeView<TRoot>;
 }
 
 // @public
@@ -505,6 +533,12 @@ export interface ITreeConfigurationOptions {
     enableSchemaValidation?: boolean;
 }
 
+// @public
+export interface ITreeViewConfiguration<TSchema extends ImplicitFieldSchema = ImplicitFieldSchema> {
+    readonly enableSchemaValidation?: boolean;
+    readonly schema: TSchema;
+}
+
 // @public
 export type LazyItem<Item = unknown> = Item | (() => Item);
 
@@ -618,6 +652,14 @@ export interface RunTransaction {
     readonly rollback: typeof rollback;
 }
 
+// @public
+export interface SchemaCompatibilityStatus {
+    readonly canInitialize: boolean;
+    readonly canUpgrade: boolean;
+    readonly canView: boolean;
+    readonly isEquivalent: boolean;
+}
+
 // @public @sealed
 export class SchemaFactory<out TScope extends string | undefined = string | undefined, TName extends number | string = string> {
     constructor(scope: TScope);
@@ -640,7 +682,7 @@ export class SchemaFactory<out TScope extends string | undefined = string | unde
     readonly null: TreeNodeSchema<"com.fluidframework.leaf.null", NodeKind.Leaf, null, null>;
     readonly number: TreeNodeSchema<"com.fluidframework.leaf.number", NodeKind.Leaf, number, number>;
     object<const Name extends TName, const T extends RestrictiveReadonlyRecord<string, ImplicitFieldSchema>>(name: Name, fields: T): TreeNodeSchemaClass<ScopedSchemaName<TScope, Name>, NodeKind.Object, TreeObjectNode<T, ScopedSchemaName<TScope, Name>>, object & InsertableObjectFromSchemaRecord<T>, true, T>;
-    objectRecursive<const Name extends TName, const T extends Unenforced<RestrictiveReadonlyRecord<string, ImplicitFieldSchema>>>(name: Name, t: T): TreeNodeSchemaClass<ScopedSchemaName<TScope, Name>, NodeKind.Object, TreeObjectNodeUnsafe<T, ScopedSchemaName<TScope, Name>>, object & InsertableObjectFromSchemaRecordUnsafe<T>, false, T>;
+    objectRecursive<const Name extends TName, const T extends Unenforced<RestrictiveReadonlyRecord<string, ImplicitFieldSchema>>>(name: Name, t: T): TreeNodeSchemaClass<ScopedSchemaName<TScope, Name>, NodeKind.Object, TreeObjectNodeUnsafe<T, ScopedSchemaName<TScope, Name>>, object & { readonly [Property in keyof T as FieldHasDefaultUnsafe<T[Property]> extends false ? Property : never]: InsertableTreeFieldFromImplicitFieldUnsafe<T[Property]>; } & { readonly [Property_1 in keyof T as FieldHasDefaultUnsafe<T[Property_1]> extends true ? Property_1 : never]?: InsertableTreeFieldFromImplicitFieldUnsafe<T[Property_1]> | undefined; }, false, T>;
     optional<const T extends ImplicitAllowedTypes>(t: T, props?: Omit<FieldProps, "defaultProvider">): FieldSchema<FieldKind.Optional, T>;
     optionalRecursive<const T extends Unenforced<ImplicitAllowedTypes>>(t: T, props?: Omit<FieldProps, "defaultProvider">): FieldSchemaUnsafe<FieldKind.Optional, T>;
     required<const T extends ImplicitAllowedTypes>(t: T, props?: Omit<FieldProps, "defaultProvider">): FieldSchema<FieldKind.Required, T>;
@@ -650,11 +692,6 @@ export class SchemaFactory<out TScope extends string | undefined = string | unde
     readonly string: TreeNodeSchema<"com.fluidframework.leaf.string", NodeKind.Leaf, string, string>;
 }
 
-// @public
-export interface SchemaIncompatible {
-    readonly canUpgrade: boolean;
-}
-
 // @public
 export type ScopedSchemaName<TScope extends string | undefined, TName extends number | string> = TScope extends undefined ? `${TName}` : `${TScope}.${TName}`;
 
@@ -731,12 +768,12 @@ export interface TreeChangeEvents {
     treeChanged(): void;
 }
 
-// @public
+// @public @deprecated
 export class TreeConfiguration<TSchema extends ImplicitFieldSchema = ImplicitFieldSchema> {
     constructor(schema: TSchema, initialTree: () => InsertableTreeFieldFromImplicitField<TSchema>, options?: ITreeConfigurationOptions);
+    readonly enableSchemaValidation: boolean;
     // (undocumented)
     readonly initialTree: () => InsertableTreeFieldFromImplicitField<TSchema>;
-    readonly options: Required<ITreeConfigurationOptions>;
     // (undocumented)
     readonly schema: TSchema;
 }
@@ -830,18 +867,27 @@ export enum TreeStatus {
 
 // @public
 export interface TreeView<TSchema extends ImplicitFieldSchema> extends IDisposable {
-    readonly error?: SchemaIncompatible;
+    readonly compatibility: SchemaCompatibilityStatus;
     readonly events: Listenable<TreeViewEvents>;
+    initialize(content: InsertableTreeFieldFromImplicitField<TSchema>): void;
     get root(): TreeFieldFromImplicitField<TSchema>;
     set root(newRoot: InsertableTreeFieldFromImplicitField<TSchema>);
     upgradeSchema(): void;
 }
 
+// @public
+export class TreeViewConfiguration<TSchema extends ImplicitFieldSchema = ImplicitFieldSchema> implements Required<ITreeViewConfiguration<TSchema>> {
+    constructor(props: ITreeViewConfiguration<TSchema>);
+    readonly enableSchemaValidation: boolean;
+    readonly schema: TSchema;
+}
+
 // @public
 export interface TreeViewEvents {
     afterBatch(): void;
     commitApplied(data: CommitMetadata, getRevertible?: RevertibleFactory): void;
     rootChanged(): void;
+    schemaChanged(): void;
 }
 
 // @public

package/dist/legacy.d.ts

@@ -11,7 +11,8 @@
 export {
 	// Unrestricted APIs
 	InternalFlexListTypes, 
-	InternalSimpleTreeTypes,
+	InternalSimpleTreeTypes, 
+	InternalUtilTypes,
  
 	// @public APIs
 	AllowedTypes, 
@@ -24,6 +25,8 @@ export {
 	ContainerSchema, 
 	DefaultProvider, 
 	ErasedType, 
+	FieldHasDefault, 
+	FieldHasDefaultUnsafe, 
 	FieldKind, 
 	FieldProps, 
 	FieldSchema, 
@@ -52,6 +55,7 @@ export {
 	ITelemetryBaseProperties, 
 	ITree, 
 	ITreeConfigurationOptions, 
+	ITreeViewConfiguration, 
 	ImplicitAllowedTypes, 
 	ImplicitFieldSchema, 
 	InitialObjects, 
@@ -87,8 +91,8 @@ export {
 	RevertibleFactory, 
 	RevertibleStatus, 
 	RunTransaction, 
+	SchemaCompatibilityStatus, 
 	SchemaFactory, 
-	SchemaIncompatible, 
 	ScopedSchemaName, 
 	SharedObjectKind, 
 	SharedTree, 
@@ -120,6 +124,7 @@ export {
 	TreeObjectNodeUnsafe, 
 	TreeStatus, 
 	TreeView, 
+	TreeViewConfiguration, 
 	TreeViewEvents, 
 	Unenforced, 
 	Unhydrated, 

package/dist/public.d.ts

@@ -11,7 +11,8 @@
 export {
 	// Unrestricted APIs
 	InternalFlexListTypes, 
-	InternalSimpleTreeTypes,
+	InternalSimpleTreeTypes, 
+	InternalUtilTypes,
  
 	// @public APIs
 	AllowedTypes, 
@@ -24,6 +25,8 @@ export {
 	ContainerSchema, 
 	DefaultProvider, 
 	ErasedType, 
+	FieldHasDefault, 
+	FieldHasDefaultUnsafe, 
 	FieldKind, 
 	FieldProps, 
 	FieldSchema, 
@@ -52,6 +55,7 @@ export {
 	ITelemetryBaseProperties, 
 	ITree, 
 	ITreeConfigurationOptions, 
+	ITreeViewConfiguration, 
 	ImplicitAllowedTypes, 
 	ImplicitFieldSchema, 
 	InitialObjects, 
@@ -87,8 +91,8 @@ export {
 	RevertibleFactory, 
 	RevertibleStatus, 
 	RunTransaction, 
+	SchemaCompatibilityStatus, 
 	SchemaFactory, 
-	SchemaIncompatible, 
 	ScopedSchemaName, 
 	SharedObjectKind, 
 	SharedTree, 
@@ -120,6 +124,7 @@ export {
 	TreeObjectNodeUnsafe, 
 	TreeStatus, 
 	TreeView, 
+	TreeViewConfiguration, 
 	TreeViewEvents, 
 	Unenforced, 
 	Unhydrated, 

package/lib/legacy.d.ts

@@ -11,7 +11,8 @@
 export {
 	// Unrestricted APIs
 	InternalFlexListTypes, 
-	InternalSimpleTreeTypes,
+	InternalSimpleTreeTypes, 
+	InternalUtilTypes,
  
 	// @public APIs
 	AllowedTypes, 
@@ -24,6 +25,8 @@ export {
 	ContainerSchema, 
 	DefaultProvider, 
 	ErasedType, 
+	FieldHasDefault, 
+	FieldHasDefaultUnsafe, 
 	FieldKind, 
 	FieldProps, 
 	FieldSchema, 
@@ -52,6 +55,7 @@ export {
 	ITelemetryBaseProperties, 
 	ITree, 
 	ITreeConfigurationOptions, 
+	ITreeViewConfiguration, 
 	ImplicitAllowedTypes, 
 	ImplicitFieldSchema, 
 	InitialObjects, 
@@ -87,8 +91,8 @@ export {
 	RevertibleFactory, 
 	RevertibleStatus, 
 	RunTransaction, 
+	SchemaCompatibilityStatus, 
 	SchemaFactory, 
-	SchemaIncompatible, 
 	ScopedSchemaName, 
 	SharedObjectKind, 
 	SharedTree, 
@@ -120,6 +124,7 @@ export {
 	TreeObjectNodeUnsafe, 
 	TreeStatus, 
 	TreeView, 
+	TreeViewConfiguration, 
 	TreeViewEvents, 
 	Unenforced, 
 	Unhydrated, 

package/lib/public.d.ts

@@ -11,7 +11,8 @@
 export {
 	// Unrestricted APIs
 	InternalFlexListTypes, 
-	InternalSimpleTreeTypes,
+	InternalSimpleTreeTypes, 
+	InternalUtilTypes,
  
 	// @public APIs
 	AllowedTypes, 
@@ -24,6 +25,8 @@ export {
 	ContainerSchema, 
 	DefaultProvider, 
 	ErasedType, 
+	FieldHasDefault, 
+	FieldHasDefaultUnsafe, 
 	FieldKind, 
 	FieldProps, 
 	FieldSchema, 
@@ -52,6 +55,7 @@ export {
 	ITelemetryBaseProperties, 
 	ITree, 
 	ITreeConfigurationOptions, 
+	ITreeViewConfiguration, 
 	ImplicitAllowedTypes, 
 	ImplicitFieldSchema, 
 	InitialObjects, 
@@ -87,8 +91,8 @@ export {
 	RevertibleFactory, 
 	RevertibleStatus, 
 	RunTransaction, 
+	SchemaCompatibilityStatus, 
 	SchemaFactory, 
-	SchemaIncompatible, 
 	ScopedSchemaName, 
 	SharedObjectKind, 
 	SharedTree, 
@@ -120,6 +124,7 @@ export {
 	TreeObjectNodeUnsafe, 
 	TreeStatus, 
 	TreeView, 
+	TreeViewConfiguration, 
 	TreeViewEvents, 
 	Unenforced, 
 	Unhydrated, 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fluid-framework",
-  "version": "2.0.0-dev-rc.5.0.0.270987",
+  "version": "2.0.0-dev-rc.5.0.0.271262",
   "description": "The main entry point into Fluid Framework public packages",
   "homepage": "https://fluidframework.com",
   "repository": {
@@ -37,15 +37,15 @@
   "main": "lib/index.js",
   "types": "lib/public.d.ts",
   "dependencies": {
-    "@fluidframework/container-definitions": "2.0.0-dev-rc.5.0.0.270987",
-    "@fluidframework/container-loader": "2.0.0-dev-rc.5.0.0.270987",
-    "@fluidframework/core-interfaces": "2.0.0-dev-rc.5.0.0.270987",
-    "@fluidframework/driver-definitions": "2.0.0-dev-rc.5.0.0.270987",
-    "@fluidframework/fluid-static": "2.0.0-dev-rc.5.0.0.270987",
-    "@fluidframework/map": "2.0.0-dev-rc.5.0.0.270987",
-    "@fluidframework/sequence": "2.0.0-dev-rc.5.0.0.270987",
-    "@fluidframework/shared-object-base": "2.0.0-dev-rc.5.0.0.270987",
-    "@fluidframework/tree": "2.0.0-dev-rc.5.0.0.270987"
+    "@fluidframework/container-definitions": "2.0.0-dev-rc.5.0.0.271262",
+    "@fluidframework/container-loader": "2.0.0-dev-rc.5.0.0.271262",
+    "@fluidframework/core-interfaces": "2.0.0-dev-rc.5.0.0.271262",
+    "@fluidframework/driver-definitions": "2.0.0-dev-rc.5.0.0.271262",
+    "@fluidframework/fluid-static": "2.0.0-dev-rc.5.0.0.271262",
+    "@fluidframework/map": "2.0.0-dev-rc.5.0.0.271262",
+    "@fluidframework/sequence": "2.0.0-dev-rc.5.0.0.271262",
+    "@fluidframework/shared-object-base": "2.0.0-dev-rc.5.0.0.271262",
+    "@fluidframework/tree": "2.0.0-dev-rc.5.0.0.271262"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.15.2",