@fluidframework/tree 2.40.0-336023 → 2.41.0-337492

package/lib/tableSchema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tableSchema.d.ts","sourceRoot":"","sources":["../src/tableSchema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tableSchema.d.ts","sourceRoot":"","sources":["../src/tableSchema.ts"],"names":[],"mappings":"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"}

package/lib/tableSchema.js

@@ -3,11 +3,18 @@
  * Licensed under the MIT License.
  */
 import { oob } from "@fluidframework/core-utils/internal";
+import { UsageError } from "@fluidframework/telemetry-utils/internal";
 import { Tree } from "./shared-tree/index.js";
 import { TreeArrayNode, SchemaFactory, } from "./simple-tree/index.js";
-// Future improvement TODOs (ideally to be done before promoting these APIs to `@alpha`):
+// Future improvement TODOs:
+// - Omit `cells` property from Row insertion type.
 // - Record-like type parameters / input parameters?
 // - Omit `props` properties from Row and Column schemas when not provided?
+// Longer-term work:
+// - Add constraint APIs to make it possible to avoid situations that could yield "orphaned" cells.
+/**
+ * The sub-scope applied to user-provided {@link SchemaFactory}s by table schema factories.
+ */
 const tableSchemaFactorySubScope = "table";
 /**
  * Not intended for use outside of this package.
@@ -22,11 +29,11 @@ const tableSchemaFactorySubScope = "table";
 export var System_TableSchema;
 (function (System_TableSchema) {
     /**
-     * Factory for creating new table column schema.
+     * Factory for creating column schema.
      * @system @internal
      */
     // eslint-disable-next-line @typescript-eslint/explicit-function-return-type -- Return type is too complex to be reasonable to specify
