# Changelog

## v0.6.96

* **Bug Fixes**
  * Fixed lack of auto-updating after import of items
  * Fixed bug where contextual buttons were added multiple times over each other
  * Fixed missing space between creator name & creator role
  * Fixed bug where search panel could be opened on top of another dialog
  * More consistent/detailed ARIA labelling of DOM elements
* **Improvements/QoL**
  * **Backend/Metadata**
    * Tags are automatically retrieved for each library
    * Speed optimizations for Roam API queries
    * More reusable Pagination class
  * **Visual/CSS improvements**
    * Added icons to context menus
    * Dialogs can be closed by clicking on their backdrop
    * Open-in-Zotero buttons have different labels to distinguish between Web library and local app
    * Better display of in-panel item information
      * Cleaner look&#x20;
        * Metadata now matches what shows in list view
        * Item DOI/URL (if exists) now directly visible
        * Creators list moved to bottom section
        * "Copy as..." buttons now have outlined styling for better differentiation
      * Creators and tags which exist in Roam are now functional links (click to navigate to their Roam page)
* **New features**
  * :label: Tag Manager (*early version*)

## v0.6.91

* **Bug Fixes**
  * Fixed page contents shifting to the left when a contextual button is present (=> DNP log)
  * Fixed inconsistent DOI parsing & matching (lowercase vs. uppercase/multicase)
  * Fixed inconsistent navigation to citekey pages, using the new `roamAlphaAPI` method
* **Improvements/QoL**
  * **Metadata import**
    * More intuitive syntax for the settings
    * Metadata template can now be either a JavaScript function or a SmartBlock
  * **Visual/CSS improvements**
    * `data-*` (and other) attributes are now available in list displays
      * Enable contextual customization
    * Better display for mobile & smaller screens
    * Better display of library backlinks
      * Logical ordering (by year of publication)
      * Alternating highlighting to facilitate parsing
      * More informative "add" buttons
    * Better library search panel
      * Cleaner, more compact look
      * Highlighting of search terms
      * Visual differentiation of items in-graph vs. Zotero-only
      * Sorting by match ranking (matches in title prioritized, single field over multi-field)
      * Performance improvement upon opening
* **New user settings**&#x20;
  * `render_inline: true` will render inline citekey references of type `[[@citekey]` as citations of type `Smith et al. (2003)`.
* **New features**
  * :mag\_right: Exploratory search : import items from the web *(early version)*
  * :bricks: SmartBlocks integration *(early version)*

## v0.6.65

* **Bug Fixes**
  * Removed limit of 25 collections displayed per library when importing items
  * Fixed on-page menu not displaying when there is an error retrieving citations data
  * Fixed DOI parsing issue when the DOI is not in the right format

## v0.6.62

* **Bug Fixes**
  * Notes parsing will now clean closing `</span>` tags
  * Conflict with Roam42 Smartblocks V1 (due to tribute) is fixed
* **Improvements/QoL**
  * Related items
  * * Now includes references (substitution of the Scite.ai API for the Semantic Scholar API)
    * List is sorted by first author's last name, and organized into references vs. citing papers
  * Metadata import
    * Block objects now support the latest update to the roamAlphaAPI : `children-view-type`, `alignment`, and `heading` parameters can be specified
  * Notes import
    * Notes are now nested under a `[[Notes]]` block
  * Cleaner handling of event listeners in the code base, through event delegation
  * Deletion of items in Zotero will now be reflected in the extension's data store
