apostrophe - npm Package Versions

3.20.0

Adds

• Adds French translation of the admin UI (use the fr locale).

3.19.0

Adds

• New schema field type dateAndTime added. This schema field type saves in ISO8601 format, as UTC (Universal Coordinated Time), but is edited in a user-friendly way in the user's current time zone and locale.
• Webpack disk cache for better build performance in development and, if appropriately configured, production as well.
• In development, Webpack rebuilds the front end without the need to restart the Node.js process, yielding an additional speedup. To get this speedup for existing projects, see the nodemonConfig section of the latest package.json in a3-boilerplate for the new "ignore" rules you'll need to prevent nodemon from stopping the process and restarting.
• Added the new command line task apostrophecms/asset:clear-cache for clearing the webpack disk cache. This should be necessary only in rare cases where the configuration has changed in ways Apostrophe can't automatically detect.
• A separate publishedLabel field can be set for any schema field of a page or piece. If present it is displayed instead of label if the document has already been published.

3.18.1

Fixes

• The admin UI now rebuilds properly in a development environment when new npm modules are installed in a multisite project (apos.rootDir differs from apos.npmRootDir).

3.18.0 (2022-05-03)

Adds

• Images may now be cropped to suit a particular placement after selecting them. SVG files may not be cropped as it is not possible in the general case.
• Editors may also select a "focal point" for the image after selecting it. This ensures that this particular point remains visible even if CSS would otherwise crop it, which is a common issue in responsive design. See the @apostrophecms/image widget for a sample implementation of the necessary styles.
• Adds the aspectRatio option for image widgets. When set to [ w, h ] (a ratio of width to height), images are automatically cropped to this aspect ratio when chosen for that particular widget. If the user does not crop manually, then cropping happens automatically.
• Adds the minSize option for image widgets. This ensures that the images chosen are at least the given size [ width, height ], and also ensures the user cannot choose something smaller than that when cropping.
• Implements OpenTelemetry instrumentation.
• Developers may now specify an alternate Vue component to be used for editing the subfields of relationships, either at the field level or as a default for all relationships with a particular piece type.
• The widget type base module now always passes on the components option as browser data, so that individual widget type modules that support contextual editing can be implemented more conveniently.
• In-context widget editor components now receive a focused prop which is helpful in deciding when to display additional UI.
• Adds new configuration option - beforeExit async handler.
• Handlers listening for the apostrophe:run event are now able to send an exit code to the Apostrophe bootstrap routine.
• Support for Node.js 17 and 18. MongoDB connections to localhost will now successfully find a typical dev MongoDB server bound only to 127.0.0.1, Apostrophe can generate valid ipv6 URLs pointing back to itself, and webpack and vue-loader have been updated to address incompatibilities.
• Adds support for custom context menus provided by any module (see apos.doc.addContextOperation()).
• The AposSchema component now supports an optional generation prop which may be used to force a refresh when the value of the object changes externally. This is a compromise to avoid the performance hit of checking numerous subfields for possible changes every time the value prop changes in response to an input event.
• Adds new event @apostrophecms/doc:afterAllModesDeleted fired after all modes of a given document are purged.

Fixes

• Documentation of obsolete options has been removed.
• Dead code relating to activating in-context widget editors have been removed. They are always active and have been for some time. In the future they might be swapped in on scroll, but there will never be a need to swap them in "on click."
• The self.email method of modules now correctly accepts a default from address configured for a specific module via the from subproperty of the email option to that module. Thanks to chmdebeer for pointing out the issue and the fix.
• Fixes _urls not added on attachment fields when pieces API index is requested (#3643)
• Fixes float field UI bug that transforms the value to integer when there is no field error and the first number after the decimal is 0.
• The nestedModuleSubdirs feature no longer throws an error and interrupts startup if a project contains both @apostrophecms/asset and asset, which should be considered separate module names.

3.17.0 (2022-03-31)

Adds

• Full support for the object field type, which works just like array but stores just one sub-object as a property, rather than an array of objects.
• To help find documents that reference related ones via relationship fields, implement backlinks of related documents by adding a relatedReverseIds field to them and keeping it up to date. There is no UI based on this feature yet but it will permit various useful features in the near future.
• Adds possibility for modules to extend the webpack configuration.
• Adds possibility for modules to add extra frontend bundles for scss and js. This is useful when the ui/src build would otherwise be very large due to code used on rarely accessed pages.
• Loads the right bundles on the right pages depending on the page template and the loaded widgets. Logged-in users have all the bundles on every page, because they might introduce widgets at any time.
• Fixes deprecation warnings displayed after running npm install, for dependencies that are directly included by this package.
• Implement custom ETags emission when etags cache option is enabled. See the documentation for more information. It allows caching of pages and pieces, using a cache invalidation mechanism that takes into account related (and reverse related) document updates, thanks to backlinks mentioned above. Note that for now, only single pages and pieces benefit from the ETags caching system (pages' and pieces' getOne REST API route, and regular served pages). The cache of an index page corresponding to the type of a piece that was just saved will automatically be invalidated. However, please consider that it won't be effective when a related piece is saved, therefore the cache will automatically be invalidated after the cache lifetime set in maxAge cache option.

Fixes

• Apostrophe's webpack build now works properly when developing code that imports module-specific npm dependencies from ui/src or ui/apos when using npm link to develop the module in question.
• The es5: true option to @apostrophecms/asset works again.

3.16.1 (2022-03-21)

Fixes

• Fixes a bug in the new Cache-Control support introduced by 3.16.0 in which we get the logged-out homepage right after logging in. This issue only came into play if the new caching options were enabled.