@fluidframework/tree 2.81.0 → 2.82.0

package/dist/tableSchema.js.map

@@ -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\n/* eslint-disable @typescript-eslint/no-unsafe-member-access -- This file uses intentional `as any` casts to access hidden internal properties (cells, tableSchemaSymbol) */\n\nimport { fail } from \"@fluidframework/core-utils/internal\";\nimport { UsageError } from \"@fluidframework/telemetry-utils/internal\";\n\nimport { EmptyKey } from \"./core/index.js\";\nimport { TreeAlpha } from \"./shared-tree/index.js\";\nimport {\n\ttype FieldHasDefault,\n\ttype ImplicitAllowedTypes,\n\ttype InsertableObjectFromSchemaRecord,\n\ttype InsertableTreeNodeFromImplicitAllowedTypes,\n\ttype NodeKind,\n\tSchemaFactoryBeta,\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\tscoped,\n\ttype ImplicitFieldSchema,\n\twithBufferedTreeEvents,\n\ttype TreeRecordNode,\n\tobjectSchema,\n\teraseSchemaDetailsSubclassable,\n\t// eslint-disable-next-line @typescript-eslint/no-unused-vars, unused-imports/no-unused-imports -- This makes the API report slightly cleaner.\n\tTreeNodeSchemaCore,\n} from \"./simple-tree/index.js\";\nimport { validateIndex, validateIndexRange } from \"./util/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 * Scope for table schema built-in types.\n * @remarks User-provided factory scoping will be applied as `com.fluidframework.table<user-scope>`.\n */\nconst baseSchemaScope = \"com.fluidframework.table\";\n\n/**\n * A private symbol put on table schema to help identify them.\n */\nconst tableSchemaSymbol: unique symbol = Symbol(\"tableNode\");\n\n/**\n * A row in a table.\n * @typeParam TCellSchema - The type of the cells in the {@link TableSchema.Table}.\n * @typeParam TPropsSchema - Additional properties to associate with the row.\n * @privateRemarks Private counterpart to the {@link TableSchema.Row}.\n * Exposes internal properties needed for table operations (publicly exposed via {@link TableSchema.Table}).\n * @sealed\n */\nexport interface RowPrivate<\n\tTCellSchema extends ImplicitAllowedTypes,\n\tTPropsSchema extends ImplicitFieldSchema = ImplicitFieldSchema,\n> extends TableSchema.Row<TCellSchema, TPropsSchema> {\n\t/**\n\t * The row's cells.\n\t * @remarks This is a user-defined schema that can be used to store additional information about the row.\n\t * @privateRemarks\n\t * Note: these docs are duplicated on the inline type definitions in {@link System_TableSchema.createRowSchema}.\n\t * If you update the docs here, please also update the inline type definitions.\n\t */\n\treadonly cells: TreeRecordNode<TCellSchema>;\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 * A list of items in a table whose elements may be rearranged, but not inserted or removed.\n\t *\n\t * @privateRemarks Used by {@link TableSchema.Table} for its `rows` and `columns` properties to allow basic rearrangement operations on the underlying sequences without permitting mutation operations that might violate table invariants.\n\t *\n\t * Note: this can't reasonably be implemented via `Pick<ArrayNode<...>>` because we only want to include the\n\t * subset of its method overloads which do not support moving items between lists.\n\t *\n\t * @alpha @system\n\t */\n\texport type RearrangeableList<TItemSchema extends ImplicitAllowedTypes> = TreeNode &\n\t\treadonly TreeNodeFromImplicitAllowedTypes<TItemSchema>[] & {\n\t\t\t// #region Capture the subset of item rearrangement methods from `TreeArrayNode` that do not allow moving between lists.\n\n\t\t\t/** {@inheritDoc (TreeArrayNode:interface).(moveToEnd:1)} */\n\t\t\tmoveToEnd(sourceIndex: number): void;\n\t\t\t/** {@inheritDoc (TreeArrayNode:interface).(moveToStart:1)} */\n\t\t\tmoveToStart(sourceIndex: number): void;\n\t\t\t/** {@inheritDoc (TreeArrayNode:interface).(moveToIndex:1)} */\n\t\t\tmoveToIndex(sourceIndex: number, destinationIndex: number): void;\n\t\t\t/** {@inheritDoc (TreeArrayNode:interface).(moveRangeToEnd:1)} */\n\t\t\tmoveRangeToEnd(startIndex: number, endIndex: number): void;\n\t\t\t/** {@inheritDoc (TreeArrayNode:interface).(moveRangeToStart:1)} */\n\t\t\tmoveRangeToStart(startIndex: number, endIndex: number): void;\n\t\t\t/** {@inheritDoc (TreeArrayNode:interface).(moveRangeToIndex:1)} */\n\t\t\tmoveRangeToIndex(startIndex: number, endIndex: number, destinationIndex: number): void;\n\n\t\t\t// #endregion\n\t\t};\n\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 SchemaFactoryBeta> {\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 * The resulting schema will have an identifier of the form: `com.fluidframework.table<${TUserScope}>.<Column|Row|Table>`.\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 column schema.\n\t * @remarks Includes parameters common to all column factory overloads.\n\t * @system @alpha\n\t */\n\texport type CreateColumnOptionsBase<\n\t\tTUserScope extends string = string,\n\t\tTSchemaFactory extends SchemaFactoryBeta<TUserScope> = SchemaFactoryBeta<TUserScope>,\n\t\tTCellSchema extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t> = OptionsWithSchemaFactory<TSchemaFactory> & OptionsWithCellSchema<TCellSchema>;\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 TUserScope extends string,\n\t\tconst TCellSchema extends ImplicitAllowedTypes,\n\t\tconst TPropsSchema extends ImplicitFieldSchema,\n\t>(inputSchemaFactory: SchemaFactoryBeta<TUserScope>, propsSchema: TPropsSchema) {\n\t\tconst schemaFactory = createTableScopedFactory(inputSchemaFactory);\n\t\ttype Scope = typeof schemaFactory.scope;\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.object(\"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\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<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<TPropsSchema>;\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<TPropsSchema>;\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\tTUserScope extends string = string,\n\t\tTCellSchema extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t\tTPropsSchema extends ImplicitFieldSchema = ImplicitFieldSchema,\n\t> = ReturnType<typeof createColumnSchema<TUserScope, 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\tTUserScope extends string = string,\n\t\tTSchemaFactory extends SchemaFactoryBeta<TUserScope> = SchemaFactoryBeta<TUserScope>,\n\t\tTCellSchema extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t> = OptionsWithSchemaFactory<TSchemaFactory> & OptionsWithCellSchema<TCellSchema>;\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 TUserScope extends string,\n\t\tconst TCellSchema extends ImplicitAllowedTypes,\n\t\tconst TPropsSchema extends ImplicitFieldSchema,\n\t>(\n\t\tinputSchemaFactory: SchemaFactoryBeta<TUserScope>,\n\t\tcellSchema: TCellSchema,\n\t\tpropsSchema: TPropsSchema,\n\t) {\n\t\tconst schemaFactory = createTableScopedFactory(inputSchemaFactory);\n\t\ttype Scope = typeof schemaFactory.scope;\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 RowSchema} 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 RowSchema\n\t\t\textends schemaFactory.object(\"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 RowPrivate<TCellSchema, TPropsSchema> {}\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<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<TPropsSchema>;\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<TPropsSchema>;\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 RowSchema]: (typeof RowSchema)[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) => RowSchema) & {\n\t\t\t\tcreateFromInsertable(parameters: RowInsertableType): RowSchema;\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> = RowSchema 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\tTUserScope extends string = string,\n\t\tTCellSchema extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t\tTPropsSchema extends ImplicitFieldSchema = ImplicitFieldSchema,\n\t> = ReturnType<typeof createRowSchema<TUserScope, 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\tTUserScope extends string = string,\n\t\tTSchemaFactory extends SchemaFactoryBeta<TUserScope> = SchemaFactoryBeta<TUserScope>,\n\t\tTCellSchema extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t> = OptionsWithSchemaFactory<TSchemaFactory> & OptionsWithCellSchema<TCellSchema>;\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 TUserScope extends string,\n\t\tconst TCellSchema extends ImplicitAllowedTypes,\n\t\tconst TColumnSchema extends ColumnSchemaBase<TUserScope, TCellSchema>,\n\t\tconst TRowSchema extends RowSchemaBase<TUserScope, TCellSchema>,\n\t>(\n\t\tinputSchemaFactory: SchemaFactoryBeta<TUserScope>,\n\t\t_cellSchema: TCellSchema,\n\t\tcolumnSchema: TColumnSchema,\n\t\trowSchema: TRowSchema,\n\t) {\n\t\tconst schemaFactory = createTableScopedFactory(inputSchemaFactory);\n\t\ttype Scope = typeof schemaFactory.scope;\n\n\t\ttype CellValueType = TreeNodeFromImplicitAllowedTypes<TCellSchema>;\n\t\ttype ColumnValueType = TreeNodeFromImplicitAllowedTypes<TColumnSchema>;\n\t\ttype ColumnInsertableType = InsertableTreeNodeFromImplicitAllowedTypes<TColumnSchema>;\n\t\ttype RowValueType = TreeNodeFromImplicitAllowedTypes<TRowSchema>;\n\t\ttype RowInsertableType = InsertableTreeNodeFromImplicitAllowedTypes<TRowSchema>;\n\n\t\t// Internal version of RowValueType that exposes the `cells` property for use within Table methods.\n\t\ttype RowValueInternalType = RowValueType & RowPrivate<TCellSchema>;\n\n\t\t/**\n\t\t * {@link Table} inner fields.\n\t\t * @remarks Extracted for re-use as construction parameters.\n\t\t * @see {@link Table.create}.\n\t\t */\n\t\tconst tableInnerFields = {\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, ImplicitFieldSchema>;\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\ttable: schemaFactory.required(schemaFactory.object(\"Table\", tableInnerFields), {\n\t\t\t\t// Use an empty key in the stored schema format to help prevent schema-unaware edits from being\n\t\t\t\t// made to the table, which may violate intended invariants.\n\t\t\t\tkey: EmptyKey,\n\t\t\t}),\n\t\t} as const satisfies Record<string, ImplicitFieldSchema>;\n\n\t\ttype TableValueType = TreeNode &\n\t\t\tTableSchema.Table<TUserScope, TCellSchema, TColumnSchema, TRowSchema> &\n\t\t\tWithType<ScopedSchemaName<Scope, \"TableRoot\">>;\n\t\ttype TableConstructorType = new (data?: InternalTreeNode | undefined) => TableValueType;\n\n\t\t/**\n\t\t * The Table schema\n\t\t */\n\t\tclass Table\n\t\t\t// Calling the objectSchema factory directly rather than using the schemaFactory so we can specify\n\t\t\t// `implicitlyConstructable: false`, which the SchemaFactory APIs do not yet support.\n\t\t\t// TODO: when support for configuring `implicitlyConstructable` is added to SchemaFactory, switch to\n\t\t\t// using that instead.\n\t\t\textends objectSchema(\n\t\t\t\t/* identifier: */ scoped(schemaFactory as SchemaFactory<Scope>, \"TableRoot\"),\n\t\t\t\t/* info: */ tableFields,\n\t\t\t\t/* implicitlyConstructable: */ false,\n\t\t\t\t/* nodeOptions: */ {\n\t\t\t\t\t// Will make it easier to evolve this schema in the future.\n\t\t\t\t\tallowUnknownOptionalFields: true,\n\t\t\t\t},\n\t\t\t)\n\t\t\timplements TableSchema.Table<TUserScope, TCellSchema, TColumnSchema, TRowSchema>\n\t\t{\n\t\t\tpublic constructor(node?: InternalTreeNode | undefined) {\n\t\t\t\tsuper(node ?? { table: { columns: [], rows: [] } });\n\t\t\t}\n\n\t\t\tpublic static create<TThis extends TableConstructorType>(\n\t\t\t\tthis: TThis,\n\t\t\t\tinitialContents?:\n\t\t\t\t\t| TableSchema.TableFactoryMethodParameters<\n\t\t\t\t\t\t\tTUserScope,\n\t\t\t\t\t\t\tTCellSchema,\n\t\t\t\t\t\t\tTColumnSchema,\n\t\t\t\t\t\t\tTRowSchema\n\t\t\t\t\t  >\n\t\t\t\t\t| undefined,\n\t\t\t): InstanceType<TThis> {\n\t\t\t\t// #region Input validation\n\n\t\t\t\tconst columns =\n\t\t\t\t\t(initialContents?.columns as Iterable<ColumnInsertableType> | undefined) ?? [];\n\n\t\t\t\tconst columnIds = new Set<string>();\n\t\t\t\tfor (const column of columns) {\n\t\t\t\t\tcolumnIds.add((column as ColumnValueType).id);\n\t\t\t\t}\n\n\t\t\t\tconst rows = (initialContents?.rows as Iterable<RowInsertableType> | undefined) ?? [];\n\n\t\t\t\tTable._validateNewColumns(\n\t\t\t\t\tcolumns,\n\t\t\t\t\t// New table, so no existing columns to validate against\n\t\t\t\t\tnew Set(),\n\t\t\t\t);\n\n\t\t\t\tTable._validateNewRows(\n\t\t\t\t\trows,\n\t\t\t\t\t// New table, so no existing rows to validate against\n\t\t\t\t\tnew Set(),\n\t\t\t\t\t// No existing columns to validate cells against, but we do need to validate the new rows against the new columns\n\t\t\t\t\tcolumnIds,\n\t\t\t\t);\n\n\t\t\t\t// #endregion\n\t\t\t\treturn new this(\n\t\t\t\t\tinitialContents === undefined\n\t\t\t\t\t\t? undefined\n\t\t\t\t\t\t: ({\n\t\t\t\t\t\t\t\ttable: initialContents,\n\t\t\t\t\t\t\t\t// We have typed our constructor to prevent users from calling it directly with insertable contents.\n\t\t\t\t\t\t\t\t// But the base constructor still allows it. Cast to work around this.\n\t\t\t\t\t\t\t} as unknown as InternalTreeNode),\n\t\t\t\t) as InstanceType<TThis>;\n\t\t\t}\n\n\t\t\tpublic get columns(): RearrangeableList<TColumnSchema> {\n\t\t\t\treturn this.table.columns as RearrangeableList<TColumnSchema>;\n\t\t\t}\n\n\t\t\tpublic get rows(): RearrangeableList<TRowSchema> {\n\t\t\t\treturn this.table.rows as RearrangeableList<TRowSchema>;\n\t\t\t}\n\n\t\t\tpublic getColumn(indexOrId: number | string): ColumnValueType | undefined {\n\t\t\t\treturn this.#tryGetColumn(indexOrId);\n\t\t\t}\n\n\t\t\tpublic getRow(indexOrId: number | string): RowValueType | undefined {\n\t\t\t\treturn this.#tryGetRow(indexOrId);\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: columnOrIdOrIndex, row: rowOrIdOrIndex } = key;\n\t\t\t\tconst row = this.#tryGetRow(rowOrIdOrIndex);\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(columnOrIdOrIndex);\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 as RowValueInternalType).cells[column.id];\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// #region Input validation\n\n\t\t\t\t// Ensure specified index is valid\n\t\t\t\tif (index !== undefined) {\n\t\t\t\t\tvalidateIndex(index, this.table.columns, \"Table.insertColumns\", true);\n\t\t\t\t}\n\n\t\t\t\t// Ensure the new columns being inserted are valid\n\t\t\t\tthis.#validateNewColumns(columns);\n\n\t\t\t\t// #endregion\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.table.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.table.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 specified index is valid\n\t\t\t\tif (index !== undefined) {\n\t\t\t\t\tvalidateIndex(index, this.table.rows, \"Table.insertRows\", true);\n\t\t\t\t}\n\n\t\t\t\t// Ensure the new rows being inserted are valid\n\t\t\t\tthis.#validateNewRows(rows);\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.table.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.table.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\t(row as RowValueInternalType).cells[column.id] = cell as CellValueType;\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 endIndex =\n\t\t\t\t\t\tcount === undefined ? this.table.columns.length : startIndex + count;\n\n\t\t\t\t\t// If there are no columns to remove, do nothing\n\t\t\t\t\tif (startIndex === endIndex) {\n\t\t\t\t\t\treturn [];\n\t\t\t\t\t}\n\n\t\t\t\t\tvalidateIndexRange(startIndex, endIndex, this.table.columns, \"Table.removeColumns\");\n\n\t\t\t\t\tthis.#applyEditsInBatch(() => {\n\t\t\t\t\t\tconst columnsToRemove = this.table.columns.slice(\n\t\t\t\t\t\t\tstartIndex,\n\t\t\t\t\t\t\tendIndex,\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\tremoveRangeFromArray(\n\t\t\t\t\t\t\tstartIndex,\n\t\t\t\t\t\t\tendIndex,\n\t\t\t\t\t\t\tthis.table.columns,\n\t\t\t\t\t\t\t\"Table.removeColumns\",\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.table.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\tthis.removeCell({\n\t\t\t\t\t\t\t\t\tcolumn: columnToRemove,\n\t\t\t\t\t\t\t\t\trow: row as RowValueType,\n\t\t\t\t\t\t\t\t});\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.table.columns.removeAt(this.table.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 endIndex = count === undefined ? this.table.rows.length : startIndex + count;\n\n\t\t\t\t\t// If there are no rows to remove, do nothing\n\t\t\t\t\tif (startIndex === endIndex) {\n\t\t\t\t\t\treturn [];\n\t\t\t\t\t}\n\n\t\t\t\t\treturn removeRangeFromArray(\n\t\t\t\t\t\tstartIndex,\n\t\t\t\t\t\tendIndex,\n\t\t\t\t\t\tthis.table.rows,\n\t\t\t\t\t\t\"Table.removeRows\",\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\tconst index = this.table.rows.indexOf(rowToRemove);\n\t\t\t\t\t\tthis.table.rows.removeAt(index);\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: columnOrIdOrIndex, row: rowOrIdOrIndex } = key;\n\t\t\t\tconst row = this.#getRow(rowOrIdOrIndex) as RowValueInternalType;\n\t\t\t\tconst column = this.#getColumn(columnOrIdOrIndex);\n\n\t\t\t\tconst cell: CellValueType | undefined = row.cells[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\t// eslint-disable-next-line @typescript-eslint/no-dynamic-delete\n\t\t\t\tdelete row.cells[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\t#removeCells(column: ColumnValueType): void {\n\t\t\t\tfor (const row of this.table.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\tthis.removeCell({\n\t\t\t\t\t\tcolumn,\n\t\t\t\t\t\trow: row as RowValueType,\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\t#applyEditsInBatch(applyEdits: () => void): void {\n\t\t\t\tconst branch = TreeAlpha.branch(this);\n\n\t\t\t\t// Ensure events are paused until all of the edits are applied.\n\t\t\t\t// This ensures that the user sees the corresponding table-level edit as atomic,\n\t\t\t\t// and ensures they are not spammed with intermediate events.\n\t\t\t\twithBufferedTreeEvents(() => {\n\t\t\t\t\tif (branch === undefined) {\n\t\t\t\t\t\t// If this node does not have a corresponding branch, then it is unhydrated.\n\t\t\t\t\t\t// I.e., it is not part of a collaborative session yet.\n\t\t\t\t\t\t// Therefore, we don't need to run the edits as a transaction.\n\t\t\t\t\t\tapplyEdits();\n\t\t\t\t\t} else {\n\t\t\t\t\t\tbranch.runTransaction(() => {\n\t\t\t\t\t\t\tapplyEdits();\n\t\t\t\t\t\t});\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\t#tryGetColumn(\n\t\t\t\tcolumnOrIdOrIndex: ColumnValueType | string | number,\n\t\t\t): ColumnValueType | undefined {\n\t\t\t\tif (typeof columnOrIdOrIndex === \"number\") {\n\t\t\t\t\tif (columnOrIdOrIndex < 0 || columnOrIdOrIndex >= this.table.columns.length) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\t// TypeScript is unable to narrow the types correctly here, hence the cast.\n\t\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\t\treturn this.table.columns[columnOrIdOrIndex] as ColumnValueType;\n\t\t\t\t}\n\n\t\t\t\tif (typeof columnOrIdOrIndex === \"string\") {\n\t\t\t\t\tconst columnId = columnOrIdOrIndex;\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\treturn this.table.columns.find((col) => (col as ColumnValueType).id === columnId) as\n\t\t\t\t\t\t| ColumnValueType\n\t\t\t\t\t\t| undefined;\n\t\t\t\t}\n\n\t\t\t\t// If the user provided a node, ensure it actually exists in this table.\n\t\t\t\tif (!this.table.columns.includes(columnOrIdOrIndex)) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\n\t\t\t\treturn columnOrIdOrIndex;\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\t#getColumn(columnOrIdOrIndex: ColumnValueType | string | number): ColumnValueType {\n\t\t\t\tconst column = this.#tryGetColumn(columnOrIdOrIndex);\n\t\t\t\tif (column === undefined) {\n\t\t\t\t\tTable._throwMissingColumnError(columnOrIdOrIndex);\n\t\t\t\t}\n\t\t\t\treturn column;\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Throw a `UsageError` for a missing Column by its ID or index.\n\t\t\t */\n\t\t\tprivate static _throwMissingColumnError(\n\t\t\t\tcolumnOrIdOrIndex: ColumnValueType | string | number,\n\t\t\t): never {\n\t\t\t\tif (typeof columnOrIdOrIndex === \"number\") {\n\t\t\t\t\tthrow new UsageError(`No column exists at index ${columnOrIdOrIndex}.`);\n\t\t\t\t}\n\n\t\t\t\tif (typeof columnOrIdOrIndex === \"string\") {\n\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t`No column with ID \"${columnOrIdOrIndex}\" exists in the table.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\tthrow new UsageError(\n\t\t\t\t\t`The specified column node with ID \"${columnOrIdOrIndex.id}\" does not exist in the table.`,\n\t\t\t\t);\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\t#tryGetRow(rowOrIdOrIndex: RowValueType | string | number): RowValueType | undefined {\n\t\t\t\tif (typeof rowOrIdOrIndex === \"number\") {\n\t\t\t\t\tif (rowOrIdOrIndex < 0 || rowOrIdOrIndex >= this.table.rows.length) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\t// TypeScript is unable to narrow the types correctly here, hence the cast.\n\t\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\t\treturn this.table.rows[rowOrIdOrIndex] as RowValueType;\n\t\t\t\t}\n\n\t\t\t\tif (typeof rowOrIdOrIndex === \"string\") {\n\t\t\t\t\tconst rowId = rowOrIdOrIndex;\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\treturn this.table.rows.find((row) => (row as RowValueType).id === rowId) as\n\t\t\t\t\t\t| RowValueType\n\t\t\t\t\t\t| undefined;\n\t\t\t\t}\n\n\t\t\t\t// If the user provided a node, ensure it actually exists in this table.\n\t\t\t\tif (!this.table.rows.includes(rowOrIdOrIndex)) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\n\t\t\t\treturn rowOrIdOrIndex;\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Attempts to resolve the provided Row node, ID, or index 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\t#getRow(rowOrIdOrIndex: RowValueType | string | number): RowValueType {\n\t\t\t\tconst row = this.#tryGetRow(rowOrIdOrIndex);\n\t\t\t\tif (row === undefined) {\n\t\t\t\t\tTable._throwMissingRowError(rowOrIdOrIndex);\n\t\t\t\t}\n\t\t\t\treturn row;\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Validates the provided list of new columns being inserted into the table.\n\t\t\t * @throws Throws a `UsageError` if any of the following conditions are met:\n\t\t\t * - A column with a duplicate ID is being inserted.\n\t\t\t */\n\t\t\t#validateNewColumns(newColumns: readonly ColumnInsertableType[]): void {\n\t\t\t\treturn Table._validateNewColumns(\n\t\t\t\t\tnewColumns,\n\t\t\t\t\tnew Set(this.table.columns.map((column) => (column as ColumnValueType).id)),\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Validates the provided list of new rows being inserted into the table.\n\t\t\t * @throws Throws a `UsageError` if any of the following conditions are met:\n\t\t\t * - A row with a duplicate ID is being inserted.\n\t\t\t * - A row is being inserted that contains cells for columns that do not exist in the table.\n\t\t\t */\n\t\t\t#validateNewRows(newRows: readonly RowInsertableType[]): void {\n\t\t\t\treturn Table._validateNewRows(\n\t\t\t\t\tnewRows,\n\t\t\t\t\tnew Set(this.table.rows.map((row) => (row as RowValueType).id)),\n\t\t\t\t\tnew Set(this.table.columns.map((column) => (column as ColumnValueType).id)),\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Validates the provided list of new columns being inserted into the table.\n\t\t\t * @throws Throws a `UsageError` if any of the following conditions are met:\n\t\t\t * - A column with a duplicate ID is being inserted.\n\t\t\t */\n\t\t\tprivate static _validateNewColumns(\n\t\t\t\tnewColumns: Iterable<ColumnInsertableType>,\n\t\t\t\texistingColumnIds: Set<string>,\n\t\t\t): void {\n\t\t\t\tconst newColumnIds = new Set<string>();\n\t\t\t\tfor (const newColumn of newColumns) {\n\t\t\t\t\t// #region Ensure each column ID is unique\n\t\t\t\t\tconst newColumnId = (newColumn as ColumnValueType).id;\n\t\t\t\t\tif (existingColumnIds.has(newColumnId)) {\n\t\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t\t`Attempted to insert a column with ID \"${newColumnId}\", but a column with that ID already exists in the table.`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tif (newColumnIds.has(newColumnId)) {\n\t\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t\t`Attempted to insert multiple columns with ID \"${newColumnId}\". Column IDs must be unique.`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tnewColumnIds.add(newColumnId);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Validates the provided list of new rows being inserted into the table.\n\t\t\t * @throws Throws a `UsageError` if any of the following conditions are met:\n\t\t\t * - A row with a duplicate ID is being inserted.\n\t\t\t * - A row is being inserted that contains cells for columns that do not exist in the table.\n\t\t\t */\n\t\t\tprivate static _validateNewRows(\n\t\t\t\tnewRows: Iterable<RowInsertableType>,\n\t\t\t\texistingRowIds: Set<string>,\n\t\t\t\tcolumnIds: Set<string>,\n\t\t\t): void {\n\t\t\t\tconst newRowIds = new Set<string>();\n\t\t\t\tfor (const newRow of newRows) {\n\t\t\t\t\t// #region Ensure each row ID is unique\n\n\t\t\t\t\tconst newRowId = (newRow as RowValueType).id;\n\t\t\t\t\tif (existingRowIds.has(newRowId)) {\n\t\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t\t`Attempted to insert a row with ID \"${newRowId}\", but a row with that ID already exists in the table.`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tif (newRowIds.has(newRowId)) {\n\t\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t\t`Attempted to insert multiple rows with ID \"${newRowId}\". Row IDs must be unique.`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tnewRowIds.add(newRowId);\n\n\t\t\t\t\t// #endregion\n\n\t\t\t\t\t// #region If the row contains cells, verify that the table contains the columns for those cells\n\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 (!columnIds.has(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 a row containing 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\n\t\t\t\t\t// #endregion\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Throw a `UsageError` for a missing Row by its ID or index.\n\t\t\t */\n\t\t\tprivate static _throwMissingRowError(\n\t\t\t\trowOrIdOrIndex: RowValueType | string | number,\n\t\t\t): never {\n\t\t\t\tif (typeof rowOrIdOrIndex === \"number\") {\n\t\t\t\t\tthrow new UsageError(`No row exists at index ${rowOrIdOrIndex}.`);\n\t\t\t\t}\n\n\t\t\t\tif (typeof rowOrIdOrIndex === \"string\") {\n\t\t\t\t\tthrow new UsageError(`No row with ID \"${rowOrIdOrIndex}\" exists in the table.`);\n\t\t\t\t}\n\n\t\t\t\tthrow new UsageError(\n\t\t\t\t\t`The specified row node with ID \"${rowOrIdOrIndex.id}\" does not exist in the table.`,\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\t// Named interfaces here do not compile.\n\t\ttype Statics = {\n\t\t\t/**\n\t\t\t * Create a table with initial contents.\n\t\t\t * @param initialContents - The initial contents of the table.\n\t\t\t * If not provided, an empty table will be constructed.\n\t\t\t * @remarks Performs the following input validation:\n\t\t\t * - Ensures that any cells specified in the initial rows correspond to existing columns in the initial columns.\n\t\t\t * - Ensures that all column and row IDs are unique.\n\t\t\t */\n\t\t\tcreate<TThis extends TableConstructorType>(\n\t\t\t\tthis: TThis,\n\t\t\t\tinitialContents?:\n\t\t\t\t\t| TableSchema.TableFactoryMethodParameters<\n\t\t\t\t\t\t\tTUserScope,\n\t\t\t\t\t\t\tTCellSchema,\n\t\t\t\t\t\t\tTColumnSchema,\n\t\t\t\t\t\t\tTRowSchema\n\t\t\t\t\t  >\n\t\t\t\t\t| undefined,\n\t\t\t): InstanceType<TThis>;\n\t\t} & TableConstructorType;\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 eraseSubclassableSchemaDetails to erase internal details.\n\t\tconst TableSchemaType = eraseSchemaDetailsSubclassable<TableValueType, Statics>()(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\tTUserScope extends string,\n\t\tTCellSchema extends ImplicitAllowedTypes,\n\t\tTColumnSchema extends ColumnSchemaBase<TUserScope, TCellSchema>,\n\t\tTRowSchema extends RowSchemaBase<TUserScope, TCellSchema>,\n\t> = ReturnType<typeof createTableSchema<TUserScope, TCellSchema, TColumnSchema, TRowSchema>>;\n\n\t// #endregion\n}\n\nfunction createTableScopedFactory<TUserScope extends string>(\n\tinputSchemaFactory: SchemaFactoryBeta<TUserScope>,\n): SchemaFactoryBeta<`${typeof baseSchemaScope}<${TUserScope}>`> {\n\treturn new SchemaFactoryBeta(`${baseSchemaScope}<${inputSchemaFactory.scope}>`);\n}\n\n/**\n * Removes the specified range of elements from the array.\n * @returns The removed elements.\n */\nfunction removeRangeFromArray<TNodeSchema extends ImplicitAllowedTypes>(\n\tstartIndex: number,\n\tendIndex: number,\n\tarray: TreeArrayNode<TNodeSchema>,\n\tmethodName: string,\n): TreeNodeFromImplicitAllowedTypes<TNodeSchema>[] {\n\tvalidateIndexRange(startIndex, endIndex, array, methodName);\n\n\t// TypeScript is unable to narrow the array element type correctly here, hence the cast.\n\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\tconst removedRows = array.slice(\n\t\tstartIndex,\n\t\tendIndex,\n\t) as TreeNodeFromImplicitAllowedTypes<TNodeSchema>[];\n\tarray.removeRange(startIndex, endIndex);\n\n\treturn removedRows;\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 = MyTable.create({\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\t// eslint-disable-next-line @typescript-eslint/no-unused-vars -- Reserving this for future use.\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTProps extends ImplicitFieldSchema = ImplicitFieldSchema,\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<TProps>;\n\t\tset props(value: InsertableTreeFieldFromImplicitField<TProps>);\n\t}\n\n\t/**\n\t * Factory for creating new table column schema.\n\t * @typeParam TUserScope - 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 TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t>(\n\t\tparams: System_TableSchema.CreateColumnOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t>,\n\t): System_TableSchema.ColumnSchemaBase<\n\t\tTUserScope,\n\t\tTCell,\n\t\tSystem_TableSchema.DefaultPropsType\n\t>;\n\t/**\n\t * Factory for creating new table column schema.\n\t * @typeParam TUserScope - 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 TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TProps extends ImplicitFieldSchema,\n\t>(\n\t\tparams: System_TableSchema.CreateColumnOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t> & {\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<TUserScope, 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?: ImplicitFieldSchema;\n\t}): TreeNodeSchema {\n\t\treturn System_TableSchema.createColumnSchema(schemaFactory, 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\t// eslint-disable-next-line @typescript-eslint/no-unused-vars -- Reserving this for future use.\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTProps extends ImplicitFieldSchema = ImplicitFieldSchema,\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 * 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<TProps>;\n\t\tset props(value: InsertableTreeFieldFromImplicitField<TProps>);\n\t}\n\n\t/**\n\t * Factory for creating new table column schema.\n\t * @typeParam TUserScope - 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 TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t>(\n\t\tparams: System_TableSchema.CreateRowOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t>,\n\t): System_TableSchema.RowSchemaBase<TUserScope, TCell, System_TableSchema.DefaultPropsType>;\n\t/**\n\t * Factory for creating new table row schema.\n\t * @typeParam TUserScope - 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 TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TProps extends ImplicitFieldSchema,\n\t>(\n\t\tparams: System_TableSchema.CreateRowOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t> & {\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<TUserScope, 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?: ImplicitFieldSchema;\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 * @input @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}, {@link TableSchema.Column.id}, or column index at which the cell is located.\n\t\t */\n\t\treadonly column: string | number | TreeNodeFromImplicitAllowedTypes<TColumn>;\n\n\t\t/**\n\t\t * {@link TableSchema.Row}, {@link TableSchema.Row.id}, or row index at which the cell is located.\n\t\t */\n\t\treadonly row: string | number | TreeNodeFromImplicitAllowedTypes<TRow>;\n\t}\n\n\t/**\n\t * {@link TableSchema.Table.insertColumns} parameters.\n\t * @input @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 * @input @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 * @input @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 *\n\t * @remarks Table schema is created via the {@link TableSchema.(table:1)} factory.\n\t * Node instances of the schema type should be constructed via the static `create` method on the schema class.\n\t * E.g. `const table = MyTableSchema.create({ columns, rows});`\n\t *\n\t * @typeParam TUserScope - 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 *\n\t * @sealed @alpha\n\t */\n\texport interface Table<\n\t\tTUserScope extends string,\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTColumn extends System_TableSchema.ColumnSchemaBase<TUserScope, TCell>,\n\t\tTRow extends System_TableSchema.RowSchemaBase<TUserScope, TCell>,\n\t> {\n\t\t/**\n\t\t * The table's columns.\n\t\t */\n\t\treadonly columns: System_TableSchema.RearrangeableList<TColumn>;\n\n\t\t/**\n\t\t * The table's rows.\n\t\t */\n\t\treadonly rows: System_TableSchema.RearrangeableList<TRow>;\n\n\t\t/**\n\t\t * Gets a table column by its {@link TableSchema.Column.id}.\n\t\t * @returns The column, if it exists. Otherwise, `undefined`.\n\t\t */\n\t\tgetColumn(id: string): TreeNodeFromImplicitAllowedTypes<TColumn> | undefined;\n\t\t/**\n\t\t * Gets a table column by its index in the table.\n\t\t * @returns The column, if it exists. Otherwise, `undefined`.\n\t\t */\n\t\tgetColumn(index: number): TreeNodeFromImplicitAllowedTypes<TColumn> | undefined;\n\n\t\t/**\n\t\t * Gets a table row by its {@link TableSchema.Row.id}.\n\t\t * @returns The row, if it exists. Otherwise, `undefined`.\n\t\t */\n\t\tgetRow(id: string): TreeNodeFromImplicitAllowedTypes<TRow> | undefined;\n\t\t/**\n\t\t * Gets a table row by its index in the table.\n\t\t * @returns The row, if it exists. Otherwise, `undefined`.\n\t\t */\n\t\tgetRow(index: number): TreeNodeFromImplicitAllowedTypes<TRow> | undefined;\n\n\t\t/**\n\t\t * Gets a cell in the table by corresponding column and row.\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 * @returns The cell, if it exists. Otherwise, `undefined`.\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 * Input parameters for {@link TableSchema.Table}'s `create` factory method.\n\t * @input @alpha\n\t */\n\texport interface TableFactoryMethodParameters<\n\t\tTUserScope extends string,\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTColumn extends System_TableSchema.ColumnSchemaBase<TUserScope, TCell>,\n\t\tTRow extends System_TableSchema.RowSchemaBase<TUserScope, TCell>,\n\t> {\n\t\t/**\n\t\t * Initial columns for the table.\n\t\t */\n\t\treadonly columns?:\n\t\t\t| Iterable<InsertableTreeNodeFromImplicitAllowedTypes<TColumn>>\n\t\t\t| undefined;\n\n\t\t/**\n\t\t * Initial rows for the table.\n\t\t * @remarks If any cells are specified, they will be validated against the IDs of the provided columns.\n\t\t */\n\t\treadonly rows?: Iterable<InsertableTreeNodeFromImplicitAllowedTypes<TRow>> | undefined;\n\t}\n\n\t/**\n\t * Factory for creating new table schema.\n\t * @typeParam TUserScope - The {@link SchemaFactory.scope | schema factory scope}.\n\t * The resulting schema will have an identifier of the form: `com.fluidframework.table<${TUserScope}>.Table`.\n\t * @typeParam TCell - The type of the cells in the table.\n\t * @alpha\n\t */\n\texport function table<\n\t\tconst TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t>,\n\t): System_TableSchema.TableSchemaBase<\n\t\tTUserScope,\n\t\tTCell,\n\t\tSystem_TableSchema.ColumnSchemaBase<\n\t\t\tTUserScope,\n\t\t\tTCell,\n\t\t\tSystem_TableSchema.DefaultPropsType\n\t\t>,\n\t\tSystem_TableSchema.RowSchemaBase<TUserScope, TCell, System_TableSchema.DefaultPropsType>\n\t>;\n\t/**\n\t * Factory for creating new table schema with custom column schema.\n\t * @typeParam TUserScope - The {@link SchemaFactory.scope | schema factory scope}.\n\t * The resulting schema will have an identifier of the form: `com.fluidframework.table<${TUserScope}>.Table`.\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 TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TColumn extends System_TableSchema.ColumnSchemaBase<TUserScope, TCell>,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t> & {\n\t\t\treadonly column: TColumn;\n\t\t},\n\t): System_TableSchema.TableSchemaBase<\n\t\tTUserScope,\n\t\tTCell,\n\t\tTColumn,\n\t\tSystem_TableSchema.RowSchemaBase<TUserScope, TCell, System_TableSchema.DefaultPropsType>\n\t>;\n\t/**\n\t * Factory for creating new table schema with custom row schema.\n\t * @typeParam TUserScope - The {@link SchemaFactory.scope | schema factory scope}.\n\t * The resulting schema will have an identifier of the form: `com.fluidframework.table<${TUserScope}>.Table`.\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 TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TRow extends System_TableSchema.RowSchemaBase<TUserScope, TCell>,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t> & {\n\t\t\treadonly row: TRow;\n\t\t},\n\t): System_TableSchema.TableSchemaBase<\n\t\tTUserScope,\n\t\tTCell,\n\t\tSystem_TableSchema.ColumnSchemaBase<\n\t\t\tTUserScope,\n\t\t\tTCell,\n\t\t\tSystem_TableSchema.DefaultPropsType\n\t\t>,\n\t\tTRow\n\t>;\n\t/**\n\t * Factory for creating new table schema with custom column and row schema.\n\t * @typeParam TUserScope - The {@link SchemaFactory.scope | schema factory scope}.\n\t * The resulting schema will have an identifier of the form: `com.fluidframework.table<${TUserScope}>.Table`.\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 TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TColumn extends System_TableSchema.ColumnSchemaBase<TUserScope, TCell>,\n\t\tconst TRow extends System_TableSchema.RowSchemaBase<TUserScope, TCell>,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t> & {\n\t\t\treadonly column: TColumn;\n\t\t\treadonly row: TRow;\n\t\t},\n\t): System_TableSchema.TableSchemaBase<TUserScope, 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"]}
+{"version":3,"file":"tableSchema.js","sourceRoot":"","sources":["../src/tableSchema.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;AAEH,kEAA2D;AAC3D,uEAAsE;AAEtE,8CAA2C;AAC3C,qDAAmD;AAEnD,qDA2BgC;AAChC,8CAAoE;AAgCpE;;;;;;;;;;;;;;;;GAgBG;AACH,IAAiB,kBAAkB,CAkrClC;AAlrCD,WAAiB,kBAAkB;IAkFlC;;;OAGG;IACH,sIAAsI;IACtI,SAAgB,kBAAkB,CAIhC,kBAAiD,EAAE,WAAyB;QAC7E,MAAM,aAAa,GAAG,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;QAGnE,gFAAgF;QAChF,yCAAyC;QACzC,kDAAkD;QAClD,MAAM,wBAAwB,GAAG;YAChC,EAAE,EAAE,aAAa,CAAC,UAAU;SACnB,CAAC;QACX,MAAM,qBAAqB,GAAG;YAC7B,KAAK,EAAE,WAAW;SACT,CAAC;QAEX;;;;;;;;;;WAUG;QACH,MAAM,YAAY,GAAG;YACpB,GAAG,wBAAwB;YAC3B,GAAG,qBAAqB;SACf,CAAC,CAAC,iDAAiD;QAE7D;;WAEG;QACH,MAAM,MACL,SAAQ,aAAa,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,EAAE;YACpD,2DAA2D;YAC3D,0BAA0B,EAAE,IAAI;SAChC,CAAC;SACyD;QAoD5D,8IAA8I;QAC9I,2CAA2C;QAC3C,yHAAyH;QACzH,iDAAiD;QACjD,qFAAqF;QACrF,MAAM,gBAAgB,GAOlB,MAAkC,CAAC;QAEvC,OAAO,gBAAgB,CAAC;IACzB,CAAC;IA7Ge,qCAAkB,qBA6GjC,CAAA;IA2BD;;;OAGG;IACH,sIAAsI;IACtI,SAAgB,eAAe,CAK9B,kBAAiD,EACjD,UAAuB,EACvB,WAAyB;QAEzB,MAAM,aAAa,GAAG,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;QAGnE,6EAA6E;QAC7E,yCAAyC;QACzC,+CAA+C;QAC/C,MAAM,qBAAqB,GAAG;YAC7B,EAAE,EAAE,aAAa,CAAC,UAAU;YAC5B;;;;eAIG;YACH,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE;gBAC5E,QAAQ,EAAE;oBACT,WAAW,EAAE,iDAAiD;iBAC9D;aACD,CAAC;SACO,CAAC;QACX,MAAM,kBAAkB,GAAG;YAC1B,KAAK,EAAE,WAAW;SACT,CAAC;QAEX;;;;;;;WAOG;QACH,MAAM,SAAS,GAAG;YACjB,GAAG,qBAAqB;YACxB,GAAG,kBAAkB;SACZ,CAAC,CAAC,iDAAiD;QAE7D;;WAEG;QACH,MAAM,SACL,SAAQ,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,EAAE;YAC9C,2DAA2D;YAC3D,0BAA0B,EAAE,IAAI;SAChC,CAAC;SACiD;QAqDpD,8IAA8I;QAC9I,2CAA2C;QAC3C,yHAAyH;QACzH,iDAAiD;QACjD,qFAAqF;QACrF,MAAM,aAAa,GAOf,SAAkC,CAAC;QAEvC,OAAO,aAAa,CAAC;IACtB,CAAC;IAzHe,kCAAe,kBAyH9B,CAAA;IA2BD;;;OAGG;IACH,sIAAsI;IACtI,SAAgB,iBAAiB,CAMhC,kBAAiD,EACjD,WAAwB,EACxB,YAA2B,EAC3B,SAAqB;;QAErB,MAAM,aAAa,GAAG,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;QAYnE;;;;WAIG;QACH,MAAM,gBAAgB,GAAG;YACxB,IAAI,EAAE,aAAa,CAAC,KAAK,CAAC,YAAY,EAAE,SAAS,CAAC;YAClD,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,eAAe,EAAE,YAAY,CAAC;SACJ,CAAC;QAEzD;;;;WAIG;QACH,MAAM,WAAW,GAAG;YACnB,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,gBAAgB,CAAC,EAAE;gBAC9E,+FAA+F;gBAC/F,4DAA4D;gBAC5D,GAAG,EAAE,mBAAQ;aACb,CAAC;SACqD,CAAC;QAOzD;;WAEG;QACH,MAAM,KAAK;QACV,kGAAkG;QAClG,qFAAqF;QACrF,oGAAoG;QACpG,sBAAsB;QACtB,SAAQ,IAAA,uBAAY;QACnB,iBAAiB,CAAC,IAAA,iBAAM,EAAC,aAAqC,EAAE,WAAW,CAAC;QAC5E,WAAW,CAAC,WAAW;QACvB,8BAA8B,CAAC,KAAK;QACpC,kBAAkB,CAAC;YAClB,2DAA2D;YAC3D,0BAA0B,EAAE,IAAI;SAChC,CACD;YAGD,YAAmB,IAAmC;gBACrD,KAAK,CAAC,IAAI,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;;YACrD,CAAC;YAEM,MAAM,CAAC,MAAM,CAEnB,eAOY;gBAEZ,2BAA2B;gBAE3B,MAAM,OAAO,GACX,eAAe,EAAE,OAAsD,IAAI,EAAE,CAAC;gBAEhF,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;gBACpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;oBAC9B,SAAS,CAAC,GAAG,CAAE,MAA0B,CAAC,EAAE,CAAC,CAAC;gBAC/C,CAAC;gBAED,MAAM,IAAI,GAAI,eAAe,EAAE,IAAgD,IAAI,EAAE,CAAC;gBAEtF,EAAK,CAAC,mBAAmB,CACxB,OAAO;gBACP,wDAAwD;gBACxD,IAAI,GAAG,EAAE,CACT,CAAC;gBAEF,EAAK,CAAC,gBAAgB,CACrB,IAAI;gBACJ,qDAAqD;gBACrD,IAAI,GAAG,EAAE;gBACT,iHAAiH;gBACjH,SAAS,CACT,CAAC;gBAEF,aAAa;gBACb,OAAO,IAAI,IAAI,CACd,eAAe,KAAK,SAAS;oBAC5B,CAAC,CAAC,SAAS;oBACX,CAAC,CAAE;wBACD,KAAK,EAAE,eAAe;wBACtB,oGAAoG;wBACpG,sEAAsE;qBACtC,CACZ,CAAC;YAC1B,CAAC;YAED,IAAW,OAAO;gBACjB,OAAO,IAAI,CAAC,KAAK,CAAC,OAA2C,CAAC;YAC/D,CAAC;YAED,IAAW,IAAI;gBACd,OAAO,IAAI,CAAC,KAAK,CAAC,IAAqC,CAAC;YACzD,CAAC;YAEM,SAAS,CAAC,SAA0B;gBAC1C,OAAO,uBAAA,IAAI,6CAAc,MAAlB,IAAI,EAAe,SAAS,CAAC,CAAC;YACtC,CAAC;YAEM,MAAM,CAAC,SAA0B;gBACvC,OAAO,uBAAA,IAAI,0CAAW,MAAf,IAAI,EAAY,SAAS,CAAC,CAAC;YACnC,CAAC;YAEM,OAAO,CACb,GAAmD;gBAEnD,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,GAAG,CAAC;gBAC/D,MAAM,GAAG,GAAG,uBAAA,IAAI,0CAAW,MAAf,IAAI,EAAY,cAAc,CAAC,CAAC;gBAC5C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;oBACvB,OAAO,SAAS,CAAC;gBAClB,CAAC;gBAED,MAAM,MAAM,GAAG,uBAAA,IAAI,6CAAc,MAAlB,IAAI,EAAe,iBAAiB,CAAC,CAAC;gBACrD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC1B,OAAO,SAAS,CAAC;gBAClB,CAAC;gBAED,OAAQ,GAA4B,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YACvD,CAAC;YAEM,aAAa,CAAC,EACpB,OAAO,EACP,KAAK,GAC+C;gBACpD,2BAA2B;gBAE3B,kCAAkC;gBAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACzB,IAAA,wBAAa,EAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,qBAAqB,EAAE,IAAI,CAAC,CAAC;gBACvE,CAAC;gBAED,kDAAkD;gBAClD,uBAAA,IAAI,mDAAoB,MAAxB,IAAI,EAAqB,OAAO,CAAC,CAAC;gBAElC,aAAa;gBAEb,uBAAA,IAAI,kDAAmB,MAAvB,IAAI,EAAoB;oBACvB,UAAU,EAAE,GAAG,EAAE;wBAChB,wFAAwF;wBACxF,4DAA4D;wBAC5D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;4BACzB,8DAA8D;4BAC9D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,wBAAa,CAAC,MAAM,CAAC,OAAO,CAAQ,CAAC,CAAC;wBACtE,CAAC;6BAAM,CAAC;4BACP,8DAA8D;4BAC9D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,wBAAa,CAAC,MAAM,CAAC,OAAO,CAAQ,CAAC,CAAC;wBAC1E,CAAC;oBACF,CAAC;oBACD,0EAA0E;oBAC1E,yDAAyD;oBACzD,gIAAgI;oBAChI,mJAAmJ;oBACnJ,UAAU;oBACV,yDAAyD;oBACzD,+EAA+E;oBAC/E,2DAA2D;oBAC3D,iJAAiJ;oBACjJ,uBAAuB;oBACvB,cAAc;oBACd,yDAAyD;oBACzD,6GAA6G;oBAC7G,qBAAqB,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;iBAC7C,CAAC,CAAC;gBAEH,sFAAsF;gBACtF,OAAO,OAAuC,CAAC;YAChD,CAAC;YAEM,UAAU,CAAC,EACjB,KAAK,EACL,IAAI,GAC0C;gBAC9C,2BAA2B;gBAE3B,kCAAkC;gBAClC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACzB,IAAA,wBAAa,EAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,kBAAkB,EAAE,IAAI,CAAC,CAAC;gBACjE,CAAC;gBAED,+CAA+C;gBAC/C,uBAAA,IAAI,gDAAiB,MAArB,IAAI,EAAkB,IAAI,CAAC,CAAC;gBAE5B,aAAa;gBAEb,0EAA0E;gBAC1E,yDAAyD;gBACzD,iJAAiJ;gBACjJ,8GAA8G;gBAC9G,wHAAwH;gBACxH,gFAAgF;gBAChF,MAAM,iBAAiB,GAAiC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAC7E,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBACZ,IAAI,EAAE,gBAAgB;oBACtB,IAAI,EAAE,MAAyB;iBAC/B,CAAC,CACF,CAAC;gBAEF,uBAAA,IAAI,kDAAmB,MAAvB,IAAI,EAAoB;oBACvB,UAAU,EAAE,GAAG,EAAE;wBAChB,qFAAqF;wBACrF,4DAA4D;wBAC5D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;4BACzB,8DAA8D;4BAC9D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,wBAAa,CAAC,MAAM,CAAC,IAAI,CAAQ,CAAC,CAAC;wBAChE,CAAC;6BAAM,CAAC;4BACP,8DAA8D;4BAC9D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,wBAAa,CAAC,MAAM,CAAC,IAAI,CAAQ,CAAC,CAAC;wBACpE,CAAC;oBACF,CAAC;oBACD,aAAa,EAAE,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS;iBAC3E,CAAC,CAAC;gBAEH,sFAAsF;gBACtF,OAAO,IAAiC,CAAC;YAC1C,CAAC;YAEM,OAAO,CAAC,EACd,GAAG,EACH,IAAI,GACmE;gBACvE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;gBAEjD,MAAM,GAAG,GAAG,uBAAA,IAAI,uCAAQ,MAAZ,IAAI,EAAS,OAAO,CAAC,CAAC;gBAClC,MAAM,MAAM,GAAG,uBAAA,IAAI,0CAAW,MAAf,IAAI,EAAY,UAAU,CAAC,CAAC;gBAE3C,uBAAA,IAAI,kDAAmB,MAAvB,IAAI,EAAoB;oBACvB,UAAU,EAAE,GAAG,EAAE;wBACf,GAA4B,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAqB,CAAC;oBACxE,CAAC;oBACD,0EAA0E;oBAC1E,oFAAoF;oBACpF,iIAAiI;oBACjI,kFAAkF;oBAClF,aAAa,EAAE;wBACd;4BACC,IAAI,EAAE,gBAAgB;4BACtB,IAAI,EAAE,MAAM;yBACZ;qBACD;oBACD,0EAA0E;oBAC1E,gJAAgJ;oBAChJ,kIAAkI;oBAClI,qBAAqB,EACnB,GAA4B,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,SAAS;wBAC3D,CAAC,CAAC,SAAS;wBACX,CAAC,CAAC;4BACA;gCACC,IAAI,EAAE,gBAAgB;gCACtB,IAAI,EAAE,MAAM;6BACZ;yBACD;iBACJ,CAAC,CAAC;YACJ,CAAC;YAEM,aAAa,CACnB,cAAmF,EACnF,QAA4B,SAAS;gBAErC,0EAA0E;gBAC1E,+EAA+E;gBAC/E,8GAA8G;gBAC9G,6GAA6G;gBAC7G,4FAA4F;gBAC5F,8CAA8C;gBAC9C,6EAA6E;gBAC7E,MAAM,aAAa,GAAiC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;gBAE3E,IAAI,OAAO,cAAc,KAAK,QAAQ,IAAI,cAAc,KAAK,SAAS,EAAE,CAAC;oBACxE,IAAI,cAA6C,CAAC;oBAClD,MAAM,UAAU,GAAG,cAAc,IAAI,CAAC,CAAC;oBACvC,MAAM,QAAQ,GACb,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC;oBAEtE,gDAAgD;oBAChD,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;wBAC7B,OAAO,EAAE,CAAC;oBACX,CAAC;oBAED,IAAA,6BAAkB,EAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;oBAEpF,uBAAA,IAAI,kDAAmB,MAAvB,IAAI,EAAoB;wBACvB,UAAU,EAAE,GAAG,EAAE;4BAChB,MAAM,eAAe,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAC/C,UAAU,EACV,QAAQ,CACa,CAAC;4BAEvB,wEAAwE;4BACxE,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;gCACtC,uBAAA,IAAI,4CAAa,MAAjB,IAAI,EAAc,MAAM,CAAC,CAAC;4BAC3B,CAAC;4BAED,mCAAmC;4BACnC,oBAAoB,CACnB,UAAU,EACV,QAAQ,EACR,IAAI,CAAC,KAAK,CAAC,OAAO,EAClB,qBAAqB,CACrB,CAAC;4BACF,cAAc,GAAG,eAAe,CAAC;wBAClC,CAAC;wBACD,aAAa;qBACb,CAAC,CAAC;oBACH,OAAO,cAAc,IAAI,IAAA,eAAI,EAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;gBAC1E,CAAC;qBAAM,CAAC;oBACP,gDAAgD;oBAChD,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBACjC,OAAO,EAAE,CAAC;oBACX,CAAC;oBAED,mCAAmC;oBACnC,yEAAyE;oBACzE,8CAA8C;oBAC9C,MAAM,eAAe,GAAsB,EAAE,CAAC;oBAC9C,KAAK,MAAM,kBAAkB,IAAI,cAAc,EAAE,CAAC;wBACjD,eAAe,CAAC,IAAI,CAAC,uBAAA,IAAI,0CAAW,MAAf,IAAI,EAAY,kBAAkB,CAAC,CAAC,CAAC;oBAC3D,CAAC;oBAED,uBAAA,IAAI,kDAAmB,MAAvB,IAAI,EAAoB;wBACvB,UAAU,EAAE,GAAG,EAAE;4BAChB,kFAAkF;4BAClF,2EAA2E;4BAC3E,KAAK,MAAM,cAAc,IAAI,eAAe,EAAE,CAAC;gCAC9C,+CAA+C;gCAC/C,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oCACnC,8EAA8E;oCAC9E,4DAA4D;oCAC5D,IAAI,CAAC,UAAU,CAAC;wCACf,MAAM,EAAE,cAAc;wCACtB,GAAG,EAAE,GAAmB;qCACxB,CAAC,CAAC;gCACJ,CAAC;gCAED,kFAAkF;gCAClF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC;4BACzE,CAAC;wBACF,CAAC;wBACD,aAAa;qBACb,CAAC,CAAC;oBACH,OAAO,eAAe,CAAC;gBACxB,CAAC;YACF,CAAC;YAEM,UAAU,CAChB,WAA6E,EAC7E,KAA0B;gBAE1B,0EAA0E;gBAC1E,kGAAkG;gBAClG,wBAAwB;gBACxB,2GAA2G;gBAC3G,2CAA2C;gBAC3C,0FAA0F;gBAC1F,MAAM,iBAAiB,GAAiC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAC7E,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;oBACZ,IAAI,EAAE,gBAAgB;oBACtB,IAAI,EAAE,MAAyB;iBAC/B,CAAC,CACF,CAAC;gBAEF,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;oBAClE,IAAI,WAAuC,CAAC;oBAC5C,MAAM,UAAU,GAAG,WAAW,IAAI,CAAC,CAAC;oBACpC,MAAM,QAAQ,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,GAAG,KAAK,CAAC;oBAEnF,6CAA6C;oBAC7C,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;wBAC7B,OAAO,EAAE,CAAC;oBACX,CAAC;oBAED,IAAA,6BAAkB,EAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;oBAC9E,uBAAA,IAAI,kDAAmB,MAAvB,IAAI,EAAoB;wBACvB,UAAU,EAAE,GAAG,EAAE;4BAChB,WAAW,GAAG,oBAAoB,CACjC,UAAU,EACV,QAAQ,EACR,IAAI,CAAC,KAAK,CAAC,IAAI,EACf,kBAAkB,CAClB,CAAC;wBACH,CAAC;wBACD,qBAAqB,EACpB,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS;qBAC7D,CAAC,CAAC;oBACH,OAAO,WAAW,IAAI,IAAA,eAAI,EAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;gBACtE,CAAC;gBAED,6CAA6C;gBAC7C,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBAC9B,OAAO,EAAE,CAAC;gBACX,CAAC;gBAED,mCAAmC;gBACnC,yEAAyE;gBACzE,8CAA8C;gBAC9C,MAAM,YAAY,GAAmB,EAAE,CAAC;gBACxC,KAAK,MAAM,WAAW,IAAI,WAAW,EAAE,CAAC;oBACvC,YAAY,CAAC,IAAI,CAAC,uBAAA,IAAI,uCAAQ,MAAZ,IAAI,EAAS,WAAW,CAAC,CAAC,CAAC;gBAC9C,CAAC;gBACD,uBAAA,IAAI,kDAAmB,MAAvB,IAAI,EAAoB;oBACvB,UAAU,EAAE,GAAG,EAAE;wBAChB,kFAAkF;wBAClF,qEAAqE;wBACrE,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;4BACxC,+EAA+E;4BAC/E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;4BACnD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;wBACjC,CAAC;oBACF,CAAC;oBACD,qBAAqB,EAAE,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS;iBACnF,CAAC,CAAC;gBACH,OAAO,YAAY,CAAC;YACrB,CAAC;YAEM,UAAU,CAChB,GAAmD;gBAEnD,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,EAAE,cAAc,EAAE,GAAG,GAAG,CAAC;gBAC/D,MAAM,GAAG,GAAG,uBAAA,IAAI,uCAAQ,MAAZ,IAAI,EAAS,cAAc,CAAyB,CAAC;gBACjE,MAAM,MAAM,GAAG,uBAAA,IAAI,0CAAW,MAAf,IAAI,EAAY,iBAAiB,CAAC,CAAC;gBAElD,MAAM,IAAI,GAA8B,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC7D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;oBACxB,OAAO,SAAS,CAAC;gBAClB,CAAC;gBAED,uBAAA,IAAI,kDAAmB,MAAvB,IAAI,EAAoB;oBACvB,UAAU,EAAE,GAAG,EAAE;wBAChB,gEAAgE;wBAChE,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBAC7B,CAAC;oBACD,0EAA0E;oBAC1E,uHAAuH;oBACvH,6FAA6F;oBAC7F,2HAA2H;oBAC3H,qHAAqH;oBACrH,qBAAqB,EAAE;wBACtB;4BACC,IAAI,EAAE,gBAAgB;4BACtB,IAAI,EAAE,MAAM;yBACZ;qBACD;iBACD,CAAC,CAAC;gBAEH,OAAO,IAAI,CAAC;YACb,CAAC;YA0GD;;eAEG;YACK,MAAM,CAAC,wBAAwB,CACtC,iBAAoD;gBAEpD,IAAI,OAAO,iBAAiB,KAAK,QAAQ,EAAE,CAAC;oBAC3C,MAAM,IAAI,qBAAU,CAAC,6BAA6B,iBAAiB,GAAG,CAAC,CAAC;gBACzE,CAAC;gBAED,IAAI,OAAO,iBAAiB,KAAK,QAAQ,EAAE,CAAC;oBAC3C,MAAM,IAAI,qBAAU,CACnB,sBAAsB,iBAAiB,wBAAwB,CAC/D,CAAC;gBACH,CAAC;gBAED,MAAM,IAAI,qBAAU,CACnB,sCAAsC,iBAAiB,CAAC,EAAE,gCAAgC,CAC1F,CAAC;YACH,CAAC;YAyED;;;;eAIG;YACK,MAAM,CAAC,mBAAmB,CACjC,UAA0C,EAC1C,iBAA8B;gBAE9B,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;gBACvC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;oBACpC,0CAA0C;oBAC1C,MAAM,WAAW,GAAI,SAA6B,CAAC,EAAE,CAAC;oBACtD,IAAI,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;wBACxC,MAAM,IAAI,qBAAU,CACnB,yCAAyC,WAAW,2DAA2D,CAC/G,CAAC;oBACH,CAAC;oBACD,IAAI,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;wBACnC,MAAM,IAAI,qBAAU,CACnB,iDAAiD,WAAW,+BAA+B,CAC3F,CAAC;oBACH,CAAC;oBACD,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAC/B,CAAC;YACF,CAAC;YAED;;;;;eAKG;YACK,MAAM,CAAC,gBAAgB,CAC9B,OAAoC,EACpC,cAA2B,EAC3B,SAAsB;gBAEtB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;gBACpC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;oBAC9B,uCAAuC;oBAEvC,MAAM,QAAQ,GAAI,MAAuB,CAAC,EAAE,CAAC;oBAC7C,IAAI,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAClC,MAAM,IAAI,qBAAU,CACnB,sCAAsC,QAAQ,wDAAwD,CACtG,CAAC;oBACH,CAAC;oBACD,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;wBAC7B,MAAM,IAAI,qBAAU,CACnB,8CAA8C,QAAQ,4BAA4B,CAClF,CAAC;oBACH,CAAC;oBACD,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;oBAExB,aAAa;oBAEb,gGAAgG;oBAEhG,gJAAgJ;oBAChJ,0GAA0G;oBAC1G,IAAK,MAAc,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;wBACzC,0GAA0G;wBAC1G,MAAM,IAAI,GAAa,MAAM,CAAC,IAAI,CAAE,MAAc,CAAC,KAAK,CAAC,CAAC;wBAC1D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;4BACxB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gCACzB,MAAM,IAAI,qBAAU,CACnB,gEAAgE,GAAG,0DAA0D,CAC7H,CAAC;4BACH,CAAC;wBACF,CAAC;oBACF,CAAC;oBAED,aAAa;gBACd,CAAC;YACF,CAAC;YAED;;eAEG;YACK,MAAM,CAAC,qBAAqB,CACnC,cAA8C;gBAE9C,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;oBACxC,MAAM,IAAI,qBAAU,CAAC,0BAA0B,cAAc,GAAG,CAAC,CAAC;gBACnE,CAAC;gBAED,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;oBACxC,MAAM,IAAI,qBAAU,CAAC,mBAAmB,cAAc,wBAAwB,CAAC,CAAC;gBACjF,CAAC;gBAED,MAAM,IAAI,qBAAU,CACnB,mCAAmC,cAAc,CAAC,EAAE,gCAAgC,CACpF,CAAC;YACH,CAAC;SACD;uGAhSa,MAAuB;YACnC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBACnC,8EAA8E;gBAC9E,4DAA4D;gBAC5D,IAAI,CAAC,UAAU,CAAC;oBACf,MAAM;oBACN,GAAG,EAAE,GAAmB;iBACxB,CAAC,CAAC;YACJ,CAAC;QACF,CAAC,+DAWkB,OAOlB;YACA,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC;YACrE,MAAM,MAAM,GAAG,oBAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAEtC,+DAA+D;YAC/D,gFAAgF;YAChF,6DAA6D;YAC7D,IAAA,iCAAsB,EAAC,GAAG,EAAE;gBAC3B,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;oBAC1B,4EAA4E;oBAC5E,uDAAuD;oBACvD,8DAA8D;oBAC9D,UAAU,EAAE,CAAC;gBACd,CAAC;qBAAM,CAAC;oBACP,MAAM,CAAC,cAAc,CACpB,GAAG,EAAE;wBACJ,UAAU,EAAE,CAAC;wBACb,IAAI,qBAAqB,KAAK,SAAS,EAAE,CAAC;4BACzC,OAAO,EAAE,qBAAqB,EAAE,CAAC;wBAClC,CAAC;oBACF,CAAC,EACD,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAC3D,CAAC;gBACH,CAAC;YACF,CAAC,CAAC,CAAC;QACJ,CAAC,qDAQA,iBAAoD;YAEpD,IAAI,OAAO,iBAAiB,KAAK,QAAQ,EAAE,CAAC;gBAC3C,IAAI,iBAAiB,GAAG,CAAC,IAAI,iBAAiB,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;oBAC7E,OAAO,SAAS,CAAC;gBAClB,CAAC;gBACD,2EAA2E;gBAC3E,4DAA4D;gBAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,iBAAiB,CAAoB,CAAC;YACjE,CAAC;YAED,IAAI,OAAO,iBAAiB,KAAK,QAAQ,EAAE,CAAC;gBAC3C,MAAM,QAAQ,GAAG,iBAAiB,CAAC;gBACnC,4EAA4E;gBAC5E,4DAA4D;gBAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAE,GAAuB,CAAC,EAAE,KAAK,QAAQ,CAEpE,CAAC;YACd,CAAC;YAED,wEAAwE;YACxE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,CAAC;gBACrD,OAAO,SAAS,CAAC;YAClB,CAAC;YAED,OAAO,iBAAiB,CAAC;QAC1B,CAAC,+CAOU,iBAAoD;YAC9D,MAAM,MAAM,GAAG,uBAAA,IAAI,6CAAc,MAAlB,IAAI,EAAe,iBAAiB,CAAC,CAAC;YACrD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC1B,EAAK,CAAC,wBAAwB,CAAC,iBAAiB,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,MAAM,CAAC;QACf,CAAC,+CA4BU,cAA8C;YACxD,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;gBACxC,IAAI,cAAc,GAAG,CAAC,IAAI,cAAc,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACpE,OAAO,SAAS,CAAC;gBAClB,CAAC;gBACD,2EAA2E;gBAC3E,4DAA4D;gBAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAiB,CAAC;YACxD,CAAC;YAED,IAAI,OAAO,cAAc,KAAK,QAAQ,EAAE,CAAC;gBACxC,MAAM,KAAK,GAAG,cAAc,CAAC;gBAC7B,4EAA4E;gBAC5E,4DAA4D;gBAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAE,GAAoB,CAAC,EAAE,KAAK,KAAK,CAE3D,CAAC;YACd,CAAC;YAED,wEAAwE;YACxE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBAC/C,OAAO,SAAS,CAAC;YAClB,CAAC;YAED,OAAO,cAAc,CAAC;QACvB,CAAC,yCAOO,cAA8C;YACrD,MAAM,GAAG,GAAG,uBAAA,IAAI,0CAAW,MAAf,IAAI,EAAY,cAAc,CAAC,CAAC;YAC5C,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;gBACvB,EAAK,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAC;YAC7C,CAAC;YACD,OAAO,GAAG,CAAC;QACZ,CAAC,iEAOmB,UAA2C;YAC9D,OAAO,EAAK,CAAC,mBAAmB,CAC/B,UAAU,EACV,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAE,MAA0B,CAAC,EAAE,CAAC,CAAC,CAC3E,CAAC;QACH,CAAC,2DAQgB,OAAqC;YACrD,OAAO,EAAK,CAAC,gBAAgB,CAC5B,OAAO,EACP,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAE,GAAoB,CAAC,EAAE,CAAC,CAAC,EAC/D,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAE,MAA0B,CAAC,EAAE,CAAC,CAAC,CAC3E,CAAC;QACH,CAAC;QA0HF,8IAA8I;QAC9I,2CAA2C;QAC3C,yHAAyH;QACzH,iDAAiD;QACjD,uFAAuF;QACvF,MAAM,eAAe,GAAG,IAAA,yCAA8B,GAA2B,CAAC,KAAK,CAAC,CAAC;QAEzF,0BAA0B;QAC1B,OAAO,eAAe,CAAC;IACxB,CAAC;IAvyBe,oCAAiB,oBAuyBhC,CAAA;IAaD,aAAa;AACd,CAAC,EAlrCgB,kBAAkB,kCAAlB,kBAAkB,QAkrClC;AAED;;;GAGG;AACH,4EAA4E;AAC5E,SAAS,wBAAwB,CAChC,kBAAiD;IAEjD,OAAO,IAAA,sDAA2C,EAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;AACnF,CAAC;AAED;;;GAGG;AACH,SAAS,oBAAoB,CAC5B,UAAkB,EAClB,QAAgB,EAChB,KAAiC,EACjC,UAAkB;IAElB,IAAA,6BAAkB,EAAC,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC;IAE5D,wFAAwF;IACxF,4DAA4D;IAC5D,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAC9B,UAAU,EACV,QAAQ,CAC2C,CAAC;IACrD,KAAK,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAExC,OAAO,WAAW,CAAC;AACpB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiHG;AACH,IAAiB,WAAW,CAslB3B;AAtlBD,WAAiB,WAAW;IAC3B,iBAAiB;IA0EjB;;OAEG;IACH,SAAgB,MAAM,CAAC,EACtB,aAAa,EACb,IAAI,EACJ,KAAK,GAAG,wBAAa,CAAC,QAAQ,CAAC,wBAAa,CAAC,IAAI,CAAC,GAGlD;QACA,OAAO,kBAAkB,CAAC,kBAAkB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IACpE,CAAC;IARe,kBAAM,SAQrB,CAAA;IA0ED;;OAEG;IACH,SAAgB,GAAG,CAAC,EACnB,aAAa,EACb,IAAI,EACJ,KAAK,GAAG,wBAAa,CAAC,QAAQ,CAAC,wBAAa,CAAC,IAAI,CAAC,GAGlD;QACA,OAAO,kBAAkB,CAAC,eAAe,CAAC,aAAa,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACvE,CAAC;IARe,eAAG,MAQlB,CAAA;IAgZD;;OAEG;IACH,SAAgB,KAAK,CAAC,EACrB,aAAa,EACb,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC;QAC7B,aAAa;QACb,IAAI,EAAE,UAAU;KAChB,CAAC,EACF,GAAG,EAAE,SAAS,GAAG,GAAG,CAAC;QACpB,aAAa;QACb,IAAI,EAAE,UAAU;KAChB,CAAC,GAIF;QACA,OAAO,kBAAkB,CAAC,iBAAiB,CAC1C,aAAa,EACb,UAAU,EACV,YAAY,EACZ,SAAS,CACT,CAAC;IACH,CAAC;IArBe,iBAAK,QAqBpB,CAAA;IAED,aAAa;AACd,CAAC,EAtlBgB,WAAW,2BAAX,WAAW,QAslB3B","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 { EmptyKey } from \"./core/index.js\";\nimport { TreeAlpha } from \"./shared-tree/index.js\";\nimport type { SchemaFactoryBeta } from \"./simple-tree/index.js\";\nimport {\n\ttype FieldHasDefault,\n\ttype ImplicitAllowedTypes,\n\ttype InsertableObjectFromSchemaRecord,\n\ttype InsertableTreeNodeFromImplicitAllowedTypes,\n\ttype NodeKind,\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\tscoped,\n\ttype ImplicitFieldSchema,\n\twithBufferedTreeEvents,\n\ttype TreeRecordNode,\n\tobjectSchema,\n\teraseSchemaDetailsSubclassable,\n\t// eslint-disable-next-line @typescript-eslint/no-unused-vars, unused-imports/no-unused-imports -- This makes the API report slightly cleaner.\n\tTreeNodeSchemaCore,\n\ttype TransactionConstraintAlpha,\n\tcreateCustomizedFluidFrameworkScopedFactory,\n} from \"./simple-tree/index.js\";\nimport { validateIndex, validateIndexRange } from \"./util/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// - Use more focused constraint APIs to protect against leaked cells\n\n/**\n * A row in a table.\n * @typeParam TCellSchema - The type of the cells in the {@link TableSchema.Table}.\n * @typeParam TPropsSchema - Additional properties to associate with the row.\n * @privateRemarks Private counterpart to the {@link TableSchema.Row}.\n * Exposes internal properties needed for table operations (publicly exposed via {@link TableSchema.Table}).\n * @sealed\n */\nexport interface RowPrivate<\n\tTCellSchema extends ImplicitAllowedTypes,\n\tTPropsSchema extends ImplicitFieldSchema = ImplicitFieldSchema,\n> extends TableSchema.Row<TCellSchema, TPropsSchema> {\n\t/**\n\t * The row's cells.\n\t * @remarks This is a user-defined schema that can be used to store additional information about the row.\n\t * @privateRemarks\n\t * Note: these docs are duplicated on the inline type definitions in {@link System_TableSchema.createRowSchema}.\n\t * If you update the docs here, please also update the inline type definitions.\n\t */\n\treadonly cells: TreeRecordNode<TCellSchema>;\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 * Orphaned Cells:\n * Without safeguards, it is possible for cells to become \"orphaned\".\n * An orphaned cell is a cell that does not correspond to a valid row and column.\n * In order to preserve the invariant that all cells must have a valid row and column, table operations\n * (eg, inserting/removing rows/columns, or setting/removing a cell) will automatically include constraints that\n * guard transactions from producing orphaned cells.\n *\n * @system @beta\n */\nexport namespace System_TableSchema {\n\t/**\n\t * A list of items in a table whose elements may be rearranged, but not inserted or removed.\n\t *\n\t * @privateRemarks Used by {@link TableSchema.Table} for its `rows` and `columns` properties to allow basic rearrangement operations on the underlying sequences without permitting mutation operations that might violate table invariants.\n\t *\n\t * Note: this can't reasonably be implemented via `Pick<ArrayNode<...>>` because we only want to include the\n\t * subset of its method overloads which do not support moving items between lists.\n\t *\n\t * @beta @system\n\t */\n\texport type RearrangeableList<TItemSchema extends ImplicitAllowedTypes> = TreeNode &\n\t\treadonly TreeNodeFromImplicitAllowedTypes<TItemSchema>[] & {\n\t\t\t// #region Capture the subset of item rearrangement methods from `TreeArrayNode` that do not allow moving between lists.\n\n\t\t\t/** {@inheritDoc (TreeArrayNode:interface).(moveToEnd:1)} */\n\t\t\tmoveToEnd(sourceIndex: number): void;\n\t\t\t/** {@inheritDoc (TreeArrayNode:interface).(moveToStart:1)} */\n\t\t\tmoveToStart(sourceIndex: number): void;\n\t\t\t/** {@inheritDoc (TreeArrayNode:interface).(moveToIndex:1)} */\n\t\t\tmoveToIndex(sourceIndex: number, destinationIndex: number): void;\n\t\t\t/** {@inheritDoc (TreeArrayNode:interface).(moveRangeToEnd:1)} */\n\t\t\tmoveRangeToEnd(startIndex: number, endIndex: number): void;\n\t\t\t/** {@inheritDoc (TreeArrayNode:interface).(moveRangeToStart:1)} */\n\t\t\tmoveRangeToStart(startIndex: number, endIndex: number): void;\n\t\t\t/** {@inheritDoc (TreeArrayNode:interface).(moveRangeToIndex:1)} */\n\t\t\tmoveRangeToIndex(startIndex: number, endIndex: number, destinationIndex: number): void;\n\n\t\t\t// #endregion\n\t\t};\n\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 @beta\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 @beta\n\t */\n\texport interface OptionsWithSchemaFactory<TSchemaFactory extends SchemaFactoryBeta> {\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 * The resulting schema will have an identifier of the form: `com.fluidframework.table<${TUserScope}>.<Column|Row|Table>`.\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 @beta\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 column schema.\n\t * @remarks Includes parameters common to all column factory overloads.\n\t * @system @beta\n\t */\n\texport type CreateColumnOptionsBase<\n\t\tTUserScope extends string = string,\n\t\tTSchemaFactory extends SchemaFactoryBeta<TUserScope> = SchemaFactoryBeta<TUserScope>,\n\t\tTCellSchema extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t> = OptionsWithSchemaFactory<TSchemaFactory> & OptionsWithCellSchema<TCellSchema>;\n\n\t/**\n\t * Factory for creating column schema.\n\t * @system @beta\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 TUserScope extends string,\n\t\tconst TCellSchema extends ImplicitAllowedTypes,\n\t\tconst TPropsSchema extends ImplicitFieldSchema,\n\t>(inputSchemaFactory: SchemaFactoryBeta<TUserScope>, propsSchema: TPropsSchema) {\n\t\tconst schemaFactory = createTableScopedFactory(inputSchemaFactory);\n\t\ttype Scope = typeof schemaFactory.scope;\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.object(\"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\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<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<TPropsSchema>;\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<TPropsSchema>;\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 @beta\n\t */\n\texport type ColumnSchemaBase<\n\t\tTUserScope extends string = string,\n\t\tTCellSchema extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t\tTPropsSchema extends ImplicitFieldSchema = ImplicitFieldSchema,\n\t> = ReturnType<typeof createColumnSchema<TUserScope, 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 @beta\n\t */\n\texport type CreateRowOptionsBase<\n\t\tTUserScope extends string = string,\n\t\tTSchemaFactory extends SchemaFactoryBeta<TUserScope> = SchemaFactoryBeta<TUserScope>,\n\t\tTCellSchema extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t> = OptionsWithSchemaFactory<TSchemaFactory> & OptionsWithCellSchema<TCellSchema>;\n\n\t/**\n\t * Factory for creating row schema.\n\t * @system @beta\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 TUserScope extends string,\n\t\tconst TCellSchema extends ImplicitAllowedTypes,\n\t\tconst TPropsSchema extends ImplicitFieldSchema,\n\t>(\n\t\tinputSchemaFactory: SchemaFactoryBeta<TUserScope>,\n\t\tcellSchema: TCellSchema,\n\t\tpropsSchema: TPropsSchema,\n\t) {\n\t\tconst schemaFactory = createTableScopedFactory(inputSchemaFactory);\n\t\ttype Scope = typeof schemaFactory.scope;\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 RowSchema} 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 RowSchema\n\t\t\textends schemaFactory.object(\"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 RowPrivate<TCellSchema, TPropsSchema> {}\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<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<TPropsSchema>;\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<TPropsSchema>;\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 RowSchema]: (typeof RowSchema)[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) => RowSchema) & {\n\t\t\t\tcreateFromInsertable(parameters: RowInsertableType): RowSchema;\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> = RowSchema as RowSchemaModifiedType;\n\n\t\treturn RowSchemaType;\n\t}\n\n\t/**\n\t * Base row schema type.\n\t * @sealed @system @beta\n\t */\n\texport type RowSchemaBase<\n\t\tTUserScope extends string = string,\n\t\tTCellSchema extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t\tTPropsSchema extends ImplicitFieldSchema = ImplicitFieldSchema,\n\t> = ReturnType<typeof createRowSchema<TUserScope, 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 @beta\n\t */\n\texport type TableFactoryOptionsBase<\n\t\tTUserScope extends string = string,\n\t\tTSchemaFactory extends SchemaFactoryBeta<TUserScope> = SchemaFactoryBeta<TUserScope>,\n\t\tTCellSchema extends ImplicitAllowedTypes = ImplicitAllowedTypes,\n\t> = OptionsWithSchemaFactory<TSchemaFactory> & OptionsWithCellSchema<TCellSchema>;\n\n\t/**\n\t * Factory for creating table schema.\n\t * @system @beta\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 TUserScope extends string,\n\t\tconst TCellSchema extends ImplicitAllowedTypes,\n\t\tconst TColumnSchema extends ColumnSchemaBase<TUserScope, TCellSchema>,\n\t\tconst TRowSchema extends RowSchemaBase<TUserScope, TCellSchema>,\n\t>(\n\t\tinputSchemaFactory: SchemaFactoryBeta<TUserScope>,\n\t\t_cellSchema: TCellSchema,\n\t\tcolumnSchema: TColumnSchema,\n\t\trowSchema: TRowSchema,\n\t) {\n\t\tconst schemaFactory = createTableScopedFactory(inputSchemaFactory);\n\t\ttype Scope = typeof schemaFactory.scope;\n\n\t\ttype CellValueType = TreeNodeFromImplicitAllowedTypes<TCellSchema>;\n\t\ttype ColumnValueType = TreeNodeFromImplicitAllowedTypes<TColumnSchema>;\n\t\ttype ColumnInsertableType = InsertableTreeNodeFromImplicitAllowedTypes<TColumnSchema>;\n\t\ttype RowValueType = TreeNodeFromImplicitAllowedTypes<TRowSchema>;\n\t\ttype RowInsertableType = InsertableTreeNodeFromImplicitAllowedTypes<TRowSchema>;\n\n\t\t// Internal version of RowValueType that exposes the `cells` property for use within Table methods.\n\t\ttype RowValueInternalType = RowValueType & RowPrivate<TCellSchema>;\n\n\t\t/**\n\t\t * {@link Table} inner fields.\n\t\t * @remarks Extracted for re-use as construction parameters.\n\t\t * @see {@link Table.create}.\n\t\t */\n\t\tconst tableInnerFields = {\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, ImplicitFieldSchema>;\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\ttable: schemaFactory.required(schemaFactory.object(\"Table\", tableInnerFields), {\n\t\t\t\t// Use an empty key in the stored schema format to help prevent schema-unaware edits from being\n\t\t\t\t// made to the table, which may violate intended invariants.\n\t\t\t\tkey: EmptyKey,\n\t\t\t}),\n\t\t} as const satisfies Record<string, ImplicitFieldSchema>;\n\n\t\ttype TableValueType = TreeNode &\n\t\t\tTableSchema.Table<TUserScope, TCellSchema, TColumnSchema, TRowSchema> &\n\t\t\tWithType<ScopedSchemaName<Scope, \"TableRoot\">>;\n\t\ttype TableConstructorType = new (data?: InternalTreeNode | undefined) => TableValueType;\n\n\t\t/**\n\t\t * The Table schema\n\t\t */\n\t\tclass Table\n\t\t\t// Calling the objectSchema factory directly rather than using the schemaFactory so we can specify\n\t\t\t// `implicitlyConstructable: false`, which the SchemaFactory APIs do not yet support.\n\t\t\t// TODO: when support for configuring `implicitlyConstructable` is added to SchemaFactory, switch to\n\t\t\t// using that instead.\n\t\t\textends objectSchema(\n\t\t\t\t/* identifier: */ scoped(schemaFactory as SchemaFactory<Scope>, \"TableRoot\"),\n\t\t\t\t/* info: */ tableFields,\n\t\t\t\t/* implicitlyConstructable: */ false,\n\t\t\t\t/* nodeOptions: */ {\n\t\t\t\t\t// Will make it easier to evolve this schema in the future.\n\t\t\t\t\tallowUnknownOptionalFields: true,\n\t\t\t\t},\n\t\t\t)\n\t\t\timplements TableSchema.Table<TUserScope, TCellSchema, TColumnSchema, TRowSchema>\n\t\t{\n\t\t\tpublic constructor(node?: InternalTreeNode | undefined) {\n\t\t\t\tsuper(node ?? { table: { columns: [], rows: [] } });\n\t\t\t}\n\n\t\t\tpublic static create<TThis extends TableConstructorType>(\n\t\t\t\tthis: TThis,\n\t\t\t\tinitialContents?:\n\t\t\t\t\t| TableSchema.TableFactoryMethodParameters<\n\t\t\t\t\t\t\tTUserScope,\n\t\t\t\t\t\t\tTCellSchema,\n\t\t\t\t\t\t\tTColumnSchema,\n\t\t\t\t\t\t\tTRowSchema\n\t\t\t\t\t  >\n\t\t\t\t\t| undefined,\n\t\t\t): InstanceType<TThis> {\n\t\t\t\t// #region Input validation\n\n\t\t\t\tconst columns =\n\t\t\t\t\t(initialContents?.columns as Iterable<ColumnInsertableType> | undefined) ?? [];\n\n\t\t\t\tconst columnIds = new Set<string>();\n\t\t\t\tfor (const column of columns) {\n\t\t\t\t\tcolumnIds.add((column as ColumnValueType).id);\n\t\t\t\t}\n\n\t\t\t\tconst rows = (initialContents?.rows as Iterable<RowInsertableType> | undefined) ?? [];\n\n\t\t\t\tTable._validateNewColumns(\n\t\t\t\t\tcolumns,\n\t\t\t\t\t// New table, so no existing columns to validate against\n\t\t\t\t\tnew Set(),\n\t\t\t\t);\n\n\t\t\t\tTable._validateNewRows(\n\t\t\t\t\trows,\n\t\t\t\t\t// New table, so no existing rows to validate against\n\t\t\t\t\tnew Set(),\n\t\t\t\t\t// No existing columns to validate cells against, but we do need to validate the new rows against the new columns\n\t\t\t\t\tcolumnIds,\n\t\t\t\t);\n\n\t\t\t\t// #endregion\n\t\t\t\treturn new this(\n\t\t\t\t\tinitialContents === undefined\n\t\t\t\t\t\t? undefined\n\t\t\t\t\t\t: ({\n\t\t\t\t\t\t\t\ttable: initialContents,\n\t\t\t\t\t\t\t\t// We have typed our constructor to prevent users from calling it directly with insertable contents.\n\t\t\t\t\t\t\t\t// But the base constructor still allows it. Cast to work around this.\n\t\t\t\t\t\t\t} as unknown as InternalTreeNode),\n\t\t\t\t) as InstanceType<TThis>;\n\t\t\t}\n\n\t\t\tpublic get columns(): RearrangeableList<TColumnSchema> {\n\t\t\t\treturn this.table.columns as RearrangeableList<TColumnSchema>;\n\t\t\t}\n\n\t\t\tpublic get rows(): RearrangeableList<TRowSchema> {\n\t\t\t\treturn this.table.rows as RearrangeableList<TRowSchema>;\n\t\t\t}\n\n\t\t\tpublic getColumn(indexOrId: number | string): ColumnValueType | undefined {\n\t\t\t\treturn this.#tryGetColumn(indexOrId);\n\t\t\t}\n\n\t\t\tpublic getRow(indexOrId: number | string): RowValueType | undefined {\n\t\t\t\treturn this.#tryGetRow(indexOrId);\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: columnOrIdOrIndex, row: rowOrIdOrIndex } = key;\n\t\t\t\tconst row = this.#tryGetRow(rowOrIdOrIndex);\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(columnOrIdOrIndex);\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 as RowValueInternalType).cells[column.id];\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// #region Input validation\n\n\t\t\t\t// Ensure specified index is valid\n\t\t\t\tif (index !== undefined) {\n\t\t\t\t\tvalidateIndex(index, this.table.columns, \"Table.insertColumns\", true);\n\t\t\t\t}\n\n\t\t\t\t// Ensure the new columns being inserted are valid\n\t\t\t\tthis.#validateNewColumns(columns);\n\n\t\t\t\t// #endregion\n\n\t\t\t\tthis.#applyEditsInBatch({\n\t\t\t\t\tapplyEdits: () => {\n\t\t\t\t\t\t// TypeScript is unable to narrow the column type correctly here, hence the casts below.\n\t\t\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\t\t\tif (index === undefined) {\n\t\t\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\t\t\tthis.table.columns.insertAtEnd(TreeArrayNode.spread(columns) as any);\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\t\t\tthis.table.columns.insertAt(index, TreeArrayNode.spread(columns) as any);\n\t\t\t\t\t\t}\n\t\t\t\t\t},\n\t\t\t\t\t// Relevant invariant: each cell corresponds to an existing row and column\n\t\t\t\t\t// Scenarios that this constraint is intended to prevent:\n\t\t\t\t\t//  * Client A inserts a column, then client B adds row with a cell for that column, then client A reverts the column insertion.\n\t\t\t\t\t//  * Client A inserts a column, then client B populates a cell for that column within an existing row, then client A reverts the column insertion.\n\t\t\t\t\t//  Notes:\n\t\t\t\t\t//  * In either scenario, A and B may be the same client.\n\t\t\t\t\t//  * In either scenario, B's edit and the revert may or may not be concurrent.\n\t\t\t\t\t// Collateral scenarios that this constraint also prevents:\n\t\t\t\t\t//  * Any other scenario where client A inserts a column, then client B edits _any_ part of the tree, then client A reverts the column insertion.\n\t\t\t\t\t// Future improvements:\n\t\t\t\t\t// Use both...\n\t\t\t\t\t//  * A \"no attach on revert\" constraint on the row array\n\t\t\t\t\t//  * A \"no shallow change\" constraint on every cell that corresponds to the new column in every existing row\n\t\t\t\t\tpreconditionsOnRevert: [{ type: \"noChange\" }],\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 specified index is valid\n\t\t\t\tif (index !== undefined) {\n\t\t\t\t\tvalidateIndex(index, this.table.rows, \"Table.insertRows\", true);\n\t\t\t\t}\n\n\t\t\t\t// Ensure the new rows being inserted are valid\n\t\t\t\tthis.#validateNewRows(rows);\n\n\t\t\t\t// #endregion\n\n\t\t\t\t// Relevant invariant: each cell corresponds to an existing row and column\n\t\t\t\t// Prevents cell leaks from concurrently removed columns.\n\t\t\t\t// Example scenario: Client A removes a column while concurrently Client B adds a row with cells for those columns (including the one A removed).\n\t\t\t\t// If client B is sequenced after A, then B's row could have cells that do not correspond to existing columns.\n\t\t\t\t// This constraint ensures all columns that existed when creating the row still exist when the row insertion is applied.\n\t\t\t\t// TODO: Replace with \"no detach\" constraint on the column array when available.\n\t\t\t\tconst columnConstraints: TransactionConstraintAlpha[] = this.table.columns.map(\n\t\t\t\t\t(column) => ({\n\t\t\t\t\t\ttype: \"nodeInDocument\",\n\t\t\t\t\t\tnode: column as ColumnValueType,\n\t\t\t\t\t}),\n\t\t\t\t);\n\n\t\t\t\tthis.#applyEditsInBatch({\n\t\t\t\t\tapplyEdits: () => {\n\t\t\t\t\t\t// TypeScript is unable to narrow the row type correctly here, hence the casts below.\n\t\t\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\t\t\tif (index === undefined) {\n\t\t\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\t\t\tthis.table.rows.insertAtEnd(TreeArrayNode.spread(rows) as any);\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-explicit-any\n\t\t\t\t\t\t\tthis.table.rows.insertAt(index, TreeArrayNode.spread(rows) as any);\n\t\t\t\t\t\t}\n\t\t\t\t\t},\n\t\t\t\t\tpreconditions: columnConstraints.length > 0 ? columnConstraints : undefined,\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\tthis.#applyEditsInBatch({\n\t\t\t\t\tapplyEdits: () => {\n\t\t\t\t\t\t(row as RowValueInternalType).cells[column.id] = cell as CellValueType;\n\t\t\t\t\t},\n\t\t\t\t\t// Relevant invariant: each cell corresponds to an existing row and column\n\t\t\t\t\t// Prevents cell leaks from concurrently removed columns in earlier-sequenced edits.\n\t\t\t\t\t// Example scenario: Client A removes a column, then Client B concurrently sets a cell in that column (sequenced after A's edit).\n\t\t\t\t\t// If both edits are applied, B's cell would not correspond to an existing column.\n\t\t\t\t\tpreconditions: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: \"nodeInDocument\",\n\t\t\t\t\t\t\tnode: column,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t\t// Relevant invariant: each cell corresponds to an existing row and column\n\t\t\t\t\t// Example scenario: Client A overwrites a populated cell, then Client B removes the column associated with the A's cell (this clears the cell).\n\t\t\t\t\t// If Client A then reverts their edit, the overwritten value is restored in the cell despite the absence of column for that cell.\n\t\t\t\t\tpreconditionsOnRevert:\n\t\t\t\t\t\t(row as RowValueInternalType).cells[column.id] === undefined\n\t\t\t\t\t\t\t? undefined\n\t\t\t\t\t\t\t: [\n\t\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t\ttype: \"nodeInDocument\",\n\t\t\t\t\t\t\t\t\t\tnode: column,\n\t\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t\t],\n\t\t\t\t});\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\t// Relevant invariant: each cell corresponds to an existing row and column\n\t\t\t\t// Prevents cell leaks from concurrently added rows in earlier-sequenced edits.\n\t\t\t\t// Example scenario: Client A adds a row, Client B concurrently removes a column that is populated in A's row.\n\t\t\t\t// If Client A's edit is sequenced before Client B's edit, then B's removal would orphan the cell in A's row.\n\t\t\t\t// We have the same problem if Client A populates a cell for one of the columns removed by B\n\t\t\t\t// This constraint ensures no rows were added.\n\t\t\t\t// TODO: Replace with \"no attach\" constraint on the row array when available.\n\t\t\t\tconst preconditions: TransactionConstraintAlpha[] = [{ type: \"noChange\" }];\n\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 endIndex =\n\t\t\t\t\t\tcount === undefined ? this.table.columns.length : startIndex + count;\n\n\t\t\t\t\t// If there are no columns to remove, do nothing\n\t\t\t\t\tif (startIndex === endIndex) {\n\t\t\t\t\t\treturn [];\n\t\t\t\t\t}\n\n\t\t\t\t\tvalidateIndexRange(startIndex, endIndex, this.table.columns, \"Table.removeColumns\");\n\n\t\t\t\t\tthis.#applyEditsInBatch({\n\t\t\t\t\t\tapplyEdits: () => {\n\t\t\t\t\t\t\tconst columnsToRemove = this.table.columns.slice(\n\t\t\t\t\t\t\t\tstartIndex,\n\t\t\t\t\t\t\t\tendIndex,\n\t\t\t\t\t\t\t) as ColumnValueType[];\n\n\t\t\t\t\t\t\t// First, remove all cells that correspond to each column from each row:\n\t\t\t\t\t\t\tfor (const column of columnsToRemove) {\n\t\t\t\t\t\t\t\tthis.#removeCells(column);\n\t\t\t\t\t\t\t}\n\n\t\t\t\t\t\t\t// Second, remove the column nodes:\n\t\t\t\t\t\t\tremoveRangeFromArray(\n\t\t\t\t\t\t\t\tstartIndex,\n\t\t\t\t\t\t\t\tendIndex,\n\t\t\t\t\t\t\t\tthis.table.columns,\n\t\t\t\t\t\t\t\t\"Table.removeColumns\",\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t\tremovedColumns = columnsToRemove;\n\t\t\t\t\t\t},\n\t\t\t\t\t\tpreconditions,\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\tapplyEdits: () => {\n\t\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\t// So if we throw an error here for any column, no columns will be removed.\n\t\t\t\t\t\t\tfor (const columnToRemove of columnsToRemove) {\n\t\t\t\t\t\t\t\t// Remove the corresponding cell from all rows.\n\t\t\t\t\t\t\t\tfor (const row of this.table.rows) {\n\t\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\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\t\t\t\t\t\tthis.removeCell({\n\t\t\t\t\t\t\t\t\t\tcolumn: columnToRemove,\n\t\t\t\t\t\t\t\t\t\trow: row as RowValueType,\n\t\t\t\t\t\t\t\t\t});\n\t\t\t\t\t\t\t\t}\n\n\t\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\t\tthis.table.columns.removeAt(this.table.columns.indexOf(columnToRemove));\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t},\n\t\t\t\t\t\tpreconditions,\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\t// Relevant invariant: each cell corresponds to an existing row and column\n\t\t\t\t// Adding a constraint on columns here to prevent cells being orphaned.  The relevant scenario is:\n\t\t\t\t// Client A removes rows\n\t\t\t\t// Client B (either concurrently or not, so long as B's edit is sequenced after A's edit) removes a column,\n\t\t\t\t// Client A reverts the removal of the rows\n\t\t\t\t// TODO: Replace with \"no detach on revert\" constraint on the column array when available.\n\t\t\t\tconst columnConstraints: TransactionConstraintAlpha[] = this.table.columns.map(\n\t\t\t\t\t(column) => ({\n\t\t\t\t\t\ttype: \"nodeInDocument\",\n\t\t\t\t\t\tnode: column as ColumnValueType,\n\t\t\t\t\t}),\n\t\t\t\t);\n\n\t\t\t\tif (typeof indexOrRows === \"number\" || indexOrRows === undefined) {\n\t\t\t\t\tlet removedRows: RowValueType[] | undefined;\n\t\t\t\t\tconst startIndex = indexOrRows ?? 0;\n\t\t\t\t\tconst endIndex = count === undefined ? this.table.rows.length : startIndex + count;\n\n\t\t\t\t\t// If there are no rows to remove, do nothing\n\t\t\t\t\tif (startIndex === endIndex) {\n\t\t\t\t\t\treturn [];\n\t\t\t\t\t}\n\n\t\t\t\t\tvalidateIndexRange(startIndex, endIndex, this.table.rows, \"Table.removeRows\");\n\t\t\t\t\tthis.#applyEditsInBatch({\n\t\t\t\t\t\tapplyEdits: () => {\n\t\t\t\t\t\t\tremovedRows = removeRangeFromArray(\n\t\t\t\t\t\t\t\tstartIndex,\n\t\t\t\t\t\t\t\tendIndex,\n\t\t\t\t\t\t\t\tthis.table.rows,\n\t\t\t\t\t\t\t\t\"Table.removeRows\",\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t},\n\t\t\t\t\t\tpreconditionsOnRevert:\n\t\t\t\t\t\t\tcolumnConstraints.length > 0 ? columnConstraints : undefined,\n\t\t\t\t\t});\n\t\t\t\t\treturn removedRows ?? fail(0xccd /* Transaction did not complete */);\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\t\t\t\tthis.#applyEditsInBatch({\n\t\t\t\t\tapplyEdits: () => {\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 row, no rows will be removed.\n\t\t\t\t\t\tfor (const rowToRemove of rowsToRemove) {\n\t\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\t\tconst index = this.table.rows.indexOf(rowToRemove);\n\t\t\t\t\t\t\tthis.table.rows.removeAt(index);\n\t\t\t\t\t\t}\n\t\t\t\t\t},\n\t\t\t\t\tpreconditionsOnRevert: columnConstraints.length > 0 ? columnConstraints : undefined,\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: columnOrIdOrIndex, row: rowOrIdOrIndex } = key;\n\t\t\t\tconst row = this.#getRow(rowOrIdOrIndex) as RowValueInternalType;\n\t\t\t\tconst column = this.#getColumn(columnOrIdOrIndex);\n\n\t\t\t\tconst cell: CellValueType | undefined = row.cells[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\tthis.#applyEditsInBatch({\n\t\t\t\t\tapplyEdits: () => {\n\t\t\t\t\t\t// eslint-disable-next-line @typescript-eslint/no-dynamic-delete\n\t\t\t\t\t\tdelete row.cells[column.id];\n\t\t\t\t\t},\n\t\t\t\t\t// Relevant invariant: each cell corresponds to an existing row and column\n\t\t\t\t\t// Prevents cell leaks from concurrently removed columns in earlier-sequenced edits when this cell removal is reverted.\n\t\t\t\t\t// Example scenario: Client A removes a cell, then Client B removes the column for that cell.\n\t\t\t\t\t// If A's cell removal is later reverted, the cell would be restored but B's column removal means there's no column for it.\n\t\t\t\t\t// This constraint on revert ensures the column still exists, ensuring restored cells correspond to existing columns.\n\t\t\t\t\tpreconditionsOnRevert: [\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttype: \"nodeInDocument\",\n\t\t\t\t\t\t\tnode: column,\n\t\t\t\t\t\t},\n\t\t\t\t\t],\n\t\t\t\t});\n\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\t#removeCells(column: ColumnValueType): void {\n\t\t\t\tfor (const row of this.table.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\tthis.removeCell({\n\t\t\t\t\t\tcolumn,\n\t\t\t\t\t\trow: row as RowValueType,\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\t#applyEditsInBatch(options: {\n\t\t\t\t/** The edits to apply. */\n\t\t\t\tapplyEdits: () => void;\n\t\t\t\t/** Optional constraints that must be satisfied for the transaction to proceed. */\n\t\t\t\tpreconditions?: readonly TransactionConstraintAlpha[];\n\t\t\t\t/** Optional constraints that must be satisfied on revert for the transaction to proceed. */\n\t\t\t\tpreconditionsOnRevert?: readonly TransactionConstraintAlpha[];\n\t\t\t}): void {\n\t\t\t\tconst { applyEdits, preconditions, preconditionsOnRevert } = options;\n\t\t\t\tconst branch = TreeAlpha.branch(this);\n\n\t\t\t\t// Ensure events are paused until all of the edits are applied.\n\t\t\t\t// This ensures that the user sees the corresponding table-level edit as atomic,\n\t\t\t\t// and ensures they are not spammed with intermediate events.\n\t\t\t\twithBufferedTreeEvents(() => {\n\t\t\t\t\tif (branch === undefined) {\n\t\t\t\t\t\t// If this node does not have a corresponding branch, then it is unhydrated.\n\t\t\t\t\t\t// I.e., it is not part of a collaborative session yet.\n\t\t\t\t\t\t// Therefore, we don't need to run the edits as a transaction.\n\t\t\t\t\t\tapplyEdits();\n\t\t\t\t\t} else {\n\t\t\t\t\t\tbranch.runTransaction(\n\t\t\t\t\t\t\t() => {\n\t\t\t\t\t\t\t\tapplyEdits();\n\t\t\t\t\t\t\t\tif (preconditionsOnRevert !== undefined) {\n\t\t\t\t\t\t\t\t\treturn { preconditionsOnRevert };\n\t\t\t\t\t\t\t\t}\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\tpreconditions === undefined ? undefined : { preconditions },\n\t\t\t\t\t\t);\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\t#tryGetColumn(\n\t\t\t\tcolumnOrIdOrIndex: ColumnValueType | string | number,\n\t\t\t): ColumnValueType | undefined {\n\t\t\t\tif (typeof columnOrIdOrIndex === \"number\") {\n\t\t\t\t\tif (columnOrIdOrIndex < 0 || columnOrIdOrIndex >= this.table.columns.length) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\t// TypeScript is unable to narrow the types correctly here, hence the cast.\n\t\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\t\treturn this.table.columns[columnOrIdOrIndex] as ColumnValueType;\n\t\t\t\t}\n\n\t\t\t\tif (typeof columnOrIdOrIndex === \"string\") {\n\t\t\t\t\tconst columnId = columnOrIdOrIndex;\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\treturn this.table.columns.find((col) => (col as ColumnValueType).id === columnId) as\n\t\t\t\t\t\t| ColumnValueType\n\t\t\t\t\t\t| undefined;\n\t\t\t\t}\n\n\t\t\t\t// If the user provided a node, ensure it actually exists in this table.\n\t\t\t\tif (!this.table.columns.includes(columnOrIdOrIndex)) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\n\t\t\t\treturn columnOrIdOrIndex;\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\t#getColumn(columnOrIdOrIndex: ColumnValueType | string | number): ColumnValueType {\n\t\t\t\tconst column = this.#tryGetColumn(columnOrIdOrIndex);\n\t\t\t\tif (column === undefined) {\n\t\t\t\t\tTable._throwMissingColumnError(columnOrIdOrIndex);\n\t\t\t\t}\n\t\t\t\treturn column;\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Throw a `UsageError` for a missing Column by its ID or index.\n\t\t\t */\n\t\t\tprivate static _throwMissingColumnError(\n\t\t\t\tcolumnOrIdOrIndex: ColumnValueType | string | number,\n\t\t\t): never {\n\t\t\t\tif (typeof columnOrIdOrIndex === \"number\") {\n\t\t\t\t\tthrow new UsageError(`No column exists at index ${columnOrIdOrIndex}.`);\n\t\t\t\t}\n\n\t\t\t\tif (typeof columnOrIdOrIndex === \"string\") {\n\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t`No column with ID \"${columnOrIdOrIndex}\" exists in the table.`,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\tthrow new UsageError(\n\t\t\t\t\t`The specified column node with ID \"${columnOrIdOrIndex.id}\" does not exist in the table.`,\n\t\t\t\t);\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\t#tryGetRow(rowOrIdOrIndex: RowValueType | string | number): RowValueType | undefined {\n\t\t\t\tif (typeof rowOrIdOrIndex === \"number\") {\n\t\t\t\t\tif (rowOrIdOrIndex < 0 || rowOrIdOrIndex >= this.table.rows.length) {\n\t\t\t\t\t\treturn undefined;\n\t\t\t\t\t}\n\t\t\t\t\t// TypeScript is unable to narrow the types correctly here, hence the cast.\n\t\t\t\t\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\t\t\t\t\treturn this.table.rows[rowOrIdOrIndex] as RowValueType;\n\t\t\t\t}\n\n\t\t\t\tif (typeof rowOrIdOrIndex === \"string\") {\n\t\t\t\t\tconst rowId = rowOrIdOrIndex;\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\treturn this.table.rows.find((row) => (row as RowValueType).id === rowId) as\n\t\t\t\t\t\t| RowValueType\n\t\t\t\t\t\t| undefined;\n\t\t\t\t}\n\n\t\t\t\t// If the user provided a node, ensure it actually exists in this table.\n\t\t\t\tif (!this.table.rows.includes(rowOrIdOrIndex)) {\n\t\t\t\t\treturn undefined;\n\t\t\t\t}\n\n\t\t\t\treturn rowOrIdOrIndex;\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Attempts to resolve the provided Row node, ID, or index 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\t#getRow(rowOrIdOrIndex: RowValueType | string | number): RowValueType {\n\t\t\t\tconst row = this.#tryGetRow(rowOrIdOrIndex);\n\t\t\t\tif (row === undefined) {\n\t\t\t\t\tTable._throwMissingRowError(rowOrIdOrIndex);\n\t\t\t\t}\n\t\t\t\treturn row;\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Validates the provided list of new columns being inserted into the table.\n\t\t\t * @throws Throws a `UsageError` if any of the following conditions are met:\n\t\t\t * - A column with a duplicate ID is being inserted.\n\t\t\t */\n\t\t\t#validateNewColumns(newColumns: readonly ColumnInsertableType[]): void {\n\t\t\t\treturn Table._validateNewColumns(\n\t\t\t\t\tnewColumns,\n\t\t\t\t\tnew Set(this.table.columns.map((column) => (column as ColumnValueType).id)),\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Validates the provided list of new rows being inserted into the table.\n\t\t\t * @throws Throws a `UsageError` if any of the following conditions are met:\n\t\t\t * - A row with a duplicate ID is being inserted.\n\t\t\t * - A row is being inserted that contains cells for columns that do not exist in the table.\n\t\t\t */\n\t\t\t#validateNewRows(newRows: readonly RowInsertableType[]): void {\n\t\t\t\treturn Table._validateNewRows(\n\t\t\t\t\tnewRows,\n\t\t\t\t\tnew Set(this.table.rows.map((row) => (row as RowValueType).id)),\n\t\t\t\t\tnew Set(this.table.columns.map((column) => (column as ColumnValueType).id)),\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Validates the provided list of new columns being inserted into the table.\n\t\t\t * @throws Throws a `UsageError` if any of the following conditions are met:\n\t\t\t * - A column with a duplicate ID is being inserted.\n\t\t\t */\n\t\t\tprivate static _validateNewColumns(\n\t\t\t\tnewColumns: Iterable<ColumnInsertableType>,\n\t\t\t\texistingColumnIds: Set<string>,\n\t\t\t): void {\n\t\t\t\tconst newColumnIds = new Set<string>();\n\t\t\t\tfor (const newColumn of newColumns) {\n\t\t\t\t\t// #region Ensure each column ID is unique\n\t\t\t\t\tconst newColumnId = (newColumn as ColumnValueType).id;\n\t\t\t\t\tif (existingColumnIds.has(newColumnId)) {\n\t\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t\t`Attempted to insert a column with ID \"${newColumnId}\", but a column with that ID already exists in the table.`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tif (newColumnIds.has(newColumnId)) {\n\t\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t\t`Attempted to insert multiple columns with ID \"${newColumnId}\". Column IDs must be unique.`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tnewColumnIds.add(newColumnId);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Validates the provided list of new rows being inserted into the table.\n\t\t\t * @throws Throws a `UsageError` if any of the following conditions are met:\n\t\t\t * - A row with a duplicate ID is being inserted.\n\t\t\t * - A row is being inserted that contains cells for columns that do not exist in the table.\n\t\t\t */\n\t\t\tprivate static _validateNewRows(\n\t\t\t\tnewRows: Iterable<RowInsertableType>,\n\t\t\t\texistingRowIds: Set<string>,\n\t\t\t\tcolumnIds: Set<string>,\n\t\t\t): void {\n\t\t\t\tconst newRowIds = new Set<string>();\n\t\t\t\tfor (const newRow of newRows) {\n\t\t\t\t\t// #region Ensure each row ID is unique\n\n\t\t\t\t\tconst newRowId = (newRow as RowValueType).id;\n\t\t\t\t\tif (existingRowIds.has(newRowId)) {\n\t\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t\t`Attempted to insert a row with ID \"${newRowId}\", but a row with that ID already exists in the table.`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tif (newRowIds.has(newRowId)) {\n\t\t\t\t\t\tthrow new UsageError(\n\t\t\t\t\t\t\t`Attempted to insert multiple rows with ID \"${newRowId}\". Row IDs must be unique.`,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t\tnewRowIds.add(newRowId);\n\n\t\t\t\t\t// #endregion\n\n\t\t\t\t\t// #region If the row contains cells, verify that the table contains the columns for those cells\n\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, @typescript-eslint/no-unsafe-member-access\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, @typescript-eslint/no-unsafe-member-access\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 (!columnIds.has(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 a row containing 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\n\t\t\t\t\t// #endregion\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Throw a `UsageError` for a missing Row by its ID or index.\n\t\t\t */\n\t\t\tprivate static _throwMissingRowError(\n\t\t\t\trowOrIdOrIndex: RowValueType | string | number,\n\t\t\t): never {\n\t\t\t\tif (typeof rowOrIdOrIndex === \"number\") {\n\t\t\t\t\tthrow new UsageError(`No row exists at index ${rowOrIdOrIndex}.`);\n\t\t\t\t}\n\n\t\t\t\tif (typeof rowOrIdOrIndex === \"string\") {\n\t\t\t\t\tthrow new UsageError(`No row with ID \"${rowOrIdOrIndex}\" exists in the table.`);\n\t\t\t\t}\n\n\t\t\t\tthrow new UsageError(\n\t\t\t\t\t`The specified row node with ID \"${rowOrIdOrIndex.id}\" does not exist in the table.`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\t// Named interfaces here do not compile.\n\t\ttype Statics = {\n\t\t\t/**\n\t\t\t * Create a table with initial contents.\n\t\t\t * @param initialContents - The initial contents of the table.\n\t\t\t * If not provided, an empty table will be constructed.\n\t\t\t * @remarks Performs the following input validation:\n\t\t\t * - Ensures that any cells specified in the initial rows correspond to existing columns in the initial columns.\n\t\t\t * - Ensures that all column and row IDs are unique.\n\t\t\t */\n\t\t\tcreate<TThis extends TableConstructorType>(\n\t\t\t\tthis: TThis,\n\t\t\t\tinitialContents?:\n\t\t\t\t\t| TableSchema.TableFactoryMethodParameters<\n\t\t\t\t\t\t\tTUserScope,\n\t\t\t\t\t\t\tTCellSchema,\n\t\t\t\t\t\t\tTColumnSchema,\n\t\t\t\t\t\t\tTRowSchema\n\t\t\t\t\t  >\n\t\t\t\t\t| undefined,\n\t\t\t): InstanceType<TThis>;\n\t\t} & TableConstructorType;\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 eraseSubclassableSchemaDetails to erase internal details.\n\t\tconst TableSchemaType = eraseSchemaDetailsSubclassable<TableValueType, Statics>()(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 @beta\n\t */\n\texport type TableSchemaBase<\n\t\tTUserScope extends string,\n\t\tTCellSchema extends ImplicitAllowedTypes,\n\t\tTColumnSchema extends ColumnSchemaBase<TUserScope, TCellSchema>,\n\t\tTRowSchema extends RowSchemaBase<TUserScope, TCellSchema>,\n\t> = ReturnType<typeof createTableSchema<TUserScope, TCellSchema, TColumnSchema, TRowSchema>>;\n\n\t// #endregion\n}\n\n/**\n * Sets up scope for table schema built-in types.\n * @remarks User-provided factory scoping will be applied as `com.fluidframework.table<user-scope>`.\n */\n// eslint-disable-next-line @typescript-eslint/explicit-function-return-type\nfunction createTableScopedFactory<TUserScope extends string>(\n\tinputSchemaFactory: SchemaFactoryBeta<TUserScope>,\n) {\n\treturn createCustomizedFluidFrameworkScopedFactory(inputSchemaFactory, \"tableV2\");\n}\n\n/**\n * Removes the specified range of elements from the array.\n * @returns The removed elements.\n */\nfunction removeRangeFromArray<TNodeSchema extends ImplicitAllowedTypes>(\n\tstartIndex: number,\n\tendIndex: number,\n\tarray: TreeArrayNode<TNodeSchema>,\n\tmethodName: string,\n): TreeNodeFromImplicitAllowedTypes<TNodeSchema>[] {\n\tvalidateIndexRange(startIndex, endIndex, array, methodName);\n\n\t// TypeScript is unable to narrow the array element type correctly here, hence the cast.\n\t// See: https://github.com/microsoft/TypeScript/issues/52144\n\tconst removedRows = array.slice(\n\t\tstartIndex,\n\t\tendIndex,\n\t) as TreeNodeFromImplicitAllowedTypes<TNodeSchema>[];\n\tarray.removeRange(startIndex, endIndex);\n\n\treturn removedRows;\n}\n\n/**\n * Contains types and factories for creating schema to represent dynamic tabular data.\n *\n * @remarks\n *\n * Note: the APIs produced by this module ensure various tabular data invariants are maintained that the raw, underlying tree structures do not.\n * For example, they ensure that cells always correspond to existing rows and columns (and do not become \"orphaned\" due to row/column deletion, etc.).\n * For this reason, direct manipulation of the underlying tree structures is not supported.\n * To modify the data, only the APIs provided here may be used.\n *\n * Also note: these APIs leverage `SharedTree` functionality that was added in version `2.80.0`,\n * which is not compatible with previous versions of this library.\n * To ensure safe collaboration, you will need to configure the {@link @fluidframework/runtime-definitions#MinimumVersionForCollab}\n * for the Fluid Runtime and/or `SharedTree` to at least `2.80.0`.\n * To set this minimum version for `SharedTree`, use {@link configuredSharedTreeBeta}.\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 * @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 = MyTable.create({\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 * @beta\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 @beta\n\t */\n\texport interface Column<\n\t\t// eslint-disable-next-line @typescript-eslint/no-unused-vars -- Reserving this for future use.\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTProps extends ImplicitFieldSchema = ImplicitFieldSchema,\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<TProps>;\n\t\tset props(value: InsertableTreeFieldFromImplicitField<TProps>);\n\t}\n\n\t/**\n\t * Factory for creating new table column schema.\n\t * @typeParam TUserScope - The {@link SchemaFactory.scope | schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the {@link TableSchema.Table}.\n\t * @beta\n\t */\n\texport function column<\n\t\tconst TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t>(\n\t\tparams: System_TableSchema.CreateColumnOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t>,\n\t): System_TableSchema.ColumnSchemaBase<\n\t\tTUserScope,\n\t\tTCell,\n\t\tSystem_TableSchema.DefaultPropsType\n\t>;\n\t/**\n\t * Factory for creating new table column schema.\n\t * @typeParam TUserScope - 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 * @beta\n\t */\n\texport function column<\n\t\tconst TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TProps extends ImplicitFieldSchema,\n\t>(\n\t\tparams: System_TableSchema.CreateColumnOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t> & {\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<TUserScope, 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?: ImplicitFieldSchema;\n\t}): TreeNodeSchema {\n\t\treturn System_TableSchema.createColumnSchema(schemaFactory, 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 @beta\n\t */\n\texport interface Row<\n\t\t// eslint-disable-next-line @typescript-eslint/no-unused-vars -- Reserving this for future use.\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTProps extends ImplicitFieldSchema = ImplicitFieldSchema,\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 * 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<TProps>;\n\t\tset props(value: InsertableTreeFieldFromImplicitField<TProps>);\n\t}\n\n\t/**\n\t * Factory for creating new table column schema.\n\t * @typeParam TUserScope - The {@link SchemaFactory.scope | schema factory scope}.\n\t * @typeParam TCell - The type of the cells in the {@link TableSchema.Table}.\n\t * @beta\n\t */\n\texport function row<\n\t\tconst TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t>(\n\t\tparams: System_TableSchema.CreateRowOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t>,\n\t): System_TableSchema.RowSchemaBase<TUserScope, TCell, System_TableSchema.DefaultPropsType>;\n\t/**\n\t * Factory for creating new table row schema.\n\t * @typeParam TUserScope - 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 * @beta\n\t */\n\texport function row<\n\t\tconst TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TProps extends ImplicitFieldSchema,\n\t>(\n\t\tparams: System_TableSchema.CreateRowOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t> & {\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<TUserScope, 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?: ImplicitFieldSchema;\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 *\n\t * @remarks\n\t * Note that edits to the table structure (including edits by collaborators) can cause indexes to refer to different cells over time.\n\t * Therefore, it is recommended to use IDs or node references whenever possible to identify cells.\n\t *\n\t * @input @beta\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}, {@link TableSchema.Column.id}, or column index at which the cell is located.\n\t\t */\n\t\treadonly column: string | number | TreeNodeFromImplicitAllowedTypes<TColumn>;\n\n\t\t/**\n\t\t * {@link TableSchema.Row}, {@link TableSchema.Row.id}, or row index at which the cell is located.\n\t\t */\n\t\treadonly row: string | number | TreeNodeFromImplicitAllowedTypes<TRow>;\n\t}\n\n\t/**\n\t * {@link TableSchema.Table.insertColumns} parameters.\n\t * @input @beta\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 * @input @beta\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 * @input @beta\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 *\n\t * @remarks Table schema is created via the {@link TableSchema.(table:1)} factory.\n\t * Node instances of the schema type should be constructed via the static `create` method on the schema class.\n\t * E.g. `const table = MyTableSchema.create({ columns, rows});`\n\t *\n\t * @typeParam TUserScope - 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 *\n\t * @sealed @beta\n\t */\n\texport interface Table<\n\t\tTUserScope extends string,\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTColumn extends System_TableSchema.ColumnSchemaBase<TUserScope, TCell>,\n\t\tTRow extends System_TableSchema.RowSchemaBase<TUserScope, TCell>,\n\t> {\n\t\t/**\n\t\t * The table's columns.\n\t\t */\n\t\treadonly columns: System_TableSchema.RearrangeableList<TColumn>;\n\n\t\t/**\n\t\t * The table's rows.\n\t\t */\n\t\treadonly rows: System_TableSchema.RearrangeableList<TRow>;\n\n\t\t/**\n\t\t * Gets a table column by its {@link TableSchema.Column.id}.\n\t\t * @returns The column, if it exists. Otherwise, `undefined`.\n\t\t */\n\t\tgetColumn(id: string): TreeNodeFromImplicitAllowedTypes<TColumn> | undefined;\n\t\t/**\n\t\t * Gets a table column by its index in the table.\n\t\t *\n\t\t * @remarks\n\t\t * Note that edits to the table structure (including edits by collaborators) can cause indexes to refer to different columns over time.\n\t\t * Therefore, it is recommended to use IDs whenever possible to identify columns.\n\t\t *\n\t\t * @returns The column, if it exists. Otherwise, `undefined`.\n\t\t */\n\t\tgetColumn(index: number): TreeNodeFromImplicitAllowedTypes<TColumn> | undefined;\n\n\t\t/**\n\t\t * Gets a table row by its {@link TableSchema.Row.id}.\n\t\t * @returns The row, if it exists. Otherwise, `undefined`.\n\t\t */\n\t\tgetRow(id: string): TreeNodeFromImplicitAllowedTypes<TRow> | undefined;\n\t\t/**\n\t\t * Gets a table row by its index in the table.\n\t\t *\n\t\t * @remarks\n\t\t * Note that edits to the table structure (including edits by collaborators) can cause indexes to refer to different rows over time.\n\t\t * Therefore, it is recommended to use IDs whenever possible to identify rows.\n\t\t *\n\t\t * @returns The row, if it exists. Otherwise, `undefined`.\n\t\t */\n\t\tgetRow(index: number): TreeNodeFromImplicitAllowedTypes<TRow> | undefined;\n\n\t\t/**\n\t\t * Gets a cell in the table by corresponding column and row.\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 * @returns The cell, if it exists. Otherwise, `undefined`.\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 * Input parameters for {@link TableSchema.Table}'s `create` factory method.\n\t * @input @beta\n\t */\n\texport interface TableFactoryMethodParameters<\n\t\tTUserScope extends string,\n\t\tTCell extends ImplicitAllowedTypes,\n\t\tTColumn extends System_TableSchema.ColumnSchemaBase<TUserScope, TCell>,\n\t\tTRow extends System_TableSchema.RowSchemaBase<TUserScope, TCell>,\n\t> {\n\t\t/**\n\t\t * Initial columns for the table.\n\t\t */\n\t\treadonly columns?:\n\t\t\t| Iterable<InsertableTreeNodeFromImplicitAllowedTypes<TColumn>>\n\t\t\t| undefined;\n\n\t\t/**\n\t\t * Initial rows for the table.\n\t\t * @remarks If any cells are specified, they will be validated against the IDs of the provided columns.\n\t\t */\n\t\treadonly rows?: Iterable<InsertableTreeNodeFromImplicitAllowedTypes<TRow>> | undefined;\n\t}\n\n\t/**\n\t * Factory for creating new table schema.\n\t * @typeParam TUserScope - The {@link SchemaFactory.scope | schema factory scope}.\n\t * The resulting schema will have an identifier of the form: `com.fluidframework.table<${TUserScope}>.Table`.\n\t * @typeParam TCell - The type of the cells in the table.\n\t * @beta\n\t */\n\texport function table<\n\t\tconst TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t>,\n\t): System_TableSchema.TableSchemaBase<\n\t\tTUserScope,\n\t\tTCell,\n\t\tSystem_TableSchema.ColumnSchemaBase<\n\t\t\tTUserScope,\n\t\t\tTCell,\n\t\t\tSystem_TableSchema.DefaultPropsType\n\t\t>,\n\t\tSystem_TableSchema.RowSchemaBase<TUserScope, TCell, System_TableSchema.DefaultPropsType>\n\t>;\n\t/**\n\t * Factory for creating new table schema with custom column schema.\n\t * @typeParam TUserScope - The {@link SchemaFactory.scope | schema factory scope}.\n\t * The resulting schema will have an identifier of the form: `com.fluidframework.table<${TUserScope}>.Table`.\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 * @beta\n\t */\n\texport function table<\n\t\tconst TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TColumn extends System_TableSchema.ColumnSchemaBase<TUserScope, TCell>,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t> & {\n\t\t\treadonly column: TColumn;\n\t\t},\n\t): System_TableSchema.TableSchemaBase<\n\t\tTUserScope,\n\t\tTCell,\n\t\tTColumn,\n\t\tSystem_TableSchema.RowSchemaBase<TUserScope, TCell, System_TableSchema.DefaultPropsType>\n\t>;\n\t/**\n\t * Factory for creating new table schema with custom row schema.\n\t * @typeParam TUserScope - The {@link SchemaFactory.scope | schema factory scope}.\n\t * The resulting schema will have an identifier of the form: `com.fluidframework.table<${TUserScope}>.Table`.\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 * @beta\n\t */\n\texport function table<\n\t\tconst TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TRow extends System_TableSchema.RowSchemaBase<TUserScope, TCell>,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t> & {\n\t\t\treadonly row: TRow;\n\t\t},\n\t): System_TableSchema.TableSchemaBase<\n\t\tTUserScope,\n\t\tTCell,\n\t\tSystem_TableSchema.ColumnSchemaBase<\n\t\t\tTUserScope,\n\t\t\tTCell,\n\t\t\tSystem_TableSchema.DefaultPropsType\n\t\t>,\n\t\tTRow\n\t>;\n\t/**\n\t * Factory for creating new table schema with custom column and row schema.\n\t * @typeParam TUserScope - The {@link SchemaFactory.scope | schema factory scope}.\n\t * The resulting schema will have an identifier of the form: `com.fluidframework.table<${TUserScope}>.Table`.\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 * @beta\n\t */\n\texport function table<\n\t\tconst TUserScope extends string,\n\t\tconst TCell extends ImplicitAllowedTypes,\n\t\tconst TColumn extends System_TableSchema.ColumnSchemaBase<TUserScope, TCell>,\n\t\tconst TRow extends System_TableSchema.RowSchemaBase<TUserScope, TCell>,\n\t>(\n\t\tparams: System_TableSchema.TableFactoryOptionsBase<\n\t\t\tTUserScope,\n\t\t\tSchemaFactoryBeta<TUserScope>,\n\t\t\tTCell\n\t\t> & {\n\t\t\treadonly column: TColumn;\n\t\t\treadonly row: TRow;\n\t\t},\n\t): System_TableSchema.TableSchemaBase<TUserScope, 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/text/textDomainFormatted.js

@@ -56,7 +56,7 @@ class TextNode extends sf.object("Text", {
             for (const [key, value] of Object.entries(format)) {
                 // Object.entries should only return string keyed enumerable own properties.
                 // The TypeScript typing does not account for this, and thus this assertion is necessary for this code to compile.
-                (0, internal_1.assert)(typeof key === "string", "Object.entries returned a non-string key.");
+                (0, internal_1.assert)(typeof key === "string", 0xcc8 /* Object.entries returned a non-string key. */);
                 const f = FormattedTextAsTree.CharacterFormat.fields.get(key);
                 if (f === undefined) {
                     throw new internal_2.UsageError(`Unknown format key: ${key}`);

package/dist/text/textDomainFormatted.js.map

@@ -1 +1 @@
-{"version":3,"file":"textDomainFormatted.js","sourceRoot":"","sources":["../../src/text/textDomainFormatted.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 } from \"@fluidframework/core-utils/internal\";\nimport { UsageError } from \"@fluidframework/telemetry-utils/internal\";\n\nimport { EmptyKey } from \"../core/index.js\";\nimport {\n\tenumFromStrings,\n\teraseSchemaDetails,\n\tSchemaFactory,\n\tSchemaFactoryAlpha,\n\tTreeArrayNode,\n\tTreeBeta,\n} from \"../simple-tree/index.js\";\nimport type {\n\tInsertableTypedNode,\n\tTreeNode,\n\tTreeNodeFromImplicitAllowedTypes,\n\tWithType,\n} from \"../simple-tree/index.js\";\nimport { mapIterable } from \"../util/index.js\";\n\nimport { charactersFromString, type TextAsTree } from \"./textDomain.js\";\n\nconst sf = new SchemaFactoryAlpha(\"com.fluidframework.text.formatted\");\n\nclass TextNode\n\textends sf.object(\"Text\", {\n\t\tcontent: SchemaFactory.required([() => StringArray], { key: EmptyKey }),\n\t})\n\timplements FormattedTextAsTree.Members\n{\n\tpublic defaultFormat: FormattedTextAsTree.CharacterFormat =\n\t\tnew FormattedTextAsTree.CharacterFormat(defaultFormat);\n\n\tpublic insertAt(index: number, additionalCharacters: string): void {\n\t\tthis.content.insertAt(\n\t\t\tindex,\n\t\t\tTreeArrayNode.spread(textAtomsFromString(additionalCharacters, this.defaultFormat)),\n\t\t);\n\t}\n\tpublic removeRange(index: number, length: number): void {\n\t\tthis.content.removeRange(index, length);\n\t}\n\tpublic characters(): Iterable<string> {\n\t\treturn mapIterable(this.content, (atom) => atom.content.content);\n\t}\n\tpublic fullString(): string {\n\t\treturn [...this.characters()].join(\"\");\n\t}\n\n\tpublic static fromString(\n\t\tvalue: string,\n\t\tformat?: FormattedTextAsTree.CharacterFormat,\n\t): TextNode {\n\t\t// Constructing an ArrayNode from an iterator is supported, so creating an array from the iterable of characters seems like it's not necessary here,\n\t\t// but to reduce the risk of incorrect data interpretation, we actually ban this in the special case where the iterable is a string directly, which is the case here.\n\t\t// Thus the array construction here is necessary to avoid a runtime error.\n\t\treturn new TextNode({\n\t\t\tcontent: [\n\t\t\t\t...textAtomsFromString(\n\t\t\t\t\tvalue,\n\t\t\t\t\tformat ?? new FormattedTextAsTree.CharacterFormat(defaultFormat),\n\t\t\t\t),\n\t\t\t],\n\t\t});\n\t}\n\n\tpublic charactersWithFormatting(): Iterable<FormattedTextAsTree.StringAtom> {\n\t\treturn this.content;\n\t}\n\tpublic insertWithFormattingAt(\n\t\tindex: number,\n\t\tadditionalCharacters: Iterable<InsertableTypedNode<typeof FormattedTextAsTree.StringAtom>>,\n\t): void {\n\t\tthis.content.insertAt(index, TreeArrayNode.spread(additionalCharacters));\n\t}\n\tpublic formatRange(\n\t\tstartIndex: number,\n\t\tlength: number,\n\t\tformat: Partial<FormattedTextAsTree.CharacterFormat>,\n\t): void {\n\t\tfor (let i = startIndex; i < startIndex + length; i++) {\n\t\t\tconst atom = this.content[i];\n\t\t\tif (atom === undefined) {\n\t\t\t\tthrow new UsageError(\"Index out of bounds while formatting text range.\");\n\t\t\t}\n\t\t\tfor (const [key, value] of Object.entries(format) as [\n\t\t\t\tkeyof FormattedTextAsTree.CharacterFormat,\n\t\t\t\tunknown,\n\t\t\t][]) {\n\t\t\t\t// Object.entries should only return string keyed enumerable own properties.\n\t\t\t\t// The TypeScript typing does not account for this, and thus this assertion is necessary for this code to compile.\n\t\t\t\tassert(typeof key === \"string\", \"Object.entries returned a non-string key.\");\n\t\t\t\tconst f = FormattedTextAsTree.CharacterFormat.fields.get(key);\n\t\t\t\tif (f === undefined) {\n\t\t\t\t\tthrow new UsageError(`Unknown format key: ${key}`);\n\t\t\t\t}\n\t\t\t\t// Ensures that if the input is a node, it is cloned before being inserted into the tree.\n\t\t\t\tatom.format[key] = TreeBeta.clone(TreeBeta.create(f, value as never)) as never;\n\t\t\t}\n\t\t}\n\t}\n}\n\nconst defaultFormat = {\n\tbold: false,\n\titalic: false,\n\tunderline: false,\n\tsize: 12,\n\tfont: \"Arial\",\n} as const;\n\nfunction textAtomsFromString(\n\tvalue: string,\n\tformat: FormattedTextAsTree.CharacterFormat,\n): Iterable<FormattedTextAsTree.StringAtom> {\n\tconst result = mapIterable(\n\t\tcharactersFromString(value),\n\t\t(char) =>\n\t\t\tnew FormattedTextAsTree.StringAtom({\n\t\t\t\tcontent: { content: char },\n\t\t\t\tformat: TreeBeta.clone<typeof FormattedTextAsTree.CharacterFormat>(format),\n\t\t\t}),\n\t);\n\treturn result;\n}\n\nclass StringArray extends sf.array(\"StringArray\", [() => FormattedTextAsTree.StringAtom]) {}\n\n/**\n * A collection of text related types, schema and utilities for working with text beyond the basic {@link SchemaStatics.string}.\n * @privateRemarks\n * This has hard-coded assumptions about what kind of embedded content and what kind of formatting is supported.\n * We will want to generalize this with a more generic schema factory function like with table.\n * Then either that and/or the output from it can be package exported.\n * This version is just an initial prototype.\n * @internal\n */\nexport namespace FormattedTextAsTree {\n\t/**\n\t * Formatting options for characters.\n\t * @internal\n\t */\n\texport class CharacterFormat extends sf.objectAlpha(\"CharacterFormat\", {\n\t\tbold: SchemaFactory.boolean,\n\t\titalic: SchemaFactory.boolean,\n\t\tunderline: SchemaFactory.boolean,\n\t\tsize: SchemaFactory.number,\n\t\tfont: SchemaFactory.string,\n\t}) {}\n\n\t/**\n\t * Unit in the string representing a single character.\n\t * @internal\n\t */\n\texport class StringTextAtom extends sf.object(\"StringTextAtom\", {\n\t\t/**\n\t\t * The underlying text content of this atom.\n\t\t * @remarks\n\t\t * This is typically a single unicode codepoint, and thus may contain multiple utf-16 surrogate pair code units.\n\t\t * Using longer strings is still valid. For example, so users might store whole grapheme clusters here, or even longer sections of text.\n\t\t * Anything combined into a single atom will be treated atomically, and can not be partially selected or formatted.\n\t\t * Using larger atoms and splitting them as needed is NOT a recommended approach, since this will result in poor merge behavior for concurrent edits.\n\t\t * Instead atoms should always be the smallest unit of text which will be independently selected, moved or formatted.\n\t\t * @privateRemarks\n\t\t * This content logically represents the whole atom's content, so using {@link EmptyKey} makes sense to help indicate that.\n\t\t */\n\t\tcontent: SchemaFactory.required([SchemaFactory.string], { key: EmptyKey }),\n\t}) {}\n\n\t/**\n\t * Tag with which a line in text can be formatted from HTML.\n\t * @internal\n\t */\n\texport const LineTag = enumFromStrings(sf.scopedFactory(\"lineTag\"), [\n\t\t\"h1\",\n\t\t\"h2\",\n\t\t\"h3\",\n\t\t\"h4\",\n\t\t\"h5\",\n\t\t\"li\",\n\t]);\n\t/**\n\t * {@inheritdoc FormattedTextAsTree.(LineTag:variable)}\n\t * @internal\n\t */\n\texport type LineTag = TreeNodeFromImplicitAllowedTypes<typeof LineTag.schema>;\n\n\t/**\n\t * Unit in the string representing a new line character with line formatting.\n\t * @remarks\n\t * This aligns with how Quill represents line formatting.\n\t * Note that not all new lines will use this,\n\t * but only ones using this can have line specific formatting.\n\t * @internal\n\t */\n\texport class StringLineAtom extends sf.object(\"StringLineAtom\", {\n\t\ttag: LineTag.schema,\n\t}) {\n\t\tpublic readonly content = \"\\n\";\n\t}\n\n\t/**\n\t * Types of \"atoms\" that make up the text.\n\t * @internal\n\t */\n\texport const StringAtomContent = [StringTextAtom, StringLineAtom] as const;\n\t/**\n\t * {@inheritdoc FormattedTextAsTree.(StringAtomContent:variable)}\n\t * @internal\n\t */\n\texport type StringAtomContent = TreeNodeFromImplicitAllowedTypes<typeof StringAtomContent>;\n\n\t/**\n\t * A unit of the text, with formatting.\n\t * @internal\n\t */\n\texport class StringAtom extends sf.object(\"StringAtom\", {\n\t\tcontent: SchemaFactory.required(StringAtomContent, { key: EmptyKey }),\n\t\tformat: CharacterFormat,\n\t}) {}\n\n\t/**\n\t * Statics for text nodes.\n\t * @internal\n\t */\n\texport interface Statics {\n\t\t/**\n\t\t * Construct a {@link FormattedTextAsTree.(Tree:type)} from a string, where each character (as defined by iterating over the string) becomes a single character in the text node.\n\t\t * @remarks This combines pairs of utf-16 surrogate code units into single characters as appropriate.\n\t\t */\n\t\tfromString(value: string): Tree;\n\t}\n\n\t/**\n\t * Interface for a text node.\n\t * @remarks\n\t * The string is broken up into substrings which are referred to as 'characters'.\n\t * Unlike with JavaScript strings, all indexes are by character, not UTF-16 code unit.\n\t * This avoids the problem JavaScript where it can split UTF-16 surrogate pairs producing invalid strings,\n\t * and avoids the issue where indexing a string and iterating it segment the string differently.\n\t * This does NOT mean the characters correspond to user perceived characters (like grapheme clusters try to do):\n\t * applications will likely want to include higher level segmentation logic\n\t * which might differ between operations like delete\n\t * (which often operates on something in between unicode code points and grapheme clusters)\n\t * and navigation/selection (which typically uses grapheme clusters).\n\t *\n\t * @see {@link FormattedTextAsTree.Statics.fromString} for construction.\n\t * @see {@link FormattedTextAsTree.(Tree:type)} for schema.\n\t * @internal\n\t */\n\texport interface Members extends TextAsTree.Members {\n\t\t/**\n\t\t * Format to use by default for text inserted with non-formatted APIs.\n\t\t * @remarks\n\t\t * This is not persisted in the tree, and observation of it is not tracked by the tree observation tracking.\n\t\t * @privateRemarks\n\t\t * Opt this into observation tracking.\n\t\t */\n\t\tdefaultFormat: CharacterFormat;\n\n\t\t/**\n\t\t * Gets an iterable over the characters currently in the text.\n\t\t * @remarks\n\t\t * This iterator matches the behavior of {@link (TreeArrayNode:interface)} with respect to edits during iteration.\n\t\t */\n\t\tcharactersWithFormatting(): Iterable<StringAtom>;\n\n\t\t/**\n\t\t * Insert a range of characters into the string based on character index.\n\t\t * @remarks\n\t\t * See {@link (TreeArrayNode:interface).insertAt} for more details on the behavior.\n\t\t * See {@link FormattedTextAsTree.Statics.fromString} for how the `additionalCharacters` string is broken into characters.\n\t\t * @privateRemarks\n\t\t * If we provide ways to customize character boundaries, that could be handled here by taking in an Iterable<string> instead of a string.\n\t\t * Doing this currently would enable insertion of text with different character boundaries than the existing text,\n\t\t * which would violate the currently documented character boundary invariants.\n\t\t *\n\t\t * Another option would be to take an approach like Table,\n\t\t * where the user of the API uses a factory function to generate the schema, and can inject custom logic, like a string character iterator.\n\t\t */\n\t\tinsertWithFormattingAt(\n\t\t\tindex: number,\n\t\t\tadditionalCharacters: Iterable<InsertableTypedNode<typeof StringAtom>>,\n\t\t): void;\n\n\t\t/**\n\t\t * Apply formatting to a range of characters based on character index.\n\t\t * @param startIndex - The starting index of the range to format.\n\t\t * @param length - The number of characters to format.\n\t\t * @param format - The formatting to apply to the specified range.\n\t\t */\n\t\tformatRange(startIndex: number, length: number, format: Partial<CharacterFormat>): void;\n\t}\n\n\t/**\n\t * Schema for a text node.\n\t * @remarks\n\t * See {@link FormattedTextAsTree.Members} for the API.\n\t * See {@link FormattedTextAsTree.Statics} for static APIs on this Schema, including construction.\n\t * @internal\n\t */\n\texport const Tree = eraseSchemaDetails<Members, Statics>()(TextNode);\n\texport type Tree = Members & TreeNode & WithType<\"com.fluidframework.text.formatted.Text\">;\n}\n"]}
+{"version":3,"file":"textDomainFormatted.js","sourceRoot":"","sources":["../../src/text/textDomainFormatted.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 } from \"@fluidframework/core-utils/internal\";\nimport { UsageError } from \"@fluidframework/telemetry-utils/internal\";\n\nimport { EmptyKey } from \"../core/index.js\";\nimport {\n\tenumFromStrings,\n\teraseSchemaDetails,\n\tSchemaFactory,\n\tSchemaFactoryAlpha,\n\tTreeArrayNode,\n\tTreeBeta,\n} from \"../simple-tree/index.js\";\nimport type {\n\tInsertableTypedNode,\n\tTreeNode,\n\tTreeNodeFromImplicitAllowedTypes,\n\tWithType,\n} from \"../simple-tree/index.js\";\nimport { mapIterable } from \"../util/index.js\";\n\nimport { charactersFromString, type TextAsTree } from \"./textDomain.js\";\n\nconst sf = new SchemaFactoryAlpha(\"com.fluidframework.text.formatted\");\n\nclass TextNode\n\textends sf.object(\"Text\", {\n\t\tcontent: SchemaFactory.required([() => StringArray], { key: EmptyKey }),\n\t})\n\timplements FormattedTextAsTree.Members\n{\n\tpublic defaultFormat: FormattedTextAsTree.CharacterFormat =\n\t\tnew FormattedTextAsTree.CharacterFormat(defaultFormat);\n\n\tpublic insertAt(index: number, additionalCharacters: string): void {\n\t\tthis.content.insertAt(\n\t\t\tindex,\n\t\t\tTreeArrayNode.spread(textAtomsFromString(additionalCharacters, this.defaultFormat)),\n\t\t);\n\t}\n\tpublic removeRange(index: number, length: number): void {\n\t\tthis.content.removeRange(index, length);\n\t}\n\tpublic characters(): Iterable<string> {\n\t\treturn mapIterable(this.content, (atom) => atom.content.content);\n\t}\n\tpublic fullString(): string {\n\t\treturn [...this.characters()].join(\"\");\n\t}\n\n\tpublic static fromString(\n\t\tvalue: string,\n\t\tformat?: FormattedTextAsTree.CharacterFormat,\n\t): TextNode {\n\t\t// Constructing an ArrayNode from an iterator is supported, so creating an array from the iterable of characters seems like it's not necessary here,\n\t\t// but to reduce the risk of incorrect data interpretation, we actually ban this in the special case where the iterable is a string directly, which is the case here.\n\t\t// Thus the array construction here is necessary to avoid a runtime error.\n\t\treturn new TextNode({\n\t\t\tcontent: [\n\t\t\t\t...textAtomsFromString(\n\t\t\t\t\tvalue,\n\t\t\t\t\tformat ?? new FormattedTextAsTree.CharacterFormat(defaultFormat),\n\t\t\t\t),\n\t\t\t],\n\t\t});\n\t}\n\n\tpublic charactersWithFormatting(): Iterable<FormattedTextAsTree.StringAtom> {\n\t\treturn this.content;\n\t}\n\tpublic insertWithFormattingAt(\n\t\tindex: number,\n\t\tadditionalCharacters: Iterable<InsertableTypedNode<typeof FormattedTextAsTree.StringAtom>>,\n\t): void {\n\t\tthis.content.insertAt(index, TreeArrayNode.spread(additionalCharacters));\n\t}\n\tpublic formatRange(\n\t\tstartIndex: number,\n\t\tlength: number,\n\t\tformat: Partial<FormattedTextAsTree.CharacterFormat>,\n\t): void {\n\t\tfor (let i = startIndex; i < startIndex + length; i++) {\n\t\t\tconst atom = this.content[i];\n\t\t\tif (atom === undefined) {\n\t\t\t\tthrow new UsageError(\"Index out of bounds while formatting text range.\");\n\t\t\t}\n\t\t\tfor (const [key, value] of Object.entries(format) as [\n\t\t\t\tkeyof FormattedTextAsTree.CharacterFormat,\n\t\t\t\tunknown,\n\t\t\t][]) {\n\t\t\t\t// Object.entries should only return string keyed enumerable own properties.\n\t\t\t\t// The TypeScript typing does not account for this, and thus this assertion is necessary for this code to compile.\n\t\t\t\tassert(typeof key === \"string\", 0xcc8 /* Object.entries returned a non-string key. */);\n\t\t\t\tconst f = FormattedTextAsTree.CharacterFormat.fields.get(key);\n\t\t\t\tif (f === undefined) {\n\t\t\t\t\tthrow new UsageError(`Unknown format key: ${key}`);\n\t\t\t\t}\n\t\t\t\t// Ensures that if the input is a node, it is cloned before being inserted into the tree.\n\t\t\t\tatom.format[key] = TreeBeta.clone(TreeBeta.create(f, value as never)) as never;\n\t\t\t}\n\t\t}\n\t}\n}\n\nconst defaultFormat = {\n\tbold: false,\n\titalic: false,\n\tunderline: false,\n\tsize: 12,\n\tfont: \"Arial\",\n} as const;\n\nfunction textAtomsFromString(\n\tvalue: string,\n\tformat: FormattedTextAsTree.CharacterFormat,\n): Iterable<FormattedTextAsTree.StringAtom> {\n\tconst result = mapIterable(\n\t\tcharactersFromString(value),\n\t\t(char) =>\n\t\t\tnew FormattedTextAsTree.StringAtom({\n\t\t\t\tcontent: { content: char },\n\t\t\t\tformat: TreeBeta.clone<typeof FormattedTextAsTree.CharacterFormat>(format),\n\t\t\t}),\n\t);\n\treturn result;\n}\n\nclass StringArray extends sf.array(\"StringArray\", [() => FormattedTextAsTree.StringAtom]) {}\n\n/**\n * A collection of text related types, schema and utilities for working with text beyond the basic {@link SchemaStatics.string}.\n * @privateRemarks\n * This has hard-coded assumptions about what kind of embedded content and what kind of formatting is supported.\n * We will want to generalize this with a more generic schema factory function like with table.\n * Then either that and/or the output from it can be package exported.\n * This version is just an initial prototype.\n * @internal\n */\nexport namespace FormattedTextAsTree {\n\t/**\n\t * Formatting options for characters.\n\t * @internal\n\t */\n\texport class CharacterFormat extends sf.objectAlpha(\"CharacterFormat\", {\n\t\tbold: SchemaFactory.boolean,\n\t\titalic: SchemaFactory.boolean,\n\t\tunderline: SchemaFactory.boolean,\n\t\tsize: SchemaFactory.number,\n\t\tfont: SchemaFactory.string,\n\t}) {}\n\n\t/**\n\t * Unit in the string representing a single character.\n\t * @internal\n\t */\n\texport class StringTextAtom extends sf.object(\"StringTextAtom\", {\n\t\t/**\n\t\t * The underlying text content of this atom.\n\t\t * @remarks\n\t\t * This is typically a single unicode codepoint, and thus may contain multiple utf-16 surrogate pair code units.\n\t\t * Using longer strings is still valid. For example, so users might store whole grapheme clusters here, or even longer sections of text.\n\t\t * Anything combined into a single atom will be treated atomically, and can not be partially selected or formatted.\n\t\t * Using larger atoms and splitting them as needed is NOT a recommended approach, since this will result in poor merge behavior for concurrent edits.\n\t\t * Instead atoms should always be the smallest unit of text which will be independently selected, moved or formatted.\n\t\t * @privateRemarks\n\t\t * This content logically represents the whole atom's content, so using {@link EmptyKey} makes sense to help indicate that.\n\t\t */\n\t\tcontent: SchemaFactory.required([SchemaFactory.string], { key: EmptyKey }),\n\t}) {}\n\n\t/**\n\t * Tag with which a line in text can be formatted from HTML.\n\t * @internal\n\t */\n\texport const LineTag = enumFromStrings(sf.scopedFactory(\"lineTag\"), [\n\t\t\"h1\",\n\t\t\"h2\",\n\t\t\"h3\",\n\t\t\"h4\",\n\t\t\"h5\",\n\t\t\"li\",\n\t]);\n\t/**\n\t * {@inheritdoc FormattedTextAsTree.(LineTag:variable)}\n\t * @internal\n\t */\n\texport type LineTag = TreeNodeFromImplicitAllowedTypes<typeof LineTag.schema>;\n\n\t/**\n\t * Unit in the string representing a new line character with line formatting.\n\t * @remarks\n\t * This aligns with how Quill represents line formatting.\n\t * Note that not all new lines will use this,\n\t * but only ones using this can have line specific formatting.\n\t * @internal\n\t */\n\texport class StringLineAtom extends sf.object(\"StringLineAtom\", {\n\t\ttag: LineTag.schema,\n\t}) {\n\t\tpublic readonly content = \"\\n\";\n\t}\n\n\t/**\n\t * Types of \"atoms\" that make up the text.\n\t * @internal\n\t */\n\texport const StringAtomContent = [StringTextAtom, StringLineAtom] as const;\n\t/**\n\t * {@inheritdoc FormattedTextAsTree.(StringAtomContent:variable)}\n\t * @internal\n\t */\n\texport type StringAtomContent = TreeNodeFromImplicitAllowedTypes<typeof StringAtomContent>;\n\n\t/**\n\t * A unit of the text, with formatting.\n\t * @internal\n\t */\n\texport class StringAtom extends sf.object(\"StringAtom\", {\n\t\tcontent: SchemaFactory.required(StringAtomContent, { key: EmptyKey }),\n\t\tformat: CharacterFormat,\n\t}) {}\n\n\t/**\n\t * Statics for text nodes.\n\t * @internal\n\t */\n\texport interface Statics {\n\t\t/**\n\t\t * Construct a {@link FormattedTextAsTree.(Tree:type)} from a string, where each character (as defined by iterating over the string) becomes a single character in the text node.\n\t\t * @remarks This combines pairs of utf-16 surrogate code units into single characters as appropriate.\n\t\t */\n\t\tfromString(value: string): Tree;\n\t}\n\n\t/**\n\t * Interface for a text node.\n\t * @remarks\n\t * The string is broken up into substrings which are referred to as 'characters'.\n\t * Unlike with JavaScript strings, all indexes are by character, not UTF-16 code unit.\n\t * This avoids the problem JavaScript where it can split UTF-16 surrogate pairs producing invalid strings,\n\t * and avoids the issue where indexing a string and iterating it segment the string differently.\n\t * This does NOT mean the characters correspond to user perceived characters (like grapheme clusters try to do):\n\t * applications will likely want to include higher level segmentation logic\n\t * which might differ between operations like delete\n\t * (which often operates on something in between unicode code points and grapheme clusters)\n\t * and navigation/selection (which typically uses grapheme clusters).\n\t *\n\t * @see {@link FormattedTextAsTree.Statics.fromString} for construction.\n\t * @see {@link FormattedTextAsTree.(Tree:type)} for schema.\n\t * @internal\n\t */\n\texport interface Members extends TextAsTree.Members {\n\t\t/**\n\t\t * Format to use by default for text inserted with non-formatted APIs.\n\t\t * @remarks\n\t\t * This is not persisted in the tree, and observation of it is not tracked by the tree observation tracking.\n\t\t * @privateRemarks\n\t\t * Opt this into observation tracking.\n\t\t */\n\t\tdefaultFormat: CharacterFormat;\n\n\t\t/**\n\t\t * Gets an iterable over the characters currently in the text.\n\t\t * @remarks\n\t\t * This iterator matches the behavior of {@link (TreeArrayNode:interface)} with respect to edits during iteration.\n\t\t */\n\t\tcharactersWithFormatting(): Iterable<StringAtom>;\n\n\t\t/**\n\t\t * Insert a range of characters into the string based on character index.\n\t\t * @remarks\n\t\t * See {@link (TreeArrayNode:interface).insertAt} for more details on the behavior.\n\t\t * See {@link FormattedTextAsTree.Statics.fromString} for how the `additionalCharacters` string is broken into characters.\n\t\t * @privateRemarks\n\t\t * If we provide ways to customize character boundaries, that could be handled here by taking in an Iterable<string> instead of a string.\n\t\t * Doing this currently would enable insertion of text with different character boundaries than the existing text,\n\t\t * which would violate the currently documented character boundary invariants.\n\t\t *\n\t\t * Another option would be to take an approach like Table,\n\t\t * where the user of the API uses a factory function to generate the schema, and can inject custom logic, like a string character iterator.\n\t\t */\n\t\tinsertWithFormattingAt(\n\t\t\tindex: number,\n\t\t\tadditionalCharacters: Iterable<InsertableTypedNode<typeof StringAtom>>,\n\t\t): void;\n\n\t\t/**\n\t\t * Apply formatting to a range of characters based on character index.\n\t\t * @param startIndex - The starting index of the range to format.\n\t\t * @param length - The number of characters to format.\n\t\t * @param format - The formatting to apply to the specified range.\n\t\t */\n\t\tformatRange(startIndex: number, length: number, format: Partial<CharacterFormat>): void;\n\t}\n\n\t/**\n\t * Schema for a text node.\n\t * @remarks\n\t * See {@link FormattedTextAsTree.Members} for the API.\n\t * See {@link FormattedTextAsTree.Statics} for static APIs on this Schema, including construction.\n\t * @internal\n\t */\n\texport const Tree = eraseSchemaDetails<Members, Statics>()(TextNode);\n\texport type Tree = Members & TreeNode & WithType<\"com.fluidframework.text.formatted.Text\">;\n}\n"]}