tinybase 5.0.1 → 5.0.3

package/@types/ui-react/with-schemas/index.d.cts

@@ -3000,7 +3000,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @param getTableDeps An optional array of dependencies for the `getTable`
  * function, which, if any change, result in the regeneration of the callback.
  * This parameter defaults to an empty array. Also use this to indicate the
- * dependencies of a GetId functions if used as the tableId argument.
+ * dependencies of a GetId function if used as the tableId argument.
  * @param storeOrStoreId The Store to be updated: omit for the default context
  * Store, provide an Id for a named context Store, or provide an explicit
  * reference.
@@ -3237,7 +3237,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @param getRowDeps An optional array of dependencies for the `getRow`
  * function, which, if any change, result in the regeneration of the callback.
  * This parameter defaults to an empty array. Also use this to indicate the
- * dependencies of a GetId functions if used as the tableId argument.
+ * dependencies of a GetId function if used as the tableId argument.
  * @param storeOrStoreId The Store to be updated: omit for the default context
  * Store, provide an Id for a named context Store, or provide an explicit
  * reference.
@@ -3934,7 +3934,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * ```
  *
  * This hook is useful, for example, when creating an event handler that will
- * delete data in a Store.
+ * delete data in the Store.
  *
  * For convenience, you can optionally provide a `then` function (with its own
  * set of dependencies) which will be called just after the Store has been
@@ -3998,22 +3998,23 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
   ) => Callback;
 
   /**
- * The useDelTableCallback hook returns a callback that can be used to remove a
- * single Table from a Store.
+ * The useDelTableCallback hook returns a parameterized callback that can be
+ * used to remove a single Table from a Store.
  *
  * This has schema-based typing. The following is a simplified representation:
  *
  * ```ts override
- * useDelTableCallback(
- *   tableId: Id,
+ * useDelTableCallback<Parameter>(
+ *   tableId: Id | GetId<Parameter>,
  *   storeOrStoreId?: StoreOrStoreId,
  *   then?: (store: Store) => void,
  *   thenDeps?: React.DependencyList,
- * ): Callback;
+ * ): ParameterizedCallback<Parameter>;
  * ```
  *
  * This hook is useful, for example, when creating an event handler that will
- * delete data in a Store.
+ * delete data in the Store. In this case, the parameter will likely be the
+ * event, so that you can use data from it as part of the deletion.
  *
  * For convenience, you can optionally provide a `then` function (with its own
  * set of dependencies) which will be called just after the Store has been
@@ -4023,7 +4024,8 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * The Store to which the callback will make the deletion (indicated by the
  * hook's `storeOrStoreId` parameter) is always automatically used as a hook
  * dependency for the callback.
- * @param tableId The Id of the Table in the Store.
+ * @param tableId The Id of the Table in the Store to delete, or a GetId
+ * function that will return it.
  * @param storeOrStoreId The Store to be updated: omit for the default context
  * Store, provide an Id for a named context Store, or provide an explicit
  * reference.
@@ -4031,8 +4033,9 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * to the Store.
  * @param thenDeps An optional array of dependencies for the `then` function,
  * which, if any change, result in the regeneration of the callback. This
- * parameter defaults to an empty array.
- * @returns A callback for subsequent use.
+ * parameter defaults to an empty array. Also use this to indicate the
+ * dependencies of an GetId function if used as the tableId argument.
+ * @returns A parameterized callback for subsequent use.
  * @example
  * This example uses the useDelTableCallback hook to create an event handler
  * which deletes from the Store when the `span` element is clicked.
@@ -4071,31 +4074,35 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @category Store hooks
  * @since v1.0.0
  */
-  useDelTableCallback: <TableId extends TableIdFromSchema<Schemas[0]>>(
-    tableId: TableId,
+  useDelTableCallback: <
+    Parameter,
+    TableId extends TableIdFromSchema<Schemas[0]>,
+  >(
+    tableId: TableId | GetId<Schemas, Parameter, TableId>,
     storeOrStoreId?: StoreOrStoreId<Schemas>,
     then?: (store: Store<Schemas>) => void,
     thenDeps?: React.DependencyList,
-  ) => Callback;
+  ) => ParameterizedCallback<Parameter>;
 
   /**
- * The useDelRowCallback hook returns a callback that can be used to remove a
- * single Row from a Table.
+ * The useDelRowCallback hook returns a parameterized callback that can be used
+ * to remove a single Row from a Table.
  *
  * This has schema-based typing. The following is a simplified representation:
  *
  * ```ts override
