Apostrophe 4.10.0: Small Fixes, Big Impact - REST API Enhancements, Vite tweaks, and Import-Export Updates

[BoDonkey]

Howdy from Apostrophe Central!

This release cycle was brief, thanks to the upcoming holidays in the United States, but it's packed with impactful refinements and useful improvements to enhance your ApostropheCMS experience. Read on for the details.

Widget rendering options for the REST API

Headless CMS users rejoice! You now have more options for accessing the rendered HTML of areas in REST API responses. Choose between query parameters for fetching the HTML of entire areas or individual widgets. Bonus: the rich text widget now provides full URLs (rather than just internal IDs) for links and inline images during RESTful rendering.

Tweaks to the Apostrophe build

Our beta Vite build tool is shaping up to make ApostropheCMS development faster and more efficient. We’ve added more options to streamline workflows, especially around hot module replacement. Stay tuned in the coming weeks for guidance on taking full advantage of these features. Our stable release is planned for December 18. In the meantime, explore how to migrate your project to ESM and unlock new possibilities and share your experiences in Discord.

Import-Export extension improvements

The Import-Export extension just got better! You can now choose to import all documents as drafts—even if they were published in the original site. This provides more control and flexibility when moving content between projects.

We’ve got one more release planned before the year ends, so stay tuned. In the meantime, remember: a simple npm update keeps your project up-to-date with all the latest and greatest from ApostropheCMS!

Apostrophe 4.10.0

Fixes

• Extra bundle detection when using external build module works properly now.
• Widget players are now properly invoked when they arrive later in the page load process.
• Fix permission grid tooltip display.
• Fixes a bug that crashes external frontend applications.
• Fixes a false positive warning for module not in use for project level submodules (e.g. widges/module.js) and dot-folders (e.g. .DS_Store).
• Bumped express-bearer-token dependency to address a low-severity npm audit warning regarding noncompliant cookie names and values. Apostrophe
  did not actually use any noncompliant cookie names or values, so there was no vulnerability in Apostrophe.
• Rich text "Styles" toolbar now has visually focused state.
• The renderPermalinks and renderImages methods of the @apostrophecms/rich-text module now correctly resolve the final URLs of page links and inline images in rich text widgets, even when the user has editing privileges. Formerly this was mistakenly prevented by logic intended to preserve the editing experience. The editing experience never actually relied on the
  rendered output.
• Search bar will perform the search even if the bar is empty allowing to reset a search.
• Fixes Color picker being hidden in an inline array schema field, also fixes rgba inputs going off the modal.

Adds

• It's possible now to target the HMR build when registering via template.append and template.prepend. Use when: 'hmr:public' or when: 'hmr:apos' that will be evaluated against the current asset options.hmr configuration.
• Adds asset module option options.modulePreloadPolyfill (default true) to allow disabling the polyfill preload for e.g. external front-ends.
• Adds bundleMarkup to the data sent to the external front-end, containing all markup for injecting Apostrophe UI in the front-end.
• Warns users when two page types have the same field name, but a different field type. This may cause errors or other problems when an editor switches page types.
• The piece and page GET REST APIs now support ?render-areas=inline. When this parameter is used, an HTML rendering of each widget is added to that specific widget in each area's items array as a new _rendered property. The existing ?render-areas=1 parameter is still supported to render the entire area as a single _rendered property. Note that this older option also causes items to be omitted from the response.

Changes

• Removes postcss plugin and webpack loader used for breakpoint preview mode. Uses instead the new postcss-viewport-to-container-toggle plugin in the webpack config.
• Implement vue-color directly in Apostrophe rather than as a dependency
• Switch color handling library from tinycolor2 to @ctrl/tinycolor
• Removes error messages in server console for hidden fields. These messages should not have been printed out in the server console in the first place.
• Removes invalid error messages on select fields appearing while opening an existing valid document.

Apostrophe modules

@apostrophecms/import-export 2.5.0 (2024-11-08)

This module enables import and export of pages and pieces, with or without related documents such as files, images and other related types.

Adds

• Adds a checkbox to the import modal that, when selected, imports published versions of documents from an export file as drafts. If a document doesn’t have a published version, it will still be imported. Setting the importDraftsOnlyDefault: true option selects this checkbox by default.

@apostrophecms/vite 1.0.0-beta.2

This extension provides Vite integration for ApostropheCMS projects, enabling module bundling and hot module replacement (HMR) during development.

Adds

• Adds postcss supports for the new postcss-viewport-to-container-toggle that allows the breakpoint preview feature to work.
• Loads postcss config file from project only for public builds.
• Adds autoprefixer plugin only for apos builds.
• Adds module debug logs when in asset debug mode (APOS_ASSET_DEBUG=1).
• Adds an option for disabling the module preload polyfill.
• Adds support for synthetic entrypoints, that will only process the entrypoint prologue.
• Adds support for Modules/... alias for the public builds (Webpack BC).
• Our Vite alias plugin now throws with an useful error message when Modules/ alias resolver fails.
• Adds sass resolver for Modules/ alias. It works for both public and private builds in exactly the same way as the JS resolver.

Fixes

• Don't crash when there is no entrypoint of type index.

Utilities

@apostrophecms/apostrophe-astro 1.1.0

This module integrates ApostropheCMS into your Astro application.

Adds

• Add support for automated bundles injection in Edit (apos) mode, required for supporting the new core "manifest" builds (when available).