* **New user settings**
  * [`theme`](/zotero-roam/v0.6/customization/other/theme.md) lets you add a custom class to the extension's Blueprint dialogs and the on-page menu.&#x20;
    * Using `theme: "bp3-dark"` will directly trigger [Blueprint's dark theme](/zotero-roam/v0.6/customization/other/theme.md#blueprint-dark-theme) !
  * `pageMenu`
    * New sub-setting : [`trigger`](/zotero-roam/v0.6/customization/custom-page-menu.md#display-triggers)
      * Specifies when to trigger on-page menu/contextual buttons
* **New features** :&#x20;
  * [**Adding references/citing papers to Zotero**](/zotero-roam/v0.6/how-to/onpage.md#adding-items-to-zotero)
  * [**Contextual buttons**](/zotero-roam/v0.6/how-to/context-buttons.md)
    * Daily Notes pages --> `XX items added`
    * Non-DNP, non-citekey pages --> `XX items tagged` + `YY abstracts`
  * [**Custom events**](/zotero-roam/v0.6/customization/custom-events.md)

## v0.6.30

* **Bug Fixes**
  * PDF links for items in group libraries now have the right target (in panel and page menu)
  * When using creator types with `zoteroRoam.formatting.getCreators`, "author" no longer appears
  * Panel sizing is determined according to viewport size rather than absolute dimensions
* **Improvements/QoL**
  * More extensive use of Blueprint's CSS classes for styling
  * Results lists scroll when navigated instead of overflowing

## v0.6.27

* **Bug Fixes**
  * Local/web links for items in group libraries now have the right target
  * DOI links open in new tab
* **Improvements/QoL**
  * Updated the [autoComplete](https://tarekraafat.github.io/autoComplete.js) dependency
  * Small styling adjustments
  * Item rendering in library panel
    * Added "Open in browser" button, which opens the item's DOI record or its URL (if available)

## v0.6.25

* **Bug Fixes**
  * PDF links for items in group libraries now have the right target (from utils function)
* **Improvements/QoL**
  * Restyling of library search panel & citations search panel
    * Removed clunky header/footer in the dialog box, optimization of space taken up
    * Distinct styling for library search vs. citations
    * Added visual cues for abstract & action items to enhance readability
    * Library search only
      * Notes can be toggled & are displayed in a sliding drawer (no more scrolling)
    * Citations search only
      * The citekey for the cited item is displayed in the dialog's header
  * Context menu for page references
    * Added "View item information" option
  * On-page menu
    * Added "View item information" / "Open in Zotero (local)" / "Open in Zotero (web)" options
  * Notes import
    * Built-in parser now scrubs newlines at the beginning/end of blocks
  * Library search panel can now be launched from the Roam Command Palette
* **New user settings**
  * `pageMenu` can be defined, with a `defaults` property that specifies which items to include in the on-page menu ([docs page](/zotero-roam/v0.6/customization/custom-page-menu.md))
  * Shortcuts
    * `toggleNotes` can be used to show/hide notes when viewing an item's information in the search panel

## v0.6.18

* **Bug Fixes**
  * Autocomplete
    * Trigger can include special characters that have meaning in RegEx, like `*`&#x20;
  * Metadata formatting
    * `getItemChildren` has proper return value of `false` when there are no notes
    * `getCreators` now has an option to turn off brackets around creators' names
  * Notes import
    * Bug fix : discrepancies between import of notes within metadata vs. separate import
    * Built-in parser `parseNoteBlock` scrubs newlines at the beginning and end of blocks
  * Search panel
    * "Go to page" button works more reliably, and becomes active when page is created
    * Added small delay when opening, to prevent shortcut from printing characters in the searchbar

## v0.6.0

* **New feature** : [on-page menu](https://alix-lahuec.gitbook.io/zotero-roam/how-to/onpage) \
  \&#xNAN;*Provides action menu for each page opened in main section/sidebar*
  * Buttons for importing metadata & notes
  * List of links to PDF attachments
  * Scite.ai badge
  * List of external links (Connected Papers, Semantic Scholar, Google Scholar)
  * Ability to browse citing papers
    * In library
    * All with metadata available
* **New user settings**
  * `notes` lets you [customize the HTML parsing of Zotero notes](/zotero-roam/v0.6/customization/other/notes.md)
  * `autoload` makes the extension [activate itself upon each graph load](/zotero-roam/v0.6/customization/other/autoload-autoupdate.md)
  * `autoupdate` makes the extension [check for new/modified data every 60s](/zotero-roam/v0.6/customization/other/autoload-autoupdate.md)
* **Improvements/QoL**
  * Autocomplete
    * New option `format: 'popover'` will insert a popover element containing the embedded page
  * Search panel
    * Search is now multi-field instead of single-field
  * General UI/UX
    * Harmonizing of the CSS classes system
    * Cleanup of some injected CSS
    * Substitution of `alert` for BP3 toast notifications
* **Bug Fixes**
  * Autocomplete dropdown shows correct the publication year, instead of being off by one\
    (bug was happening with timezones West of UTC)
  * Context menu appears more reliably than before\
    (was due to conflict with native menu, resulting in neither menu showing up)
  * PDF links of type `"imported_url"` are generated with the correct target
  * Import of metadata to wrong page in sidebar is fixed\
    (was due to problems in identifying the DOM element containing the target UID)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://alix-lahuec.gitbook.io/zotero-roam/v0.6/changelog.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