- * useDelRowCallback(
- *   tableId: Id,
- *   rowId: Id,
+ * useDelRowCallback<Parameter>(
+ *   tableId: Id | GetId<Parameter>,
+ *   rowId: Id | GetId<Parameter>,
  *   storeOrStoreId?: StoreOrStoreId,
  *   then?: (store: Store) => void,
  *   thenDeps?: React.DependencyList,
- * ): Callback;
+ * ): ParameterizedCallback<Parameter>;
  * ```
  *
  * This hook is useful, for example, when creating an event handler that will
- * delete data in a Store.
+ * delete data in the Store. In this case, the parameter will likely be the
+ * event, so that you can use data from it as part of the deletion.
  *
  * For convenience, you can optionally provide a `then` function (with its own
  * set of dependencies) which will be called just after the Store has been
@@ -4105,8 +4112,10 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * The Store to which the callback will make the deletion (indicated by the
  * hook's `storeOrStoreId` parameter) is always automatically used as a hook
  * dependency for the callback.
- * @param tableId The Id of the Table in the Store.
- * @param rowId The Id of the Row in the Table.
+ * @param tableId The Id of the Table in the Store, or a GetId function that
+ * will return it.
+ * @param rowId The Id of the Row in the Table to delete, or a GetId function
+ * that will return it.
  * @param storeOrStoreId The Store to be updated: omit for the default context
  * Store, provide an Id for a named context Store, or provide an explicit
  * reference.
@@ -4114,8 +4123,10 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * to the Store.
  * @param thenDeps An optional array of dependencies for the `then` function,
  * which, if any change, result in the regeneration of the callback. This
- * parameter defaults to an empty array.
- * @returns A callback for subsequent use.
+ * parameter defaults to an empty array. Also use this to indicate the
+ * dependencies of any GetId functions if used as the tableId or rowId
+ * arguments.
+ * @returns A parameterized callback for subsequent use.
  * @example
  * This example uses the useDelRowCallback hook to create an event handler which
  * deletes from the Store when the `span` element is clicked.
@@ -4154,34 +4165,35 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @category Store hooks
  * @since v1.0.0
  */
-  useDelRowCallback: <TableId extends TableIdFromSchema<Schemas[0]>>(
-    tableId: TableId,
-    rowId: Id,
+  useDelRowCallback: <Parameter, TableId extends TableIdFromSchema<Schemas[0]>>(
+    tableId: TableId | GetId<Schemas, Parameter, TableId>,
+    rowId: Id | GetId<Schemas, Parameter, Id>,
     storeOrStoreId?: StoreOrStoreId<Schemas>,
     then?: (store: Store<Schemas>) => void,
     thenDeps?: React.DependencyList,
-  ) => Callback;
+  ) => ParameterizedCallback<Parameter>;
 
   /**
- * The useDelCellCallback hook returns a callback that can be used to remove a
- * single Cell from a Row.
+ * The useDelCellCallback hook returns a parameterized callback that can be used
+ * to remove a single Cell from a Row.
  *
  * This has schema-based typing. The following is a simplified representation:
  *
  * ```ts override