-    function createColumnInternal(inputSchemaFactory, propsSchema) {
+    function createColumnSchema(inputSchemaFactory, propsSchema) {
         const schemaFactory = inputSchemaFactory.scopedFactory(tableSchemaFactorySubScope);
         // Note: `columnFields` is broken into two parts to work around a TypeScript bug
         // that results in broken `.d.ts` output.
@@ -68,14 +75,13 @@ export var System_TableSchema;
         const ColumnSchemaType = Column;
         return ColumnSchemaType;
     }
-    System_TableSchema.createColumnInternal = createColumnInternal;
+    System_TableSchema.createColumnSchema = createColumnSchema;
     /**
-     * Factory for creating new table row schema.
-     *
+     * Factory for creating row schema.
      * @sealed @internal
      */
     // eslint-disable-next-line @typescript-eslint/explicit-function-return-type -- Return type is too complex to be reasonable to specify
-    function createRowInternal(inputSchemaFactory, cellSchema, propsSchema) {
+    function createRowSchema(inputSchemaFactory, cellSchema, propsSchema) {
         const schemaFactory = inputSchemaFactory.scopedFactory(tableSchemaFactorySubScope);
         // Note: `rowFields` is broken into two parts to work around a TypeScript bug
         // that results in broken `.d.ts` output.
@@ -115,15 +121,19 @@ export var System_TableSchema;
                 return this.cells.get(columnId);
             }
             setCell(columnOrId, value) {
+                // TODO: throw if column does not exist in the owning table.
                 const columnId = typeof columnOrId === "string" ? columnOrId : columnOrId.id;
                 this.cells.set(columnId, value);
             }
             removeCell(columnOrId) {
+                // TODO: throw if column does not exist in the owning table.
                 const columnId = typeof columnOrId === "string" ? columnOrId : columnOrId.id;
-                if (!this.cells.has(columnId)) {
-                    return;
+                const cell = this.cells.get(columnId);
+                if (cell === undefined) {
+                    return undefined;
                 }
                 this.cells.delete(columnId);
+                return cell;
             }
         }
         // Returning SingletonSchema without a type conversion results in TypeScript generating something like `readonly "__#124291@#brand": unknown;`
@@ -134,13 +144,13 @@ export var System_TableSchema;
         const RowSchemaType = Row;
         return RowSchemaType;
     }
-    System_TableSchema.createRowInternal = createRowInternal;
+    System_TableSchema.createRowSchema = createRowSchema;
     /**
-     * Factory for creating new table schema.
+     * Factory for creating table schema.
      * @system @internal
      */
     // eslint-disable-next-line @typescript-eslint/explicit-function-return-type -- Return type is too complex to be reasonable to specify
-    function createTableInternal(inputSchemaFactory, _cellSchema, columnSchema, rowSchema) {
+    function createTableSchema(inputSchemaFactory, _cellSchema, columnSchema, rowSchema) {
         const schemaFactory = inputSchemaFactory.scopedFactory(tableSchemaFactorySubScope);
         /**
          * {@link Table} fields.
@@ -169,98 +179,245 @@ export var System_TableSchema;
                 return this.rows.find((_row) => _row.id === id);
             }
             getCell(key) {
-                const { columnId, rowId } = key;
-                const row = this.getRow(rowId);
-                if (row !== undefined) {
-                    const column = this.getColumn(columnId);
-                    if (column !== undefined) {
-                        return row.getCell(column.id);
-                    }
+                const { column: columnOrId, row: rowOrId } = key;
+                const row = this._getRow(rowOrId);
+                if (row === undefined) {
+                    return undefined;
                 }
-                // If the cell does not exist return undefined
-                return undefined;
+                const column = this._getColumn(columnOrId);
+                if (column === undefined) {
+                    return undefined;
+                }
+                return row.getCell(column);
             }
             insertColumn({ column, index, }) {
-                if (index === undefined) {
-                    // TypeScript is unable to narrow the types correctly here, hence the cast.
+                const inserted = this.insertColumns({
+                    columns: [column],
+                    index,
+                });
+                return inserted[0] ?? oob();
+            }
+            insertColumns({ columns, index, }) {
+                // #region Input validation
+                // Ensure index is valid
+                if (index !== undefined) {
+                    Table.validateInsertionIndex(index, this.columns);
+                }
+                // Check all of the columns being inserted an ensure the table does not already contain any with the same ID.
+                for (const column of columns) {
+                    // TypeScript is unable to narrow the type of the column type correctly here, hence the casts below.
                     // See: https://github.com/microsoft/TypeScript/issues/52144
+                    const maybeId = column.id;
+                    if (maybeId !== undefined && this.containsColumnWithId(maybeId)) {
+                        throw new UsageError(`A column with ID "${column.id}" already exists in the table.`);
+                    }
+                }
+                // #endregion
+                // TypeScript is unable to narrow the column type correctly here, hence the casts below.
+                // See: https://github.com/microsoft/TypeScript/issues/52144
+                if (index === undefined) {
                     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                    this.columns.insertAtEnd(column);
+                    this.columns.insertAtEnd(TreeArrayNode.spread(columns));
                 }
                 else {
-                    // TypeScript is unable to narrow the types correctly here, hence the cast.
-                    // See: https://github.com/microsoft/TypeScript/issues/52144
                     // eslint-disable-next-line @typescript-eslint/no-explicit-any
-                    this.columns.insertAt(index, column);
+                    this.columns.insertAt(index, TreeArrayNode.spread(columns));
                 }
-                // Inserting the input node into the tree hydrates it, making it usable as a node.
-                return column;
+                // Inserting the input nodes into the tree hydrates them, making them usable as nodes.
+                return columns;
+            }
+            insertRow({ row, index, }) {
+                const inserted = this.insertRows({
+                    rows: [row],
+                    index,
+                });
+                return inserted[0] ?? oob();
             }
             insertRows({ index, rows, }) {
+                // #region Input validation
+                // Ensure index is valid
+                if (index !== undefined) {
+                    Table.validateInsertionIndex(index, this.rows);
+                }
+                // Note: TypeScript is unable to narrow the type of the row type correctly here, hence the casts below.
+                // See: https://github.com/microsoft/TypeScript/issues/52144
+                for (const newRow of rows) {
+                    // Check all of the rows being inserted an ensure the table does not already contain any with the same ID.
+                    const maybeId = newRow.id;
+                    if (maybeId !== undefined && this.containsRowWithId(maybeId)) {
+                        throw new UsageError(`A row with ID "${newRow.id}" already exists in the table.`);
+                    }
+                    // If the row contains cells, verify that the table contains the columns for those cells.
+                    // Note: we intentionally hide `cells` on `IRow` to avoid leaking the internal data representation as much as possible, so we have to cast here.
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    if (newRow.cells !== undefined) {
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        const keys = Object.keys(newRow.cells);
+                        for (const key of keys) {
+                            if (!this.containsColumnWithId(key)) {
+                                throw new UsageError(`Attempted to insert row a cell under column ID "${key}", but the table does not contain a column with that ID.`);
+                            }
+                        }
+                    }
+                }
+                // #endregion
+                // TypeScript is unable to narrow the row type correctly here, hence the casts below.
+                // See: https://github.com/microsoft/TypeScript/issues/52144
                 if (index === undefined) {
-                    // TypeScript is unable to narrow the types correctly here, hence the cast.
-                    // See: https://github.com/microsoft/TypeScript/issues/52144
                     // eslint-disable-next-line @typescript-eslint/no-explicit-any
                     this.rows.insertAtEnd(TreeArrayNode.spread(rows));
                 }
                 else {
-                    // TypeScript is unable to narrow the types correctly here, hence the cast.
-                    // See: https://github.com/microsoft/TypeScript/issues/52144
                     // eslint-disable-next-line @typescript-eslint/no-explicit-any
                     this.rows.insertAt(index, TreeArrayNode.spread(rows));
                 }
                 // Inserting the input nodes into the tree hydrates them, making them usable as nodes.
                 return rows;
             }
-            setCell({ key, cell }) {
-                const { columnId, rowId } = key;
-                const row = this.getRow(rowId);
-                if (row !== undefined) {
-                    const column = this.getColumn(columnId);
-                    if (column !== undefined) {
-                        row.setCell(column.id, cell);
-                    }
+            setCell({ key, cell, }) {
+                const { column: columnOrId, row: rowOrId } = key;
+                const row = this._getRow(rowOrId);
+                if (row === undefined) {
+                    const rowId = this._getRowId(rowOrId);
+                    throw new UsageError(`No row with ID "${rowId}" exists in the table.`);
+                }
+                const column = this._getColumn(columnOrId);
+                if (column === undefined) {
+                    const columnId = this._getColumnId(columnOrId);
+                    throw new UsageError(`No column with ID "${columnId}" exists in the table.`);
                 }
+                row.setCell(column, cell);
             }
-            removeColumn(column) {
-                const index = this.columns.indexOf(column);
-                // If the column is not in the table, do nothing
-                if (index === -1)
-                    return;
+            removeColumns(columns) {
+                // If there are no columns to remove, do nothing
+                if (columns.length === 0) {
+                    return [];
+                }
+                // If there is only one column to remove, remove it (and don't incur cost of transaction)
+                if (columns.length === 1) {
+                    const removedColumn = this.removeColumn(columns[0] ?? oob());
+                    return [removedColumn];
+                }
+                // If there are multiple columns to remove, remove them in a transaction.
+                const removedColumns = [];
+                Tree.runTransaction(this, () => {
+                    // Note, throwing an error within a transaction will abort the entire transaction.
+                    // So if we throw an error here for any row, no columns will be removed.
+                    for (const columnToRemove of columns) {
+                        const removedRow = this.removeColumn(columnToRemove);
+                        removedColumns.push(removedRow);
+                    }
+                });
+                return removedColumns;
+            }
+            removeColumn(columnOrId) {
+                const column = this._getColumn(columnOrId);
+                const index = column === undefined ? -1 : this.columns.indexOf(column);
+                if (index === -1) {
+                    const columnId = this._getColumnId(columnOrId);
+                    throw new UsageError(`Specified column with ID "${columnId}" does not exist in the table.`);
+                }
                 this.columns.removeAt(index);
+                return column;
+            }
+            removeAllColumns() {
+                // TypeScript is unable to narrow the row type correctly here, hence the cast.
+                // See: https://github.com/microsoft/TypeScript/issues/52144
+                return this.removeColumns(this.columns);
             }
             removeRows(rows) {
                 // If there are no rows to remove, do nothing
                 if (rows.length === 0) {
-                    return;
+                    return [];
                 }
-                // If there is only one row to remove, remove it
+                // If there is only one row to remove, remove it (and don't incur cost of transaction)
                 if (rows.length === 1) {
-                    const index = this.rows.indexOf(rows[0] ?? oob());
-                    this.rows.removeAt(index);
-                    return;
+                    const removedRow = this.removeRow(rows[0] ?? oob());
+                    return [removedRow];
                 }
-                // If there are multiple rows to remove, remove them in a transaction
-                // This is to avoid the performance issues of deleting multiple rows at once
+                // If there are multiple rows to remove, remove them in a transaction.
+                const removedRows = [];
                 Tree.runTransaction(this, () => {
-                    // Iterate over the rows and remove them
-                    for (const row of rows) {
-                        const index = this.rows.indexOf(row);
-                        this.rows.removeAt(index);
+                    // Note, throwing an error within a transaction will abort the entire transaction.
+                    // So if we throw an error here for any row, no rows will be removed.
+                    for (const rowToRemove of rows) {
+                        const removedRow = this.removeRow(rowToRemove);
+                        removedRows.push(removedRow);
                     }
                 });
+                return removedRows;
+            }
+            removeRow(rowOrId) {
+                const rowToRemove = this._getRow(rowOrId);
+                const index = rowToRemove === undefined ? -1 : this.rows.indexOf(rowToRemove);
+                // If the row does not exist in the table, throw an error.
+                if (index === -1) {
+                    const rowId = this._getRowId(rowOrId);
+                    throw new UsageError(`Specified row with ID "${rowId}" does not exist in the table.`);
+                }
+                this.rows.removeAt(index);
+                return rowToRemove;
             }
             removeAllRows() {
-                this.rows.removeRange();
+                // TypeScript is unable to narrow the row type correctly here, hence the cast.
+                // See: https://github.com/microsoft/TypeScript/issues/52144
+                return this.removeRows(this.rows);
             }
             removeCell(key) {
-                const { columnId, rowId } = key;
-                const row = this.getRow(rowId);
-                if (row !== undefined) {
-                    const column = this.getColumn(columnId);
-                    if (column !== undefined) {
-                        row.removeCell(column.id);
-                    }
+                const { column: columnOrId, row: rowOrId } = key;
+                const row = this._getRow(rowOrId);
+                if (row === undefined) {
+                    const rowId = this._getRowId(rowOrId);
+                    throw new UsageError(`Specified row with ID "${rowId}" does not exist in the table.`);
+                }
+                const column = this._getColumn(columnOrId);
+                if (column === undefined) {
+                    const columnId = this._getColumnId(columnOrId);
+                    throw new UsageError(`Specified column with ID "${columnId}" does not exist in the table.`);
+                }
+                const cell = row.getCell(column.id);
+                if (cell === undefined) {
+                    return undefined;
+                }
+                row.removeCell(column.id);
+                return cell;
+            }
+            _getColumn(columnOrId) {
+                return typeof columnOrId === "string" ? this.getColumn(columnOrId) : columnOrId;
+            }
+            _getColumnId(columnOrId) {
+                return typeof columnOrId === "string" ? columnOrId : columnOrId.id;
+            }
+            _getRow(rowOrId) {
+                return typeof rowOrId === "string" ? this.getRow(rowOrId) : rowOrId;
+            }
+            _getRowId(rowOrId) {
+                return typeof rowOrId === "string" ? rowOrId : rowOrId.id;
+            }
+            containsColumnWithId(columnId) {
+                // TypeScript is unable to narrow the types correctly here, hence the cast.
+                // See: https://github.com/microsoft/TypeScript/issues/52144
+                return (this.columns.find((column) => column.id === columnId) !==
+                    undefined);
+            }
+            containsRowWithId(rowId) {
+                // TypeScript is unable to narrow the types correctly here, hence the cast.
+                // See: https://github.com/microsoft/TypeScript/issues/52144
+                return this.rows.find((row) => row.id === rowId) !== undefined;
+            }
+            /**
+             * Ensure that the specified index is a valid location for item insertion in the destination list.
+             * @throws Throws a usage error if the destination is invalid.
+             */
+            static validateInsertionIndex(index, destinationList) {
+                if (index < 0) {
+                    throw new UsageError("The index must be greater than or equal to 0.");
+                }
+                if (index > destinationList.length) {
+                    throw new UsageError("The index specified for insertion is out of bounds.");
+                }
+                if (!Number.isInteger(index)) {
+                    throw new UsageError("The index must be an integer.");
                 }
             }
         }
@@ -273,12 +430,96 @@ export var System_TableSchema;
         // Return the table schema
         return TableSchemaType;
     }
-    System_TableSchema.createTableInternal = createTableInternal;
+    System_TableSchema.createTableSchema = createTableSchema;
     // #endregion
 })(System_TableSchema || (System_TableSchema = {}));
 /**
  * Contains types and factories for creating schema to represent dynamic tabular data.
- * @privateRemarks TODO: document in more detail and add `@example`s.
+ *
+ * @remarks
+ *
+ * Tables created using these APIs are...
+ *
+ * - sparse, meaning that cells may be omitted, and new rows are empty by default.
+ *
+ * - dynamic, meaning that their structure can be modified at runtime.
+ * Columns and rows can be inserted, removed, modified, and reordered.
+ * Cells can be inserted, removed, and modified.
+ *
+ * - row-major, meaning that operating on rows (including inserts, removal, moves, and traversal) is more efficient than operating on columns.
+ *
+ * Column and Row schema created using these APIs are extensible via the `props` field.
+ * This allows association of additional properties with column and row nodes.
+ *
+ * Note: for now it is possible for table cells to become "orphaned".
+ * That is, it is possible to enter a state where one or more rows contain cells with no corresponding column.
+ * To help avoid this situation, you can manually remove corresponding cells when removing columns.
+ * Either way, it is possible to enter such a state via the merging of edits.
+ * For example: one client might add a row while another concurrently removes a column, orphaning the cell where the column and row intersected.
+ *
+ * @example Using default Column and Row schema
+ *
+ * ```typescript
+ * class Cell extends schemaFactory.object("TableCell", {
+ * 	value: schemaFactory.string,
+ * }) {}
+ *
+ * class Table extends TableSchema.table({
+ * 	schemaFactory,
+ * 	cell: Cell,
+ * }) {}
+ *
+ * const table = new Table({
+ * 	columns: [{ id: "column-0" }],
+ * 	rows: [{ id: "row-0", cells: {} }],
+ * });
+ * ```
+ *
+ * @example Customizing Column and Row schema
+ *
+ * ```typescript
+ * class Cell extends schemaFactory.object("TableCell", {
+ * 	value: schemaFactory.string,
+ * }) {}
+ *
+ * class ColumnProps extends schemaFactory.object("TableColumnProps", {
+ * 	// Column label to display.
+ * 	label: schemaFactory.string,
+ * 	// The type of data represented by the cells. Default: string.
+ * 	dataType: schemaFactory.optional(schemaFactory.string),
+ * }) {}
+ *
+ * class Column extends TableSchema.column({
+ * 	schemaFactory,
+ * 	props: ColumnProps,
+ * }) {}
+ *
+ * class Row extends TableSchema.row({
+ * 	schemaFactory,
+ * 	cell: Cell,
+ * }) {}
+ *
+ * class Table extends TableSchema.table({
+ * 	schemaFactory,
+ * 	cell: Cell,
+ * 	column: Column,
+ * 	row: Row,
+ * }) {}
+ *
+ * const table = new Table({
+ * 	columns: [
+ * 		new Column({ props: { label: "Entry", dataType: "string" } }),
+ * 		new Column({ props: { label: "Date", dataType: "date" } }),
+ * 		new Column({ props: { label: "Amount", dataType: "number" } }),
+ * 	],
+ * 	rows: [],
+ * });
+ * ```
+ *
+ * @privateRemarks
+ * The above examples are backed by tests in `tableSchema.spec.ts`.
+ * Those tests and these examples should be kept in-sync to ensure that the examples are correct.
+ *
  * @internal
  */
 export var TableSchema;
