v2.2.0 - 2025/12/20

Marimo compatibility contributed by @N283T (PR #73)

Added

• Support for Marimo notebooks.
• MolGrid.get_marimo_selection for syncing the mols2grid selection state with other Marimo cells. See scripts/marimo_example.py for an example.

v2.1.0 - 2025/11/15

Minor update to follow the latest practices for interactive widgets.

Changed

• Switched to anywidget as the widget backend.
• Using uv for venv and running tasks.

Added

• ruff and black for linting/formatting.
• poethepoet for managing dev commands.
• Support for python 3.11 to 3.13.
• rdkit is now part of the dependencies.

Removed

• Dropped support for python 3.7 to 3.9

v2.0.0 - 2023-07-23

This release is a major change on the UI contributed by @themoenen, refer to
PR#55 for the full list of changes:

Added

• background_color="white" parameter added to display and save to control the background
  color of each cell.
• Property values displayed via subset or tooltip can now be copied by clicking them.

Changed

• Responsiveness: the grid as well as all UI components are now fully responsive, up until around
  ~415px wide. Smaller usage seems unlikely.
• n_items_per_page replaces the n_rows and n_cols parameters. The responsive CSS assumes
  results to be a multiple of 12, otherwise a gap is displayed at the end of the grid.
• Hover tooltips: now displayed when hovering the i icon, and anchored by clicking this icon.
• Save CVS: When exporting as CSV we now use a semicolon ; as delineator instead of a tab, this
  way CSVs are properly previewed on Mac.
• Templates: the pages/table templates and corresponding functions have been renamed to
  interactive/static for clarity.
• Parameters width and height have been renamed to iframe_width and iframe_height to be more
  descriptive.
• Improved the sorting UI to be more intuitive.
• You can now toggle between text/SMARTS search instead of having to click a dropdown.
• The checkbox menu icon was replaced with a more standard triple dot menu.
• The mols2grid-id is now permanently displayed next to the checkbox in the corner.
• SVGs are now rendered with a transparent background.
• The entire cell is now clickable, instead of just the tiny checkbox.
• Implemented some basic keyboard navigation: ENTER / ESC for selecting / unselecting, arrows and
  TAB for navigation.
• Copy to clipboard: this will now record a tab delineated text which is ready to be pasted into a
  spreadsheet, instead of the less useful dictionary format.
• The tooltip_trigger parameter has been removed since callback and hover functionalities don't
  overlap anymore.
• We're now automatically adding "img" to the subset instead of throwing an error.
• A smaller default font size (12px) makes the experience out of the box a bit more practical.

Fixed

• Docstring now mention default values and some inconsistencies have been fixed.
• All UI elements are now neatly aligned and displayed on top so they're accessible without
  scrolling.
• Longer property values are now only truncated in the interactive grid, and broken into multiple
  lines by default in the static grid, as it is mostly meant for printing. A new parameter
  truncate lets you override the default truncating behavior.
• The tooltip display zone (around which the tooltip is displayed) is now the entire cell instead
  of only the image, so it never overlaps with any of the cell's data or functionality.
• When you download a CSV or SMILES file without any cells selected, you will now download data for
  all cells instead of an empty document.
• Parameter gap in static template didn't work.
• We no longer resize the iframe if a custom iframe_height is set by the display function.

v1.1.1 - 2023-03-18

Added

• Support for pathlib.Path objects as input for display, save, MolGrid.from_sdf
  and sdf_to_dataframe.

Changed

• The hover tooltip placement has been changed from "bottom" to "auto".
• Code and notebook formatting with black and isort.
• Switched to hatchling for the build process, tbump for versioning, and migrated to
  using only the pyproject.toml file.
• Refactored tests to use Pytest's contest.py file.

Fixed

• CSV export when sorting the grid was not using the selected molecules.

v1.1.0 - 2022-12-24

Added

• Predefined JavaScript callbacks in the mols2grid.callbacks module. Those can be
  extensively configured:
  • info: displays a bigger image alongside some common descriptors for the molecule
  • show_3d: displays the molecule in 3D
  • external_link: opens a new tab. By default, opens Leruli.com
    using the SMILES of the molecule.
• Support for tuple of molecules in display and save.

Changed

• The "click" event is now automatically removed from tooltip_trigger when
  specifying a callback.

Fixed

• Issue #34: text searches containing any of the following regex characters
  -[]{}()*+?.,\^$|# would automatically return an empty grid, preventing searching
  for CAS numbers and any other identifier or text containing the above characters. This
  has been temporarily patched until a proper fix is released in the underlying
  list.js library.
• The link to the KNIME component on the corresponding badges has been fixed.

v1.0.0 - 2022-06-07

Added

• Notebooks running in VSCode and Jupyter Lab now support accessing selections from
  Python, executing Python callback functions, and filtering based on other widgets.

Changed

• Python callbacks can now also be lambda functions.
• If prerender=True, substructure highlighting will be automatically disabled by
  default instead of raising an error.
• When exporting a selection to a SMILES file through the GUI, the output no longer
  contains a header.
• Relies on a custom ipywidget to handle communication between the front-end/Javascript
  and the back-end/Python.
• When calling grid.filter and other filtering methods, mols2grid will now use the
  filtering code based on ipywidgets, except for Streamlit where it will use the older
  JavaScript version of the code to maintain compatibility.

Fixed

• Automatically fitting to the content's height in Streamlit.

Removed

• mapping argument for renaming fields, replaced by rename in v0.1.0.
• mols2grid.selection, replaced by mols2grid.get_selection() in v0.1.0.

v0.2.4 - 2022/05/29

Fixed

• Calling MolGrid.get_selection() when 2 grids with different names are present now returns the correct selection (Issue #31)

v0.2.3 - 2022/05/10

Fixed

• Doing a substructure search on molecules with explicit hydrogens should now highlight
  the correct atoms.

v0.2.2 - 2022/04/04

Added

• A proper documentation page with tutorials can now be accessed online.
• Added a single_highlight=False parameter to only highlight a single match per
  molecule in substructure queries.
• Added a "Check matching" button that only selects items that match the current search
  and/or filters.
• Added custom_css, custom_header and sort_by to the "table" template

Changed

• Compounds matching a substructure search are now aligned to the query molecule before
  rendering the image.
• When doing a substructure search, all matches are now highlighted by default. To only
  show a single one, use single_highlight=True.
• The Check all, Uncheck all and Invert selection buttons have been fixed. They now
  actually check/uncheck ALL items, and not just the ones matching the current search. A
  Check matching button has been added to reproduce the old behaviour.
• If both subset and tooltip are None, the index and image will be directly
  displayed on the grid while the remaining fields will be in the tooltip. This makes the
  default representation much more readable.
• The default number of columns is now 5 for template="table" (same as the other default
  template)

Fixed

• template="table" now correctly displays images when prerender=True (Issue #27)
• Displaying the grid with template="table" in a notebook now automatically fits to the
  content of the table.

v0.2.1 - 2022/02/23

Fixes

• Field names containing spaces are now correctly delt with
• The text search now looks for matches inside the values of the tooltip fields, rather than inside the HTML code of the tooltip which included tags and other irrelevant text
• Fixed an encoding bug when saving the grid as an HTML file on French Windows, which uses CP-1252 encoding instead of UTF-8