- * useDelCellCallback(
- *   tableId: Id,
- *   rowId: Id,
- *   cellId: Id,
+ * useDelCellCallback<Parameter>(
+ *   tableId: Id | GetId<Parameter>,
+ *   rowId: Id | GetId<Parameter>,
+ *   cellId: Id | GetId<Parameter>,
  *   forceDel?: boolean,
  *   storeOrStoreId?: StoreOrStoreId,
  *   then?: (store: Store) => void,
  *   thenDeps?: React.DependencyList,
- * ): Callback;
+ * ): ParameterizedCallback<Parameter>;
  * ```
  *
  * This hook is useful, for example, when creating an event handler that will
- * delete data in a Store.
+ * delete data in the Store. In this case, the parameter will likely be the
+ * event, so that you can use data from it as part of the deletion.
  *
  * For convenience, you can optionally provide a `then` function (with its own
  * set of dependencies) which will be called just after the Store has been
@@ -4191,9 +4203,12 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * The Store to which the callback will make the deletion (indicated by the
  * hook's `storeOrStoreId` parameter) is always automatically used as a hook
  * dependency for the callback.
- * @param tableId The Id of the Table in the Store.
- * @param rowId The Id of the Row in the Table.
- * @param cellId The Id of the Cell in the Row.
+ * @param tableId The Id of the Table in the Store, or a GetId function that
+ * will return it.
+ * @param rowId The Id of the Row in the Table, or a GetId function that will
+ * return it.
+ * @param cellId The Id of the Cell in the Row to delete, or a GetId function
+ * that will return it.
  * @param forceDel An optional flag to indicate that the whole Row should be
  * deleted, even if a TablesSchema provides a default value for this Cell.
  * Defaults to `false`.
@@ -4204,8 +4219,10 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * to the Store.
  * @param thenDeps An optional array of dependencies for the `then` function,
  * which, if any change, result in the regeneration of the callback. This
- * parameter defaults to an empty array.
- * @returns A callback for subsequent use.
+ * parameter defaults to an empty array. Also use this to indicate the
+ * dependencies of any GetId functions if used as the tableId, rowId, or cellId
+ * arguments.
+ * @returns A parameterized callback for subsequent use.
  * @example
  * This example uses the useDelCellCallback hook to create an event handler
  * which deletes from the Store when the `span` element is clicked.
@@ -4250,17 +4267,18 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @since v1.0.0
  */
   useDelCellCallback: <
+    Parameter,
     TableId extends TableIdFromSchema<Schemas[0]>,
     CellId extends CellIdFromSchema<Schemas[0], TableId>,
   >(
-    tableId: TableId,
-    rowId: Id,
-    cellId: CellId,
+    tableId: TableId | GetId<Schemas, Parameter, TableId>,
+    rowId: Id | GetId<Schemas, Parameter, Id>,
+    cellId: CellId | GetId<Schemas, Parameter, CellId>,
     forceDel?: boolean,
     storeOrStoreId?: StoreOrStoreId<Schemas>,
     then?: (store: Store<Schemas>) => void,
     thenDeps?: React.DependencyList,
-  ) => Callback;
+  ) => ParameterizedCallback<Parameter>;
 
   /**
  * The useDelValuesCallback hook returns a callback that can be used to remove
@@ -4341,22 +4359,23 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
   ) => Callback;
 
   /**
- * The useDelValueCallback hook returns a callback that can be used to remove a
- * single Value from a Store.
+ * The useDelValueCallback hook returns a parameterized callback that can be
+ * used to remove a single Value from a Store.
  *
  * This has schema-based typing. The following is a simplified representation:
  *
  * ```ts override
- * useDelValueCallback(
- *   valueId: Id,
+ * useDelValueCallback<Parameter>(
+ *   valueId: Id | GetId<Parameter>,
  *   storeOrStoreId?: StoreOrStoreId,
  *   then?: (store: Store) => void,
  *   thenDeps?: React.DependencyList,
- * ): Callback;
+ * ): ParameterizedCallback<Parameter>;
  * ```
  *
  * This hook is useful, for example, when creating an event handler that will
- * delete data in a Store.
+ * delete data in the Store. In this case, the parameter will likely be the
+ * event, so that you can use data from it as part of the deletion.
  *
  * For convenience, you can optionally provide a `then` function (with its own
  * set of dependencies) which will be called just after the Store has been
@@ -4366,7 +4385,8 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * The Store to which the callback will make the deletion (indicated by the
  * hook's `storeOrStoreId` parameter) is always automatically used as a hook
  * dependency for the callback.
- * @param valueId The Id of the Value in the Store.
+ * @param valueId The Id of the Value in the Store to delete, or a GetId
+ * function that will return it.
  * @param storeOrStoreId The Store to be updated: omit for the default context
  * Store, provide an Id for a named context Store, or provide an explicit
  * reference.
@@ -4374,8 +4394,9 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * to the Store.
  * @param thenDeps An optional array of dependencies for the `then` function,
  * which, if any change, result in the regeneration of the callback. This
- * parameter defaults to an empty array.
- * @returns A callback for subsequent use.
+ * parameter defaults to an empty array. Also use this to indicate the
+ * dependencies of a GetId function if used as the valueId argument.
+ * @returns A parameterized callback for subsequent use.
  * @example
  * This example uses the useDelValueCallback hook to create an event handler
  * which deletes from the Store when the `span` element is clicked.
@@ -4414,12 +4435,15 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @category Store hooks
  * @since v3.0.0
  */
-  useDelValueCallback: <ValueId extends ValueIdFromSchema<Schemas[1]>>(
-    valueId: ValueId,
+  useDelValueCallback: <
+    Parameter,
+    ValueId extends ValueIdFromSchema<Schemas[1]>,
+  >(
+    valueId: ValueId | GetId<Schemas, Parameter, ValueId>,
     storeOrStoreId?: StoreOrStoreId<Schemas>,
     then?: (store: Store<Schemas>) => void,
     thenDeps?: React.DependencyList,
-  ) => Callback;
+  ) => ParameterizedCallback<Parameter>;
 
   /**
  * The useHasTablesListener hook registers a listener function with the Store

package/@types/ui-react/with-schemas/index.d.ts

@@ -3000,7 +3000,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @param getTableDeps An optional array of dependencies for the `getTable`
  * function, which, if any change, result in the regeneration of the callback.
  * This parameter defaults to an empty array. Also use this to indicate the
- * dependencies of a GetId functions if used as the tableId argument.
+ * dependencies of a GetId function if used as the tableId argument.
  * @param storeOrStoreId The Store to be updated: omit for the default context
  * Store, provide an Id for a named context Store, or provide an explicit
  * reference.
@@ -3237,7 +3237,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @param getRowDeps An optional array of dependencies for the `getRow`
  * function, which, if any change, result in the regeneration of the callback.
  * This parameter defaults to an empty array. Also use this to indicate the
- * dependencies of a GetId functions if used as the tableId argument.
+ * dependencies of a GetId function if used as the tableId argument.
  * @param storeOrStoreId The Store to be updated: omit for the default context
  * Store, provide an Id for a named context Store, or provide an explicit
  * reference.
@@ -3934,7 +3934,7 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * ```
  *
  * This hook is useful, for example, when creating an event handler that will
