Releases: Sitecore/jss
22.2.1
22.2.1
🐛 Bug Fixes
-
[sitecore-jss-react]
[templates/nextjs-xmcloud]
[BYOC] Form's submission is failing (#1966):- Updated @sitecore-feaas/clientside to v0.5.19.
- Updated @sitecore/components to v2.0.1.
- Passed rendering data to FEAAS.ExternalComponent.
Make sure to update the relevant dependencies to be able to use the latest fixes.
-
[sitecore-jss-react]
[templates/nextjs-xmcloud]
Updated @sitecore-cloudsdk to v0.4.1 (#1966)
22.2.0
22.2.0
🛠 Breaking Change
[templates/nextjs-xmcloud]
CloudSDK dependencies have been updated to 0.4.0 (#1933)[templates/nextjs-xmcloud]
@sitecore/components
dependency has been updated to 2.0.0 (#1933)[templates/nextjs-xmcloud]
lib/context
import has been removed. Values fromtemp/config
can be used instead. (#1933)[sitecore-jss-nextjs]
Context
import and@sitecore-jss/sitecore-jss-nextjs/context
submodule have been removed. (#1933)[sitecore-jss-nextjs]
update personalize-middleware for CloudSDK 0.4.0 - passenablePersonalizeCookie
to CloudSDK.addPersonalize() function (#1963)
22.1.4
22.1.4
🐛 Bug Fixes
[sitecore-jss-nextjs]
[sitecore-jss]
Resolved an issue with Netlify where URL query parameters were being sorted, causing redirect failures. Added a method to generate all possible permutations of query parameters, ensuring proper matching with URL patterns regardless of their order. (#1935)[sitecore-jss-nextjs]
Fixed an issue with language-based redirects, ensuring users are correctly redirected to the appropriate language-specific pages rather than defaulting to the primary language. (#1938)
🎉 New Features & Improvements
21.8.0
22.1.3
22.1.3
🐛 Bug Fixes
22.1.2
22.1.2
🐛 Bug Fixes
[sitecore-jss-nextjs]
[templates/nextjs]
Update nextjs to 14.2.7 (#1911)- Make sure to update your app to use the latest Next.js version 14.2.7. It will fix the case when Embedded Personalization / A/B Testing is not executed after navigating through the router links
[sitecore-jss]
Fix isEditorActive returning false in XMCloud Pages (#1912)[templates/nextjs]
[XM Cloud]
FEAAS / BYOC Components are not visible on the page with running A/B test (#1914)- Make sure to update the PagePropsFactory plugins order, these plugins should be executed after the page-props-factory\plugins\personalize.ts plugin to ensure that personalized layout data is used:
- page-props-factory/plugins/component-themes.ts
- page-props-factory/plugins/component-props.ts
- Make sure to update the PagePropsFactory plugins order, these plugins should be executed after the page-props-factory\plugins\personalize.ts plugin to ensure that personalized layout data is used:
[sitecore-jss-nextjs]
Resolved an issue with redirects that was caused by the x-middleware-next header in Next.js. This header prevented the flow from being interrupted properly, resulting in redirects not functioning correctly in certain cases. (#1899)
22.1.1
22.1.1
🎉 New Features & Improvements
[XM Cloud]
[Metadata Mode]
[Next.js]
API was changed, next.js preview data provides a new parameterlayoutKind
therefore, please make the necessary updates in the app inplugins/preview-mode.ts
as shown in the following PR to experience a smooth upgrade.[sitecore-jss]
[sitecore-jss-nextjs]
Passsc_layoutKind
to GraphQLEditingService request header to support shared/final editing layouts (#1907)[sitecore-jss]
GraphQLRequestClient
'srequest
method now supports dynamic headers based on specific request (#1907)
client.request(query, variables, { headers })
22.1.0
22.1.0
🐛 Bug Fixes
[templates/nextjs]
[templates/react]
[templates/vue]
[templates/angular]
Changed formatting in temp/config to prevent parse issues in Unix systems (#1787)(#1791)[sitecore-jss]
GraphQLRequestClientFactory
type is updated andconfig
parameter is now optional. Since it should matchGraphQLRequestClient.createClientFactory
method return type (#1806)[templates/nextjs-sxa]
The banner variant of image component is fixed with supporting metadata mode. (#1826)[sitecore-jss]
[sitecore-jss-react]
DateField empty value is not treated as empty (#1836)[templates/nextjs-sxa]
Fix styles of title component in metadata mode. (#1839)[templates/nextjs-sxa]
Fix missing value of field property in Title component. (#1842)[templates/nextjs-sxa]
The background image in the Container component was being generated from the image ID instead of the mediaUrl parameter. This fix changes that behavior. (#1879)[templates/nextjs-sxa]
The caption of image component has been fixed. (#1874)[sitecore-jss-nextjs]
A bug has been fixed in the redirect middleware that occurred when a user clicked on a link rendered by the Link component from the Next.js library(next/link). (#1876) (#1891) (#1893)(#1895)[sitecore-jss-nextjs]
Disable nextjs image optimization in edit and preview modes. This prevents rendering issues in XM Cloud Pages Edit and Preview.
🎉 New Features & Improvements
[sitecore-jss-react]
Introduce ErrorBoundary component. All rendered components are wrapped with it and it will catch client or server side errors from any of its children, display appropriate message and prevent the rest of the application from failing. It accepts and can display custom error component and loading message if it is passed as a prop to parent Placeholder. (#1786)(#1790)(#1793)(#1794)(#1799)(#1807)(#1829)[sitecore-jss-nextjs]
Enforce CORS policy that matches Sitecore Pages domains for editing middleware API endpoints (#1798#1801)[sitecore-jss]
GraphQLRequestClient now can accept custom 'headers' in the constructor or via createClientFactory (#1806)[templates/nextjs]
Removed cors header for API endpoints from lib/next-config/plugins/cors-header plugin since cors is handled by API handlers / middlewares (#1806)[sitecore-jss-nextjs]
Updates to Next.js editing integration to further support secure hosting scenarios (on XM Cloud & Vercel) (#1832)[templates/nextjs-xmcloud]
[sitecore-jss]
JSS is now ready to support A/B testing and component-level personalization. This feature will be enabled in Pages after the current release. (#1844)(#1847)(#1848)[sitecore-jss]
[nextjs-xmcloud]
DictionaryService can now use asite
GraphQL query instead ofsearch
one to improve performance. This is currently only available for XMCloud deployments and is enabled withnextjs-xmcloud
add-on by default (#1804)(#1846)(commit)(commit)(commit)(commit)[templates/nextjs-sxa]
SXA components now use the NextImage component instead of the Image component from JSS lib for image optimization (#1843)(#1850)(#1860)[sitecore-jss-react]
[sitecore-jss-nextjs]
[sitecore-jss-angular]
[sitecore-jss-vue]
The default Hidden Rendering component now contains the text 'The component is hidden' (#1857)
🛠 Breaking Change
- Editing Integration Support: (#1776)(#1792)(#1773)(#1797)(#1800)(#1803)(#1806)(#1809)(#1814)(#1816)(#1819)(#1828)(#1835)(#1849)(#1831)(#1853)(#1854)(#1857)(#1862)(#1883)
[sitecore-jss-react]
IntroducesPlaceholderMetadata
component which supports the hydration of chromes on Pages by rendering the components and placeholders with required metadata.[sitecore-jss]
Chromes are hydrated based on the basis of neweditMode
property derived from LayoutData, which is defined as an enum consisting ofmetadata
andchromes
.ComponentConsumerProps
is removed. You might need to reuseWithSitecoreContextProps
type.[sitecore-jss-react]
[sitecore-jss-nextjs]
Introduce FieldMetadata component and functionality to render it when metadata field property is provided in the field's layout data. In such case the field component is wrapped with metadata markup to enable chromes hydration when editing in pages. Ability to render metadata has been added to the field rendering components for react and nextjs.[sitecore-jss-react]
IntroducedEditingScripts
component to render clientScripts / clientData in editing.[sitecore-jss-nextjs]
[template/nextjs-xmlcoud]
Add editMode to /editing/config endpoint response with configurable integration option.[sitecore-jss-nextjs]
Integrated a new Metadata Edit Mode in /api/editing/render endpoint.- Exported new
EditingMetadataPreviewData
type andisEditingMetadataPreviewData
guard function.
- Exported new
[sitecore-jss]
IntroducedGraphQLEditingService
class to fetch editing data in Metadata Edit Mode.[templates/nextjs-xmcloud]
Introduced /lib/graphql-editing-service to fetch editing data in Metadata Edit Mode.[templates/nextjs-xmcloud]
Added a new page-props-factory/plugins/preview-mode plugin to handle both Chromes and Metadata Edit Mode.[sitecore-jss]
layout-personalizer will mark components hidden by personalization by setting 'Hidden Rendering' component name in Metadata edit mode
[sitecore-jss]
Introduced /editing submodule that contains all editing related functionality. Editing utils are now available in /editing submodule. Editing utils exported from /utils marked as deprecated. (#1806)[sitecore-jss-nextjs]
EditingRenderMiddlewareresolvePageUrl
function now accepts an object(args: { serverUrl?: string; itemPath: string }) => string
instead of multiple parameters(serverUrl: string, itemPath: string) => string
.serverUrl
is now optional and omitted when Metadata Edit Mode is used.[templates/nextjs]
[sitecore-jss-nextjs]
[sitecore-jss]
Remove Partial rendering implementation as it will not be used by Pages in its current implementation - includes removing of EditingComponentPlaceholder component, few constants associated with it and RenderingType enum (#1821)[sitecore-jss-angular]
[sitecore-jss-schematics]
[templates/angular]
Upgrade Angular to v17 (#1837) (#1841)- Updated Angular and core dependencies to ~17.3.11
- Updated Typescript to ~5.2.2
- Updated import statements from zone.js/dist/zone-node to zone.js
[sitecore-jss/personalize]
[sitecore-jss-nextjs]
CdpHelper.getPersonalizedRewrite
signature changed to acceptvariantIds: string[]
as second parameter.CdpHelper.getContentId
was renamed toCdpHelper.getPageFriendlyId
. (#1848)
🧹 Chores
20.4.0
20.4.0
🛠 Breaking Changes
22.0.0
22.0.0
🛠 Breaking Changes
-
[sitecore-jss]
Switch to edge site query for XP and gets config sites + sxa sites (ignoring website) (#1772)- Previously introduced Boolean
useSiteQuery
switch for XMCloud users has been removed. - Search query usage has been removed.
- If you have any non-nextjs sites they should filter them out in multisite config plugin
- Previously introduced Boolean
-
[sitecore-jss-nextjs]
[templates/nextjs-xmcloud]
CloudSDK dependencies are updated to version ^0.3.0 (#1779)- Please ensure
@sitecore-cloudsdk/events
dependency is updated
- Please ensure
-
[sitecore-jss-nextjs]
Deprecated exports have been removed (#1780):sitecore-jss-nextjs
no longer exportsisEditorActive
,resetEditorChormes
,resolveUrl
,handleEditorFastRefresh
,getPublicUrl
functions. Usesitecore-jss-nextjs/utils
instead.getFEAASLibraryStylesheetLinks
function has been removed in favor ofgetComponentLibraryStylesheetLinks
-
[sitecore-jss-react]
[templates/react]
Deprecatedmedia
prop is removed from Image component. Usefield
prop instead (#1780)(#1785). -
[templates/react]
[templates/angular]
[templates/vue]
[templates/node-headless-ssr-experience-edge]
[sitecore-jss-react]
[sitecore-jss-nextjs]
(#1783):- GraphQL-based services can now only be initialized with clientFactory parameter. Previously deprecated option of providing endpoint and apiKey has been removed
- Removed deprecated defaultProps react component property
-
[templates/nextjs]
GraphQL-based services can now only be initialized with clientFactory parameter. Previously deprecated option of providing endpoint and apiKey has been removed (#1780). -
[templates/nextjs]
[templates/react]
[templates/vue]
[templates/angular]
Deprecated JSS_APP_NAME environment variable has been removed (#1780).
🧹 Chores
- Security vulnerabilities audit (1778)