@@ -287,29 +528,29 @@ export var TableSchema;
     /**
      * Overload implementation
      */
-    function createColumn({ schemaFactory, props = SchemaFactory.optional(SchemaFactory.null), }) {
-        return System_TableSchema.createColumnInternal(schemaFactory, props);
+    function column({ schemaFactory, props = SchemaFactory.optional(SchemaFactory.null), }) {
+        return System_TableSchema.createColumnSchema(schemaFactory, props);
     }
-    TableSchema.createColumn = createColumn;
+    TableSchema.column = column;
     /**
      * Overload implementation
      */
-    function createRow({ schemaFactory, cell, props = SchemaFactory.optional(SchemaFactory.null), }) {
-        return System_TableSchema.createRowInternal(schemaFactory, cell, props);
+    function row({ schemaFactory, cell, props = SchemaFactory.optional(SchemaFactory.null), }) {
+        return System_TableSchema.createRowSchema(schemaFactory, cell, props);
     }
-    TableSchema.createRow = createRow;
+    TableSchema.row = row;
     /**
      * Overload implementation
      */
-    function createTable({ schemaFactory, cell, column = createColumn({
+    function table({ schemaFactory, cell: cellSchema, column: columnSchema = column({
         schemaFactory,
-    }), row = createRow({
+    }), row: rowSchema = row({
         schemaFactory,
-        cell,
+        cell: cellSchema,
     }), }) {
-        return System_TableSchema.createTableInternal(schemaFactory, cell, column, row);
+        return System_TableSchema.createTableSchema(schemaFactory, cellSchema, columnSchema, rowSchema);
     }
-    TableSchema.createTable = createTable;
+    TableSchema.table = table;
     // #endregion
 })(TableSchema || (TableSchema = {}));
 //# sourceMappingURL=tableSchema.js.map