- * delete data in a Store.
+ * delete data in the Store.
  *
  * For convenience, you can optionally provide a `then` function (with its own
  * set of dependencies) which will be called just after the Store has been
@@ -3998,22 +3998,23 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
   ) => Callback;
 
   /**
- * The useDelTableCallback hook returns a callback that can be used to remove a
- * single Table from a Store.
+ * The useDelTableCallback hook returns a parameterized callback that can be
+ * used to remove a single Table from a Store.
  *
  * This has schema-based typing. The following is a simplified representation:
  *
  * ```ts override
- * useDelTableCallback(
- *   tableId: Id,
+ * useDelTableCallback<Parameter>(
+ *   tableId: Id | GetId<Parameter>,
  *   storeOrStoreId?: StoreOrStoreId,
  *   then?: (store: Store) => void,
  *   thenDeps?: React.DependencyList,
- * ): Callback;
+ * ): ParameterizedCallback<Parameter>;
  * ```
  *
  * This hook is useful, for example, when creating an event handler that will
- * delete data in a Store.
+ * delete data in the Store. In this case, the parameter will likely be the
+ * event, so that you can use data from it as part of the deletion.
  *
  * For convenience, you can optionally provide a `then` function (with its own
  * set of dependencies) which will be called just after the Store has been
@@ -4023,7 +4024,8 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * The Store to which the callback will make the deletion (indicated by the
  * hook's `storeOrStoreId` parameter) is always automatically used as a hook
  * dependency for the callback.
- * @param tableId The Id of the Table in the Store.
+ * @param tableId The Id of the Table in the Store to delete, or a GetId
+ * function that will return it.
  * @param storeOrStoreId The Store to be updated: omit for the default context
  * Store, provide an Id for a named context Store, or provide an explicit
  * reference.
@@ -4031,8 +4033,9 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * to the Store.
  * @param thenDeps An optional array of dependencies for the `then` function,
  * which, if any change, result in the regeneration of the callback. This
- * parameter defaults to an empty array.
- * @returns A callback for subsequent use.
+ * parameter defaults to an empty array. Also use this to indicate the
+ * dependencies of an GetId function if used as the tableId argument.
+ * @returns A parameterized callback for subsequent use.
  * @example
  * This example uses the useDelTableCallback hook to create an event handler
  * which deletes from the Store when the `span` element is clicked.
@@ -4071,31 +4074,35 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @category Store hooks
  * @since v1.0.0
  */
