fix remaining issues, clean up deps and update docs

Author: bashmish

.changeset/shiny-sloths-drum.md

@@ -1,4 +1,5 @@
 ---
+'@web/mocks': major
 '@web/storybook-addon-mocks': major
 '@web/storybook-builder': minor
 '@web/storybook-framework-web-components': minor

docs/docs/mocks/migration-to-storybook-9.md

@@ -7,19 +7,21 @@
 You need to:
 
 - update `@web/storybook-builder` and `@web/storybook-framework-web-components` to `^0.3.0`
+- remove outdated `@storybook/*` packages (see links below for more info)
+  - most common ones to remove are `@storybook/addon-essentials`, `@storybook/addon-interactions`, `@storybook/blocks`, `@storybook/test`
+  - most common one to add is `@storybook/addon-docs`
 - update dependencies under the namespace `@storybook/*` and the `storybook` itself to `^9.1.20`
 
 ## General migration guide
 
-Make sure to follow the [Storybook's own migration guide](https://storybook.js.org/docs/releases/migration-guide-from-older-version).
-We recommend to read it carefully, even though big part of it is not directly related to `@web/storybook-builder` or `@web/storybook-framework-web-components`, many small details are too easy to miss, so go through it step by step.
+Make sure to follow the [Storybook's own migration guide](https://storybook.js.org/docs/releases/migration-guide-from-older-version) and look into more [detailed migration notes on GitHub](https://github.com/storybookjs/storybook/blob/next/MIGRATION.md#from-version-8x-to-900).
 
-## Specific migration notes
+We recommend to read all of it carefully, many small details are too easy to miss, so go through it step by step.
+Some changes will be Vite/Webpack specific and unrelated to `@web/storybook-builder` or `@web/storybook-framework-web-components`, skip them.
 
-Apart from Storybook's own migration steps, from the Builder API perspective the `@web/storybook-builder` is considered backwards compatible.
-If you use standard Storybook addons and do not use custom WDS/rollup plugins, you shouldn't require any extra changes.
+## Specific migration notes
 
-However, if you do use something custom, here is a list of some changes that might cause highly unlikely difficulties:
+A few dependencies might need to be updated, only if you use them:
 
-- Storybook 9 consolidated most packages it uses into the main storybook packages. These migrated packages and instructions are found in the [migration guide](https://storybook.js.org/docs/releases/migration-guide-from-older-version#package-structure-changes).
-- CSF 3 is now the default format for stories, but CSF 2 is still supported, so if you have CSF 2 stories, they should work without any changes, but we recommend to migrate them to CSF 3 to get all the benefits of it, e.g. better support for TypeScript and better DX in general.
+- update `@web/mocks` to `^2.0.0` and follow [it's migration guide](https://github.com/modernweb-dev/web/blob/master/packages/mocks/MIGRATION.md)
+- update `@web/storybook-utils` to `^2.0.0`