npm - @fluidframework/tree - Versions diffs - 2.53.1 → 2.60.0 - Mend

@fluidframework/tree 2.53.1 → 2.60.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (424) hide show

package/dist/tableSchema.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"tableSchema.js","sourceRoot":"","sources":["../src/tableSchema.ts"],"names":[],"mappings":"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","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n /\n\nimport { assert, oob } from \"@fluidframework/core-utils/internal\";\nimport { UsageError } from \"@fluidframework/telemetry-utils/internal\";\n\nimport { Tree, TreeAlpha } from \"./shared-tree/index.js\";\nimport {\n\ttype FieldHasDefault,\n\ttype ImplicitAllowedTypes,\n\ttype InsertableObjectFromSchemaRecord,\n\ttype InsertableTreeNodeFromImplicitAllowedTypes,\n\ttype NodeKind,\n\ttype SchemaFactoryAlpha,\n\ttype ScopedSchemaName,\n\tTreeArrayNode,\n\ttype TreeNode,\n\ttype TreeNodeFromImplicitAllowedTypes,\n\ttype TreeNodeSchema,\n\ttype TreeNodeSchemaClass,\n\ttype WithType,\n\ttype TreeFieldFromImplicitField,\n\ttype InsertableTreeFieldFromImplicitField,\n\ttype InternalTreeNode,\n\tSchemaFactory,\n\ttype ImplicitAnnotatedFieldSchema,\n\ttype UnannotateImplicitFieldSchema,\n\tisArrayNodeSchema,\n\ttype InsertableField,\n} from \"./simple-tree/index.js\";\n\n// Future improvement TODOs:\n// - Omit `cells` property from Row insertion type.\n// - Record-like type parameters / input parameters?\n// - Omit `props` properties from Row and Column schemas when not provided?\n\n// Longer-term work:\n// - Add constraint APIs to make it possible to avoid situations that could yield \"orphaned\" cells.\n\n/\n The sub-scope applied to user-provided {@link SchemaFactory}s by table schema factories.\n /\nconst tableSchemaFactorySubScope = \"table\";\n\n/\n Gets the table containing the provided row/column node, if the node is part of a table.\n * @remarks Assumes that the table is the grandparent of the row/column node.\n /\nfunction getParentTable(\n\trowOrColumnNode: TreeNode,\n):\n\t\| (TreeNode &\n\t\t\tTableSchema.Table<\n\t\t\t\tstring \| undefined,\n\t\t\t\tImplicitAllowedTypes,\n\t\t\t\tSystem_TableSchema.ColumnSchemaBase,\n\t\t\t\tSystem_TableSchema.RowSchemaBase\n\t\t\t>)\n\t\| undefined {\n\tconst rowListNode = Tree.parent(rowOrColumnNode);\n\tif (rowListNode === undefined \|\| !isArrayNodeSchema(Tree.schema(rowListNode))) {\n\t\treturn undefined;\n\t}\n\tconst tableNode = Tree.parent(rowListNode);\n\tif (tableNode === undefined \|\| !isTableNode(tableNode)) {\n\t\treturn undefined;\n\t}\n\n\treturn tableNode;\n}\n\n/\n A private symbol put on table schema to help identify them.\n /\nconst tableSchemaSymbol: unique symbol = Symbol(\"tableNode\");\n\n/\n Type-guard to determine if a node is a table node.\n * @remarks Uses {@link tableSchemaSymbol} to identify table nodes.\n /\nfunction isTableNode(\n\tnode: TreeNode,\n): node is TreeNode &\n\tTableSchema.Table<\n\t\tstring \| undefined,\n\t\tImplicitAllowedTypes,\n\t\tSystem_TableSchema.ColumnSchemaBase,\n\t\tSystem_TableSchema.RowSchemaBase\n\t> {\n\treturn tableSchemaSymbol in Tree.schema(node);\n}\n\n/\n Not intended for use outside of this package.\n \n @privateRemarks\n * This namespace is a collection of internal system types relate to {@link TableSchema}.\n * This namespace should be strictly type-exported by the package.\n * All members should be tagged with `@system`.\n \n @system @alpha\n /\nexport namespace System_TableSchema {\n\t/\n\t Default type used for column and row \"props\" fields.\n\t * @privateRemarks\n\t * Longer term, it would be better to simply omit \"props\" altogether by default.\n\t * For now, this ensures that the user doesn't have to specify a \"props\" entry when initializing column/row nodes\n\t * and ensures that they cannot set anything that might conflict with future evolutions of the schema.\n\t * @system @alpha\n\t /\n\texport type DefaultPropsType = ReturnType<typeof SchemaFactory.optional<[]>>;\n\n\t/\n\t A base interface for factory input options which include an schema factory.\n\t * @remarks This interface should not be referenced directly.\n\t * @privateRemarks This interface primarily exists to provide a single home for property documentation.\n\t * @system @alpha\n\t /\n\texport interface OptionsWithSchemaFactory<TSchemaFactory extends SchemaFactoryAlpha> {\n\t\t/\n\t\t Schema factory with which the Column schema will be associated.\n\t\t * @remarks Can be used to associate the resulting schema with an existing {@link SchemaFactory.scope\|scope}.\n\t\t /\n\t\treadonly schemaFactory: TSchemaFactory;\n\t}\n\n\t/\n\t A base interface for factory input options which include the table cell schema.\n\t * @remarks This interface should not be referenced directly.\n\t * @privateRemarks This interface primarily exists to provide a single home for property documentation.\n\t * @system @alpha\n\t /\n\texport interface OptionsWithCellSchema<TCellSchema extends ImplicitAllowedTypes> {\n\t\t/\n\t\t Schema for the table's cells.\n\t\t /\n\t\treadonly cell: TCellSchema;\n\t}\n\n\t// #region Column\n\n\t/\n\t Base options for creating table cow schema.\n\t * @remarks Includes parameters common to all column factory overloads.\n\t * @system @alpha\n\t /\n\texport type CreateColumnOptionsBase<\n\t\tTSchemaFactory extends SchemaFactoryAlpha = SchemaFactoryAlpha,\n\t\tTCell extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t> = OptionsWithSchemaFactory<TSchemaFactory> & OptionsWithCellSchema<TCell>;\n\n\t/\n\t Factory for creating column schema.\n\t * @system @alpha\n\t /\n\t// eslint-disable-next-line @typescript-eslint/explicit-function-return-type -- Return type is too complex to be reasonable to specify\n\texport function createColumnSchema<\n\t\tconst TInputScope extends string \| undefined,\n\t\tconst TCellSchema extends ImplicitAllowedTypes,\n\t\tconst TPropsSchema extends ImplicitAnnotatedFieldSchema,\n\t>(\n\t\tinputSchemaFactory: SchemaFactoryAlpha<TInputScope>,\n\t\tcellSchema: TCellSchema,\n\t\tpropsSchema: TPropsSchema,\n\t) {\n\t\tconst schemaFactory = inputSchemaFactory.scopedFactory(tableSchemaFactorySubScope);\n\t\ttype Scope = ScopedSchemaName<TInputScope, typeof tableSchemaFactorySubScope>;\n\n\t\ttype CellValueType = TreeNodeFromImplicitAllowedTypes<TCellSchema>;\n\n\t\t// Note: `columnFields` is broken into two parts to work around a TypeScript bug\n\t\t// that results in broken `.d.ts` output.\n\t\t// See definition of `ColumnInsertableType` below.\n\t\tconst columnFieldsBuiltInParts = {\n\t\t\tid: schemaFactory.identifier,\n\t\t} as const;\n\t\tconst columnFieldsPropsPart = {\n\t\t\tprops: propsSchema,\n\t\t} as const;\n\n\t\t/\n\t\t {@link Column} fields.\n\t\t \n\t\t @remarks\n\t\t * Extracted for re-use in returned type signature defined later in this function.\n\t\t * The implicit typing is intentional.\n\t\t \n\t\t Note: ideally we would add a satisfies clause here to ensure that this satisfies\n\t\t * `Record<string, ImplicitFieldSchema>`, but doing so causes TypeScript to prematurely and incorrectly evaluate the type of `propsSchema`.\n\t\t * Likely related to the following issue: https://github.com/microsoft/TypeScript/issues/52394\n\t\t /\n\t\tconst columnFields = {\n\t\t\t...columnFieldsBuiltInParts,\n\t\t\t...columnFieldsPropsPart,\n\t\t} as const; // satisfies Record<string, ImplicitFieldSchema>;\n\n\t\t/\n\t\t A column in a table.\n\t\t /\n\t\tclass Column\n\t\t\textends schemaFactory.objectAlpha(\"Column\", columnFields, {\n\t\t\t\t// Will make it easier to evolve this schema in the future.\n\t\t\t\tallowUnknownOptionalFields: true,\n\t\t\t})\n\t\t\timplements TableSchema.Column<TCellSchema, TPropsSchema>\n\t\t{\n\t\t\tpublic getCells(): {\n\t\t\t\trowId: string;\n\t\t\t\tcell: CellValueType;\n\t\t\t}[] {\n\t\t\t\tconst tableNode = getParentTable(this);\n\t\t\t\tif (tableNode === undefined) {\n\t\t\t\t\tthrow new UsageError(`Column with ID \"${this.id}\" is not contained in a table.`);\n\t\t\t\t}\n\n\t\t\t\tconst result = [];\n\t\t\t\tfor (const row of tableNode.rows) {\n\t\t\t\t\tconst cell = row.getCell(this.id);\n\t\t\t\t\tif (cell !== undefined) {\n\t\t\t\t\t\tif (!Tree.is(cell, cellSchema)) {\n\t\t\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t\t\t\"Parent table contains a cell with incompatible with this column.\",\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tresult.push({ rowId: row.id, cell: cell as CellValueType });\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn result;\n\t\t\t}\n\t\t}\n\n\t\ttype ColumnValueType = TreeNode &\n\t\t\tTableSchema.Column<TCellSchema, TPropsSchema> &\n\t\t\tWithType<ScopedSchemaName<Scope, \"Column\">>;\n\n\t\t// Note: ideally this type would just leverage `InsertableObjectFromSchemaRecord<typeof columnFields>`,\n\t\t// but that results in broken `.d.ts` output due to a TypeScript bug.\n\t\t// See: https://github.com/microsoft/TypeScript/issues/58688.\n\t\t// Instead we extract and inline the typing of the \"props\" field here, which seems to sufficiently work around the issue.\n\t\t// type ColumnInsertableType = InsertableObjectFromSchemaRecord<typeof columnFields>;\n\t\ttype ColumnInsertableType = InsertableObjectFromSchemaRecord<\n\t\t\ttypeof columnFieldsBuiltInParts\n\t\t> &\n\t\t\t(FieldHasDefault<UnannotateImplicitFieldSchema<TPropsSchema>> extends true\n\t\t\t\t? // Note: The docs on the below properties are copied from `IColumn.props`' docs to ensure that the\n\t\t\t\t\t// documentation appears in the data insertion scenario.\n\t\t\t\t\t// The contents are duplicated instead of using `@inheritdoc`, as intellisense does not correctly\n\t\t\t\t\t// support `@inheritDoc`.\n\t\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/31267\n\t\t\t\t\t{\n\t\t\t\t\t\t/\n\t\t\t\t\t\t The column's properties.\n\t\t\t\t\t\t * @remarks This is a user-defined schema that can be used to store additional information about the column.\n\t\t\t\t\t\t /\n\t\t\t\t\t\tprops?: InsertableTreeFieldFromImplicitField<\n\t\t\t\t\t\t\tUnannotateImplicitFieldSchema<TPropsSchema>\n\t\t\t\t\t\t>;\n\t\t\t\t\t}\n\t\t\t\t: {\n\t\t\t\t\t\t/\n\t\t\t\t\t\t The column's properties.\n\t\t\t\t\t\t * @remarks This is a user-defined schema that can be used to store additional information about the column.\n\t\t\t\t\t\t /\n\t\t\t\t\t\tprops: InsertableTreeFieldFromImplicitField<\n\t\t\t\t\t\t\tUnannotateImplicitFieldSchema<TPropsSchema>\n\t\t\t\t\t\t>;\n\t\t\t\t\t});\n\n\t\t// Modified version of `Column` that ensures the constructor (and `createFromInsertable`) are\n\t\t// typed correctly in terms of our insertable type.\n\t\t// This lets us be selective in our type-cast for the value returned from this function,\n\t\t// preserving as much type-safety as we reasonably can.\n\t\ttype ColumnSchemaModifiedType = Omit<\n\t\t\t// Use mapped type to omit the constructor\n\t\t\t{\n\t\t\t\t[Property in keyof typeof Column]: (typeof Column)[Property];\n\t\t\t},\n\t\t\t\"createFromInsertable\"\n\t\t> &\n\t\t\t(new (\n\t\t\t\tparameters: InternalTreeNode \| ColumnInsertableType,\n\t\t\t) => Column) & {\n\t\t\t\tcreateFromInsertable(parameters: ColumnInsertableType): Column;\n\t\t\t};\n\n\t\t// Returning SingletonSchema without a type conversion results in TypeScript generating something like `readonly \"__#124291@#brand\": unknown;`\n\t\t// for the private brand field of TreeNode.\n\t\t// This numeric id doesn't seem to be stable over incremental builds, and thus causes diffs in the API extractor reports.\n\t\t// This is avoided by doing this type conversion.\n\t\t// The conversion is done via assignment instead of `as` to get stronger type safety.\n\t\tconst ColumnSchemaType: TreeNodeSchemaClass<\n\t\t\t/ Name / ScopedSchemaName<Scope, \"Column\">,\n\t\t\t/ Kind / NodeKind.Object,\n\t\t\t/ TNode / ColumnValueType,\n\t\t\t/ TInsertable / object & ColumnInsertableType,\n\t\t\t/ ImplicitlyConstructable / true,\n\t\t\t/ Info / typeof columnFields\n\t\t> = Column as ColumnSchemaModifiedType;\n\n\t\treturn ColumnSchemaType;\n\t}\n\n\t/\n\t Base column schema type.\n\t * @sealed @system @alpha\n\t /\n\texport type ColumnSchemaBase<\n\t\tTScope extends string \| undefined = string \| undefined,\n\t\tTCellSchema extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t\tTPropsSchema extends ImplicitAnnotatedFieldSchema = ImplicitAnnotatedFieldSchema,\n\t> = ReturnType<typeof createColumnSchema<TScope, TCellSchema, TPropsSchema>>;\n\n\t// #endregion\n\n\t// #region Row\n\n\t/\n\t Base options for creating table row schema.\n\t * @remarks Includes parameters common to all row factory overloads.\n\t * @system @alpha\n\t /\n\texport type CreateRowOptionsBase<\n\t\tTSchemaFactory extends SchemaFactoryAlpha = SchemaFactoryAlpha,\n\t\tTCell extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t> = OptionsWithSchemaFactory<TSchemaFactory> & OptionsWithCellSchema<TCell>;\n\n\t/\n\t Factory for creating row schema.\n\t * @sealed @alpha\n\t /\n\t// eslint-disable-next-line @typescript-eslint/explicit-function-return-type -- Return type is too complex to be reasonable to specify\n\texport function createRowSchema<\n\t\tconst TInputScope extends string \| undefined,\n\t\tconst TCellSchema extends ImplicitAllowedTypes,\n\t\tconst TPropsSchema extends ImplicitAnnotatedFieldSchema,\n\t>(\n\t\tinputSchemaFactory: SchemaFactoryAlpha<TInputScope>,\n\t\tcellSchema: TCellSchema,\n\t\tpropsSchema: TPropsSchema,\n\t) {\n\t\tconst schemaFactory = inputSchemaFactory.scopedFactory(tableSchemaFactorySubScope);\n\t\ttype Scope = ScopedSchemaName<TInputScope, typeof tableSchemaFactorySubScope>;\n\n\t\ttype CellValueType = TreeNodeFromImplicitAllowedTypes<TCellSchema>;\n\t\ttype CellInsertableType = InsertableTreeNodeFromImplicitAllowedTypes<TCellSchema>;\n\n\t\t// Note: `rowFields` is broken into two parts to work around a TypeScript bug\n\t\t// that results in broken `.d.ts` output.\n\t\t// See definition of `RowInsertableType` below.\n\t\tconst rowFieldsBuiltInParts = {\n\t\t\tid: schemaFactory.identifier,\n\t\t\t/\n\t\t\t The cells of the table row, keyed by column ID.\n\t\t\t * @remarks\n\t\t\t * The table row models its cells as a record, where each key is the ID of the column it belongs to. The choice of record (as opposed to a map) is intended to make interop with common table rendering libraries in TypeScript/JavaScript easier.\n\t\t\t /\n\t\t\tcells: schemaFactory.required(schemaFactory.record(\"Row.cells\", cellSchema), {\n\t\t\t\tmetadata: {\n\t\t\t\t\tdescription: \"The cells of the table row, keyed by column ID.\",\n\t\t\t\t},\n\t\t\t}),\n\t\t} as const;\n\t\tconst rowFieldsPropsPart = {\n\t\t\tprops: propsSchema,\n\t\t} as const;\n\n\t\t/\n\t\t {@link Row} fields.\n\t\t * @remarks Extracted for re-use in returned type signature defined later in this function.\n\t\t * The implicit typing is intentional.\n\t\t * Note: ideally we would add a satisfies clause here to ensure that this satisfies\n\t\t * `Record<string, ImplicitFieldSchema>`, but doing so causes TypeScript to prematurely and incorrectly evaluate the type of `propsSchema`.\n\t\t * Likely related to the following issue: https://github.com/microsoft/TypeScript/issues/52394\n\t\t /\n\t\tconst rowFields = {\n\t\t\t...rowFieldsBuiltInParts,\n\t\t\t...rowFieldsPropsPart,\n\t\t} as const; // satisfies Record<string, ImplicitFieldSchema>;\n\n\t\t/\n\t\t The Row schema - this is a map of Cells where the key is the column id\n\t\t /\n\t\tclass Row\n\t\t\textends schemaFactory.objectAlpha(\"Row\", rowFields, {\n\t\t\t\t// Will make it easier to evolve this schema in the future.\n\t\t\t\tallowUnknownOptionalFields: true,\n\t\t\t})\n\t\t\timplements TableSchema.Row<TCellSchema, TPropsSchema>\n\t\t{\n\t\t\tpublic getCell(\n\t\t\t\tcolumnOrId: TableSchema.Column<TCellSchema> \| string,\n\t\t\t): CellValueType \| undefined {\n\t\t\t\tconst columnId = typeof columnOrId === \"string\" ? columnOrId : columnOrId.id;\n\t\t\t\t// Unlike most objects, RecordNodes don't have the default inherited object properties, so this is safe\n\t\t\t\treturn this.cells[columnId];\n\t\t\t}\n\n\t\t\tpublic setCell(\n\t\t\t\tcolumnOrId: TableSchema.Column<TCellSchema> \| string,\n\t\t\t\tvalue: CellInsertableType \| undefined,\n\t\t\t): void {\n\t\t\t\t// TODO: throw if column does not exist in the owning table.\n\n\t\t\t\tif (value === undefined) {\n\t\t\t\t\tthis.removeCell(columnOrId);\n\t\t\t\t} else {\n\t\t\t\t\tconst columnId = typeof columnOrId === \"string\" ? columnOrId : columnOrId.id;\n\n\t\t\t\t\t// TypeScript is unable to narrow the types correctly here, hence the casts.\n\t\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\t\tthis.cells[columnId] = TreeAlpha.create(\n\t\t\t\t\t\tcellSchema,\n\t\t\t\t\t\tvalue as InsertableField<TCellSchema>,\n\t\t\t\t\t) as CellValueType;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tpublic removeCell(\n\t\t\t\tcolumnOrId: TableSchema.Column<TCellSchema> \| string,\n\t\t\t): CellValueType \| undefined {\n\t\t\t\t// TODO: throw if column does not exist in the owning table.\n\n\t\t\t\tconst columnId = typeof columnOrId === \"string\" ? columnOrId : columnOrId.id;\n\n\t\t\t\tconst cell: CellValueType \| undefined = this.getCell(columnId);\n\t\t\t\tif (cell === undefined) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\n\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-dynamic-delete -- The record's values are non-optional, so setting `undefined` as a means to remove the cell is not supported.\n\t\t\t\tdelete this.cells[columnId];\n\n\t\t\t\treturn cell;\n\t\t\t}\n\n\t\t\tpublic getCells(): {\n\t\t\t\tcolumnId: string;\n\t\t\t\tcell: CellValueType;\n\t\t\t}[] {\n\t\t\t\tconst result = [];\n\t\t\t\tfor (const [columnId, cell] of Object.entries(this.cells)) {\n\t\t\t\t\tif (cell !== undefined) {\n\t\t\t\t\t\tresult.push({\n\t\t\t\t\t\t\tcolumnId,\n\t\t\t\t\t\t\tcell,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn result;\n\t\t\t}\n\t\t}\n\n\t\ttype RowValueType = TreeNode &\n\t\t\tTableSchema.Row<TCellSchema, TPropsSchema> &\n\t\t\tWithType<ScopedSchemaName<Scope, \"Row\">>;\n\n\t\t// Note: ideally this type would just leverage `InsertableObjectFromSchemaRecord<typeof rowFields>`,\n\t\t// but that results in broken `.d.ts` output due to a TypeScript bug.\n\t\t// See: https://github.com/microsoft/TypeScript/issues/58688.\n\t\t// Instead we extract and inline the typing of the \"props\" field here, which seems to sufficiently work around\n\t\t// the issue.\n\t\t// type RowInsertableType = InsertableObjectFromSchemaRecord<typeof rowFields>;\n\t\ttype RowInsertableType = InsertableObjectFromSchemaRecord<typeof rowFieldsBuiltInParts> &\n\t\t\t(FieldHasDefault<UnannotateImplicitFieldSchema<TPropsSchema>> extends true\n\t\t\t\t? // Note: The docs on the below properties are copied from `IRow.props`' docs to ensure that the\n\t\t\t\t\t// documentation appears in the data insertion scenario.\n\t\t\t\t\t// The contents are duplicated instead of using `@inheritdoc`, as intellisense does not correctly\n\t\t\t\t\t// support `@inheritDoc`.\n\t\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/31267\n\t\t\t\t\t{\n\t\t\t\t\t\t/\n\t\t\t\t\t\t The row's properties.\n\t\t\t\t\t\t * @remarks This is a user-defined schema that can be used to store additional information\n\t\t\t\t\t\t * about the row.\n\t\t\t\t\t\t /\n\t\t\t\t\t\tprops?: InsertableTreeFieldFromImplicitField<\n\t\t\t\t\t\t\tUnannotateImplicitFieldSchema<TPropsSchema>\n\t\t\t\t\t\t>;\n\t\t\t\t\t}\n\t\t\t\t: {\n\t\t\t\t\t\t/\n\t\t\t\t\t\t The row's properties.\n\t\t\t\t\t\t * @remarks This is a user-defined schema that can be used to store additional information\n\t\t\t\t\t\t * about the row.\n\t\t\t\t\t\t /\n\t\t\t\t\t\tprops: InsertableTreeFieldFromImplicitField<\n\t\t\t\t\t\t\tUnannotateImplicitFieldSchema<TPropsSchema>\n\t\t\t\t\t\t>;\n\t\t\t\t\t});\n\n\t\t// Modified version of `Row` that ensures the constructor (and `createFromInsertable`) are\n\t\t// typed correctly in terms of our insertable type.\n\t\t// This lets us be selective in our type-cast for the value returned from this function,\n\t\t// preserving as much type-safety as we reasonably can.\n\t\ttype RowSchemaModifiedType = Omit<\n\t\t\t// Use mapped type to omit the constructor\n\t\t\t{\n\t\t\t\t[Property in keyof typeof Row]: (typeof Row)[Property];\n\t\t\t},\n\t\t\t\"createFromInsertable\"\n\t\t> &\n\t\t\t(new (\n\t\t\t\tparameters: InternalTreeNode \| RowInsertableType,\n\t\t\t) => Row) & {\n\t\t\t\tcreateFromInsertable(parameters: RowInsertableType): Row;\n\t\t\t};\n\n\t\t// Returning SingletonSchema without a type conversion results in TypeScript generating something like `readonly \"__#124291@#brand\": unknown;`\n\t\t// for the private brand field of TreeNode.\n\t\t// This numeric id doesn't seem to be stable over incremental builds, and thus causes diffs in the API extractor reports.\n\t\t// This is avoided by doing this type conversion.\n\t\t// The conversion is done via assignment instead of `as` to get stronger type safety.\n\t\tconst RowSchemaType: TreeNodeSchemaClass<\n\t\t\t/ Name / ScopedSchemaName<Scope, \"Row\">,\n\t\t\t/ Kind / NodeKind.Object,\n\t\t\t/ TNode / RowValueType,\n\t\t\t/ TInsertable / object & RowInsertableType,\n\t\t\t/ ImplicitlyConstructable / true,\n\t\t\t/ Info / typeof rowFields\n\t\t> = Row as RowSchemaModifiedType;\n\n\t\treturn RowSchemaType;\n\t}\n\n\t/\n\t Base row schema type.\n\t * @sealed @system @alpha\n\t /\n\texport type RowSchemaBase<\n\t\tTScope extends string \| undefined = string \| undefined,\n\t\tTCellSchema extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t\tTPropsSchema extends ImplicitAnnotatedFieldSchema = ImplicitAnnotatedFieldSchema,\n\t> = ReturnType<typeof createRowSchema<TScope, TCellSchema, TPropsSchema>>;\n\n\t// #endregion\n\n\t// #region Table\n\n\t/\n\t Base options for creating table schema.\n\t * @remarks Includes parameters common to all table factory overloads.\n\t * @system @alpha\n\t /\n\texport type TableFactoryOptionsBase<\n\t\tTSchemaFactory extends SchemaFactoryAlpha = SchemaFactoryAlpha,\n\t\tTCell extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t> = OptionsWithSchemaFactory<TSchemaFactory> & OptionsWithCellSchema<TCell>;\n\n\t/\n\t Factory for creating table schema.\n\t * @system @alpha\n\t /\n\t// eslint-disable-next-line @typescript-eslint/explicit-function-return-type -- Return type is too complex to be reasonable to specify\n\texport function createTableSchema<\n\t\tconst TInputScope extends string \| undefined,\n\t\tconst TCellSchema extends ImplicitAllowedTypes,\n\t\tconst TColumnSchema extends ColumnSchemaBase<TInputScope, TCellSchema>,\n\t\tconst TRowSchema extends RowSchemaBase<TInputScope, TCellSchema>,\n\t>(\n\t\tinputSchemaFactory: SchemaFactoryAlpha<TInputScope>,\n\t\t_cellSchema: TCellSchema,\n\t\tcolumnSchema: TColumnSchema,\n\t\trowSchema: TRowSchema,\n\t) {\n\t\tconst schemaFactory = inputSchemaFactory.scopedFactory(tableSchemaFactorySubScope);\n\t\ttype Scope = ScopedSchemaName<TInputScope, typeof tableSchemaFactorySubScope>;\n\n\t\ttype CellValueType = TreeNodeFromImplicitAllowedTypes<TCellSchema>;\n\t\ttype ColumnValueType = TreeNodeFromImplicitAllowedTypes<TColumnSchema>;\n\t\ttype RowValueType = TreeNodeFromImplicitAllowedTypes<TRowSchema>;\n\n\t\t/\n\t\t {@link Table} fields.\n\t\t * @remarks Extracted for re-use in returned type signature defined later in this function.\n\t\t * The implicit typing is intentional.\n\t\t /\n\t\tconst tableFields = {\n\t\t\trows: schemaFactory.array(\"Table.rows\", rowSchema),\n\t\t\tcolumns: schemaFactory.array(\"Table.columns\", columnSchema),\n\t\t} as const satisfies Record<string, ImplicitAnnotatedFieldSchema>;\n\n\t\t/\n\t\t The Table schema\n\t\t /\n\t\tclass Table\n\t\t\textends schemaFactory.objectAlpha(\"Table\", tableFields, {\n\t\t\t\t// Will make it easier to evolve this schema in the future.\n\t\t\t\tallowUnknownOptionalFields: true,\n\t\t\t})\n\t\t\timplements TableSchema.Table<TInputScope, TCellSchema, TColumnSchema, TRowSchema>\n\t\t{\n\t\t\tpublic static empty<TThis extends TableConstructorType>(\n\t\t\t\tthis: TThis,\n\t\t\t): InstanceType<TThis> {\n\t\t\t\treturn new this({ columns: [], rows: [] }) as InstanceType<TThis>;\n\t\t\t}\n\n\t\t\tpublic getColumn(id: string): ColumnValueType \| undefined {\n\t\t\t\t// TypeScript is unable to narrow the types correctly here, hence the casts.\n\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\treturn this.columns.find((column) => (column as ColumnValueType).id === id) as\n\t\t\t\t\t\| ColumnValueType\n\t\t\t\t\t\| undefined;\n\t\t\t}\n\n\t\t\tpublic getRow(id: string): RowValueType \| undefined {\n\t\t\t\t// TypeScript is unable to narrow the types correctly here, hence the casts.\n\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\treturn this.rows.find((_row) => (_row as RowValueType).id === id) as\n\t\t\t\t\t\| RowValueType\n\t\t\t\t\t\| undefined;\n\t\t\t}\n\n\t\t\tpublic getCell(\n\t\t\t\tkey: TableSchema.CellKey<TColumnSchema, TRowSchema>,\n\t\t\t): CellValueType \| undefined {\n\t\t\t\tconst { column: columnOrId, row: rowOrId } = key;\n\t\t\t\tconst row = this._getRow(rowOrId);\n\t\t\t\tif (row === undefined) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\n\t\t\t\tconst column = this._getColumn(columnOrId);\n\t\t\t\tif (column === undefined) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\n\t\t\t\treturn row.getCell(column);\n\t\t\t}\n\n\t\t\tpublic insertColumn({\n\t\t\t\tcolumn,\n\t\t\t\tindex,\n\t\t\t}: TableSchema.InsertColumnParameters<TColumnSchema>): ColumnValueType {\n\t\t\t\tconst inserted = this.insertColumns({\n\t\t\t\t\tcolumns: [column],\n\t\t\t\t\tindex,\n\t\t\t\t});\n\t\t\t\treturn inserted[0] ?? oob();\n\t\t\t}\n\n\t\t\tpublic insertColumns({\n\t\t\t\tcolumns,\n\t\t\t\tindex,\n\t\t\t}: TableSchema.InsertColumnsParameters<TColumnSchema>): ColumnValueType[] {\n\t\t\t\t// Ensure index is valid\n\t\t\t\tif (index !== undefined) {\n\t\t\t\t\tTable.validateInsertionIndex(index, this.columns);\n\t\t\t\t}\n\n\t\t\t\t// TypeScript is unable to narrow the column type correctly here, hence the casts below.\n\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\tif (index === undefined) {\n\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\tthis.columns.insertAtEnd(TreeArrayNode.spread(columns) as any);\n\t\t\t\t} else {\n\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\tthis.columns.insertAt(index, TreeArrayNode.spread(columns) as any);\n\t\t\t\t}\n\n\t\t\t\t// Inserting the input nodes into the tree hydrates them, making them usable as nodes.\n\t\t\t\treturn columns as unknown as ColumnValueType[];\n\t\t\t}\n\n\t\t\tpublic insertRow({\n\t\t\t\trow,\n\t\t\t\tindex,\n\t\t\t}: TableSchema.InsertRowParameters<TRowSchema>): RowValueType {\n\t\t\t\tconst inserted = this.insertRows({\n\t\t\t\t\trows: [row],\n\t\t\t\t\tindex,\n\t\t\t\t});\n\t\t\t\treturn inserted[0] ?? oob();\n\t\t\t}\n\n\t\t\tpublic insertRows({\n\t\t\t\tindex,\n\t\t\t\trows,\n\t\t\t}: TableSchema.InsertRowsParameters<TRowSchema>): RowValueType[] {\n\t\t\t\t// #region Input validation\n\n\t\t\t\t// Ensure index is valid\n\t\t\t\tif (index !== undefined) {\n\t\t\t\t\tTable.validateInsertionIndex(index, this.rows);\n\t\t\t\t}\n\n\t\t\t\t// Note: TypeScript is unable to narrow the type of the row type correctly here, hence the casts below.\n\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\tfor (const newRow of rows) {\n\t\t\t\t\t// If the row contains cells, verify that the table contains the columns for those cells.\n\t\t\t\t\t// Note: we intentionally hide `cells` on `IRow` to avoid leaking the internal data representation as much as possible, so we have to cast here.\n\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\tif ((newRow as any).cells !== undefined) {\n\t\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\t\tconst keys: string[] = Object.keys((newRow as any).cells);\n\t\t\t\t\t\tfor (const key of keys) {\n\t\t\t\t\t\t\tif (!this.containsColumnWithId(key)) {\n\t\t\t\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t\t\t\t`Attempted to insert row a cell under column ID \"${key}\", but the table does not contain a column with that ID.`,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\t// #endregion\n\n\t\t\t\t// TypeScript is unable to narrow the row type correctly here, hence the casts below.\n\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\tif (index === undefined) {\n\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\tthis.rows.insertAtEnd(TreeArrayNode.spread(rows) as any);\n\t\t\t\t} else {\n\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\tthis.rows.insertAt(index, TreeArrayNode.spread(rows) as any);\n\t\t\t\t}\n\n\t\t\t\t// Inserting the input nodes into the tree hydrates them, making them usable as nodes.\n\t\t\t\treturn rows as unknown as RowValueType[];\n\t\t\t}\n\n\t\t\tpublic setCell({\n\t\t\t\tkey,\n\t\t\t\tcell,\n\t\t\t}: TableSchema.SetCellParameters<TCellSchema, TColumnSchema, TRowSchema>): void {\n\t\t\t\tconst { column: columnOrId, row: rowOrId } = key;\n\n\t\t\t\tconst row = this._getRow(rowOrId);\n\t\t\t\tif (row === undefined) {\n\t\t\t\t\tconst rowId = this._getRowId(rowOrId);\n\t\t\t\t\tthrow new UsageError(`No row with ID \"${rowId}\" exists in the table.`);\n\t\t\t\t}\n\n\t\t\t\tconst column = this._getColumn(columnOrId);\n\t\t\t\tif (column === undefined) {\n\t\t\t\t\tconst columnId = this._getColumnId(columnOrId);\n\t\t\t\t\tthrow new UsageError(`No column with ID \"${columnId}\" exists in the table.`);\n\t\t\t\t}\n\n\t\t\t\trow.setCell(column, cell);\n\t\t\t}\n\n\t\t\tpublic removeColumns(\n\t\t\t\tcolumns: readonly string[] \| readonly ColumnValueType[],\n\t\t\t): ColumnValueType[] {\n\t\t\t\t// If there are no columns to remove, do nothing\n\t\t\t\tif (columns.length === 0) {\n\t\t\t\t\treturn [];\n\t\t\t\t}\n\n\t\t\t\t// If there is only one column to remove, remove it (and don't incur cost of transaction)\n\t\t\t\tif (columns.length === 1) {\n\t\t\t\t\tconst removedColumn = this.removeColumn(columns[0] ?? oob());\n\t\t\t\t\treturn [removedColumn];\n\t\t\t\t}\n\n\t\t\t\t// If there are multiple columns to remove, remove them in a transaction.\n\t\t\t\tconst removedColumns: ColumnValueType[] = [];\n\t\t\t\tTree.runTransaction(this, () => {\n\t\t\t\t\t// Note, throwing an error within a transaction will abort the entire transaction.\n\t\t\t\t\t// So if we throw an error here for any row, no columns will be removed.\n\t\t\t\t\tfor (const columnToRemove of columns) {\n\t\t\t\t\t\tconst removedRow = this.removeColumn(columnToRemove);\n\t\t\t\t\t\tremovedColumns.push(removedRow);\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t\treturn removedColumns;\n\t\t\t}\n\n\t\t\tpublic removeColumn(columnOrId: string \| ColumnValueType): ColumnValueType {\n\t\t\t\tconst column = this._getColumn(columnOrId);\n\t\t\t\tconst index = column === undefined ? -1 : this.columns.indexOf(column);\n\t\t\t\tif (index === -1) {\n\t\t\t\t\tconst columnId = this._getColumnId(columnOrId);\n\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t`Specified column with ID \"${columnId}\" does not exist in the table.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tassert(column !== undefined, 0xc10 / column should not be undefined /);\n\n\t\t\t\tTree.runTransaction(this, () => {\n\t\t\t\t\t// Remove the corresponding cell from all rows.\n\t\t\t\t\tfor (const row of this.rows) {\n\t\t\t\t\t\t// TypeScript is unable to narrow the row type correctly here, hence the cast.\n\t\t\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\t\t\t(row as RowValueType).removeCell(column);\n\t\t\t\t\t}\n\n\t\t\t\t\tthis.columns.removeAt(index);\n\t\t\t\t});\n\n\t\t\t\treturn column;\n\t\t\t}\n\n\t\t\tpublic removeAllColumns(): ColumnValueType[] {\n\t\t\t\t// TypeScript is unable to narrow the row type correctly here, hence the cast.\n\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\treturn this.removeColumns(this.columns as unknown as ColumnValueType[]);\n\t\t\t}\n\n\t\t\tpublic removeRows(rows: readonly string[] \| readonly RowValueType[]): RowValueType[] {\n\t\t\t\t// If there are no rows to remove, do nothing\n\t\t\t\tif (rows.length === 0) {\n\t\t\t\t\treturn [];\n\t\t\t\t}\n\n\t\t\t\t// If there is only one row to remove, remove it (and don't incur cost of transaction)\n\t\t\t\tif (rows.length === 1) {\n\t\t\t\t\tconst removedRow = this.removeRow(rows[0] ?? oob());\n\t\t\t\t\treturn [removedRow];\n\t\t\t\t}\n\n\t\t\t\t// If there are multiple rows to remove, remove them in a transaction.\n\t\t\t\tconst removedRows: RowValueType[] = [];\n\t\t\t\tTree.runTransaction(this, () => {\n\t\t\t\t\t// Note, throwing an error within a transaction will abort the entire transaction.\n\t\t\t\t\t// So if we throw an error here for any row, no rows will be removed.\n\t\t\t\t\tfor (const rowToRemove of rows) {\n\t\t\t\t\t\tconst removedRow = this.removeRow(rowToRemove);\n\t\t\t\t\t\tremovedRows.push(removedRow);\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t\treturn removedRows;\n\t\t\t}\n\n\t\t\tpublic removeRow(rowOrId: string \| RowValueType): RowValueType {\n\t\t\t\tconst rowToRemove = this._getRow(rowOrId);\n\t\t\t\tconst index = rowToRemove === undefined ? -1 : this.rows.indexOf(rowToRemove);\n\n\t\t\t\t// If the row does not exist in the table, throw an error.\n\t\t\t\tif (index === -1) {\n\t\t\t\t\tconst rowId = this._getRowId(rowOrId);\n\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t`Specified row with ID \"${rowId}\" does not exist in the table.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\tthis.rows.removeAt(index);\n\t\t\t\treturn rowToRemove as RowValueType;\n\t\t\t}\n\n\t\t\tpublic removeAllRows(): RowValueType[] {\n\t\t\t\t// TypeScript is unable to narrow the row type correctly here, hence the cast.\n\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\treturn this.removeRows(this.rows as unknown as RowValueType[]);\n\t\t\t}\n\n\t\t\tpublic removeCell(\n\t\t\t\tkey: TableSchema.CellKey<TColumnSchema, TRowSchema>,\n\t\t\t): CellValueType \| undefined {\n\t\t\t\tconst { column: columnOrId, row: rowOrId } = key;\n\t\t\t\tconst row = this._getRow(rowOrId);\n\t\t\t\tif (row === undefined) {\n\t\t\t\t\tconst rowId = this._getRowId(rowOrId);\n\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t`Specified row with ID \"${rowId}\" does not exist in the table.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\tconst column = this._getColumn(columnOrId);\n\t\t\t\tif (column === undefined) {\n\t\t\t\t\tconst columnId = this._getColumnId(columnOrId);\n\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t`Specified column with ID \"${columnId}\" does not exist in the table.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\tconst cell: CellValueType \| undefined = row.getCell(column.id);\n\t\t\t\tif (cell === undefined) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\n\t\t\t\trow.removeCell(column.id);\n\t\t\t\treturn cell;\n\t\t\t}\n\n\t\t\tprivate _getColumn(columnOrId: string \| ColumnValueType): ColumnValueType \| undefined {\n\t\t\t\treturn typeof columnOrId === \"string\" ? this.getColumn(columnOrId) : columnOrId;\n\t\t\t}\n\n\t\t\tprivate _getColumnId(columnOrId: string \| ColumnValueType): string {\n\t\t\t\treturn typeof columnOrId === \"string\" ? columnOrId : columnOrId.id;\n\t\t\t}\n\n\t\t\tprivate _getRow(rowOrId: string \| RowValueType): RowValueType \| undefined {\n\t\t\t\treturn typeof rowOrId === \"string\" ? this.getRow(rowOrId) : rowOrId;\n\t\t\t}\n\n\t\t\tprivate _getRowId(rowOrId: string \| RowValueType): string {\n\t\t\t\treturn typeof rowOrId === \"string\" ? rowOrId : rowOrId.id;\n\t\t\t}\n\n\t\t\tprivate containsColumnWithId(columnId: string): boolean {\n\t\t\t\t// TypeScript is unable to narrow the types correctly here, hence the cast.\n\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\treturn (\n\t\t\t\t\tthis.columns.find(\n\t\t\t\t\t\t(column) => (column as TableSchema.Column<TCellSchema>).id === columnId,\n\t\t\t\t\t) !== undefined\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tprivate containsRowWithId(rowId: string): boolean {\n\t\t\t\t// TypeScript is unable to narrow the types correctly here, hence the cast.\n\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\treturn (\n\t\t\t\t\tthis.rows.find((row) => (row as TableSchema.Row<TCellSchema>).id === rowId) !==\n\t\t\t\t\tundefined\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t/\n\t\t\t Ensure that the specified index is a valid location for item insertion in the destination list.\n\t\t\t * @throws Throws a usage error if the destination is invalid.\n\t\t\t /\n\t\t\tprivate static validateInsertionIndex(\n\t\t\t\tindex: number,\n\t\t\t\tdestinationList: readonly unknown[],\n\t\t\t): void {\n\t\t\t\tif (index < 0) {\n\t\t\t\t\tthrow new UsageError(\"The index must be greater than or equal to 0.\");\n\t\t\t\t}\n\n\t\t\t\tif (index > destinationList.length) {\n\t\t\t\t\tthrow new UsageError(\"The index specified for insertion is out of bounds.\");\n\t\t\t\t}\n\n\t\t\t\tif (!Number.isInteger(index)) {\n\t\t\t\t\tthrow new UsageError(\"The index must be an integer.\");\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Set a private symbol on the schema class that marks it as having been generated by this factory.\n\t\t// Column / Row functionality use this to validate that they are being used in a table.\n\t\t// This is effectively a work-around that allows columns and rows to invoke table methods\n\t\t// without having to pass the table as a parameter to their construction, which isn't possible.\n\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t(Table as any)[tableSchemaSymbol] = true;\n\n\t\ttype TableValueType = TreeNode &\n\t\t\tTableSchema.Table<TInputScope, TCellSchema, TColumnSchema, TRowSchema> &\n\t\t\tWithType<ScopedSchemaName<Scope, \"Table\">>;\n\t\ttype TableInsertableType = InsertableObjectFromSchemaRecord<typeof tableFields>;\n\t\ttype TableConstructorType = new (data: TableInsertableType) => TableValueType;\n\n\t\t// Returning SingletonSchema without a type conversion results in TypeScript generating something like `readonly \"__#124291@#brand\": unknown;`\n\t\t// for the private brand field of TreeNode.\n\t\t// This numeric id doesn't seem to be stable over incremental builds, and thus causes diffs in the API extractor reports.\n\t\t// This is avoided by doing this type conversion.\n\t\t// The conversion is done via assignment instead of `as` to get stronger type safety.\n\t\tconst TableSchemaType: TreeNodeSchemaClass<\n\t\t\t/ Name / ScopedSchemaName<Scope, \"Table\">,\n\t\t\t/ Kind / NodeKind.Object,\n\t\t\t/ TNode / TableValueType,\n\t\t\t/ TInsertable / object & TableInsertableType,\n\t\t\t/ ImplicitlyConstructable / true,\n\t\t\t/ Info / typeof tableFields\n\t\t> & {\n\t\t\t/\n\t\t\t Create an empty table.\n\t\t\t /\n\t\t\tempty<TThis extends TableConstructorType>(this: TThis): InstanceType<TThis>;\n\t\t} = Table;\n\n\t\t// Return the table schema\n\t\treturn TableSchemaType;\n\t}\n\n\t/\n\t Base row schema type.\n\t * @sealed @system @alpha\n\t /\n\texport type TableSchemaBase<\n\t\tTScope extends string \| undefined,\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTColumn extends ColumnSchemaBase<TScope, TCell>,\n\t\tTRow extends RowSchemaBase<TScope, TCell>,\n\t> = ReturnType<typeof createTableSchema<TScope, TCell, TColumn, TRow>>;\n\n\t// #endregion\n}\n\n/\n Contains types and factories for creating schema to represent dynamic tabular data.\n \n @remarks\n \n WARNING: These APIs are in preview and are subject to change.\n * Until these APIs have stabilized, it is not recommended to use them in production code.\n * There may be breaking changes to these APIs and their underlying data format.\n * Using these APIs in production code may result in data loss or corruption.\n \n The primary APIs for create tabular data schema are:\n \n - {@link TableSchema.(table:1)}\n \n - {@link TableSchema.(column:1)}\n \n - {@link TableSchema.(row:1)}\n \n Tables created using these APIs are...\n \n - sparse, meaning that cells may be omitted, and new rows are empty by default.\n \n - dynamic, meaning that their structure can be modified at runtime.\n * Columns and rows can be inserted, removed, modified, and reordered.\n * Cells can be inserted, removed, and modified.\n \n - row-major, meaning that operating on rows (including inserts, removal, moves, and traversal) is more efficient than operating on columns.\n \n Column and Row schema created using these APIs are extensible via the `props` field.\n * This allows association of additional properties with column and row nodes.\n \n Cells in the table may become \"orphaned.\"\n * That is, it is possible to enter a state where one or more rows contain cells with no corresponding column.\n * To reduce the likelihood of this, you can manually remove corresponding cells when removing columns.\n * Either way, it is possible to enter such a state via the merging of edits.\n * For example: one client might add a row while another concurrently removes a column, orphaning the cell where the column and row intersected.\n \n @example Defining a Table schema\n \n ```typescript\n * class MyTable extends TableSchema.table({\n * \tschemaFactory,\n * \tcell: schemaFactory.string,\n * }) {}\n \n const table = new MyTable({\n * \tcolumns: [{ id: \"column-0\" }],\n * \trows: [{ id: \"row-0\", cells: { \"column-0\": \"Hello world!\" } }],\n * });\n * ```\n \n @example Customizing Column and Row schema\n \n ```typescript\n * const Cell = schemaFactory.string;\n \n class MyColumn extends TableSchema.column({\n * \tschemaFactory,\n * \tcell: Cell,\n * \tprops: schemaFactory.object(\"TableColumnProps\", {\n * \t\tlabel: schemaFactory.string,\n * \t}),\n * }) {}\n \n class MyRow extends TableSchema.row({\n * \tschemaFactory,\n * \tcell: Cell,\n * }) {}\n \n class MyTable extends TableSchema.table({\n * \tschemaFactory,\n * \tcell: Cell,\n * \tcolumn: MyColumn,\n * \trow: MyRow,\n * }) {}\n \n const table = new MyTable({\n * \tcolumns: [\n * \t\tnew MyColumn({ props: { label: \"Entry\" } }),\n * \t\tnew MyColumn({ props: { label: \"Date\" } }),\n * \t\tnew MyColumn({ props: { label: \"Amount\" } }),\n * \t],\n * \trows: [],\n * });\n * ```\n \n @example Listening for changes in the table\n \n ```typescript\n * // Listen for any changes to the table and its children.\n * // The \"treeChanged\" event will fire when the associated node or any of its descendants change.\n * Tree.on(table, \"treeChanged\", () => {\n * \t// Respond to the change.\n * });\n * ```\n \n @example Listening for changes to the rows list only\n \n ```typescript\n * // Listen for any changes to the list of rows.\n * // The \"nodeChanged\" event will fire only when the specified node itself changes (i.e., its own properties change).\n * // In this case, the event will fire when a row is added or removed, or the order of the list is changed.\n * // But it won't fire when a row's properties change, or when the row's cells change, etc.\n * Tree.on(table.rows, \"nodeChanged\", () => {\n * \t// Respond to the change.\n * });\n * ```\n \n @privateRemarks\n * The above examples are backed by tests in `tableSchema.spec.ts`.\n * Those tests and these examples should be kept in-sync to ensure that the examples are correct.\n \n @alpha\n /\nexport namespace TableSchema {\n\t// #region Column\n\n\t/\n\t A column in a table.\n\t * @remarks Implemented by the schema class returned from {@link TableSchema.(column:2)}.\n\t * @typeParam TCell - The type of the cells in the {@link TableSchema.Table}.\n\t * @typeParam TProps - Additional properties to associate with the column.\n\t * @sealed @alpha\n\t /\n\texport interface Column<\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTProps extends ImplicitAnnotatedFieldSchema = ImplicitAnnotatedFieldSchema,\n\t> {\n\t\t/\n\t\t The unique identifier of the column.\n\t\t * @remarks Uniquely identifies the node within the entire tree, not just the table.\n\t\t /\n\t\treadonly id: string;\n\n\t\t/\n\t\t The column's properties.\n\t\t * @remarks This is a user-defined schema that can be used to store additional information about the column.\n\t\t * @privateRemarks\n\t\t * Note: these docs are duplicated on the inline type definitions in {@link System_TableSchema.createColumnSchema}.\n\t\t * If you update the docs here, please also update the inline type definitions.\n\t\t /\n\t\tget props(): TreeFieldFromImplicitField<UnannotateImplicitFieldSchema<TProps>>;\n\t\tset props(value: InsertableTreeFieldFromImplicitField<\n\t\t\tUnannotateImplicitFieldSchema<TProps>\n\t\t>);\n\n\t\t/\n\t\t Gets all of the populated cells in the column, keyed by their associated row IDs.\n\t\t * @throws Throws an error if the column is not in a table.\n\t\t /\n\t\tgetCells(): readonly {\n\t\t\trowId: string;\n\t\t\tcell: TreeNodeFromImplicitAllowedTypes<TCell>;\n\t\t}[];\n\t}\n\n\t/\n\t Factory for creating new table column schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the {@link TableSchema.Table}.\n\t * @alpha\n\t /\n\texport function column<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t>(\n\t\tparams: System_TableSchema.CreateColumnOptionsBase<SchemaFactoryAlpha<TScope>, TCell>,\n\t): System_TableSchema.ColumnSchemaBase<TScope, TCell, System_TableSchema.DefaultPropsType>;\n\t/\n\t Factory for creating new table column schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the {@link TableSchema.Table}.\n\t * @typeParam TProps - Additional properties to associate with the column.\n\t * @alpha\n\t /\n\texport function column<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TProps extends ImplicitAnnotatedFieldSchema,\n\t>(\n\t\tparams: System_TableSchema.CreateColumnOptionsBase<SchemaFactoryAlpha<TScope>, TCell> & {\n\t\t\t/\n\t\t\t Optional column properties.\n\t\t\t /\n\t\t\treadonly props: TProps;\n\t\t},\n\t): System_TableSchema.ColumnSchemaBase<TScope, TCell, TProps>;\n\t/\n\t Overload implementation\n\t /\n\texport function column({\n\t\tschemaFactory,\n\t\tcell,\n\t\tprops = SchemaFactory.optional(SchemaFactory.null),\n\t}: System_TableSchema.CreateColumnOptionsBase & {\n\t\treadonly props?: ImplicitAnnotatedFieldSchema;\n\t}): TreeNodeSchema {\n\t\treturn System_TableSchema.createColumnSchema(schemaFactory, cell, props);\n\t}\n\n\t// #endregion\n\n\t// #region Row\n\n\t/\n\t A row in a table.\n\t * @remarks Implemented by the schema class returned from {@link TableSchema.(row:2)}.\n\t * @typeParam TCell - The type of the cells in the {@link TableSchema.Table}.\n\t * @typeParam TProps - Additional properties to associate with the row.\n\t * @sealed @alpha\n\t /\n\texport interface Row<\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTProps extends ImplicitAnnotatedFieldSchema = ImplicitAnnotatedFieldSchema,\n\t> {\n\t\t/\n\t\t The unique identifier of the row.\n\t\t * @remarks Uniquely identifies the node within the entire tree, not just the table.\n\t\t /\n\t\treadonly id: string;\n\n\t\t/\n\t\t Gets the cell in the specified column.\n\t\t * @returns The cell if it exists, otherwise undefined.\n\t\t * @privateRemarks TODO: throw if the column does not belong to the same table as the row.\n\t\t /\n\t\tgetCell(column: Column<TCell>): TreeNodeFromImplicitAllowedTypes<TCell> \| undefined;\n\t\t/\n\t\t Gets the cell in the specified column, denoted by column ID.\n\t\t * @returns The cell if it exists, otherwise undefined.\n\t\t /\n\t\tgetCell(columnId: string): TreeNodeFromImplicitAllowedTypes<TCell> \| undefined;\n\n\t\t/\n\t\t Gets all of the populated cells in the row, keyed by their associated column IDs.\n\t\t /\n\t\tgetCells(): readonly {\n\t\t\tcolumnId: string;\n\t\t\tcell: TreeNodeFromImplicitAllowedTypes<TCell>;\n\t\t}[];\n\n\t\t/\n\t\t Sets the cell in the specified column.\n\t\t * @remarks To remove a cell, call {@link TableSchema.Row.(removeCell:1)} instead.\n\t\t * @privateRemarks TODO: Throw an error if the column does not exist in the table.\n\t\t /\n\t\tsetCell(\n\t\t\tcolumn: Column<TCell>,\n\t\t\tvalue: InsertableTreeNodeFromImplicitAllowedTypes<TCell>,\n\t\t): void;\n\t\t/\n\t\t Sets the cell in the specified column, denoted by column ID.\n\t\t * @remarks To remove a cell, call {@link TableSchema.Row.(removeCell:2)} instead.\n\t\t /\n\t\tsetCell(columnId: string, value: InsertableTreeNodeFromImplicitAllowedTypes<TCell>): void;\n\n\t\t/\n\t\t Removes the cell in the specified column.\n\t\t * @returns The cell if it exists, otherwise undefined.\n\t\t * @privateRemarks TODO: Throw if the column does not belong to the same table as the row.\n\t\t /\n\t\tremoveCell(column: Column<TCell>): TreeNodeFromImplicitAllowedTypes<TCell> \| undefined;\n\t\t/\n\t\t Removes the cell in the specified column, denoted by column ID.\n\t\t * @returns The cell if it exists, otherwise undefined.\n\t\t /\n\t\tremoveCell(columnId: string): TreeNodeFromImplicitAllowedTypes<TCell> \| undefined;\n\n\t\t/\n\t\t The row's properties.\n\t\t * @remarks This is a user-defined schema that can be used to store additional information about the row.\n\t\t * @privateRemarks\n\t\t * Note: these docs are duplicated on the inline type definitions in {@link System_TableSchema.createRowSchema}.\n\t\t * If you update the docs here, please also update the inline type definitions.\n\t\t /\n\t\tget props(): TreeFieldFromImplicitField<UnannotateImplicitFieldSchema<TProps>>;\n\t\tset props(value: InsertableTreeFieldFromImplicitField<\n\t\t\tUnannotateImplicitFieldSchema<TProps>\n\t\t>);\n\t}\n\n\t/\n\t Factory for creating new table column schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the {@link TableSchema.Table}.\n\t * @alpha\n\t /\n\texport function row<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t>(\n\t\tparams: System_TableSchema.CreateRowOptionsBase<SchemaFactoryAlpha<TScope>, TCell>,\n\t): System_TableSchema.RowSchemaBase<TScope, TCell, System_TableSchema.DefaultPropsType>;\n\t/\n\t Factory for creating new table row schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the {@link TableSchema.Table}.\n\t * @typeParam TProps - Additional properties to associate with the row.\n\t * @alpha\n\t /\n\texport function row<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TProps extends ImplicitAnnotatedFieldSchema,\n\t>(\n\t\tparams: System_TableSchema.CreateRowOptionsBase<SchemaFactoryAlpha<TScope>, TCell> & {\n\t\t\t/\n\t\t\t Optional row properties.\n\t\t\t /\n\t\t\treadonly props: TProps;\n\t\t},\n\t): System_TableSchema.RowSchemaBase<TScope, TCell, TProps>;\n\t/\n\t Overload implementation\n\t /\n\texport function row({\n\t\tschemaFactory,\n\t\tcell,\n\t\tprops = SchemaFactory.optional(SchemaFactory.null),\n\t}: System_TableSchema.CreateRowOptionsBase & {\n\t\treadonly props?: ImplicitAnnotatedFieldSchema;\n\t}): TreeNodeSchema {\n\t\treturn System_TableSchema.createRowSchema(schemaFactory, cell, props);\n\t}\n\n\t// #endregion\n\n\t// #region Table\n\n\t/\n\t A key to uniquely identify a cell within a table.\n\t * @alpha\n\t /\n\texport interface CellKey<\n\t\tTColumn extends ImplicitAllowedTypes,\n\t\tTRow extends ImplicitAllowedTypes,\n\t> {\n\t\t/\n\t\t {@link TableSchema.Column} or {@link TableSchema.Column.id} at which the cell is located.\n\t\t /\n\t\treadonly column: string \| TreeNodeFromImplicitAllowedTypes<TColumn>;\n\n\t\t/\n\t\t {@link TableSchema.Row} or {@link TableSchema.Row.id} at which the cell is located.\n\t\t /\n\t\treadonly row: string \| TreeNodeFromImplicitAllowedTypes<TRow>;\n\t}\n\n\t/\n\t {@link TableSchema.Table.insertColumn} parameters.\n\t * @alpha\n\t /\n\texport interface InsertColumnParameters<TColumn extends ImplicitAllowedTypes> {\n\t\t/\n\t\t The index at which to insert the new column.\n\t\t * @remarks If not provided, the column will be appended to the end of the table.\n\t\t /\n\t\treadonly index?: number \| undefined;\n\n\t\t/\n\t\t The column to insert.\n\t\t /\n\t\treadonly column: InsertableTreeNodeFromImplicitAllowedTypes<TColumn>;\n\t}\n\n\t/\n\t {@link TableSchema.Table.insertColumns} parameters.\n\t * @alpha\n\t /\n\texport interface InsertColumnsParameters<TColumn extends ImplicitAllowedTypes> {\n\t\t/\n\t\t The index at which to insert the new columns.\n\t\t * @remarks If not provided, the columns will be appended to the end of the table.\n\t\t /\n\t\treadonly index?: number \| undefined;\n\n\t\t/\n\t\t The columns to insert.\n\t\t /\n\t\treadonly columns: InsertableTreeNodeFromImplicitAllowedTypes<TColumn>[];\n\t}\n\n\t/\n\t {@link TableSchema.Table.insertRow} parameters.\n\t * @alpha\n\t /\n\texport interface InsertRowParameters<TRow extends ImplicitAllowedTypes> {\n\t\t/\n\t\t The index at which to insert the new row.\n\t\t * @remarks If not provided, the row will be appended to the end of the table.\n\t\t /\n\t\treadonly index?: number \| undefined;\n\n\t\t/\n\t\t The row to insert.\n\t\t /\n\t\treadonly row: InsertableTreeNodeFromImplicitAllowedTypes<TRow>;\n\t}\n\n\t/\n\t {@link TableSchema.Table.insertRows} parameters.\n\t * @alpha\n\t /\n\texport interface InsertRowsParameters<TRow extends ImplicitAllowedTypes> {\n\t\t/\n\t\t The index at which to insert the new rows.\n\t\t * @remarks If not provided, the rows will be appended to the end of the table.\n\t\t /\n\t\treadonly index?: number \| undefined;\n\n\t\t/\n\t\t The rows to insert.\n\t\t /\n\t\treadonly rows: InsertableTreeNodeFromImplicitAllowedTypes<TRow>[];\n\t}\n\n\t/\n\t {@link TableSchema.Table.setCell} parameters.\n\t * @alpha\n\t /\n\texport interface SetCellParameters<\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTColumn extends ImplicitAllowedTypes,\n\t\tTRow extends ImplicitAllowedTypes,\n\t> {\n\t\t/\n\t\t The key to uniquely identify a cell in a table.\n\t\t /\n\t\treadonly key: CellKey<TColumn, TRow>;\n\n\t\t/\n\t\t The cell to set.\n\t\t /\n\t\treadonly cell: InsertableTreeNodeFromImplicitAllowedTypes<TCell>;\n\t}\n\n\t/\n\t A table.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the table.\n\t * @typeParam TColumn - The type of the columns in the table.\n\t * @typeParam TRow - The type of the rows in the table.\n\t * @sealed @alpha\n\t /\n\texport interface Table<\n\t\tTScope extends string \| undefined,\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTColumn extends System_TableSchema.ColumnSchemaBase<TScope, TCell>,\n\t\tTRow extends System_TableSchema.RowSchemaBase<TScope, TCell>,\n\t> {\n\t\t/\n\t\t The table's columns.\n\t\t /\n\t\treadonly columns: TreeArrayNode<TColumn>;\n\n\t\t/\n\t\t The table's rows.\n\t\t /\n\t\treadonly rows: TreeArrayNode<TRow>;\n\n\t\t/\n\t\t Gets a table column by its {@link TableSchema.Column.id}.\n\t\t /\n\t\tgetColumn(id: string): TreeNodeFromImplicitAllowedTypes<TColumn> \| undefined;\n\n\t\t/\n\t\t Gets a table row by its {@link TableSchema.Row.id}.\n\t\t /\n\t\tgetRow(id: string): TreeNodeFromImplicitAllowedTypes<TRow> \| undefined;\n\n\t\t/\n\t\t Gets a cell in the table by column and row IDs.\n\t\t * @param key - A key that uniquely distinguishes a cell in the table, represented as a combination of the column ID and row ID.\n\t\t /\n\t\tgetCell(key: CellKey<TColumn, TRow>): TreeNodeFromImplicitAllowedTypes<TCell> \| undefined;\n\n\t\t/\n\t\t Inserts a column into the table.\n\t\t \n\t\t @throws Throws an error if the specified index is out of range.\n\t\t \n\t\t No column is inserted in this case.\n\t\t /\n\t\tinsertColumn(\n\t\t\tparams: InsertColumnParameters<TColumn>,\n\t\t): TreeNodeFromImplicitAllowedTypes<TColumn>;\n\n\t\t/\n\t\t Inserts 0 or more columns into the table.\n\t\t \n\t\t @throws Throws an error if the specified index is out of range.\n\t\t \n\t\t No columns are inserted in this case.\n\t\t /\n\t\tinsertColumns(\n\t\t\tparams: InsertColumnsParameters<TColumn>,\n\t\t): TreeNodeFromImplicitAllowedTypes<TColumn>[];\n\n\t\t/\n\t\t Inserts a row into the table.\n\t\t \n\t\t @throws\n\t\t * Throws an error in the following cases:\n\t\t \n\t\t - The row contains cells, but the table does not contain matching columns for one or more of those cells.\n\t\t \n\t\t - The specified index is out of range.\n\t\t \n\t\t No row is inserted in these cases.\n\t\t /\n\t\tinsertRow(params: InsertRowParameters<TRow>): TreeNodeFromImplicitAllowedTypes<TRow>;\n\n\t\t/\n\t\t Inserts 0 or more rows into the table.\n\t\t \n\t\t @throws\n\t\t * Throws an error in the following cases:\n\t\t \n\t\t - The row contains cells, but the table does not contain matching columns for one or more of those cells.\n\t\t \n\t\t - The specified index is out of range.\n\t\t \n\t\t No rows are inserted in these cases.\n\t\t /\n\t\tinsertRows(params: InsertRowsParameters<TRow>): TreeNodeFromImplicitAllowedTypes<TRow>[];\n\n\t\t/\n\t\t Sets the cell at the specified location in the table.\n\t\t * @remarks To remove a cell, call {@link TableSchema.Table.removeCell} instead.\n\t\t /\n\t\tsetCell(params: SetCellParameters<TCell, TColumn, TRow>): void;\n\n\t\t/\n\t\t Removes the specified column from the table.\n\t\t * @remarks\n\t\t * Also removes any corresponding cells from the table's rows.\n\t\t \n\t\t Note: this operation can be slow for tables with many rows.\n\t\t * We are actively working on improving the performance of this operation, but for now it may have a negative\n\t\t * impact on performance.\n\t\t \n\t\t @param column - The {@link TableSchema.Column \| column} or {@link TableSchema.Column.id \| column ID} to remove.\n\t\t * @throws Throws an error if the column is not in the table.\n\t\t * In this case, no columns are removed.\n\t\t /\n\t\tremoveColumn(\n\t\t\tcolumn: string \| TreeNodeFromImplicitAllowedTypes<TColumn>,\n\t\t): TreeNodeFromImplicitAllowedTypes<TColumn>;\n\n\t\t/\n\t\t Removes 0 or more columns from the table.\n\t\t * @remarks\n\t\t * Also removes any corresponding cells from the table's rows.\n\t\t \n\t\t Note: this operation can be slow for tables with many rows.\n\t\t * We are actively working on improving the performance of this operation, but for now it may have a negative\n\t\t * impact on performance.\n\t\t \n\t\t @param columns - The columns to remove.\n\t\t * @throws Throws an error if any of the columns are not in the table.\n\t\t * In this case, no columns are removed.\n\t\t /\n\t\tremoveColumns(\n\t\t\tcolumns: readonly TreeNodeFromImplicitAllowedTypes<TColumn>[],\n\t\t): TreeNodeFromImplicitAllowedTypes<TColumn>[];\n\t\t/\n\t\t Removes 0 or more columns from the table.\n\t\t \n\t\t @remarks\n\t\t * Also removes any corresponding cells from the table's rows.\n\t\t \n\t\t Note: this operation can be slow for tables with many rows.\n\t\t * We are actively working on improving the performance of this operation, but for now it may have a negative\n\t\t * impact on performance.\n\t\t \n\t\t @param columns - The columns to remove, specified by their {@link TableSchema.Column.id}.\n\t\t * @throws Throws an error if any of the columns are not in the table.\n\t\t * In this case, no columns are removed.\n\t\t /\n\t\tremoveColumns(columns: readonly string[]): TreeNodeFromImplicitAllowedTypes<TColumn>[];\n\n\t\t/\n\t\t Removes all columns from the table.\n\t\t \n\t\t @remarks\n\t\t * Also removes any corresponding cells from the table's rows.\n\t\t \n\t\t Note: this operation can be slow for tables with many rows.\n\t\t * We are actively working on improving the performance of this operation, but for now it may have a negative\n\t\t * impact on performance.\n\t\t \n\t\t @returns The removed columns.\n\t\t /\n\t\tremoveAllColumns(): TreeNodeFromImplicitAllowedTypes<TColumn>[];\n\n\t\t/\n\t\t Removes the specified row from the table.\n\t\t * @param row - The {@link TableSchema.Row \| row} or {@link TableSchema.Row.id \| row ID} to remove.\n\t\t * @throws Throws an error if the row is not in the table.\n\t\t * In this case, no rows are removed.\n\t\t /\n\t\tremoveRow(\n\t\t\trow: string \| TreeNodeFromImplicitAllowedTypes<TRow>,\n\t\t): TreeNodeFromImplicitAllowedTypes<TRow>;\n\n\t\t/\n\t\t Removes 0 or more rows from the table.\n\t\t * @param rows - The rows to remove.\n\t\t * @throws Throws an error if any of the rows are not in the table.\n\t\t * In this case, no rows are removed.\n\t\t /\n\t\tremoveRows(\n\t\t\trows: readonly TreeNodeFromImplicitAllowedTypes<TRow>[],\n\t\t): TreeNodeFromImplicitAllowedTypes<TRow>[];\n\t\t/\n\t\t Removes 0 or more rows from the table.\n\t\t * @param rows - The rows to remove, specified by their {@link TableSchema.Row.id}.\n\t\t * @throws Throws an error if any of the rows are not in the table.\n\t\t * In this case, no rows are removed.\n\t\t /\n\t\tremoveRows(rows: readonly string[]): TreeNodeFromImplicitAllowedTypes<TRow>[];\n\n\t\t/\n\t\t Removes all rows from the table.\n\t\t * @returns The removed rows.\n\t\t /\n\t\tremoveAllRows(): TreeNodeFromImplicitAllowedTypes<TRow>[];\n\n\t\t/\n\t\t Removes the cell at the specified location in the table.\n\t\t * @returns The cell if it exists, otherwise undefined.\n\t\t * @throws Throws an error if the location does not exist in the table.\n\t\t /\n\t\tremoveCell(\n\t\t\tkey: CellKey<TColumn, TRow>,\n\t\t): TreeNodeFromImplicitAllowedTypes<TCell> \| undefined;\n\t}\n\n\t/\n\t Factory for creating new table schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the table.\n\t * @alpha\n\t /\n\texport function table<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<SchemaFactoryAlpha<TScope>, TCell>,\n\t): System_TableSchema.TableSchemaBase<\n\t\tTScope,\n\t\tTCell,\n\t\tSystem_TableSchema.ColumnSchemaBase<TScope, TCell, System_TableSchema.DefaultPropsType>,\n\t\tSystem_TableSchema.RowSchemaBase<TScope, TCell, System_TableSchema.DefaultPropsType>\n\t>;\n\t/\n\t Factory for creating new table schema with custom column schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the table.\n\t * @typeParam TColumn - The type of the columns in the table.\n\t * @alpha\n\t /\n\texport function table<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TColumn extends System_TableSchema.ColumnSchemaBase<TScope, TCell>,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<SchemaFactoryAlpha<TScope>, TCell> & {\n\t\t\treadonly column: TColumn;\n\t\t},\n\t): System_TableSchema.TableSchemaBase<\n\t\tTScope,\n\t\tTCell,\n\t\tTColumn,\n\t\tSystem_TableSchema.RowSchemaBase<TScope, TCell, System_TableSchema.DefaultPropsType>\n\t>;\n\t/\n\t Factory for creating new table schema with custom row schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the table.\n\t * @typeParam TRow - The type of the rows in the table.\n\t * @alpha\n\t /\n\texport function table<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TRow extends System_TableSchema.RowSchemaBase<TScope, TCell>,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<SchemaFactoryAlpha<TScope>, TCell> & {\n\t\t\treadonly row: TRow;\n\t\t},\n\t): System_TableSchema.TableSchemaBase<\n\t\tTScope,\n\t\tTCell,\n\t\tSystem_TableSchema.ColumnSchemaBase<TScope, TCell, System_TableSchema.DefaultPropsType>,\n\t\tTRow\n\t>;\n\t/\n\t Factory for creating new table schema with custom column and row schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the table.\n\t * @typeParam TColumn - The type of the columns in the table.\n\t * @typeParam TRow - The type of the rows in the table.\n\t * @alpha\n\t /\n\texport function table<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TColumn extends System_TableSchema.ColumnSchemaBase<TScope, TCell>,\n\t\tconst TRow extends System_TableSchema.RowSchemaBase<TScope, TCell>,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<SchemaFactoryAlpha<TScope>, TCell> & {\n\t\t\treadonly column: TColumn;\n\t\t\treadonly row: TRow;\n\t\t},\n\t): System_TableSchema.TableSchemaBase<TScope, TCell, TColumn, TRow>;\n\t/\n\t Overload implementation\n\t */\n\texport function table({\n\t\tschemaFactory,\n\t\tcell: cellSchema,\n\t\tcolumn: columnSchema = column({\n\t\t\tschemaFactory,\n\t\t\tcell: cellSchema,\n\t\t}),\n\t\trow: rowSchema = row({\n\t\t\tschemaFactory,\n\t\t\tcell: cellSchema,\n\t\t}),\n\t}: System_TableSchema.TableFactoryOptionsBase & {\n\t\treadonly column?: System_TableSchema.ColumnSchemaBase;\n\t\treadonly row?: System_TableSchema.RowSchemaBase;\n\t}): TreeNodeSchema {\n\t\treturn System_TableSchema.createTableSchema(\n\t\t\tschemaFactory,\n\t\t\tcellSchema,\n\t\t\tcolumnSchema,\n\t\t\trowSchema,\n\t\t);\n\t}\n\n\t// #endregion\n}\n"]}
1	+ {"version":3,"file":"tableSchema.js","sourceRoot":"","sources":["../src/tableSchema.ts"],"names":[],"mappings":"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","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n /\n\nimport { fail } from \"@fluidframework/core-utils/internal\";\nimport { UsageError } from \"@fluidframework/telemetry-utils/internal\";\n\nimport { Tree, TreeAlpha } from \"./shared-tree/index.js\";\nimport {\n\ttype FieldHasDefault,\n\ttype ImplicitAllowedTypes,\n\ttype InsertableObjectFromSchemaRecord,\n\ttype InsertableTreeNodeFromImplicitAllowedTypes,\n\ttype NodeKind,\n\ttype SchemaFactoryAlpha,\n\ttype ScopedSchemaName,\n\tTreeArrayNode,\n\ttype TreeNode,\n\ttype TreeNodeFromImplicitAllowedTypes,\n\ttype TreeNodeSchema,\n\ttype TreeNodeSchemaClass,\n\ttype WithType,\n\ttype TreeFieldFromImplicitField,\n\ttype InsertableTreeFieldFromImplicitField,\n\ttype InternalTreeNode,\n\tSchemaFactory,\n\ttype ImplicitAnnotatedFieldSchema,\n\ttype UnannotateImplicitFieldSchema,\n\tisArrayNodeSchema,\n\ttype InsertableField,\n} from \"./simple-tree/index.js\";\n\n// Future improvement TODOs:\n// - Omit `cells` property from Row insertion type.\n// - Record-like type parameters / input parameters?\n// - Omit `props` properties from Row and Column schemas when not provided?\n\n// Longer-term work:\n// - Add constraint APIs to make it possible to avoid situations that could yield \"orphaned\" cells.\n\n/\n The sub-scope applied to user-provided {@link SchemaFactory}s by table schema factories.\n /\nconst tableSchemaFactorySubScope = \"table\";\n\n/\n Gets the table containing the provided row/column node, if the node is part of a table.\n * @remarks Assumes that the table is the grandparent of the row/column node.\n /\nfunction getParentTable(\n\trowOrColumnNode: TreeNode,\n):\n\t\| (TreeNode &\n\t\t\tTableSchema.Table<\n\t\t\t\tstring \| undefined,\n\t\t\t\tImplicitAllowedTypes,\n\t\t\t\tSystem_TableSchema.ColumnSchemaBase,\n\t\t\t\tSystem_TableSchema.RowSchemaBase\n\t\t\t>)\n\t\| undefined {\n\tconst rowListNode = Tree.parent(rowOrColumnNode);\n\tif (rowListNode === undefined \|\| !isArrayNodeSchema(Tree.schema(rowListNode))) {\n\t\treturn undefined;\n\t}\n\tconst tableNode = Tree.parent(rowListNode);\n\tif (tableNode === undefined \|\| !isTableNode(tableNode)) {\n\t\treturn undefined;\n\t}\n\n\treturn tableNode;\n}\n\n/\n A private symbol put on table schema to help identify them.\n /\nconst tableSchemaSymbol: unique symbol = Symbol(\"tableNode\");\n\n/\n Type-guard to determine if a node is a table node.\n * @remarks Uses {@link tableSchemaSymbol} to identify table nodes.\n /\nfunction isTableNode(\n\tnode: TreeNode,\n): node is TreeNode &\n\tTableSchema.Table<\n\t\tstring \| undefined,\n\t\tImplicitAllowedTypes,\n\t\tSystem_TableSchema.ColumnSchemaBase,\n\t\tSystem_TableSchema.RowSchemaBase\n\t> {\n\treturn tableSchemaSymbol in Tree.schema(node);\n}\n\n/\n Not intended for use outside of this package.\n \n @privateRemarks\n * This namespace is a collection of internal system types relate to {@link TableSchema}.\n * This namespace should be strictly type-exported by the package.\n * All members should be tagged with `@system`.\n \n @system @alpha\n /\nexport namespace System_TableSchema {\n\t/\n\t Default type used for column and row \"props\" fields.\n\t * @privateRemarks\n\t * Longer term, it would be better to simply omit \"props\" altogether by default.\n\t * For now, this ensures that the user doesn't have to specify a \"props\" entry when initializing column/row nodes\n\t * and ensures that they cannot set anything that might conflict with future evolutions of the schema.\n\t * @system @alpha\n\t /\n\texport type DefaultPropsType = ReturnType<typeof SchemaFactory.optional<[]>>;\n\n\t/\n\t A base interface for factory input options which include an schema factory.\n\t * @remarks This interface should not be referenced directly.\n\t * @privateRemarks This interface primarily exists to provide a single home for property documentation.\n\t * @system @alpha\n\t /\n\texport interface OptionsWithSchemaFactory<TSchemaFactory extends SchemaFactoryAlpha> {\n\t\t/\n\t\t Schema factory with which the Column schema will be associated.\n\t\t * @remarks Can be used to associate the resulting schema with an existing {@link SchemaFactory.scope\|scope}.\n\t\t /\n\t\treadonly schemaFactory: TSchemaFactory;\n\t}\n\n\t/\n\t A base interface for factory input options which include the table cell schema.\n\t * @remarks This interface should not be referenced directly.\n\t * @privateRemarks This interface primarily exists to provide a single home for property documentation.\n\t * @system @alpha\n\t /\n\texport interface OptionsWithCellSchema<TCellSchema extends ImplicitAllowedTypes> {\n\t\t/\n\t\t Schema for the table's cells.\n\t\t /\n\t\treadonly cell: TCellSchema;\n\t}\n\n\t// #region Column\n\n\t/\n\t Base options for creating table cow schema.\n\t * @remarks Includes parameters common to all column factory overloads.\n\t * @system @alpha\n\t /\n\texport type CreateColumnOptionsBase<\n\t\tTSchemaFactory extends SchemaFactoryAlpha = SchemaFactoryAlpha,\n\t\tTCell extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t> = OptionsWithSchemaFactory<TSchemaFactory> & OptionsWithCellSchema<TCell>;\n\n\t/\n\t Factory for creating column schema.\n\t * @system @alpha\n\t /\n\t// eslint-disable-next-line @typescript-eslint/explicit-function-return-type -- Return type is too complex to be reasonable to specify\n\texport function createColumnSchema<\n\t\tconst TInputScope extends string \| undefined,\n\t\tconst TCellSchema extends ImplicitAllowedTypes,\n\t\tconst TPropsSchema extends ImplicitAnnotatedFieldSchema,\n\t>(\n\t\tinputSchemaFactory: SchemaFactoryAlpha<TInputScope>,\n\t\tcellSchema: TCellSchema,\n\t\tpropsSchema: TPropsSchema,\n\t) {\n\t\tconst schemaFactory = inputSchemaFactory.scopedFactoryAlpha(tableSchemaFactorySubScope);\n\t\ttype Scope = ScopedSchemaName<TInputScope, typeof tableSchemaFactorySubScope>;\n\n\t\ttype CellValueType = TreeNodeFromImplicitAllowedTypes<TCellSchema>;\n\n\t\t// Note: `columnFields` is broken into two parts to work around a TypeScript bug\n\t\t// that results in broken `.d.ts` output.\n\t\t// See definition of `ColumnInsertableType` below.\n\t\tconst columnFieldsBuiltInParts = {\n\t\t\tid: schemaFactory.identifier,\n\t\t} as const;\n\t\tconst columnFieldsPropsPart = {\n\t\t\tprops: propsSchema,\n\t\t} as const;\n\n\t\t/\n\t\t {@link Column} fields.\n\t\t \n\t\t @remarks\n\t\t * Extracted for re-use in returned type signature defined later in this function.\n\t\t * The implicit typing is intentional.\n\t\t \n\t\t Note: ideally we would add a satisfies clause here to ensure that this satisfies\n\t\t * `Record<string, ImplicitFieldSchema>`, but doing so causes TypeScript to prematurely and incorrectly evaluate the type of `propsSchema`.\n\t\t * Likely related to the following issue: https://github.com/microsoft/TypeScript/issues/52394\n\t\t /\n\t\tconst columnFields = {\n\t\t\t...columnFieldsBuiltInParts,\n\t\t\t...columnFieldsPropsPart,\n\t\t} as const; // satisfies Record<string, ImplicitFieldSchema>;\n\n\t\t/\n\t\t A column in a table.\n\t\t /\n\t\tclass Column\n\t\t\textends schemaFactory.objectAlpha(\"Column\", columnFields, {\n\t\t\t\t// Will make it easier to evolve this schema in the future.\n\t\t\t\tallowUnknownOptionalFields: true,\n\t\t\t})\n\t\t\timplements TableSchema.Column<TCellSchema, TPropsSchema>\n\t\t{\n\t\t\tpublic getCells(): {\n\t\t\t\trowId: string;\n\t\t\t\tcell: CellValueType;\n\t\t\t}[] {\n\t\t\t\tconst tableNode = getParentTable(this);\n\t\t\t\tif (tableNode === undefined) {\n\t\t\t\t\tthrow new UsageError(`Column with ID \"${this.id}\" is not contained in a table.`);\n\t\t\t\t}\n\n\t\t\t\tconst result = [];\n\t\t\t\tfor (const row of tableNode.rows) {\n\t\t\t\t\tconst cell = row.getCell(this.id);\n\t\t\t\t\tif (cell !== undefined) {\n\t\t\t\t\t\tif (!Tree.is(cell, cellSchema)) {\n\t\t\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t\t\t\"Parent table contains a cell with incompatible with this column.\",\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\tresult.push({ rowId: row.id, cell: cell as CellValueType });\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn result;\n\t\t\t}\n\t\t}\n\n\t\ttype ColumnValueType = TreeNode &\n\t\t\tTableSchema.Column<TCellSchema, TPropsSchema> &\n\t\t\tWithType<ScopedSchemaName<Scope, \"Column\">>;\n\n\t\t// Note: ideally this type would just leverage `InsertableObjectFromSchemaRecord<typeof columnFields>`,\n\t\t// but that results in broken `.d.ts` output due to a TypeScript bug.\n\t\t// See: https://github.com/microsoft/TypeScript/issues/58688.\n\t\t// Instead we extract and inline the typing of the \"props\" field here, which seems to sufficiently work around the issue.\n\t\t// type ColumnInsertableType = InsertableObjectFromSchemaRecord<typeof columnFields>;\n\t\ttype ColumnInsertableType = InsertableObjectFromSchemaRecord<\n\t\t\ttypeof columnFieldsBuiltInParts\n\t\t> &\n\t\t\t(FieldHasDefault<UnannotateImplicitFieldSchema<TPropsSchema>> extends true\n\t\t\t\t? // Note: The docs on the below properties are copied from `IColumn.props`' docs to ensure that the\n\t\t\t\t\t// documentation appears in the data insertion scenario.\n\t\t\t\t\t// The contents are duplicated instead of using `@inheritdoc`, as intellisense does not correctly\n\t\t\t\t\t// support `@inheritDoc`.\n\t\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/31267\n\t\t\t\t\t{\n\t\t\t\t\t\t/\n\t\t\t\t\t\t The column's properties.\n\t\t\t\t\t\t * @remarks This is a user-defined schema that can be used to store additional information about the column.\n\t\t\t\t\t\t /\n\t\t\t\t\t\tprops?: InsertableTreeFieldFromImplicitField<\n\t\t\t\t\t\t\tUnannotateImplicitFieldSchema<TPropsSchema>\n\t\t\t\t\t\t>;\n\t\t\t\t\t}\n\t\t\t\t: {\n\t\t\t\t\t\t/\n\t\t\t\t\t\t The column's properties.\n\t\t\t\t\t\t * @remarks This is a user-defined schema that can be used to store additional information about the column.\n\t\t\t\t\t\t /\n\t\t\t\t\t\tprops: InsertableTreeFieldFromImplicitField<\n\t\t\t\t\t\t\tUnannotateImplicitFieldSchema<TPropsSchema>\n\t\t\t\t\t\t>;\n\t\t\t\t\t});\n\n\t\t// Modified version of `Column` that ensures the constructor (and `createFromInsertable`) are\n\t\t// typed correctly in terms of our insertable type.\n\t\t// This lets us be selective in our type-cast for the value returned from this function,\n\t\t// preserving as much type-safety as we reasonably can.\n\t\ttype ColumnSchemaModifiedType = Omit<\n\t\t\t// Use mapped type to omit the constructor\n\t\t\t{\n\t\t\t\t[Property in keyof typeof Column]: (typeof Column)[Property];\n\t\t\t},\n\t\t\t\"createFromInsertable\"\n\t\t> &\n\t\t\t(new (\n\t\t\t\tparameters: InternalTreeNode \| ColumnInsertableType,\n\t\t\t) => Column) & {\n\t\t\t\tcreateFromInsertable(parameters: ColumnInsertableType): Column;\n\t\t\t};\n\n\t\t// Returning SingletonSchema without a type conversion results in TypeScript generating something like `readonly \"__#124291@#brand\": unknown;`\n\t\t// for the private brand field of TreeNode.\n\t\t// This numeric id doesn't seem to be stable over incremental builds, and thus causes diffs in the API extractor reports.\n\t\t// This is avoided by doing this type conversion.\n\t\t// The conversion is done via assignment instead of `as` to get stronger type safety.\n\t\tconst ColumnSchemaType: TreeNodeSchemaClass<\n\t\t\t/ Name / ScopedSchemaName<Scope, \"Column\">,\n\t\t\t/ Kind / NodeKind.Object,\n\t\t\t/ TNode / ColumnValueType,\n\t\t\t/ TInsertable / object & ColumnInsertableType,\n\t\t\t/ ImplicitlyConstructable / true,\n\t\t\t/ Info / typeof columnFields\n\t\t> = Column as ColumnSchemaModifiedType;\n\n\t\treturn ColumnSchemaType;\n\t}\n\n\t/\n\t Base column schema type.\n\t * @sealed @system @alpha\n\t /\n\texport type ColumnSchemaBase<\n\t\tTScope extends string \| undefined = string \| undefined,\n\t\tTCellSchema extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t\tTPropsSchema extends ImplicitAnnotatedFieldSchema = ImplicitAnnotatedFieldSchema,\n\t> = ReturnType<typeof createColumnSchema<TScope, TCellSchema, TPropsSchema>>;\n\n\t// #endregion\n\n\t// #region Row\n\n\t/\n\t Base options for creating table row schema.\n\t * @remarks Includes parameters common to all row factory overloads.\n\t * @system @alpha\n\t /\n\texport type CreateRowOptionsBase<\n\t\tTSchemaFactory extends SchemaFactoryAlpha = SchemaFactoryAlpha,\n\t\tTCell extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t> = OptionsWithSchemaFactory<TSchemaFactory> & OptionsWithCellSchema<TCell>;\n\n\t/\n\t Factory for creating row schema.\n\t * @sealed @alpha\n\t /\n\t// eslint-disable-next-line @typescript-eslint/explicit-function-return-type -- Return type is too complex to be reasonable to specify\n\texport function createRowSchema<\n\t\tconst TInputScope extends string \| undefined,\n\t\tconst TCellSchema extends ImplicitAllowedTypes,\n\t\tconst TPropsSchema extends ImplicitAnnotatedFieldSchema,\n\t>(\n\t\tinputSchemaFactory: SchemaFactoryAlpha<TInputScope>,\n\t\tcellSchema: TCellSchema,\n\t\tpropsSchema: TPropsSchema,\n\t) {\n\t\tconst schemaFactory = inputSchemaFactory.scopedFactoryAlpha(tableSchemaFactorySubScope);\n\t\ttype Scope = ScopedSchemaName<TInputScope, typeof tableSchemaFactorySubScope>;\n\n\t\ttype CellValueType = TreeNodeFromImplicitAllowedTypes<TCellSchema>;\n\t\ttype CellInsertableType = InsertableTreeNodeFromImplicitAllowedTypes<TCellSchema>;\n\n\t\t// Note: `rowFields` is broken into two parts to work around a TypeScript bug\n\t\t// that results in broken `.d.ts` output.\n\t\t// See definition of `RowInsertableType` below.\n\t\tconst rowFieldsBuiltInParts = {\n\t\t\tid: schemaFactory.identifier,\n\t\t\t/\n\t\t\t The cells of the table row, keyed by column ID.\n\t\t\t * @remarks\n\t\t\t * The table row models its cells as a record, where each key is the ID of the column it belongs to. The choice of record (as opposed to a map) is intended to make interop with common table rendering libraries in TypeScript/JavaScript easier.\n\t\t\t /\n\t\t\tcells: schemaFactory.required(schemaFactory.record(\"Row.cells\", cellSchema), {\n\t\t\t\tmetadata: {\n\t\t\t\t\tdescription: \"The cells of the table row, keyed by column ID.\",\n\t\t\t\t},\n\t\t\t}),\n\t\t} as const;\n\t\tconst rowFieldsPropsPart = {\n\t\t\tprops: propsSchema,\n\t\t} as const;\n\n\t\t/\n\t\t {@link Row} fields.\n\t\t * @remarks Extracted for re-use in returned type signature defined later in this function.\n\t\t * The implicit typing is intentional.\n\t\t * Note: ideally we would add a satisfies clause here to ensure that this satisfies\n\t\t * `Record<string, ImplicitFieldSchema>`, but doing so causes TypeScript to prematurely and incorrectly evaluate the type of `propsSchema`.\n\t\t * Likely related to the following issue: https://github.com/microsoft/TypeScript/issues/52394\n\t\t /\n\t\tconst rowFields = {\n\t\t\t...rowFieldsBuiltInParts,\n\t\t\t...rowFieldsPropsPart,\n\t\t} as const; // satisfies Record<string, ImplicitFieldSchema>;\n\n\t\t/\n\t\t The Row schema - this is a map of Cells where the key is the column id\n\t\t /\n\t\tclass Row\n\t\t\textends schemaFactory.objectAlpha(\"Row\", rowFields, {\n\t\t\t\t// Will make it easier to evolve this schema in the future.\n\t\t\t\tallowUnknownOptionalFields: true,\n\t\t\t})\n\t\t\timplements TableSchema.Row<TCellSchema, TPropsSchema>\n\t\t{\n\t\t\tpublic getCell(\n\t\t\t\tcolumnOrId: TableSchema.Column<TCellSchema> \| string,\n\t\t\t): CellValueType \| undefined {\n\t\t\t\tconst columnId = typeof columnOrId === \"string\" ? columnOrId : columnOrId.id;\n\t\t\t\t// Unlike most objects, RecordNodes don't have the default inherited object properties, so this is safe\n\t\t\t\treturn this.cells[columnId];\n\t\t\t}\n\n\t\t\tpublic setCell(\n\t\t\t\tcolumnOrId: TableSchema.Column<TCellSchema> \| string,\n\t\t\t\tvalue: CellInsertableType \| undefined,\n\t\t\t): void {\n\t\t\t\t// TODO: throw if column does not exist in the owning table.\n\n\t\t\t\tif (value === undefined) {\n\t\t\t\t\tthis.removeCell(columnOrId);\n\t\t\t\t} else {\n\t\t\t\t\tconst columnId = typeof columnOrId === \"string\" ? columnOrId : columnOrId.id;\n\n\t\t\t\t\t// TypeScript is unable to narrow the types correctly here, hence the casts.\n\t\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\t\tthis.cells[columnId] = TreeAlpha.create(\n\t\t\t\t\t\tcellSchema,\n\t\t\t\t\t\tvalue as InsertableField<TCellSchema>,\n\t\t\t\t\t) as CellValueType;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tpublic removeCell(\n\t\t\t\tcolumnOrId: TableSchema.Column<TCellSchema> \| string,\n\t\t\t): CellValueType \| undefined {\n\t\t\t\t// TODO: throw if column does not exist in the owning table.\n\n\t\t\t\tconst columnId = typeof columnOrId === \"string\" ? columnOrId : columnOrId.id;\n\n\t\t\t\tconst cell: CellValueType \| undefined = this.getCell(columnId);\n\t\t\t\tif (cell === undefined) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\n\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-dynamic-delete -- The record's values are non-optional, so setting `undefined` as a means to remove the cell is not supported.\n\t\t\t\tdelete this.cells[columnId];\n\n\t\t\t\treturn cell;\n\t\t\t}\n\n\t\t\tpublic getCells(): {\n\t\t\t\tcolumnId: string;\n\t\t\t\tcell: CellValueType;\n\t\t\t}[] {\n\t\t\t\tconst result = [];\n\t\t\t\tfor (const [columnId, cell] of Object.entries(this.cells)) {\n\t\t\t\t\tif (cell !== undefined) {\n\t\t\t\t\t\tresult.push({\n\t\t\t\t\t\t\tcolumnId,\n\t\t\t\t\t\t\tcell,\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\treturn result;\n\t\t\t}\n\t\t}\n\n\t\ttype RowValueType = TreeNode &\n\t\t\tTableSchema.Row<TCellSchema, TPropsSchema> &\n\t\t\tWithType<ScopedSchemaName<Scope, \"Row\">>;\n\n\t\t// Note: ideally this type would just leverage `InsertableObjectFromSchemaRecord<typeof rowFields>`,\n\t\t// but that results in broken `.d.ts` output due to a TypeScript bug.\n\t\t// See: https://github.com/microsoft/TypeScript/issues/58688.\n\t\t// Instead we extract and inline the typing of the \"props\" field here, which seems to sufficiently work around\n\t\t// the issue.\n\t\t// type RowInsertableType = InsertableObjectFromSchemaRecord<typeof rowFields>;\n\t\ttype RowInsertableType = InsertableObjectFromSchemaRecord<typeof rowFieldsBuiltInParts> &\n\t\t\t(FieldHasDefault<UnannotateImplicitFieldSchema<TPropsSchema>> extends true\n\t\t\t\t? // Note: The docs on the below properties are copied from `IRow.props`' docs to ensure that the\n\t\t\t\t\t// documentation appears in the data insertion scenario.\n\t\t\t\t\t// The contents are duplicated instead of using `@inheritdoc`, as intellisense does not correctly\n\t\t\t\t\t// support `@inheritDoc`.\n\t\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/31267\n\t\t\t\t\t{\n\t\t\t\t\t\t/\n\t\t\t\t\t\t The row's properties.\n\t\t\t\t\t\t * @remarks This is a user-defined schema that can be used to store additional information\n\t\t\t\t\t\t * about the row.\n\t\t\t\t\t\t /\n\t\t\t\t\t\tprops?: InsertableTreeFieldFromImplicitField<\n\t\t\t\t\t\t\tUnannotateImplicitFieldSchema<TPropsSchema>\n\t\t\t\t\t\t>;\n\t\t\t\t\t}\n\t\t\t\t: {\n\t\t\t\t\t\t/\n\t\t\t\t\t\t The row's properties.\n\t\t\t\t\t\t * @remarks This is a user-defined schema that can be used to store additional information\n\t\t\t\t\t\t * about the row.\n\t\t\t\t\t\t /\n\t\t\t\t\t\tprops: InsertableTreeFieldFromImplicitField<\n\t\t\t\t\t\t\tUnannotateImplicitFieldSchema<TPropsSchema>\n\t\t\t\t\t\t>;\n\t\t\t\t\t});\n\n\t\t// Modified version of `Row` that ensures the constructor (and `createFromInsertable`) are\n\t\t// typed correctly in terms of our insertable type.\n\t\t// This lets us be selective in our type-cast for the value returned from this function,\n\t\t// preserving as much type-safety as we reasonably can.\n\t\ttype RowSchemaModifiedType = Omit<\n\t\t\t// Use mapped type to omit the constructor\n\t\t\t{\n\t\t\t\t[Property in keyof typeof Row]: (typeof Row)[Property];\n\t\t\t},\n\t\t\t\"createFromInsertable\"\n\t\t> &\n\t\t\t(new (\n\t\t\t\tparameters: InternalTreeNode \| RowInsertableType,\n\t\t\t) => Row) & {\n\t\t\t\tcreateFromInsertable(parameters: RowInsertableType): Row;\n\t\t\t};\n\n\t\t// Returning SingletonSchema without a type conversion results in TypeScript generating something like `readonly \"__#124291@#brand\": unknown;`\n\t\t// for the private brand field of TreeNode.\n\t\t// This numeric id doesn't seem to be stable over incremental builds, and thus causes diffs in the API extractor reports.\n\t\t// This is avoided by doing this type conversion.\n\t\t// The conversion is done via assignment instead of `as` to get stronger type safety.\n\t\tconst RowSchemaType: TreeNodeSchemaClass<\n\t\t\t/ Name / ScopedSchemaName<Scope, \"Row\">,\n\t\t\t/ Kind / NodeKind.Object,\n\t\t\t/ TNode / RowValueType,\n\t\t\t/ TInsertable / object & RowInsertableType,\n\t\t\t/ ImplicitlyConstructable / true,\n\t\t\t/ Info / typeof rowFields\n\t\t> = Row as RowSchemaModifiedType;\n\n\t\treturn RowSchemaType;\n\t}\n\n\t/\n\t Base row schema type.\n\t * @sealed @system @alpha\n\t /\n\texport type RowSchemaBase<\n\t\tTScope extends string \| undefined = string \| undefined,\n\t\tTCellSchema extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t\tTPropsSchema extends ImplicitAnnotatedFieldSchema = ImplicitAnnotatedFieldSchema,\n\t> = ReturnType<typeof createRowSchema<TScope, TCellSchema, TPropsSchema>>;\n\n\t// #endregion\n\n\t// #region Table\n\n\t/\n\t Base options for creating table schema.\n\t * @remarks Includes parameters common to all table factory overloads.\n\t * @system @alpha\n\t /\n\texport type TableFactoryOptionsBase<\n\t\tTSchemaFactory extends SchemaFactoryAlpha = SchemaFactoryAlpha,\n\t\tTCell extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t> = OptionsWithSchemaFactory<TSchemaFactory> & OptionsWithCellSchema<TCell>;\n\n\t/\n\t Factory for creating table schema.\n\t * @system @alpha\n\t /\n\t// eslint-disable-next-line @typescript-eslint/explicit-function-return-type -- Return type is too complex to be reasonable to specify\n\texport function createTableSchema<\n\t\tconst TInputScope extends string \| undefined,\n\t\tconst TCellSchema extends ImplicitAllowedTypes,\n\t\tconst TColumnSchema extends ColumnSchemaBase<TInputScope, TCellSchema>,\n\t\tconst TRowSchema extends RowSchemaBase<TInputScope, TCellSchema>,\n\t>(\n\t\tinputSchemaFactory: SchemaFactoryAlpha<TInputScope>,\n\t\t_cellSchema: TCellSchema,\n\t\tcolumnSchema: TColumnSchema,\n\t\trowSchema: TRowSchema,\n\t) {\n\t\tconst schemaFactory = inputSchemaFactory.scopedFactoryAlpha(tableSchemaFactorySubScope);\n\t\ttype Scope = ScopedSchemaName<TInputScope, typeof tableSchemaFactorySubScope>;\n\n\t\ttype CellValueType = TreeNodeFromImplicitAllowedTypes<TCellSchema>;\n\t\ttype ColumnValueType = TreeNodeFromImplicitAllowedTypes<TColumnSchema>;\n\t\ttype RowValueType = TreeNodeFromImplicitAllowedTypes<TRowSchema>;\n\n\t\t/\n\t\t {@link Table} fields.\n\t\t * @remarks Extracted for re-use in returned type signature defined later in this function.\n\t\t * The implicit typing is intentional.\n\t\t /\n\t\tconst tableFields = {\n\t\t\trows: schemaFactory.array(\"Table.rows\", rowSchema),\n\t\t\tcolumns: schemaFactory.array(\"Table.columns\", columnSchema),\n\t\t} as const satisfies Record<string, ImplicitAnnotatedFieldSchema>;\n\n\t\t/\n\t\t The Table schema\n\t\t /\n\t\tclass Table\n\t\t\textends schemaFactory.objectAlpha(\"Table\", tableFields, {\n\t\t\t\t// Will make it easier to evolve this schema in the future.\n\t\t\t\tallowUnknownOptionalFields: true,\n\t\t\t})\n\t\t\timplements TableSchema.Table<TInputScope, TCellSchema, TColumnSchema, TRowSchema>\n\t\t{\n\t\t\tpublic static empty<TThis extends TableConstructorType>(\n\t\t\t\tthis: TThis,\n\t\t\t): InstanceType<TThis> {\n\t\t\t\treturn new this({ columns: [], rows: [] }) as InstanceType<TThis>;\n\t\t\t}\n\n\t\t\tpublic getColumn(id: string): ColumnValueType \| undefined {\n\t\t\t\t// TypeScript is unable to narrow the types correctly here, hence the casts.\n\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\treturn this.columns.find((column) => (column as ColumnValueType).id === id) as\n\t\t\t\t\t\| ColumnValueType\n\t\t\t\t\t\| undefined;\n\t\t\t}\n\n\t\t\tpublic getRow(id: string): RowValueType \| undefined {\n\t\t\t\t// TypeScript is unable to narrow the types correctly here, hence the casts.\n\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\treturn this.rows.find((_row) => (_row as RowValueType).id === id) as\n\t\t\t\t\t\| RowValueType\n\t\t\t\t\t\| undefined;\n\t\t\t}\n\n\t\t\tpublic getCell(\n\t\t\t\tkey: TableSchema.CellKey<TColumnSchema, TRowSchema>,\n\t\t\t): CellValueType \| undefined {\n\t\t\t\tconst { column: columnOrId, row: rowOrId } = key;\n\t\t\t\tconst row = this._tryGetRow(rowOrId);\n\t\t\t\tif (row === undefined) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\n\t\t\t\tconst column = this._tryGetColumn(columnOrId);\n\t\t\t\tif (column === undefined) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\n\t\t\t\treturn row.getCell(column);\n\t\t\t}\n\n\t\t\tpublic insertColumns({\n\t\t\t\tcolumns,\n\t\t\t\tindex,\n\t\t\t}: TableSchema.InsertColumnsParameters<TColumnSchema>): ColumnValueType[] {\n\t\t\t\t// Ensure index is valid\n\t\t\t\tif (index !== undefined) {\n\t\t\t\t\tTable.validateInsertionIndex(index, this.columns);\n\t\t\t\t}\n\n\t\t\t\t// TypeScript is unable to narrow the column type correctly here, hence the casts below.\n\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\tif (index === undefined) {\n\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\tthis.columns.insertAtEnd(TreeArrayNode.spread(columns) as any);\n\t\t\t\t} else {\n\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\tthis.columns.insertAt(index, TreeArrayNode.spread(columns) as any);\n\t\t\t\t}\n\n\t\t\t\t// Inserting the input nodes into the tree hydrates them, making them usable as nodes.\n\t\t\t\treturn columns as unknown as ColumnValueType[];\n\t\t\t}\n\n\t\t\tpublic insertRows({\n\t\t\t\tindex,\n\t\t\t\trows,\n\t\t\t}: TableSchema.InsertRowsParameters<TRowSchema>): RowValueType[] {\n\t\t\t\t// #region Input validation\n\n\t\t\t\t// Ensure index is valid\n\t\t\t\tif (index !== undefined) {\n\t\t\t\t\tTable.validateInsertionIndex(index, this.rows);\n\t\t\t\t}\n\n\t\t\t\t// Note: TypeScript is unable to narrow the type of the row type correctly here, hence the casts below.\n\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\tfor (const newRow of rows) {\n\t\t\t\t\t// If the row contains cells, verify that the table contains the columns for those cells.\n\t\t\t\t\t// Note: we intentionally hide `cells` on `IRow` to avoid leaking the internal data representation as much as possible, so we have to cast here.\n\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\tif ((newRow as any).cells !== undefined) {\n\t\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\t\tconst keys: string[] = Object.keys((newRow as any).cells);\n\t\t\t\t\t\tfor (const key of keys) {\n\t\t\t\t\t\t\tif (!this._containsColumnWithId(key)) {\n\t\t\t\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t\t\t\t`Attempted to insert row a cell under column ID \"${key}\", but the table does not contain a column with that ID.`,\n\t\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t}\n\n\t\t\t\t// #endregion\n\n\t\t\t\t// TypeScript is unable to narrow the row type correctly here, hence the casts below.\n\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\tif (index === undefined) {\n\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\tthis.rows.insertAtEnd(TreeArrayNode.spread(rows) as any);\n\t\t\t\t} else {\n\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\tthis.rows.insertAt(index, TreeArrayNode.spread(rows) as any);\n\t\t\t\t}\n\n\t\t\t\t// Inserting the input nodes into the tree hydrates them, making them usable as nodes.\n\t\t\t\treturn rows as unknown as RowValueType[];\n\t\t\t}\n\n\t\t\tpublic setCell({\n\t\t\t\tkey,\n\t\t\t\tcell,\n\t\t\t}: TableSchema.SetCellParameters<TCellSchema, TColumnSchema, TRowSchema>): void {\n\t\t\t\tconst { column: columnOrId, row: rowOrId } = key;\n\n\t\t\t\tconst row = this._getRow(rowOrId);\n\t\t\t\tconst column = this._getColumn(columnOrId);\n\n\t\t\t\trow.setCell(column, cell);\n\t\t\t}\n\n\t\t\tpublic removeColumns(\n\t\t\t\tindexOrColumns: number \| undefined \| readonly string[] \| readonly ColumnValueType[],\n\t\t\t\tcount: number \| undefined = undefined,\n\t\t\t): ColumnValueType[] {\n\t\t\t\tif (typeof indexOrColumns === \"number\" \|\| indexOrColumns === undefined) {\n\t\t\t\t\tlet removedColumns: ColumnValueType[] \| undefined;\n\t\t\t\t\tconst startIndex = indexOrColumns ?? 0;\n\t\t\t\t\tconst _count = count ?? this.columns.length - startIndex;\n\n\t\t\t\t\t// If there are no columns to remove, do nothing\n\t\t\t\t\tif (_count === 0) {\n\t\t\t\t\t\treturn [];\n\t\t\t\t\t}\n\n\t\t\t\t\tTable._assertValidRange({ index: startIndex, count: _count }, this.columns);\n\n\t\t\t\t\tthis._applyEditsInBatch(() => {\n\t\t\t\t\t\tconst columnsToRemove = this.columns.slice(\n\t\t\t\t\t\t\tstartIndex,\n\t\t\t\t\t\t\tstartIndex + _count,\n\t\t\t\t\t\t) as ColumnValueType[];\n\n\t\t\t\t\t\t// First, remove all cells that correspond to each column from each row:\n\t\t\t\t\t\tfor (const column of columnsToRemove) {\n\t\t\t\t\t\t\tthis._removeCells(column);\n\t\t\t\t\t\t}\n\n\t\t\t\t\t\t// Second, remove the column nodes:\n\t\t\t\t\t\tTable._removeRange(\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tindex: startIndex,\n\t\t\t\t\t\t\t\tcount: _count,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tthis.columns,\n\t\t\t\t\t\t);\n\t\t\t\t\t\tremovedColumns = columnsToRemove;\n\t\t\t\t\t});\n\t\t\t\t\treturn removedColumns ?? fail(0xc1f / Transaction did not complete. /);\n\t\t\t\t} else {\n\t\t\t\t\t// If there are no columns to remove, do nothing\n\t\t\t\t\tif (indexOrColumns.length === 0) {\n\t\t\t\t\t\treturn [];\n\t\t\t\t\t}\n\n\t\t\t\t\t// Resolve any IDs to actual nodes.\n\t\t\t\t\t// This validates that all of the rows exist before starting transaction.\n\t\t\t\t\t// This improves user-facing error experience.\n\t\t\t\t\tconst columnsToRemove: ColumnValueType[] = [];\n\t\t\t\t\tfor (const columnOrIdToRemove of indexOrColumns) {\n\t\t\t\t\t\tcolumnsToRemove.push(this._getColumn(columnOrIdToRemove));\n\t\t\t\t\t}\n\n\t\t\t\t\tthis._applyEditsInBatch(() => {\n\t\t\t\t\t\t// Note, throwing an error within a transaction will abort the entire transaction.\n\t\t\t\t\t\t// So if we throw an error here for any column, no columns will be removed.\n\t\t\t\t\t\tfor (const columnToRemove of columnsToRemove) {\n\t\t\t\t\t\t\t// Remove the corresponding cell from all rows.\n\t\t\t\t\t\t\tfor (const row of this.rows) {\n\t\t\t\t\t\t\t\t// TypeScript is unable to narrow the row type correctly here, hence the cast.\n\t\t\t\t\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\t\t\t\t\t(row as RowValueType).removeCell(columnToRemove);\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t// We have already validated that all of the columns exist above, so this is safe.\n\t\t\t\t\t\t\tthis.columns.removeAt(this.columns.indexOf(columnToRemove));\n\t\t\t\t\t\t}\n\t\t\t\t\t});\n\t\t\t\t\treturn columnsToRemove;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tpublic removeRows(\n\t\t\t\tindexOrRows: number \| undefined \| readonly string[] \| readonly RowValueType[],\n\t\t\t\tcount?: number \| undefined,\n\t\t\t): RowValueType[] {\n\t\t\t\tif (typeof indexOrRows === \"number\" \|\| indexOrRows === undefined) {\n\t\t\t\t\tconst startIndex = indexOrRows ?? 0;\n\t\t\t\t\tconst _count = count ?? this.columns.length - startIndex;\n\n\t\t\t\t\t// If there are no rows to remove, do nothing\n\t\t\t\t\tif (_count === 0) {\n\t\t\t\t\t\treturn [];\n\t\t\t\t\t}\n\n\t\t\t\t\treturn Table._removeRange(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\tindex: startIndex,\n\t\t\t\t\t\t\tcount: _count,\n\t\t\t\t\t\t},\n\t\t\t\t\t\tthis.rows,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\t// If there are no rows to remove, do nothing\n\t\t\t\tif (indexOrRows.length === 0) {\n\t\t\t\t\treturn [];\n\t\t\t\t}\n\n\t\t\t\t// Resolve any IDs to actual nodes.\n\t\t\t\t// This validates that all of the rows exist before starting transaction.\n\t\t\t\t// This improves user-facing error experience.\n\t\t\t\tconst rowsToRemove: RowValueType[] = [];\n\t\t\t\tfor (const rowToRemove of indexOrRows) {\n\t\t\t\t\trowsToRemove.push(this._getRow(rowToRemove));\n\t\t\t\t}\n\n\t\t\t\tthis._applyEditsInBatch(() => {\n\t\t\t\t\t// Note, throwing an error within a transaction will abort the entire transaction.\n\t\t\t\t\t// So if we throw an error here for any row, no rows will be removed.\n\t\t\t\t\tfor (const rowToRemove of rowsToRemove) {\n\t\t\t\t\t\t// We have already validated that all of the rows exist above, so this is safe.\n\t\t\t\t\t\tthis.rows.removeAt(this.rows.indexOf(rowToRemove));\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t\treturn rowsToRemove;\n\t\t\t}\n\n\t\t\tpublic removeCell(\n\t\t\t\tkey: TableSchema.CellKey<TColumnSchema, TRowSchema>,\n\t\t\t): CellValueType \| undefined {\n\t\t\t\tconst { column: columnOrId, row: rowOrId } = key;\n\t\t\t\tconst row = this._getRow(rowOrId);\n\t\t\t\tconst column = this._getColumn(columnOrId);\n\n\t\t\t\tconst cell: CellValueType \| undefined = row.getCell(column.id);\n\t\t\t\tif (cell === undefined) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\n\t\t\t\trow.removeCell(column.id);\n\t\t\t\treturn cell;\n\t\t\t}\n\n\t\t\t/\n\t\t\t Removes the cell corresponding with the specified column from each row in the table.\n\t\t\t /\n\t\t\tprivate _removeCells(column: ColumnValueType): void {\n\t\t\t\tfor (const row of this.rows) {\n\t\t\t\t\t// TypeScript is unable to narrow the row type correctly here, hence the cast.\n\t\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\t\t(row as RowValueType).removeCell(column);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tprivate static _assertValidRange<T>(\n\t\t\t\trange: { index: number; count: number },\n\t\t\t\tarray: readonly T[],\n\t\t\t): void {\n\t\t\t\tconst { index, count } = range;\n\t\t\t\tif (index < 0 \|\| index >= array.length) {\n\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t`Start index out of bounds. Expected index to be on [0, ${array.length - 1}], but got ${index}.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t\tif (count < 0) {\n\t\t\t\t\tthrow new UsageError(`Expected non-negative count. Got ${count}.`);\n\t\t\t\t}\n\n\t\t\t\tconst end = index + count; // exclusive\n\t\t\t\tif (end > array.length) {\n\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t`End index out of bounds. Expected end to be on [${index}, ${array.length}], but got ${end}.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t/\n\t\t\t Applies the provided edits in a \"batch\".\n\t\t\t \n\t\t\t @remarks\n\t\t\t * For hydrated trees, this will be done in a transaction to ensure atomicity.\n\t\t\t \n\t\t\t Transactions are not supported for unhydrated trees, so we cannot run a transaction in that case.\n\t\t\t * But since there are no collaborators, this is not an issue.\n\t\t\t /\n\t\t\tprivate _applyEditsInBatch(applyEdits: () => void): void {\n\t\t\t\tconst branch = TreeAlpha.branch(this);\n\n\t\t\t\tif (branch === undefined) {\n\t\t\t\t\t// If this node does not have a corresponding branch, then it is unhydrated.\n\t\t\t\t\t// I.e., it is not part of a collaborative session yet.\n\t\t\t\t\t// Therefore, we don't need to run the edits as a transaction.\n\t\t\t\t\tapplyEdits();\n\t\t\t\t} else {\n\t\t\t\t\tbranch.runTransaction(() => {\n\t\t\t\t\t\tapplyEdits();\n\t\t\t\t\t});\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t/\n\t\t\t Attempts to resolve the provided Column node or ID to a Column node in the table.\n\t\t\t * Returns `undefined` if there is no match.\n\t\t\t * @remarks Searches for a match based strictly on the ID and returns that result.\n\t\t\t /\n\t\t\tprivate _tryGetColumn(\n\t\t\t\tcolumnOrId: string \| ColumnValueType,\n\t\t\t): ColumnValueType \| undefined {\n\t\t\t\tconst columnId = this._getColumnId(columnOrId);\n\t\t\t\treturn this.getColumn(columnId);\n\t\t\t}\n\n\t\t\t/\n\t\t\t Attempts to resolve the provided Column node or ID to a Column node in the table.\n\t\t\t * @throws Throws a `UsageError` if there is no match.\n\t\t\t * @remarks Searches for a match based strictly on the ID and returns that result.\n\t\t\t /\n\t\t\tprivate _getColumn(columnOrId: string \| ColumnValueType): ColumnValueType {\n\t\t\t\tconst column = this._tryGetColumn(columnOrId);\n\t\t\t\tif (column === undefined) {\n\t\t\t\t\tthis._throwMissingColumnError(this._getColumnId(columnOrId));\n\t\t\t\t}\n\t\t\t\treturn column;\n\t\t\t}\n\n\t\t\t/\n\t\t\t Resolves a Column node or ID to its ID.\n\t\t\t * If an ID is provided, it is returned as-is.\n\t\t\t * If a node is provided, its ID is returned.\n\t\t\t /\n\t\t\tprivate _getColumnId(columnOrId: string \| ColumnValueType): string {\n\t\t\t\treturn typeof columnOrId === \"string\" ? columnOrId : columnOrId.id;\n\t\t\t}\n\n\t\t\t/\n\t\t\t Checks if a Column with the specified ID exists in the table.\n\t\t\t /\n\t\t\tprivate _containsColumnWithId(columnId: string): boolean {\n\t\t\t\treturn this._tryGetColumn(columnId) !== undefined;\n\t\t\t}\n\n\t\t\t/\n\t\t\t Throw a `UsageError` for a missing Column by its ID.\n\t\t\t /\n\t\t\tprivate _throwMissingColumnError(columnId: string): never {\n\t\t\t\tthrow new UsageError(`No column with ID \"${columnId}\" exists in the table.`);\n\t\t\t}\n\n\t\t\t/\n\t\t\t Attempts to resolve the provided Row node or ID to a Row node in the table.\n\t\t\t * Returns `undefined` if there is no match.\n\t\t\t * @remarks Searches for a match based strictly on the ID and returns that result.\n\t\t\t /\n\t\t\tprivate _tryGetRow(rowOrId: string \| RowValueType): RowValueType \| undefined {\n\t\t\t\tconst rowId = this._getRowId(rowOrId);\n\t\t\t\treturn this.getRow(rowId);\n\t\t\t}\n\n\t\t\t/\n\t\t\t Attempts to resolve the provided Row node or ID to a Row node in the table.\n\t\t\t * @throws Throws a `UsageError` if there is no match.\n\t\t\t * @remarks Searches for a match based strictly on the ID and returns that result.\n\t\t\t /\n\t\t\tprivate _getRow(rowOrId: string \| RowValueType): RowValueType {\n\t\t\t\tconst row = this._tryGetRow(rowOrId);\n\t\t\t\tif (row === undefined) {\n\t\t\t\t\tthis._throwMissingRowError(this._getRowId(rowOrId));\n\t\t\t\t}\n\t\t\t\treturn row;\n\t\t\t}\n\n\t\t\t/\n\t\t\t Resolves a Row node or ID to its ID.\n\t\t\t * If an ID is provided, it is returned as-is.\n\t\t\t * If a node is provided, its ID is returned.\n\t\t\t /\n\t\t\tprivate _getRowId(rowOrId: string \| RowValueType): string {\n\t\t\t\treturn typeof rowOrId === \"string\" ? rowOrId : rowOrId.id;\n\t\t\t}\n\n\t\t\t/\n\t\t\t Throw a `UsageError` for a missing Row by its ID.\n\t\t\t /\n\t\t\tprivate _throwMissingRowError(rowId: string): never {\n\t\t\t\tthrow new UsageError(`No row with ID \"${rowId}\" exists in the table.`);\n\t\t\t}\n\n\t\t\tprivate static _removeRange<TNodeSchema extends ImplicitAllowedTypes>(\n\t\t\t\trange: { index: number; count: number },\n\t\t\t\tarray: TreeArrayNode<TNodeSchema>,\n\t\t\t): TreeNodeFromImplicitAllowedTypes<TNodeSchema>[] {\n\t\t\t\tTable._assertValidRange(range, array);\n\n\t\t\t\tconst { index, count } = range;\n\t\t\t\tconst end = index + count; // exclusive\n\n\t\t\t\t// TypeScript is unable to narrow the array element type correctly here, hence the cast.\n\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\tconst removedRows = array.slice(\n\t\t\t\t\tindex,\n\t\t\t\t\tend,\n\t\t\t\t) as TreeNodeFromImplicitAllowedTypes<TNodeSchema>[];\n\t\t\t\tarray.removeRange(index, end);\n\n\t\t\t\treturn removedRows;\n\t\t\t}\n\n\t\t\t/\n\t\t\t Ensure that the specified index is a valid location for item insertion in the destination list.\n\t\t\t * @throws Throws a usage error if the destination is invalid.\n\t\t\t /\n\t\t\tprivate static validateInsertionIndex(\n\t\t\t\tindex: number,\n\t\t\t\tdestinationList: readonly unknown[],\n\t\t\t): void {\n\t\t\t\tif (index < 0) {\n\t\t\t\t\tthrow new UsageError(\"The index must be greater than or equal to 0.\");\n\t\t\t\t}\n\n\t\t\t\tif (index > destinationList.length) {\n\t\t\t\t\tthrow new UsageError(\"The index specified for insertion is out of bounds.\");\n\t\t\t\t}\n\n\t\t\t\tif (!Number.isInteger(index)) {\n\t\t\t\t\tthrow new UsageError(\"The index must be an integer.\");\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// Set a private symbol on the schema class that marks it as having been generated by this factory.\n\t\t// Column / Row functionality use this to validate that they are being used in a table.\n\t\t// This is effectively a work-around that allows columns and rows to invoke table methods\n\t\t// without having to pass the table as a parameter to their construction, which isn't possible.\n\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t(Table as any)[tableSchemaSymbol] = true;\n\n\t\ttype TableValueType = TreeNode &\n\t\t\tTableSchema.Table<TInputScope, TCellSchema, TColumnSchema, TRowSchema> &\n\t\t\tWithType<ScopedSchemaName<Scope, \"Table\">>;\n\t\ttype TableInsertableType = InsertableObjectFromSchemaRecord<typeof tableFields>;\n\t\ttype TableConstructorType = new (data: TableInsertableType) => TableValueType;\n\n\t\t// Returning SingletonSchema without a type conversion results in TypeScript generating something like `readonly \"__#124291@#brand\": unknown;`\n\t\t// for the private brand field of TreeNode.\n\t\t// This numeric id doesn't seem to be stable over incremental builds, and thus causes diffs in the API extractor reports.\n\t\t// This is avoided by doing this type conversion.\n\t\t// The conversion is done via assignment instead of `as` to get stronger type safety.\n\t\tconst TableSchemaType: TreeNodeSchemaClass<\n\t\t\t/ Name / ScopedSchemaName<Scope, \"Table\">,\n\t\t\t/ Kind / NodeKind.Object,\n\t\t\t/ TNode / TableValueType,\n\t\t\t/ TInsertable / object & TableInsertableType,\n\t\t\t/ ImplicitlyConstructable / true,\n\t\t\t/ Info / typeof tableFields\n\t\t> & {\n\t\t\t/\n\t\t\t Create an empty table.\n\t\t\t /\n\t\t\tempty<TThis extends TableConstructorType>(this: TThis): InstanceType<TThis>;\n\t\t} = Table;\n\n\t\t// Return the table schema\n\t\treturn TableSchemaType;\n\t}\n\n\t/\n\t Base row schema type.\n\t * @sealed @system @alpha\n\t /\n\texport type TableSchemaBase<\n\t\tTScope extends string \| undefined,\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTColumn extends ColumnSchemaBase<TScope, TCell>,\n\t\tTRow extends RowSchemaBase<TScope, TCell>,\n\t> = ReturnType<typeof createTableSchema<TScope, TCell, TColumn, TRow>>;\n\n\t// #endregion\n}\n\n/\n Contains types and factories for creating schema to represent dynamic tabular data.\n \n @remarks\n \n WARNING: These APIs are in preview and are subject to change.\n * Until these APIs have stabilized, it is not recommended to use them in production code.\n * There may be breaking changes to these APIs and their underlying data format.\n * Using these APIs in production code may result in data loss or corruption.\n \n The primary APIs for create tabular data schema are:\n \n - {@link TableSchema.(table:1)}\n \n - {@link TableSchema.(column:1)}\n \n - {@link TableSchema.(row:1)}\n \n Tables created using these APIs are...\n \n - sparse, meaning that cells may be omitted, and new rows are empty by default.\n \n - dynamic, meaning that their structure can be modified at runtime.\n * Columns and rows can be inserted, removed, modified, and reordered.\n * Cells can be inserted, removed, and modified.\n \n - row-major, meaning that operating on rows (including inserts, removal, moves, and traversal) is more efficient than operating on columns.\n \n Column and Row schema created using these APIs are extensible via the `props` field.\n * This allows association of additional properties with column and row nodes.\n \n Cells in the table may become \"orphaned.\"\n * That is, it is possible to enter a state where one or more rows contain cells with no corresponding column.\n * To reduce the likelihood of this, you can manually remove corresponding cells when removing columns.\n * Either way, it is possible to enter such a state via the merging of edits.\n * For example: one client might add a row while another concurrently removes a column, orphaning the cell where the column and row intersected.\n \n @example Defining a Table schema\n \n ```typescript\n * class MyTable extends TableSchema.table({\n * \tschemaFactory,\n * \tcell: schemaFactory.string,\n * }) {}\n \n const table = new MyTable({\n * \tcolumns: [{ id: \"column-0\" }],\n * \trows: [{ id: \"row-0\", cells: { \"column-0\": \"Hello world!\" } }],\n * });\n * ```\n \n @example Customizing Column and Row schema\n \n ```typescript\n * const Cell = schemaFactory.string;\n \n class MyColumn extends TableSchema.column({\n * \tschemaFactory,\n * \tcell: Cell,\n * \tprops: schemaFactory.object(\"TableColumnProps\", {\n * \t\tlabel: schemaFactory.string,\n * \t}),\n * }) {}\n \n class MyRow extends TableSchema.row({\n * \tschemaFactory,\n * \tcell: Cell,\n * }) {}\n \n class MyTable extends TableSchema.table({\n * \tschemaFactory,\n * \tcell: Cell,\n * \tcolumn: MyColumn,\n * \trow: MyRow,\n * }) {}\n \n const table = new MyTable({\n * \tcolumns: [\n * \t\tnew MyColumn({ props: { label: \"Entry\" } }),\n * \t\tnew MyColumn({ props: { label: \"Date\" } }),\n * \t\tnew MyColumn({ props: { label: \"Amount\" } }),\n * \t],\n * \trows: [],\n * });\n * ```\n \n @example Listening for changes in the table\n \n ```typescript\n * // Listen for any changes to the table and its children.\n * // The \"treeChanged\" event will fire when the associated node or any of its descendants change.\n * Tree.on(table, \"treeChanged\", () => {\n * \t// Respond to the change.\n * });\n * ```\n \n @example Listening for changes to the rows list only\n \n ```typescript\n * // Listen for any changes to the list of rows.\n * // The \"nodeChanged\" event will fire only when the specified node itself changes (i.e., its own properties change).\n * // In this case, the event will fire when a row is added or removed, or the order of the list is changed.\n * // But it won't fire when a row's properties change, or when the row's cells change, etc.\n * Tree.on(table.rows, \"nodeChanged\", () => {\n * \t// Respond to the change.\n * });\n * ```\n \n @privateRemarks\n * The above examples are backed by tests in `tableSchema.spec.ts`.\n * Those tests and these examples should be kept in-sync to ensure that the examples are correct.\n \n @alpha\n /\nexport namespace TableSchema {\n\t// #region Column\n\n\t/\n\t A column in a table.\n\t * @remarks Implemented by the schema class returned from {@link TableSchema.(column:2)}.\n\t * @typeParam TCell - The type of the cells in the {@link TableSchema.Table}.\n\t * @typeParam TProps - Additional properties to associate with the column.\n\t * @sealed @alpha\n\t /\n\texport interface Column<\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTProps extends ImplicitAnnotatedFieldSchema = ImplicitAnnotatedFieldSchema,\n\t> {\n\t\t/\n\t\t The unique identifier of the column.\n\t\t * @remarks Uniquely identifies the node within the entire tree, not just the table.\n\t\t /\n\t\treadonly id: string;\n\n\t\t/\n\t\t The column's properties.\n\t\t * @remarks This is a user-defined schema that can be used to store additional information about the column.\n\t\t * @privateRemarks\n\t\t * Note: these docs are duplicated on the inline type definitions in {@link System_TableSchema.createColumnSchema}.\n\t\t * If you update the docs here, please also update the inline type definitions.\n\t\t /\n\t\tget props(): TreeFieldFromImplicitField<UnannotateImplicitFieldSchema<TProps>>;\n\t\tset props(value: InsertableTreeFieldFromImplicitField<\n\t\t\tUnannotateImplicitFieldSchema<TProps>\n\t\t>);\n\n\t\t/\n\t\t Gets all of the populated cells in the column, keyed by their associated row IDs.\n\t\t * @throws Throws an error if the column is not in a table.\n\t\t /\n\t\tgetCells(): readonly {\n\t\t\trowId: string;\n\t\t\tcell: TreeNodeFromImplicitAllowedTypes<TCell>;\n\t\t}[];\n\t}\n\n\t/\n\t Factory for creating new table column schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the {@link TableSchema.Table}.\n\t * @alpha\n\t /\n\texport function column<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t>(\n\t\tparams: System_TableSchema.CreateColumnOptionsBase<SchemaFactoryAlpha<TScope>, TCell>,\n\t): System_TableSchema.ColumnSchemaBase<TScope, TCell, System_TableSchema.DefaultPropsType>;\n\t/\n\t Factory for creating new table column schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the {@link TableSchema.Table}.\n\t * @typeParam TProps - Additional properties to associate with the column.\n\t * @alpha\n\t /\n\texport function column<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TProps extends ImplicitAnnotatedFieldSchema,\n\t>(\n\t\tparams: System_TableSchema.CreateColumnOptionsBase<SchemaFactoryAlpha<TScope>, TCell> & {\n\t\t\t/\n\t\t\t Optional column properties.\n\t\t\t /\n\t\t\treadonly props: TProps;\n\t\t},\n\t): System_TableSchema.ColumnSchemaBase<TScope, TCell, TProps>;\n\t/\n\t Overload implementation\n\t /\n\texport function column({\n\t\tschemaFactory,\n\t\tcell,\n\t\tprops = SchemaFactory.optional(SchemaFactory.null),\n\t}: System_TableSchema.CreateColumnOptionsBase & {\n\t\treadonly props?: ImplicitAnnotatedFieldSchema;\n\t}): TreeNodeSchema {\n\t\treturn System_TableSchema.createColumnSchema(schemaFactory, cell, props);\n\t}\n\n\t// #endregion\n\n\t// #region Row\n\n\t/\n\t A row in a table.\n\t * @remarks Implemented by the schema class returned from {@link TableSchema.(row:2)}.\n\t * @typeParam TCell - The type of the cells in the {@link TableSchema.Table}.\n\t * @typeParam TProps - Additional properties to associate with the row.\n\t * @sealed @alpha\n\t /\n\texport interface Row<\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTProps extends ImplicitAnnotatedFieldSchema = ImplicitAnnotatedFieldSchema,\n\t> {\n\t\t/\n\t\t The unique identifier of the row.\n\t\t * @remarks Uniquely identifies the node within the entire tree, not just the table.\n\t\t /\n\t\treadonly id: string;\n\n\t\t/\n\t\t Gets the cell in the specified column.\n\t\t * @returns The cell if it exists, otherwise undefined.\n\t\t * @privateRemarks TODO: throw if the column does not belong to the same table as the row.\n\t\t /\n\t\tgetCell(column: Column<TCell>): TreeNodeFromImplicitAllowedTypes<TCell> \| undefined;\n\t\t/\n\t\t Gets the cell in the specified column, denoted by column ID.\n\t\t * @returns The cell if it exists, otherwise undefined.\n\t\t /\n\t\tgetCell(columnId: string): TreeNodeFromImplicitAllowedTypes<TCell> \| undefined;\n\n\t\t/\n\t\t Gets all of the populated cells in the row, keyed by their associated column IDs.\n\t\t /\n\t\tgetCells(): readonly {\n\t\t\tcolumnId: string;\n\t\t\tcell: TreeNodeFromImplicitAllowedTypes<TCell>;\n\t\t}[];\n\n\t\t/\n\t\t Sets the cell in the specified column.\n\t\t * @remarks To remove a cell, call {@link TableSchema.Row.(removeCell:1)} instead.\n\t\t * @privateRemarks TODO: Throw an error if the column does not exist in the table.\n\t\t /\n\t\tsetCell(\n\t\t\tcolumn: Column<TCell>,\n\t\t\tvalue: InsertableTreeNodeFromImplicitAllowedTypes<TCell>,\n\t\t): void;\n\t\t/\n\t\t Sets the cell in the specified column, denoted by column ID.\n\t\t * @remarks To remove a cell, call {@link TableSchema.Row.(removeCell:2)} instead.\n\t\t /\n\t\tsetCell(columnId: string, value: InsertableTreeNodeFromImplicitAllowedTypes<TCell>): void;\n\n\t\t/\n\t\t Removes the cell in the specified column.\n\t\t * @returns The cell if it exists, otherwise undefined.\n\t\t * @privateRemarks TODO: Throw if the column does not belong to the same table as the row.\n\t\t /\n\t\tremoveCell(column: Column<TCell>): TreeNodeFromImplicitAllowedTypes<TCell> \| undefined;\n\t\t/\n\t\t Removes the cell in the specified column, denoted by column ID.\n\t\t * @returns The cell if it exists, otherwise undefined.\n\t\t /\n\t\tremoveCell(columnId: string): TreeNodeFromImplicitAllowedTypes<TCell> \| undefined;\n\n\t\t/\n\t\t The row's properties.\n\t\t * @remarks This is a user-defined schema that can be used to store additional information about the row.\n\t\t * @privateRemarks\n\t\t * Note: these docs are duplicated on the inline type definitions in {@link System_TableSchema.createRowSchema}.\n\t\t * If you update the docs here, please also update the inline type definitions.\n\t\t /\n\t\tget props(): TreeFieldFromImplicitField<UnannotateImplicitFieldSchema<TProps>>;\n\t\tset props(value: InsertableTreeFieldFromImplicitField<\n\t\t\tUnannotateImplicitFieldSchema<TProps>\n\t\t>);\n\t}\n\n\t/\n\t Factory for creating new table column schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the {@link TableSchema.Table}.\n\t * @alpha\n\t /\n\texport function row<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t>(\n\t\tparams: System_TableSchema.CreateRowOptionsBase<SchemaFactoryAlpha<TScope>, TCell>,\n\t): System_TableSchema.RowSchemaBase<TScope, TCell, System_TableSchema.DefaultPropsType>;\n\t/\n\t Factory for creating new table row schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the {@link TableSchema.Table}.\n\t * @typeParam TProps - Additional properties to associate with the row.\n\t * @alpha\n\t /\n\texport function row<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TProps extends ImplicitAnnotatedFieldSchema,\n\t>(\n\t\tparams: System_TableSchema.CreateRowOptionsBase<SchemaFactoryAlpha<TScope>, TCell> & {\n\t\t\t/\n\t\t\t Optional row properties.\n\t\t\t /\n\t\t\treadonly props: TProps;\n\t\t},\n\t): System_TableSchema.RowSchemaBase<TScope, TCell, TProps>;\n\t/\n\t Overload implementation\n\t /\n\texport function row({\n\t\tschemaFactory,\n\t\tcell,\n\t\tprops = SchemaFactory.optional(SchemaFactory.null),\n\t}: System_TableSchema.CreateRowOptionsBase & {\n\t\treadonly props?: ImplicitAnnotatedFieldSchema;\n\t}): TreeNodeSchema {\n\t\treturn System_TableSchema.createRowSchema(schemaFactory, cell, props);\n\t}\n\n\t// #endregion\n\n\t// #region Table\n\n\t/\n\t A key to uniquely identify a cell within a table.\n\t * @alpha\n\t /\n\texport interface CellKey<\n\t\tTColumn extends ImplicitAllowedTypes,\n\t\tTRow extends ImplicitAllowedTypes,\n\t> {\n\t\t/\n\t\t {@link TableSchema.Column} or {@link TableSchema.Column.id} at which the cell is located.\n\t\t /\n\t\treadonly column: string \| TreeNodeFromImplicitAllowedTypes<TColumn>;\n\n\t\t/\n\t\t {@link TableSchema.Row} or {@link TableSchema.Row.id} at which the cell is located.\n\t\t /\n\t\treadonly row: string \| TreeNodeFromImplicitAllowedTypes<TRow>;\n\t}\n\n\t/\n\t {@link TableSchema.Table.insertColumns} parameters.\n\t * @alpha\n\t /\n\texport interface InsertColumnsParameters<TColumn extends ImplicitAllowedTypes> {\n\t\t/\n\t\t The index at which to insert the new columns.\n\t\t * @remarks If not provided, the columns will be appended to the end of the table.\n\t\t /\n\t\treadonly index?: number \| undefined;\n\n\t\t/\n\t\t The columns to insert.\n\t\t /\n\t\treadonly columns: InsertableTreeNodeFromImplicitAllowedTypes<TColumn>[];\n\t}\n\n\t/\n\t {@link TableSchema.Table.insertRows} parameters.\n\t * @alpha\n\t /\n\texport interface InsertRowsParameters<TRow extends ImplicitAllowedTypes> {\n\t\t/\n\t\t The index at which to insert the new rows.\n\t\t * @remarks If not provided, the rows will be appended to the end of the table.\n\t\t /\n\t\treadonly index?: number \| undefined;\n\n\t\t/\n\t\t The rows to insert.\n\t\t /\n\t\treadonly rows: InsertableTreeNodeFromImplicitAllowedTypes<TRow>[];\n\t}\n\n\t/\n\t {@link TableSchema.Table.setCell} parameters.\n\t * @alpha\n\t /\n\texport interface SetCellParameters<\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTColumn extends ImplicitAllowedTypes,\n\t\tTRow extends ImplicitAllowedTypes,\n\t> {\n\t\t/\n\t\t The key to uniquely identify a cell in a table.\n\t\t /\n\t\treadonly key: CellKey<TColumn, TRow>;\n\n\t\t/\n\t\t The cell to set.\n\t\t /\n\t\treadonly cell: InsertableTreeNodeFromImplicitAllowedTypes<TCell>;\n\t}\n\n\t/\n\t A table.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the table.\n\t * @typeParam TColumn - The type of the columns in the table.\n\t * @typeParam TRow - The type of the rows in the table.\n\t * @sealed @alpha\n\t /\n\texport interface Table<\n\t\tTScope extends string \| undefined,\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTColumn extends System_TableSchema.ColumnSchemaBase<TScope, TCell>,\n\t\tTRow extends System_TableSchema.RowSchemaBase<TScope, TCell>,\n\t> {\n\t\t/\n\t\t The table's columns.\n\t\t /\n\t\treadonly columns: TreeArrayNode<TColumn>;\n\n\t\t/\n\t\t The table's rows.\n\t\t /\n\t\treadonly rows: TreeArrayNode<TRow>;\n\n\t\t/\n\t\t Gets a table column by its {@link TableSchema.Column.id}.\n\t\t /\n\t\tgetColumn(id: string): TreeNodeFromImplicitAllowedTypes<TColumn> \| undefined;\n\n\t\t/\n\t\t Gets a table row by its {@link TableSchema.Row.id}.\n\t\t /\n\t\tgetRow(id: string): TreeNodeFromImplicitAllowedTypes<TRow> \| undefined;\n\n\t\t/\n\t\t Gets a cell in the table by column and row IDs.\n\t\t * @param key - A key that uniquely distinguishes a cell in the table, represented as a combination of the column ID and row ID.\n\t\t /\n\t\tgetCell(key: CellKey<TColumn, TRow>): TreeNodeFromImplicitAllowedTypes<TCell> \| undefined;\n\n\t\t/\n\t\t Inserts 0 or more columns into the table.\n\t\t \n\t\t @throws Throws an error if the specified index is out of range.\n\t\t \n\t\t No columns are inserted in this case.\n\t\t /\n\t\tinsertColumns(\n\t\t\tparams: InsertColumnsParameters<TColumn>,\n\t\t): TreeNodeFromImplicitAllowedTypes<TColumn>[];\n\n\t\t/\n\t\t Inserts 0 or more rows into the table.\n\t\t \n\t\t @throws\n\t\t * Throws an error in the following cases:\n\t\t \n\t\t - The row contains cells, but the table does not contain matching columns for one or more of those cells.\n\t\t \n\t\t - The specified index is out of range.\n\t\t \n\t\t No rows are inserted in these cases.\n\t\t /\n\t\tinsertRows(params: InsertRowsParameters<TRow>): TreeNodeFromImplicitAllowedTypes<TRow>[];\n\n\t\t/\n\t\t Sets the cell at the specified location in the table.\n\t\t * @remarks To remove a cell, call {@link TableSchema.Table.removeCell} instead.\n\t\t /\n\t\tsetCell(params: SetCellParameters<TCell, TColumn, TRow>): void;\n\n\t\t/\n\t\t Removes a range of columns from the table.\n\t\t \n\t\t @remarks\n\t\t * Also removes any corresponding cells from the table's rows.\n\t\t \n\t\t Note: this operation can be slow for tables with many rows.\n\t\t * We are actively working on improving the performance of this operation, but for now it may have a negative\n\t\t * impact on performance.\n\t\t * @param index - The starting index of the range to remove. Default: `0`.\n\t\t * @param count - The number of columns to remove. Default: all remaining columns starting from `index`.\n\t\t * @throws Throws an error if the specified range is invalid. In this case, no columns are removed.\n\t\t /\n\t\tremoveColumns(\n\t\t\tindex?: number \| undefined,\n\t\t\tcount?: number \| undefined,\n\t\t): TreeNodeFromImplicitAllowedTypes<TColumn>[];\n\t\t/\n\t\t Removes 0 or more columns from the table.\n\t\t * @remarks\n\t\t * Also removes any corresponding cells from the table's rows.\n\t\t \n\t\t Note: this operation can be slow for tables with many rows.\n\t\t * We are actively working on improving the performance of this operation, but for now it may have a negative\n\t\t * impact on performance.\n\t\t \n\t\t @param columns - The columns to remove.\n\t\t * @throws Throws an error if any of the columns are not in the table.\n\t\t * In this case, no columns are removed.\n\t\t /\n\t\tremoveColumns(\n\t\t\tcolumns: readonly TreeNodeFromImplicitAllowedTypes<TColumn>[],\n\t\t): TreeNodeFromImplicitAllowedTypes<TColumn>[];\n\t\t/\n\t\t Removes 0 or more columns from the table.\n\t\t \n\t\t @remarks\n\t\t * Also removes any corresponding cells from the table's rows.\n\t\t \n\t\t Note: this operation can be slow for tables with many rows.\n\t\t * We are actively working on improving the performance of this operation, but for now it may have a negative\n\t\t * impact on performance.\n\t\t \n\t\t @param columns - The columns to remove, specified by their {@link TableSchema.Column.id}.\n\t\t * @throws Throws an error if any of the columns are not in the table.\n\t\t * In this case, no columns are removed.\n\t\t /\n\t\tremoveColumns(columns: readonly string[]): TreeNodeFromImplicitAllowedTypes<TColumn>[];\n\n\t\t/\n\t\t Removes a range of rows from the table.\n\t\t * @param index - The starting index of the range to remove. Default: `0`.\n\t\t * @param count - The number of rows to remove. Default: all remaining rows starting from `index`.\n\t\t * @throws Throws an error if the specified range is invalid. In this case, no rows are removed.\n\t\t /\n\t\tremoveRows(\n\t\t\tindex?: number \| undefined,\n\t\t\tcount?: number \| undefined,\n\t\t): TreeNodeFromImplicitAllowedTypes<TRow>[];\n\t\t/\n\t\t Removes 0 or more rows from the table.\n\t\t * @param rows - The rows to remove.\n\t\t * @throws Throws an error if any of the rows are not in the table.\n\t\t * In this case, no rows are removed.\n\t\t /\n\t\tremoveRows(\n\t\t\trows: readonly TreeNodeFromImplicitAllowedTypes<TRow>[],\n\t\t): TreeNodeFromImplicitAllowedTypes<TRow>[];\n\t\t/\n\t\t Removes 0 or more rows from the table.\n\t\t * @param rows - The rows to remove, specified by their {@link TableSchema.Row.id}.\n\t\t * @throws Throws an error if any of the rows are not in the table.\n\t\t * In this case, no rows are removed.\n\t\t /\n\t\tremoveRows(rows: readonly string[]): TreeNodeFromImplicitAllowedTypes<TRow>[];\n\n\t\t/\n\t\t Removes the cell at the specified location in the table.\n\t\t * @returns The cell if it exists, otherwise undefined.\n\t\t * @throws Throws an error if the location does not exist in the table.\n\t\t /\n\t\tremoveCell(\n\t\t\tkey: CellKey<TColumn, TRow>,\n\t\t): TreeNodeFromImplicitAllowedTypes<TCell> \| undefined;\n\t}\n\n\t/\n\t Factory for creating new table schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the table.\n\t * @alpha\n\t /\n\texport function table<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<SchemaFactoryAlpha<TScope>, TCell>,\n\t): System_TableSchema.TableSchemaBase<\n\t\tTScope,\n\t\tTCell,\n\t\tSystem_TableSchema.ColumnSchemaBase<TScope, TCell, System_TableSchema.DefaultPropsType>,\n\t\tSystem_TableSchema.RowSchemaBase<TScope, TCell, System_TableSchema.DefaultPropsType>\n\t>;\n\t/\n\t Factory for creating new table schema with custom column schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the table.\n\t * @typeParam TColumn - The type of the columns in the table.\n\t * @alpha\n\t /\n\texport function table<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TColumn extends System_TableSchema.ColumnSchemaBase<TScope, TCell>,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<SchemaFactoryAlpha<TScope>, TCell> & {\n\t\t\treadonly column: TColumn;\n\t\t},\n\t): System_TableSchema.TableSchemaBase<\n\t\tTScope,\n\t\tTCell,\n\t\tTColumn,\n\t\tSystem_TableSchema.RowSchemaBase<TScope, TCell, System_TableSchema.DefaultPropsType>\n\t>;\n\t/\n\t Factory for creating new table schema with custom row schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the table.\n\t * @typeParam TRow - The type of the rows in the table.\n\t * @alpha\n\t /\n\texport function table<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TRow extends System_TableSchema.RowSchemaBase<TScope, TCell>,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<SchemaFactoryAlpha<TScope>, TCell> & {\n\t\t\treadonly row: TRow;\n\t\t},\n\t): System_TableSchema.TableSchemaBase<\n\t\tTScope,\n\t\tTCell,\n\t\tSystem_TableSchema.ColumnSchemaBase<TScope, TCell, System_TableSchema.DefaultPropsType>,\n\t\tTRow\n\t>;\n\t/\n\t Factory for creating new table schema with custom column and row schema.\n\t * @typeParam TScope - The {@link SchemaFactory.scope \| schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the table.\n\t * @typeParam TColumn - The type of the columns in the table.\n\t * @typeParam TRow - The type of the rows in the table.\n\t * @alpha\n\t /\n\texport function table<\n\t\tconst TScope extends string \| undefined,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TColumn extends System_TableSchema.ColumnSchemaBase<TScope, TCell>,\n\t\tconst TRow extends System_TableSchema.RowSchemaBase<TScope, TCell>,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<SchemaFactoryAlpha<TScope>, TCell> & {\n\t\t\treadonly column: TColumn;\n\t\t\treadonly row: TRow;\n\t\t},\n\t): System_TableSchema.TableSchemaBase<TScope, TCell, TColumn, TRow>;\n\t/\n\t Overload implementation\n\t */\n\texport function table({\n\t\tschemaFactory,\n\t\tcell: cellSchema,\n\t\tcolumn: columnSchema = column({\n\t\t\tschemaFactory,\n\t\t\tcell: cellSchema,\n\t\t}),\n\t\trow: rowSchema = row({\n\t\t\tschemaFactory,\n\t\t\tcell: cellSchema,\n\t\t}),\n\t}: System_TableSchema.TableFactoryOptionsBase & {\n\t\treadonly column?: System_TableSchema.ColumnSchemaBase;\n\t\treadonly row?: System_TableSchema.RowSchemaBase;\n\t}): TreeNodeSchema {\n\t\treturn System_TableSchema.createTableSchema(\n\t\t\tschemaFactory,\n\t\t\tcellSchema,\n\t\t\tcolumnSchema,\n\t\t\trowSchema,\n\t\t);\n\t}\n\n\t// #endregion\n}\n"]}