-  useDelTableCallback: <TableId extends TableIdFromSchema<Schemas[0]>>(
-    tableId: TableId,
+  useDelTableCallback: <
+    Parameter,
+    TableId extends TableIdFromSchema<Schemas[0]>,
+  >(
+    tableId: TableId | GetId<Schemas, Parameter, TableId>,
     storeOrStoreId?: StoreOrStoreId<Schemas>,
     then?: (store: Store<Schemas>) => void,
     thenDeps?: React.DependencyList,
-  ) => Callback;
+  ) => ParameterizedCallback<Parameter>;
 
   /**
- * The useDelRowCallback hook returns a callback that can be used to remove a
- * single Row from a Table.
+ * The useDelRowCallback hook returns a parameterized callback that can be used
+ * to remove a single Row from a Table.
  *
  * This has schema-based typing. The following is a simplified representation:
  *
  * ```ts override
- * useDelRowCallback(
- *   tableId: Id,
- *   rowId: Id,
+ * useDelRowCallback<Parameter>(
+ *   tableId: Id | GetId<Parameter>,
+ *   rowId: Id | GetId<Parameter>,
  *   storeOrStoreId?: StoreOrStoreId,
  *   then?: (store: Store) => void,
  *   thenDeps?: React.DependencyList,
- * ): Callback;
+ * ): ParameterizedCallback<Parameter>;
  * ```
  *
  * This hook is useful, for example, when creating an event handler that will
- * delete data in a Store.
+ * delete data in the Store. In this case, the parameter will likely be the
+ * event, so that you can use data from it as part of the deletion.
  *
  * For convenience, you can optionally provide a `then` function (with its own
  * set of dependencies) which will be called just after the Store has been
@@ -4105,8 +4112,10 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * The Store to which the callback will make the deletion (indicated by the
  * hook's `storeOrStoreId` parameter) is always automatically used as a hook
  * dependency for the callback.
- * @param tableId The Id of the Table in the Store.
- * @param rowId The Id of the Row in the Table.
+ * @param tableId The Id of the Table in the Store, or a GetId function that
+ * will return it.
+ * @param rowId The Id of the Row in the Table to delete, or a GetId function
+ * that will return it.
  * @param storeOrStoreId The Store to be updated: omit for the default context
  * Store, provide an Id for a named context Store, or provide an explicit
  * reference.
@@ -4114,8 +4123,10 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * to the Store.
  * @param thenDeps An optional array of dependencies for the `then` function,
  * which, if any change, result in the regeneration of the callback. This
- * parameter defaults to an empty array.
- * @returns A callback for subsequent use.
+ * parameter defaults to an empty array. Also use this to indicate the
+ * dependencies of any GetId functions if used as the tableId or rowId
+ * arguments.
+ * @returns A parameterized callback for subsequent use.
  * @example
  * This example uses the useDelRowCallback hook to create an event handler which
  * deletes from the Store when the `span` element is clicked.
@@ -4154,34 +4165,35 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @category Store hooks
  * @since v1.0.0
  */
-  useDelRowCallback: <TableId extends TableIdFromSchema<Schemas[0]>>(
-    tableId: TableId,
-    rowId: Id,
+  useDelRowCallback: <Parameter, TableId extends TableIdFromSchema<Schemas[0]>>(
+    tableId: TableId | GetId<Schemas, Parameter, TableId>,
+    rowId: Id | GetId<Schemas, Parameter, Id>,
     storeOrStoreId?: StoreOrStoreId<Schemas>,
     then?: (store: Store<Schemas>) => void,
     thenDeps?: React.DependencyList,
-  ) => Callback;
+  ) => ParameterizedCallback<Parameter>;
 
   /**
- * The useDelCellCallback hook returns a callback that can be used to remove a
- * single Cell from a Row.
+ * The useDelCellCallback hook returns a parameterized callback that can be used
+ * to remove a single Cell from a Row.
  *
  * This has schema-based typing. The following is a simplified representation:
  *
  * ```ts override
- * useDelCellCallback(
- *   tableId: Id,
- *   rowId: Id,
- *   cellId: Id,
+ * useDelCellCallback<Parameter>(
+ *   tableId: Id | GetId<Parameter>,
+ *   rowId: Id | GetId<Parameter>,
+ *   cellId: Id | GetId<Parameter>,
  *   forceDel?: boolean,
  *   storeOrStoreId?: StoreOrStoreId,
  *   then?: (store: Store) => void,
  *   thenDeps?: React.DependencyList,
- * ): Callback;
+ * ): ParameterizedCallback<Parameter>;
  * ```
  *
  * This hook is useful, for example, when creating an event handler that will
- * delete data in a Store.
+ * delete data in the Store. In this case, the parameter will likely be the
+ * event, so that you can use data from it as part of the deletion.
  *
  * For convenience, you can optionally provide a `then` function (with its own
  * set of dependencies) which will be called just after the Store has been
@@ -4191,9 +4203,12 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * The Store to which the callback will make the deletion (indicated by the
  * hook's `storeOrStoreId` parameter) is always automatically used as a hook
  * dependency for the callback.
- * @param tableId The Id of the Table in the Store.
- * @param rowId The Id of the Row in the Table.
- * @param cellId The Id of the Cell in the Row.
+ * @param tableId The Id of the Table in the Store, or a GetId function that
+ * will return it.
+ * @param rowId The Id of the Row in the Table, or a GetId function that will
+ * return it.
+ * @param cellId The Id of the Cell in the Row to delete, or a GetId function
+ * that will return it.
  * @param forceDel An optional flag to indicate that the whole Row should be
  * deleted, even if a TablesSchema provides a default value for this Cell.
  * Defaults to `false`.
@@ -4204,8 +4219,10 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * to the Store.
  * @param thenDeps An optional array of dependencies for the `then` function,
  * which, if any change, result in the regeneration of the callback. This
- * parameter defaults to an empty array.
- * @returns A callback for subsequent use.
+ * parameter defaults to an empty array. Also use this to indicate the
+ * dependencies of any GetId functions if used as the tableId, rowId, or cellId
+ * arguments.
+ * @returns A parameterized callback for subsequent use.
  * @example
  * This example uses the useDelCellCallback hook to create an event handler
  * which deletes from the Store when the `span` element is clicked.
@@ -4250,17 +4267,18 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @since v1.0.0
  */
   useDelCellCallback: <
