diff --git a/MIGRATION.md b/MIGRATION.md index bcb6cc51801f..ad9108ec360f 100644 --- a/MIGRATION.md +++ b/MIGRATION.md @@ -2,7 +2,6 @@ - [From version 6.5.x to 7.0.0](#from-version-65x-to-700) - [7.0 breaking changes](#70-breaking-changes) - - [Story context is prepared before for supporting fine grained updates](#story-context-is-prepared-before-for-supporting-fine-grained-updates) - [Dropped support for Node 15 and below](#dropped-support-for-node-15-and-below) - [Modern browser support](#modern-browser-support) - [React peer dependencies required](#react-peer-dependencies-required) @@ -18,6 +17,7 @@ - [Babel mode v7 exclusively](#babel-mode-v7-exclusively) - [Importing plain markdown files with `transcludeMarkdown` has changed](#importing-plain-markdown-files-with-transcludemarkdown-has-changed) - [7.0 feature flags removed](#70-feature-flags-removed) + - [Story context is prepared before for supporting fine grained updates](#story-context-is-prepared-before-for-supporting-fine-grained-updates) - [Core addons](#core-addons) - [Removed auto injection of @storybook/addon-actions decorator](#removed-auto-injection-of-storybookaddon-actions-decorator) - [Addon-backgrounds: Removed deprecated grid parameter](#addon-backgrounds-removed-deprecated-grid-parameter) @@ -281,12 +281,6 @@ A number of these changes can be made automatically by the Storybook CLI. To tak ### 7.0 breaking changes -#### Story context is prepared before for supporting fine grained updates - -This change modifies the way Storybook prepares stories to avoid reactive args to get lost for fine-grained updates JS frameworks as `SolidJS` or `Vue`. That's because those frameworks handle args/props as proxies behind the scenes to make reactivity work. So when `argType` mapping was done in `prepareStory` the Proxies were destroyed and args becomes a plain object again, losing the reactivity. - -For avoiding that, this change passes the mapped args instead of raw args at `renderToCanvas` so that the proxies stay intact. Also decorators will benefit from this as well by receiving mapped args instead of raw args. - #### Dropped support for Node 15 and below Storybook 7.0 requires **Node 16** or above. If you are using an older version of Node, you will need to upgrade or keep using Storybook 6 in the meantime. @@ -586,6 +580,12 @@ In 7.0 we've removed the following feature flags: | `breakingChangesV7` | This flag is no longer needed and should be deleted. | | `babelModeV7` | See [Babel mode v7 exclusively](#babel-mode-v7-exclusively) | +#### Story context is prepared before for supporting fine grained updates + +This change modifies the way Storybook prepares stories to avoid reactive args to get lost for fine-grained updates JS frameworks as `SolidJS` or `Vue`. That's because those frameworks handle args/props as proxies behind the scenes to make reactivity work. So when `argType` mapping was done in `prepareStory` the Proxies were destroyed and args becomes a plain object again, losing the reactivity. + +For avoiding that, this change passes the mapped args instead of raw args at `renderToCanvas` so that the proxies stay intact. Also decorators will benefit from this as well by receiving mapped args instead of raw args. + ### Core addons #### Removed auto injection of @storybook/addon-actions decorator