tinybase 5.0.0-beta.26 → 5.0.0-beta.28

package/@types/ui-react-dom/index.d.ts

@@ -35,16 +35,22 @@ export type CustomCell = {
   /**
    * An optional string that will be used as the label at the top of the table
    * column for this Cell.
+   * @category Prop
+   * @since v4.1.0
    */
   label?: string;
   /**
    * An optional custom component for rendering each Cell in the Table (to
    * override the default CellView component).
+   * @category Prop
+   * @since v4.1.0
    */
   component?: ComponentType<CellProps>;
   /**
    * An optional function for generating extra props for each custom Cell
    * component based on Row and Cell Id.
+   * @category Prop
+   * @since v4.1.0
    */
   getComponentProps?: (rowId: Id, cellId: Id) => ExtraProps;
 };
@@ -59,16 +65,22 @@ export type CustomResultCell = {
   /**
    * An optional string that will be used as the label at the top of the table
    * column for this Cell.
+   * @category Prop
+   * @since v4.1.0
    */
   label?: string;
   /**
    * An optional custom component for rendering each Cell in the ResultTable (to
    * override the default ResultCellView component).
+   * @category Prop
+   * @since v4.1.0
    */
   component?: ComponentType<ResultCellProps>;
   /**
    * An optional function for generating extra props for each custom Cell
    * component based on Row and Cell Id.
+   * @category Prop
+   * @since v4.1.0
    */
   getComponentProps?: (rowId: Id, cellId: Id) => ExtraProps;
 };