+    Parameter,
     TableId extends TableIdFromSchema<Schemas[0]>,
     CellId extends CellIdFromSchema<Schemas[0], TableId>,
   >(
-    tableId: TableId,
-    rowId: Id,
-    cellId: CellId,
+    tableId: TableId | GetId<Schemas, Parameter, TableId>,
+    rowId: Id | GetId<Schemas, Parameter, Id>,
+    cellId: CellId | GetId<Schemas, Parameter, CellId>,
     forceDel?: boolean,
     storeOrStoreId?: StoreOrStoreId<Schemas>,
     then?: (store: Store<Schemas>) => void,
     thenDeps?: React.DependencyList,
-  ) => Callback;
+  ) => ParameterizedCallback<Parameter>;
 
   /**
  * The useDelValuesCallback hook returns a callback that can be used to remove
@@ -4341,22 +4359,23 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
   ) => Callback;
 
   /**
- * The useDelValueCallback hook returns a callback that can be used to remove a
- * single Value from a Store.
+ * The useDelValueCallback hook returns a parameterized callback that can be
+ * used to remove a single Value from a Store.
  *
  * This has schema-based typing. The following is a simplified representation:
  *
  * ```ts override
- * useDelValueCallback(
- *   valueId: Id,
+ * useDelValueCallback<Parameter>(
+ *   valueId: Id | GetId<Parameter>,
  *   storeOrStoreId?: StoreOrStoreId,
  *   then?: (store: Store) => void,
  *   thenDeps?: React.DependencyList,
- * ): Callback;
+ * ): ParameterizedCallback<Parameter>;
  * ```
  *
  * This hook is useful, for example, when creating an event handler that will
- * delete data in a Store.
+ * delete data in the Store. In this case, the parameter will likely be the
+ * event, so that you can use data from it as part of the deletion.
  *
  * For convenience, you can optionally provide a `then` function (with its own
  * set of dependencies) which will be called just after the Store has been
@@ -4366,7 +4385,8 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * The Store to which the callback will make the deletion (indicated by the
  * hook's `storeOrStoreId` parameter) is always automatically used as a hook
  * dependency for the callback.
- * @param valueId The Id of the Value in the Store.
+ * @param valueId The Id of the Value in the Store to delete, or a GetId
+ * function that will return it.
  * @param storeOrStoreId The Store to be updated: omit for the default context
  * Store, provide an Id for a named context Store, or provide an explicit
  * reference.
@@ -4374,8 +4394,9 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * to the Store.
  * @param thenDeps An optional array of dependencies for the `then` function,
  * which, if any change, result in the regeneration of the callback. This
- * parameter defaults to an empty array.
- * @returns A callback for subsequent use.
+ * parameter defaults to an empty array. Also use this to indicate the
+ * dependencies of a GetId function if used as the valueId argument.
+ * @returns A parameterized callback for subsequent use.
  * @example
  * This example uses the useDelValueCallback hook to create an event handler
  * which deletes from the Store when the `span` element is clicked.
@@ -4414,12 +4435,15 @@ export type WithSchemas<Schemas extends OptionalSchemas> = {
  * @category Store hooks
  * @since v3.0.0
  */