package/dist/treeFactory.d.ts CHANGED Viewed

@@ -16,8 +16,7 @@ export interface ISharedTree extends ISharedObject, ITreePrivate {
 /**
  * SharedTree is a hierarchical data structure for collaboratively editing strongly typed JSON-like trees
  * of objects, arrays, and other data types.
- * @legacy
- * @alpha
+ * @legacy @beta
  */
 export declare const SharedTree: ISharedObjectKind<ITree> & SharedObjectKind<ITree>;
 /**

package/dist/treeFactory.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"treeFactory.d.ts","sourceRoot":"","sources":["../src/treeFactory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,iBAAiB,EAMtB,MAAM,6CAA6C,CAAC;AAGrD,OAAO,EAEN,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAGtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAIpD;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,aAAa,EAAE,YAAY;CAAG;AAgDnE~~;;;;;GAKG~~;AACH,eAAO,MAAM,UAAU,oDAA2B,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,iBAAiB,GACxB,iBAAiB,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CASpD"}
1	+ {"version":3,"file":"treeFactory.d.ts","sourceRoot":"","sources":["../src/treeFactory.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,iBAAiB,EAMtB,MAAM,6CAA6C,CAAC;AAGrD,OAAO,EAEN,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAGtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAIpD;;;;GAIG;AACH,MAAM,WAAW,WAAY,SAAQ,aAAa,EAAE,YAAY;CAAG;AAgDnE;;;;GAIG;AACH,eAAO,MAAM,UAAU,oDAA2B,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,iBAAiB,GACxB,iBAAiB,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CASpD"}

package/dist/treeFactory.js CHANGED Viewed

@@ -43,8 +43,7 @@ function treeKernelFactory(options) {
 /**
  * SharedTree is a hierarchical data structure for collaboratively editing strongly typed JSON-like trees
  * of objects, arrays, and other data types.
- * @legacy
- * @alpha
+ * @legacy @beta
  */
 exports.SharedTree = configuredSharedTree({});
 /**

package/dist/treeFactory.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"treeFactory.js","sourceRoot":"","sources":["../src/treeFactory.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,0EAQqD;AACrD,uEAAsE;AAEtE,qDAMgC;AAChC,uEAAwF;AAExF,8CAA4C;AAC5C,+CAAsD;AAStD;;;;;GAKG;AACH,SAAS,iBAAiB,CACzB,OAAkC;IAElC,SAAS,kBAAkB,CAAC,IAAgB;QAC3C,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,IAAI,qBAAU,CAAC,gDAAgD,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,eAAe,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QACvC,4FAA4F;QAC5F,kFAAkF;QAClF,eAAe,CAAC,sBAAsB,KAAK,6BAAkB,CAAC,IAAI,CAAC;QACnE,OAAO,IAAI,2BAAgB,CAC1B,IAAI,oBAAS,CAAC,YAAY,CAAC,EAC3B,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,kBAAkB,EACvB,IAAI,CAAC,kBAAkB,EACvB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,YAAY,EACjB,eAAe,CACf,CAAC;IACH,CAAC;IAED,OAAO;QACN,MAAM,EAAE,CAAC,IAAgB,EAAoC,EAAE;YAC9D,MAAM,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACnC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,QAAQ,CACb,IAAgB,EAChB,OAA+B;YAE/B,MAAM,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC1B,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;KACD,CAAC;AACH,CAAC;AAED~~;;;;;GAKG~~;AACU,QAAA,UAAU,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,oBAAoB,CACnC,OAA0B;IAE1B,MAAM,mBAAmB,GAA+B;QACvD,IAAI,EAAE,+CAAqB;QAC3B,UAAU,EAAE,8CAAoB;QAChC,sBAAsB,EAAE,mBAAmB;QAC3C,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC;KACnC,CAAC;IAEF,OAAO,IAAA,+BAAoB,EAAQ,mBAAmB,CAAC,CAAC;AACzD,CAAC;AAXD,oDAWC","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n /\n\nimport type { IChannelStorageService } from \"@fluidframework/datastore-definitions/internal\";\nimport type { SharedObjectKind } from \"@fluidframework/shared-object-base\";\nimport {\n\ttype ISharedObject,\n\ttype ISharedObjectKind,\n\tmakeSharedObjectKind,\n\ttype KernelArgs,\n\ttype SharedKernelFactory,\n\ttype SharedObjectOptions,\n\ttype FactoryOut,\n} from \"@fluidframework/shared-object-base/internal\";\nimport { UsageError } from \"@fluidframework/telemetry-utils/internal\";\n\nimport {\n\tSharedTreeKernel,\n\ttype ITreePrivate,\n\ttype SharedTreeOptions,\n\ttype SharedTreeOptionsInternal,\n\ttype SharedTreeKernelView,\n} from \"./shared-tree/index.js\";\nimport { SharedTreeFactoryType, SharedTreeAttributes } from \"./sharedTreeAttributes.js\";\nimport type { ITree } from \"./simple-tree/index.js\";\nimport { Breakable } from \"./util/index.js\";\nimport { FluidClientVersion } from \"./codec/index.js\";\n\n/\n {@link ITreePrivate} extended with ISharedObject.\n * @remarks\n * This is used when integration testing this package with the Fluid runtime as it exposes the APIs the runtime consumes to manipulate the tree.\n /\nexport interface ISharedTree extends ISharedObject, ITreePrivate {}\n\n/\n Creates a factory for shared tree kernels with the given options.\n * @remarks\n * Exposes {@link ITreePrivate} to allow access to internals in tests without a cast.\n * Code exposing this beyond this package will need to update to a more public type.\n /\nfunction treeKernelFactory(\n\toptions: SharedTreeOptionsInternal,\n): SharedKernelFactory<SharedTreeKernelView> {\n\tfunction treeFromKernelArgs(args: KernelArgs): SharedTreeKernel {\n\t\tif (args.idCompressor === undefined) {\n\t\t\tthrow new UsageError(\"IdCompressor must be enabled to use SharedTree\");\n\t\t}\n\t\tconst adjustedOptions = { ...options };\n\t\t// TODO: get default from runtime once something like runtime.oldestCompatibleClient exists.\n\t\t// Using default of 2.0 since that is the oldest version that supports SharedTree.\n\t\tadjustedOptions.oldestCompatibleClient ??= FluidClientVersion.v2_0;\n\t\treturn new SharedTreeKernel(\n\t\t\tnew Breakable(\"SharedTree\"),\n\t\t\targs.sharedObject,\n\t\t\targs.serializer,\n\t\t\targs.submitLocalMessage,\n\t\t\targs.lastSequenceNumber,\n\t\t\targs.logger,\n\t\t\targs.idCompressor,\n\t\t\tadjustedOptions,\n\t\t);\n\t}\n\n\treturn {\n\t\tcreate: (args: KernelArgs): FactoryOut<SharedTreeKernelView> => {\n\t\t\tconst k = treeFromKernelArgs(args);\n\t\t\treturn { kernel: k, view: k.view };\n\t\t},\n\n\t\tasync loadCore(\n\t\t\targs: KernelArgs,\n\t\t\tstorage: IChannelStorageService,\n\t\t): Promise<FactoryOut<SharedTreeKernelView>> {\n\t\t\tconst k = treeFromKernelArgs(args);\n\t\t\tawait k.loadCore(storage);\n\t\t\treturn { kernel: k, view: k.view };\n\t\t},\n\t};\n}\n\n/\n SharedTree is a hierarchical data structure for collaboratively editing strongly typed JSON-like trees\n * of objects, arrays, and other data types.\n * @legacy\n * @~~alpha~~\n /\nexport const SharedTree = configuredSharedTree({});\n\n/\n {@link SharedTree} but allowing a non-default configuration.\n * @remarks\n * This is useful for debugging and testing to opt into extra validation or see if opting out of some optimizations fixes an issue.\n * @example\n * ```typescript\n * import {\n * \tForestType,\n * \tTreeCompressionStrategy,\n * \tconfiguredSharedTree,\n * \ttypeboxValidator,\n * } from \"@fluidframework/tree/internal\";\n * const SharedTree = configuredSharedTree({\n * \tforest: ForestTypeReference,\n * \tjsonValidator: typeboxValidator,\n * \ttreeEncodeType: TreeCompressionStrategy.Uncompressed,\n * });\n * ```\n * @privateRemarks\n * This should be legacy, but has to be internal due to limitations of API tagging preventing it from being both alpha and alpha+legacy.\n * TODO:\n * Expose Ajv validator for better error message quality somehow.\n * Maybe as part of a test utils or dev-tool package?\n * @internal\n */\nexport function configuredSharedTree(\n\toptions: SharedTreeOptions,\n): ISharedObjectKind<ITree> & SharedObjectKind<ITree> {\n\tconst sharedObjectOptions: SharedObjectOptions<ITree> = {\n\t\ttype: SharedTreeFactoryType,\n\t\tattributes: SharedTreeAttributes,\n\t\ttelemetryContextPrefix: \"fluid_sharedTree_\",\n\t\tfactory: treeKernelFactory(options),\n\t};\n\n\treturn makeSharedObjectKind<ITree>(sharedObjectOptions);\n}\n"]}
1	+ {"version":3,"file":"treeFactory.js","sourceRoot":"","sources":["../src/treeFactory.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH,0EAQqD;AACrD,uEAAsE;AAEtE,qDAMgC;AAChC,uEAAwF;AAExF,8CAA4C;AAC5C,+CAAsD;AAStD;;;;;GAKG;AACH,SAAS,iBAAiB,CACzB,OAAkC;IAElC,SAAS,kBAAkB,CAAC,IAAgB;QAC3C,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACrC,MAAM,IAAI,qBAAU,CAAC,gDAAgD,CAAC,CAAC;QACxE,CAAC;QACD,MAAM,eAAe,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QACvC,4FAA4F;QAC5F,kFAAkF;QAClF,eAAe,CAAC,sBAAsB,KAAK,6BAAkB,CAAC,IAAI,CAAC;QACnE,OAAO,IAAI,2BAAgB,CAC1B,IAAI,oBAAS,CAAC,YAAY,CAAC,EAC3B,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,kBAAkB,EACvB,IAAI,CAAC,kBAAkB,EACvB,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,YAAY,EACjB,eAAe,CACf,CAAC;IACH,CAAC;IAED,OAAO;QACN,MAAM,EAAE,CAAC,IAAgB,EAAoC,EAAE;YAC9D,MAAM,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACnC,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,QAAQ,CACb,IAAgB,EAChB,OAA+B;YAE/B,MAAM,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC1B,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;KACD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACU,QAAA,UAAU,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,oBAAoB,CACnC,OAA0B;IAE1B,MAAM,mBAAmB,GAA+B;QACvD,IAAI,EAAE,+CAAqB;QAC3B,UAAU,EAAE,8CAAoB;QAChC,sBAAsB,EAAE,mBAAmB;QAC3C,OAAO,EAAE,iBAAiB,CAAC,OAAO,CAAC;KACnC,CAAC;IAEF,OAAO,IAAA,+BAAoB,EAAQ,mBAAmB,CAAC,CAAC;AACzD,CAAC;AAXD,oDAWC","sourcesContent":["/!\n Copyright (c) Microsoft Corporation and contributors. All rights reserved.\n * Licensed under the MIT License.\n /\n\nimport type { IChannelStorageService } from \"@fluidframework/datastore-definitions/internal\";\nimport type { SharedObjectKind } from \"@fluidframework/shared-object-base\";\nimport {\n\ttype ISharedObject,\n\ttype ISharedObjectKind,\n\tmakeSharedObjectKind,\n\ttype KernelArgs,\n\ttype SharedKernelFactory,\n\ttype SharedObjectOptions,\n\ttype FactoryOut,\n} from \"@fluidframework/shared-object-base/internal\";\nimport { UsageError } from \"@fluidframework/telemetry-utils/internal\";\n\nimport {\n\tSharedTreeKernel,\n\ttype ITreePrivate,\n\ttype SharedTreeOptions,\n\ttype SharedTreeOptionsInternal,\n\ttype SharedTreeKernelView,\n} from \"./shared-tree/index.js\";\nimport { SharedTreeFactoryType, SharedTreeAttributes } from \"./sharedTreeAttributes.js\";\nimport type { ITree } from \"./simple-tree/index.js\";\nimport { Breakable } from \"./util/index.js\";\nimport { FluidClientVersion } from \"./codec/index.js\";\n\n/\n {@link ITreePrivate} extended with ISharedObject.\n * @remarks\n * This is used when integration testing this package with the Fluid runtime as it exposes the APIs the runtime consumes to manipulate the tree.\n /\nexport interface ISharedTree extends ISharedObject, ITreePrivate {}\n\n/\n Creates a factory for shared tree kernels with the given options.\n * @remarks\n * Exposes {@link ITreePrivate} to allow access to internals in tests without a cast.\n * Code exposing this beyond this package will need to update to a more public type.\n /\nfunction treeKernelFactory(\n\toptions: SharedTreeOptionsInternal,\n): SharedKernelFactory<SharedTreeKernelView> {\n\tfunction treeFromKernelArgs(args: KernelArgs): SharedTreeKernel {\n\t\tif (args.idCompressor === undefined) {\n\t\t\tthrow new UsageError(\"IdCompressor must be enabled to use SharedTree\");\n\t\t}\n\t\tconst adjustedOptions = { ...options };\n\t\t// TODO: get default from runtime once something like runtime.oldestCompatibleClient exists.\n\t\t// Using default of 2.0 since that is the oldest version that supports SharedTree.\n\t\tadjustedOptions.oldestCompatibleClient ??= FluidClientVersion.v2_0;\n\t\treturn new SharedTreeKernel(\n\t\t\tnew Breakable(\"SharedTree\"),\n\t\t\targs.sharedObject,\n\t\t\targs.serializer,\n\t\t\targs.submitLocalMessage,\n\t\t\targs.lastSequenceNumber,\n\t\t\targs.logger,\n\t\t\targs.idCompressor,\n\t\t\tadjustedOptions,\n\t\t);\n\t}\n\n\treturn {\n\t\tcreate: (args: KernelArgs): FactoryOut<SharedTreeKernelView> => {\n\t\t\tconst k = treeFromKernelArgs(args);\n\t\t\treturn { kernel: k, view: k.view };\n\t\t},\n\n\t\tasync loadCore(\n\t\t\targs: KernelArgs,\n\t\t\tstorage: IChannelStorageService,\n\t\t): Promise<FactoryOut<SharedTreeKernelView>> {\n\t\t\tconst k = treeFromKernelArgs(args);\n\t\t\tawait k.loadCore(storage);\n\t\t\treturn { kernel: k, view: k.view };\n\t\t},\n\t};\n}\n\n/\n SharedTree is a hierarchical data structure for collaboratively editing strongly typed JSON-like trees\n * of objects, arrays, and other data types.\n * @legacy @beta\n /\nexport const SharedTree = configuredSharedTree({});\n\n/\n {@link SharedTree} but allowing a non-default configuration.\n * @remarks\n * This is useful for debugging and testing to opt into extra validation or see if opting out of some optimizations fixes an issue.\n * @example\n * ```typescript\n * import {\n * \tForestType,\n * \tTreeCompressionStrategy,\n * \tconfiguredSharedTree,\n * \ttypeboxValidator,\n * } from \"@fluidframework/tree/internal\";\n * const SharedTree = configuredSharedTree({\n * \tforest: ForestTypeReference,\n * \tjsonValidator: typeboxValidator,\n * \ttreeEncodeType: TreeCompressionStrategy.Uncompressed,\n * });\n * ```\n * @privateRemarks\n * This should be legacy, but has to be internal due to limitations of API tagging preventing it from being both alpha and alpha+legacy.\n * TODO:\n * Expose Ajv validator for better error message quality somehow.\n * Maybe as part of a test utils or dev-tool package?\n * @internal\n */\nexport function configuredSharedTree(\n\toptions: SharedTreeOptions,\n): ISharedObjectKind<ITree> & SharedObjectKind<ITree> {\n\tconst sharedObjectOptions: SharedObjectOptions<ITree> = {\n\t\ttype: SharedTreeFactoryType,\n\t\tattributes: SharedTreeAttributes,\n\t\ttelemetryContextPrefix: \"fluid_sharedTree_\",\n\t\tfactory: treeKernelFactory(options),\n\t};\n\n\treturn makeSharedObjectKind<ITree>(sharedObjectOptions);\n}\n"]}

package/lib/alpha.d.ts CHANGED Viewed

@@ -89,8 +89,11 @@ export {
 	typeSchemaSymbol,
 	// @beta APIs
+	ForestOptions,
+	ForestType,
 	NodeChangedData,
 	PopUnion,
+	SchemaFactoryBeta,
 	TreeBeta,
 	TreeChangeEventsBeta,
 	UnionToTuple,
@@ -117,11 +120,12 @@ export {
 	FieldSchemaAlphaUnsafe,
 	FixRecursiveArraySchema,
 	FluidClientVersion,
-	ForestOptions,
-	ForestType,
 	ForestTypeExpensiveDebug,
 	ForestTypeOptimized,
 	ForestTypeReference,
+	FormatValidator,
+	FormatValidatorBasic,
+	FormatValidatorNoOp,
 	HandleConverter,
 	ICodecOptions,
 	ITreeAlpha,
@@ -153,6 +157,7 @@ export {
 	JsonStringKeyPatternProperties,
 	JsonTreeSchema,
 	JsonValidator,
+	KeyEncodingOptions,
 	MapNodeCustomizableSchema,
 	MapNodeCustomizableSchemaUnsafe,
 	MapNodePojoEmulationSchema,
@@ -205,6 +210,7 @@ export {
 	TreeIndex,
 	TreeIndexKey,
 	TreeIndexNodes,
+	TreeParsingOptions,
 	TreeRecordNode,
 	TreeRecordNodeUnsafe,
 	TreeSchema,

package/lib/beta.d.ts CHANGED Viewed

@@ -89,8 +89,11 @@ export {
 	typeSchemaSymbol,
 	// @beta APIs
+	ForestOptions,
+	ForestType,
 	NodeChangedData,
 	PopUnion,
+	SchemaFactoryBeta,
 	TreeBeta,
 	TreeChangeEventsBeta,
 	UnionToTuple,

package/lib/codec/codec.d.ts CHANGED Viewed

@@ -2,6 +2,7 @@
  * Copyright (c) Microsoft Corporation and contributors. All rights reserved.
  * Licensed under the MIT License.
  */
+import type { ErasedType } from "@fluidframework/core-interfaces/internal";
 import { IsoBuffer } from "@fluid-internal/client-utils";
 import type { Static, TAnySchema, TSchema } from "@sinclair/typebox";
 import type { ChangeEncodingContext } from "../core/index.js";
@@ -37,6 +38,39 @@ export interface SchemaValidationFunction<Schema extends TSchema> {
      */
     check(data: unknown): data is Static<Schema>;
 }
+/**
+ * A kind of validator for SharedTree's internal data formats.
+ * @remarks
+ * Assuming no data corruption or type confusion, such validation should never fail.
+ * Any client version compatibility issues should instead be detected by the data format versioning which Shared Tree does internally independent of data format validation.
+ * However, persisted data can sometimes be corrupted, bugs can produce invalid data, or users can mix up which data is compatible with which APIs.
+ * In such cases, a format validator can help catch issues.
+ *
+ * Current options are {@link FormatValidatorNoOp} and {@link FormatValidatorBasic}.
+ * @privateRemarks
+ * Implement using {@link toFormatValidator}.
+ * Consume using {@link extractJsonValidator}.
+ *
+ * Exposing this as the stable API entry point (instead of {@link JsonValidator}) means that we avoid leaking the reference to TypeBox to the API surface.
+ * Additionally, if we adopt non JSON formats, we can just update the validators as needed without breaking the API.
+ * This also allows us to avoid stabilizing or documenting how handles interact with JSON validation since that is not exposed through this type.
+ * @sealed @alpha
+ */
+export interface FormatValidator extends ErasedType<"FormatValidator"> {
+}
+/**
+ * A {@link FormatValidator} which does no validation.
+ * @alpha
+ */
+export declare const FormatValidatorNoOp: FormatValidator;
+/**
+ * Type erase a {@link JsonValidator} to a {@link FormatValidator}.
+ */
+export declare function toFormatValidator(factory: JsonValidator): FormatValidator;
+/**
+ * Un-type-erase the {@link FormatValidator}.
+ */
+export declare function extractJsonValidator(input: FormatValidator | JsonValidator): JsonValidator;
 /**
  * JSON schema validator compliant with draft 6 schema. See https://json-schema.org.
  * @alpha @input
@@ -61,19 +95,22 @@ export interface JsonValidator {
  */
 export interface ICodecOptions {
     /**
-     * {@link JsonValidator} which SharedTree uses to validate persisted data it reads & writes
+     * {@link FormatValidator} which SharedTree uses to validate persisted data it reads & writes
      * matches the expected encoded format (i.e. the wire format for ops and summaries).
-     *
-     * See {@link noopValidator} and {@link typeboxValidator} for out-of-the-box implementations.
+     * @remarks
+     * See {@link FormatValidatorNoOp} and {@link FormatValidatorBasic} for out-of-the-box implementations.
      *
      * This option is not "on-by-default" because JSON schema validation comes with a small but noticeable
      * runtime performance cost, and popular schema validation libraries have relatively large bundle size.
      *
-     * SharedTree users are still encouraged to use a non-trivial validator (i.e. not `noopValidator`)
+     * SharedTree users are still encouraged to use a non-trivial validator (i.e. not `FormatValidatorNoOp`)
      * whenever reasonable: it gives better fail-fast behavior when unexpected encoded data is found,
      * which reduces the risk of unrecoverable data corruption.
+     *
+     * Use of {@link JsonValidator} here is deprecated and will be removed:
+     * it is recommended to use {@link FormatValidator} instead.
      */
-    readonly jsonValidator: JsonValidator;
+    readonly jsonValidator: JsonValidator | FormatValidator;
 }
 /**
  * Options relating to encoding of persisted data.
@@ -199,7 +236,7 @@ export declare const unitCodec: IMultiFormatCodec<0, JsonCompatibleReadOnly, Jso
  * Wraps a codec with JSON schema validation for its encoded type.
  * @returns An {@link IJsonCodec} which validates the data it encodes and decodes matches the provided schema.
  */
-export declare function withSchemaValidation<TInMemoryFormat, EncodedSchema extends TSchema, TEncodedFormat = JsonCompatibleReadOnly, TValidate = TEncodedFormat, TContext = ChangeEncodingContext>(schema: EncodedSchema, codec: IJsonCodec<TInMemoryFormat, TEncodedFormat, TValidate, TContext>, validator?: JsonValidator): IJsonCodec<TInMemoryFormat, TEncodedFormat, TValidate, TContext>;
+export declare function withSchemaValidation<TInMemoryFormat, EncodedSchema extends TSchema, TEncodedFormat = JsonCompatibleReadOnly, TValidate = TEncodedFormat, TContext = ChangeEncodingContext>(schema: EncodedSchema, codec: IJsonCodec<TInMemoryFormat, TEncodedFormat, TValidate, TContext>, validator?: JsonValidator | FormatValidator): IJsonCodec<TInMemoryFormat, TEncodedFormat, TValidate, TContext>;
 /**
  * Versions of Fluid Framework client packages.
  * @remarks