apostrophe - npm Package Versions

3.48.0 (2023-05-26)

Adds

• For performance, add apos.modules['piece-type']getManagerApiProjection method to reduce the amount of data returned in the manager modal. The projection will contain the fields returned in the method in addition to the existing manager modal columns.
• Add apos.schema.getRelationshipQueryBuilderChoicesProjection method to set the projection used in apos.schema.relationshipQueryBuilderChoices.
• Rich-text inline images now copies the alt attribute from the original image from the Media Library.

Changes

• Remove stripPlaceholderBrs and restorePlaceholderBrs from AposRichTextWidgetEditor.vue component.
• Change tiptap Gapcursor display to use a vertical blinking cursor instead of an horizontal cursor, which allow users to add text before and after inline images and tables.
• You can set max-width on .apos-rich-text-toolbar__inner to define the width of the rich-text toolbar. It will now flow on multiple lines if needed.
• The utilityRail prop of AposSchema now defaults to false, removing the need to explicitly pass it in almost all contexts.
• Mark apos.modules['doc-type'] methods getAutocompleteTitle, getAutocompleteProjection and autocomplete as deprecated. Our admin UI does not use them, it uses the autocomplete('...') query builder. More info at https://v3.docs.apostrophecms.org/reference/query-builders.html#autocomplete'.
• Print a warning with a clear explanation if a module's index.js file contains no module.exports object (often due to a typo), or it is empty.

Fixes

• Now errors and exits when a piece-type or widget-type module has a field object with the property type. Thanks to NuktukDev for this contribution.
• Add a default page type value to prevent the dropdown from containing an empty value.

3.47.0 (2023-05-05)

Changes

• Since Node 14 and MongoDB 4.2 have reached their own end-of-support dates, we are no longer supporting them for A3. Note that our dependency on jsdom 22 is incompatible with Node 14. Node 16 and Node 18 are both still supported. However, because Node 16 reaches its end-of-life date quite soon (September), testing and upgrading directly to Node 18 is strongly recommended.
• Updated sluggo to version 1.0.0.
• Updated jsdom to version 22.0.0 to address an installation warning about the word-wrap module.

Fixes

• Fix extendQueries to use super pattern for every function in builders and methods (and override properties that are not functions).

3.46.0 (2023-05-03)

Fixes

• Adding or editing a piece no longer immediately refreshes the main content area if a widget editor is open. This prevents interruption of the widget editing process when working with the @apostrophecms/ai-helper module, and also helps in other situations.
• Check that e.doc exists when handling content-changed event.
• Require updated uploadfs version with no dependency warnings.

Adds

• Allow sub-schema fields (array and object) to follow parent schema fields using the newly introduced following: '<parentField' syntax, where the starting < indicates the parent level. For example <parentField follows a field in the parent level, <<grandParentField follows a field in the grandparent level, etc. The change is fully backward compatible with the current syntax for following fields from the same schema level.

Changes

• Debounce search to prevent calling search on every key stroke in the manager modal.
• Various size and spacing adjustments in the expanded Add Content modal UI

3.45.1 (2023-04-28)

Fixes

• Added missing styles to ensure consistent presentation of the rich text insert menu.
• Fixed a bug in which clicking on an image in the media manager would close the "insert image" dialog box.
• Update html-to-text package to the latest major version.

3.45.0 (2023-04-27)

Adds

• Rich text widgets now support the insert option, an array which currently may contain the strings image and table in order to add a convenient "insert menu" that pops up when the slash key is pressed. This provides a better user experience for rich text features that shouldn't require that the user select existing text before using them.
• Auto expand inline array width if needed using width: max-content in the admin UI.
• The "browse" button is now available when selecting pages and pieces to link to in the rich text editor.
• The "browse" button is also available when selecting inline images in the rich text editor.
• Images are now previewed in the relationship field's compact list view.
• The new apos-refreshing Apostrophe bus event can be used to prevent Apostrophe from refreshing the main content zone of the page when images and pieces are edited, by clearing the refresh property of the object passed to the event.
• To facilitate custom click handlers, an apos.modal.onTopOf(el1, el2) function is now available to check whether an element is considered to be "on top of" another element in the modal stack.

Changes

• The v-click-outside-element Vue directive now understands that modals "on top of" an element should be considered to be "inside" the element, e.g. clicks on them shouldn't close the link dialog etc.

Fixes

• Fix various issues on conditional fields that were occurring when adding new widgets with default values or selecting a falsy value in a field that has a conditional field relying on it. Populate new or existing doc instances with default values and add an empty null choice to select fields that do not have a default value (required or not) and to the ones configured with dynamic choices.
• Rich text widgets save more reliably when many actions are taken quickly just before save.
• Fix an issue in the oembed field where the value was kept in memory after cancelling the widget editor, which resulted in saving the value if the widget was nested and the parent widget was saved. Also improve the oembed field UX by setting the input as readonly rather than disabled when fetching the video metadata, in order to avoid losing its focus when typing.

3.44.0 (2023-04-13)

Adds

• checkboxes fields now support a new style: 'combobox' option for a better multiple-select experience when there are many choices.
• If the new guestApiAccess option is set to true for a piece type or for @apostrophecms/page, Apostrophe will allow all logged-in users to access the GET-method REST APIs of that module, not just users with editing privileges, even if publicApiProjection is not set. This is useful when the goal is to allow REST API access to "guest" users who have project-specific reasons to fetch access content via REST APIs.
• test-lib/utils.js has new createUser and loginAs methods for the convenience of those writing mocha tests of Apostrophe modules.
• batchOperations permissions: if a permission property is added to any entry in the batchOperations cascade of a piece-type module, this permission will be checked for every user. See batchOperations configuration in modules/@apostrophecms/piece-type/index.js. The check function checkBatchOperationsPermissions can be extended. Please note that this permission is checked only to determine whether to offer the operation.

Fixes

• Fix child page slug when title is deleted

3.43.0 (2023-03-29)

Adds

• Add the possibility to override the default "Add Item" button label by setting the itemLabel option of an array field.
• Adds touch task for every piece type. This task invokes update on each piece, which will execute all of the same event handlers that normally execute when a piece of that type is updated. Example usage: node app article:touch.

Fixes

• Hide the suggestion help from the relationship input list when the user starts typing a search term.
• Hide the suggestion hint from the relationship input list when the user starts typing a search term except when there are no matches to display.
• Disable context menu for related items when their relationship field has no sub-fields configured.
• Logic for checking whether we are running a unit test of an external module under mocha now uses includes for a simpler, safer test that should be more cross-platform.