-  useDelValueCallback: <ValueId extends ValueIdFromSchema<Schemas[1]>>(
-    valueId: ValueId,
+  useDelValueCallback: <
+    Parameter,
+    ValueId extends ValueIdFromSchema<Schemas[1]>,
+  >(
+    valueId: ValueId | GetId<Schemas, Parameter, ValueId>,
     storeOrStoreId?: StoreOrStoreId<Schemas>,
     then?: (store: Store<Schemas>) => void,
     thenDeps?: React.DependencyList,
-  ) => Callback;
+  ) => ParameterizedCallback<Parameter>;
 
   /**
  * The useHasTablesListener hook registers a listener function with the Store

package/cjs/es6/min/synchronizers/synchronizer-ws-server/index.cjs

@@ -1 +1 @@
-"use strict";const n=n=>null==n,e=(e,l,t)=>n(e)?null==t?void 0:t():l(e),l=(n,e,l)=>n.slice(e,l),t=n=>n.length,r=(n,e)=>n.forEach(e),s=(n,...e)=>n.push(...e),u=Object.freeze,o=n=>{var e;return null!=(e=null==n?void 0:n.size)?e:0},d=(a=o,n=>{return e=(n,e)=>n+a(e),i(n).reduce(e,0);var e});var a;const c=e=>n(e)||0==o(e),i=n=>{var e;return[...null!=(e=null==n?void 0:n.values())?e:[]]},v=(n,e)=>null==n?void 0:n.forEach(e),h=(n,e)=>null==n?void 0:n.delete(e),f=n=>new Map(n),g=n=>{var e;return[...null!=(e=null==n?void 0:n.keys())?e:[]]},S=(n,e)=>null==n?void 0:n.get(e),y=(e,l,t)=>n(t)?(h(e,l),e):null==e?void 0:e.set(l,t),k=(n,e,l,t)=>{var r,s,u;return s=e,null!=(u=null==(r=n)?void 0:r.has(s))&&u?null==t||t(S(n,e)):y(n,e,l()),S(n,e)},p=(n,l,r,s,u=0)=>e((r?k:S)(n,l[u],u>t(l)-2?r:f),(e=>{if(u>t(l)-2)return(null==s?void 0:s(e))&&y(n,l[u]),e;const o=p(e,l,r,s,u+1);return c(e)&&y(n,l[u]),o})),I=e=>new Set(Array.isArray(e)||n(e)?e:[e]),b=/^\d+$/,w=/\/([^?]*)/;exports.createWsServer=a=>{const i=f(),z=f(),L=f(),[m,x,A]=(l=>{let u;const[o,d]=(()=>{const n=[];let e=0;return[l=>{var t;return null!=(t=l?n.shift():null)?t:""+e++},e=>{b.test(e)&&t(n)<1e3&&s(n,e)}]})(),a=f();return[(n,e,l,t=[],r=(()=>[]))=>{null!=u||(u=C);const s=o(1);var d,c;return y(a,s,[n,e,l,t,r]),c=s,null==(d=p(e,null!=l?l:[""],I))||d.add(c),s},(n,e,...l)=>r(((n,e=[""])=>{const l=[],u=(n,o)=>o==t(e)?s(l,n):null===e[o]?v(n,(n=>u(n,o+1))):r([e[o],null],(e=>u(S(n,e),o+1)));return u(n,0),l})(n,e),(n=>v(n,(n=>S(a,n)[0](u,...null!=e?e:[],...l))))),n=>e(S(a,n),(([,e,l])=>(p(e,null!=l?l:[""],void 0,(e=>(h(e,n),c(e)?1:0))),y(a,n),d(n),l))),l=>e(S(a,l),(([e,,l=[],s,o])=>{const d=(...a)=>{var c,i;const v=t(a);v==t(l)?e(u,...a,...o(a)):n(l[v])?r(null!=(i=null==(c=s[v])?void 0:c.call(s,...a))?i:[],(n=>d(...a,n))):d(...a,l[v])};d()}))]})();a.on("connection",((n,t)=>{var r;return e(null==(r=t.url)?void 0:r.match(w),(([,r])=>e(t.headers["sec-websocket-key"],(e=>{const t=k(L,r,f);y(t,e,n),1==t.size&&x(i,void 0,(()=>({[r]:1}))),x(z,[r],(()=>({[e]:1}))),n.on("message",(n=>{var r;const s=n.toString("utf8"),u=s.indexOf("\n");if(-1!==u){const n=l(s,0,u),d=l(s,u+1);""===n?(o=(n,l)=>n!=e?l.send(e+"\n"+d):0,v(t,((n,e)=>o(e,n)))):null==(r=S(t,n))||r.send(e+"\n"+d)}var o})),n.on("close",(()=>{h(t,e),x(z,[r],(()=>({[e]:-1}))),c(t)&&(h(L,r),x(i,void 0,(()=>({[r]:-1}))))}))}))))}));const C={getWebSocketServer:()=>a,getPathIds:()=>g(L),getClientIds:n=>g(S(L,n)),addPathIdsListener:n=>m(n,i),addClientIdsListener:(n,e)=>m(e,z,[n]),delListener:n=>(A(n),C),getStats:()=>({paths:o(L),clients:d(L)}),destroy:()=>{a.close(),L.clear()}};return u(C)};
+"use strict";const n=n=>null==n,e=(e,l,t)=>n(e)?null==t?void 0:t():l(e),l=(n,e,l)=>n.slice(e,l),t=n=>n.length,r=(n,e)=>n.forEach(e),s=(n,...e)=>n.push(...e),u=Object.freeze,o=n=>{var e;return null!=(e=null==n?void 0:n.size)?e:0},d=(a=o,n=>{return e=(n,e)=>n+a(e),i(n).reduce(e,0);var e});var a;const c=e=>n(e)||0==o(e),i=n=>{var e;return[...null!=(e=null==n?void 0:n.values())?e:[]]},v=(n,e)=>null==n?void 0:n.forEach(e),h=(n,e)=>null==n?void 0:n.delete(e),f=n=>new Map(n),g=n=>{var e;return[...null!=(e=null==n?void 0:n.keys())?e:[]]},S=(n,e)=>null==n?void 0:n.get(e),y=(e,l,t)=>n(t)?(h(e,l),e):null==e?void 0:e.set(l,t),k=(n,e,l,t)=>{var r,s,u;return s=e,null!=(u=null==(r=n)?void 0:r.has(s))&&u?null==t||t(S(n,e)):y(n,e,l()),S(n,e)},p=(n,l,r,s,u=0)=>e((r?k:S)(n,l[u],u>t(l)-2?r:f),(e=>{if(u>t(l)-2)return(null==s?void 0:s(e))&&y(n,l[u]),e;const o=p(e,l,r,s,u+1);return c(e)&&y(n,l[u]),o})),I=e=>new Set(Array.isArray(e)||n(e)?e:[e]),b=/^\d+$/,w=/\/([^?]*)/;exports.createWsServer=a=>{const i=f(),z=f(),L=f(),[m,x,A]=(l=>{let u;const[o,d]=(()=>{const n=[];let e=0;return[l=>{var t;return null!=(t=l?n.shift():null)?t:""+e++},e=>{b.test(e)&&t(n)<1e3&&s(n,e)}]})(),a=f();return[(n,e,l,t=[],r=(()=>[]))=>{null!=u||(u=C);const s=o(1);var d,c;return y(a,s,[n,e,l,t,r]),c=s,null==(d=p(e,null!=l?l:[""],I))||d.add(c),s},(n,e,...l)=>r(((n,e=[""])=>{const l=[],u=(n,o)=>o==t(e)?s(l,n):null===e[o]?v(n,(n=>u(n,o+1))):r([e[o],null],(e=>u(S(n,e),o+1)));return u(n,0),l})(n,e),(n=>v(n,(n=>S(a,n)[0](u,...null!=e?e:[],...l))))),n=>e(S(a,n),(([,e,l])=>(p(e,null!=l?l:[""],void 0,(e=>(h(e,n),c(e)?1:0))),y(a,n),d(n),l))),l=>e(S(a,l),(([e,,l=[],s,o])=>{const d=(...a)=>{var c,i;const v=t(a);v==t(l)?e(u,...a,...o(a)):n(l[v])?r(null!=(i=null==(c=s[v])?void 0:c.call(s,...a))?i:[],(n=>d(...a,n))):d(...a,l[v])};d()}))]})();a.on("connection",((n,t)=>{var r;return e(null==(r=t.url)?void 0:r.match(w),(([,r])=>e(t.headers["sec-websocket-key"],(e=>{const t=k(L,r,f);y(t,e,n),1==t.size&&x(i,void 0,r,1),x(z,[r],e,1),n.on("message",(n=>{var r;const s=n.toString("utf8"),u=s.indexOf("\n");if(-1!==u){const n=l(s,0,u),d=l(s,u+1);""===n?(o=(n,l)=>n!=e?l.send(e+"\n"+d):0,v(t,((n,e)=>o(e,n)))):null==(r=S(t,n))||r.send(e+"\n"+d)}var o})),n.on("close",(()=>{h(t,e),x(z,[r],e,-1),c(t)&&(h(L,r),x(i,void 0,r,-1))}))}))))}));const C={getWebSocketServer:()=>a,getPathIds:()=>g(L),getClientIds:n=>g(S(L,n)),addPathIdsListener:n=>m(n,i),addClientIdsListener:(n,e)=>m(e,z,[n]),delListener:n=>(A(n),C),getStats:()=>({paths:o(L),clients:d(L)}),destroy:()=>{a.close(),L.clear()}};return u(C)};