@@ -83,16 +95,22 @@ export type CustomResultCell = {
 export type HtmlTableProps = {
   /**
    * A string className to use on the root of the resulting element.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly className?: string;
   /**
    * Whether a header row should be rendered at the top of the table, defaulting
    * to `true`.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly headerRow?: boolean;
   /**
    * Whether an Id column should be rendered on the left of the table,
    * defaulting to `true`.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly idColumn?: boolean;
 };
@@ -106,17 +124,23 @@ export type HtmlTableProps = {
 export type TableInHtmlTableProps = {
   /**
    * The Id of the Table in the Store to be rendered.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly tableId: Id;
   /**
    * The Store to be accessed: omit for the default context Store, provide an Id
    * for a named context Store, or provide an explicit reference.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly store?: StoreOrStoreId;
   /**
    * Whether the Cells should be editable. This affects the default CellView
    * component (to use the EditableCellView component instead) but of course
    * will not affect custom Cell components if you have set them.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly editable?: boolean;
   /**
@@ -125,6 +149,8 @@ export type TableInHtmlTableProps = {
    * Cell Ids as keys, and with a value that can either be a string label to
    * show in the column header, or a CustomCell object to further configure the
    * column.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly customCells?: Ids | {[cellId: Id]: string | CustomCell};
 };
@@ -138,34 +164,48 @@ export type TableInHtmlTableProps = {
 export type SortedTableInHtmlTableProps = {
   /**
    * The Id of the Table in the Store to be rendered.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly tableId: Id;
   /**
    * The Id of the Cell whose values are used for the sorting. If omitted, the
    * view will sort the Row Id itself.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly cellId?: Id;
   /**
    * Whether the sorting should be in descending order.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly descending?: boolean;
   /**
    * The number of Row Ids to skip for pagination purposes.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly offset?: number;
   /**
    * The maximum number of Row Ids to return.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly limit?: number;
   /**
    * The Store to be accessed: omit for the default context Store, provide an Id
    * for a named context Store, or provide an explicit reference.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly store?: StoreOrStoreId;
   /**
    * Whether the Cells should be editable. This affects the default CellView
    * component (to use the EditableCellView component instead) but of course
    * will not affect custom Cell components if you have set them.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly editable?: boolean;
   /**
@@ -174,22 +214,30 @@ export type SortedTableInHtmlTableProps = {
    * Cell Ids as keys, and with a value that can either be a string label to
    * show in the column header, or a CustomCell object to further configure the
    * column.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly customCells?: Ids | {[cellId: Id]: string | CustomCell};
   /**
    * Whether the table should be interactive such that clicking a header changes
    * the sorting and/or direction.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly sortOnClick?: boolean;
   /**
    * Either `true` to show the default SortedTablePaginator for the Table, or
    * provide your own paginator component that takes SortedTablePaginatorProps.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly paginator?: boolean | ComponentType<SortedTablePaginatorProps>;
   /**
    * A function that is called whenever the sorting or pagination of the Table
    * is changed by the user, invoked with the sorted Cell Id, whether descending
    * or not, and the offset of the pagination.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly onChange?: (
     sortAndOffset: [
@@ -210,22 +258,30 @@ export type ValuesInHtmlTableProps = {
   /**
    * The Store to be accessed: omit for the default context Store, provide an Id
    * for a named context Store, or provide an explicit reference.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly store?: StoreOrStoreId;
   /**
    * Whether the Values should be editable. This affects the default ValueView
    * component (to use the EditableValueView component instead) but of course
    * will not affect a custom valueComponent if you have set one.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly editable?: boolean;
   /**
    * A custom component for rendering each Value in the Store (to override the
    * default ValueView component).
+   * @category Prop
+   * @since v4.1.0
    */
   readonly valueComponent?: ComponentType<ValueProps>;
   /**
    * A function for generating extra props for each custom Value component based
    * on its Id.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly getValueComponentProps?: (valueId: Id) => ExtraProps;
 };
@@ -239,22 +295,30 @@ export type ValuesInHtmlTableProps = {
 export type SliceInHtmlTableProps = {
   /**
    * The Id of the Index in the Indexes object.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly indexId: Id;
   /**
    * The Id of the Slice in the Index to be rendered.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly sliceId: Id;
   /**
    * The Indexes object to be accessed: omit for the default context Indexes
    * object, provide an Id for a named context Indexes object, or provide an
    * explicit reference.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly indexes?: IndexesOrIndexesId;
   /**
    * Whether the Cells should be editable. This affects the default CellView
    * component (to use the EditableCellView component instead) but of course
    * will not affect custom Cell components if you have set them.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly editable?: boolean;
   /**
@@ -263,6 +327,8 @@ export type SliceInHtmlTableProps = {
    * Cell Ids as keys, and with a value that can either be a string label to
    * show in the column header, or a CustomCell object to further configure the
    * column.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly customCells?: Ids | {[cellId: Id]: string | CustomCell};
 };
@@ -283,18 +349,24 @@ export type RelationshipInHtmlTableProps = {
   /**
    * The Id of the relationship in the Relationships object for which the
    * relationship Table Rows will be rendered.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly relationshipId: Id;
   /**
    * The Relationships object to be accessed: omit for the default context
    * Relationships object, provide an Id for a named context Relationships
    * object, or provide an explicit reference.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly relationships?: RelationshipsOrRelationshipsId;
   /**
    * Whether the Cells should be editable. This affects the default CellView
    * component (to use the EditableCellView component instead) but of course
    * will not affect custom Cell components if you have set them.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly editable?: boolean;
   /**
@@ -304,6 +376,8 @@ export type RelationshipInHtmlTableProps = {
    * pairs as keys, and with a value that can either be a string label to show
    * in the column header, or a CustomCell object to further configure the
    * column.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly customCells?: Ids | {[cellId: Id]: string | CustomCell};
 };
@@ -318,12 +392,16 @@ export type ResultTableInHtmlTableProps = {
   /**
    * The Id of the query in the Queries object for which the ResultTable will be
    * rendered.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly queryId: Id;
   /**
    * The Queries object to be accessed: omit for the default context Queries
    * object, provide an Id for a named context Queries object, or provide an
    * explicit reference.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly queries?: QueriesOrQueriesId;
   /**
@@ -332,6 +410,8 @@ export type ResultTableInHtmlTableProps = {
    * desired Cell Ids as keys, and with a value that can either be a string
    * label to show in the column header, or a ResultCustomCell object to further
    * configure the column.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly customCells?: Ids | {[cellId: Id]: string | CustomResultCell};
 };
@@ -347,29 +427,41 @@ export type ResultSortedTableInHtmlTableProps = {
   /**
    * The Id of the query in the Queries object for which the ResultTable will be
    * rendered.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly queryId: Id;
   /**
    * The Id of the Cell whose values are used for the sorting. If omitted, the
    * view will sort the Row Id itself.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly cellId?: Id;
   /**
    * Whether the sorting should be in descending order.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly descending?: boolean;
   /**
    * The number of Row Ids to skip for pagination purposes.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly offset?: number;
   /**
    * The maximum number of Row Ids to return.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly limit?: number;
   /**
    * The Queries object to be accessed: omit for the default context Queries
    * object, provide an Id for a named context Queries object, or provide an
    * explicit reference.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly queries?: QueriesOrQueriesId;
   /**
@@ -378,23 +470,31 @@ export type ResultSortedTableInHtmlTableProps = {
    * desired Cell Ids as keys, and with a value that can either be a string
    * label to show in the column header, or a ResultCustomCell object to further
    * configure the column.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly customCells?: Ids | {[cellId: Id]: string | CustomResultCell};
   /**
    * Whether the table should be interactive such that clicking a header changes
    * the sorting and/or direction.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly sortOnClick?: boolean;
   /**
    * Either `true` to show the default SortedTablePaginator for the ResultTable,
    * or provide your own paginator component that takes
    * SortedTablePaginatorProps.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly paginator?: boolean | ComponentType<SortedTablePaginatorProps>;
   /**
    * A function that is called whenever the sorting or pagination of the
    * ResultTable is changed by the user, invoked with the sorted Cell Id,
    * whether descending or not, and the offset of the pagination.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly onChange?: (
     sortAndOffset: [
@@ -415,28 +515,40 @@ export type SortedTablePaginatorProps = {
   /**
    * An event that will fire when the offset is updated, called with the new
    * offset.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly onChange: (offset: number) => void;
   /**
    * The number of Row Ids to skip for pagination.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly offset?: number;
   /**
    * The maximum number of Row Ids being returned.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly limit?: number;
   /**
    * The total number of Row Ids in the paginated table.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly total: number;
   /**
    * A noun to use in the pagination label for a single row, defaulting to
    * 'row'.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly singular?: string;
   /**
    * A noun to use in the pagination label for multiple rows, defaulting to the
    * value of the singular noun suffixed with the letter 's'.
+   * @category Prop
+   * @since v4.1.0
    */
   readonly plural?: string;
 };