Apostrophe 3.51.0 Admin-bar upgrade, rich text polish, open-source collaborations, and fixes

[BoDonkey]

Aloha, Apostrophe Architects!

Today's release, coinciding with the solstice, marks the onset of summer for our friends in the Northern Hemisphere. With this release come added features, tooling updates, and fixes across core and numerous other modules. Let's delve deeper!

The @apostrophecms/admin-bar module got some love in this release. There is now a way to add additional options to the “user” menu on which “Log Out” already appears, and functionality to create additional custom admin bars. On the schema field side, conditionals can now be used within array and object fields. Even though it isn't mentioned in the Changelog, we've also refined the UX for areas and the rich text widget. Give them a whirl!

If you're eager to contribute to the Apostrophe core or our official open-source extensions, we've got you covered with new ESLint and Stylelint packages to ensure your code aligns with our standards. And speaking of open-source contributions, we have not one, not two, but three contributions to the sanitize-html repository this release!

We have been focused for several cycles now on a new major feature, template libraries, and we are almost at the finish line! As always, we are interested in your feedback. Please visit our Productboard to cast your vote on what features we should prioritize or consider next!

Until our next release, remember that optimism in software development is an asset, but Cypress tests are a surety! (Hint, hint - we've also enhanced our Cypress tools repo)

Apostrophe 3.51.0

Adds

• Items can now be added to the user's personal menu in the admin bar, alongside the "Log Out" option. To do so, specify the user: true option when calling self.apos.adminBar.add. This should be reserved for items that manage personal settings.
• When duplicating another document, the _id properties of array items, widgets and areas are still regenerated to ensure uniqueness across documents. However, an _originalId property is now available for reference while the document remains in memory. This facilitates change detection within array items in beforeSave handlers and the like.
• Adds the possibility to add custom admin bars via the addBar() method from the admin-bar module.
• Adds support for conditional fields within array and object field schema. See the documentation for more information.

Fixes

• Uses findForEditing method in the page put route.
• The "Duplicate" option in the page or piece manager now correctly duplicates the
  entire document. This was a regression introduced in 3.48.0. The "Duplicate" option
  in the editor dialog box always worked correctly.

Changes

• Browser URL now changes to reflect the slug of the document according to the mode that is being viewed.

Pro modules

@apostrophecms-pro/data-set 1.0.2

This module provides an easy avenue for low-code data presentation. It creates a data-set piece for the import of comma-separated values (CSV) files. A separate widget allows for the dynamic selection of columns, and display of the data as an HTML table, or in other templates provided by the developer. Contact us or visit our new pricing page to learn more.

Fixes

• Add support for @apostrophecms-pro/document-versions

@apostrophecms-pro/multisite 3.10.0

This module lets you have many ApostropheCMS websites running on a single codebase in a single Node.js process. Each has its own database, users, media uploads, etc. Sites can be created and managed via a dashboard site. Contact us or visit our new pricing page to learn more.

Fixes

• Locales are now renamed properly if their names are changed during the "Duplicate" process to copy a site to a new site.
  Note that apostrophe must also be up to date to leverage this fix.

@apostrophecms-pro/cypress-tools 1.0.0-beta.7

Automated functional browser tests are an important part of quality assurance for enterprise websites and web applications. Cypress is an industry-standard, open-source library for carrying out automated functional browser tests. This module provides a collection of conveniences for testing ApostropheCMS sites and applications within Cypress. Contact us or visit our new pricing page to learn more.

Changes

• depth option in containsWidget converted to a level option. This searches for a specific element in the breadcrumb chain by their relationship to the active widget. The active widget is level: 0, its parent is level: 1, and so on.

Fixes

• Fixes unclosed log streams.

Utilities

sanitize-html 2.11.0

sanitize-html provides a simple HTML sanitizer with a clear API.

• Fix to allow false in allowedClasses attributes. Thanks to Kevin Jiang for this fix!
• Upgrade mocha version
• Apply small linter fixes in tests
• Add .idea temp files to .gitignore
• Thanks to Vitalii Shpital for the updates!
• Show parseStyleAttributes warning in browser only. Thanks to mog422 for this update!
• Remove empty non-boolean attributes via an exhaustive, configurable list of known non-boolean attributes. Thanks to Dylan Armstrong for this update!

@apostrophecms/eslint-config-apostrophe 4.0.0

An ESLint configuration for ApostropheCMS core and officials modules.

Changed

• Upgraded dependencies
• Swapped eslint-plugin-node for eslint-plugin-n which is what standard now uses

Added

• Added missing rules no-var, object-shorthand, array-callback-return, default-case-last, multiline-ternary, no-useless-backreference, no-empty, no-import-assign, no-loss-of-precision, no-unreachable-loop, prefer-regex-literals, n/handle-callback-err, n/no-callback-literal, n/no-deprecated-api, n/no-exports-assign, n/no-new-require, n/no-path-concat, n/process-exit-as-throw

Fixed

• Fixed compare check which was returning some false positives

@apostrophecms/stylelint-config-apostrophe 3.0.0

This module provides a stylelint configuration for the Apostrophe team and contributors.

Changed

• Upgraded dependencies

Removed

• After upgrading to Stylelint 15, 76 rules that enforce stylistic conventions had been deprecated. They have been removed from the config.