Release: Prerelease 9.2.0-alpha.2

CHANGELOG.md

@@ -1,3 +1,9 @@
+## 9.1.1
+
+- CLI: Fix throwing in readonly environments - [#31785](https://github.com/storybookjs/storybook/pull/31785), thanks @JReinhold!
+- Onboarding: Tweak referral wording in survey - [#32185](https://github.com/storybookjs/storybook/pull/32185), thanks @shilman!
+- Telemetry: Send index stats on dev exit - [#32168](https://github.com/storybookjs/storybook/pull/32168), thanks @shilman!
+
 ## 9.1.0
 
 Storybook 9.1 is packed with new features and improvements to enhance accessibility, streamline testing, and make your development workflow even smoother!

CHANGELOG.prerelease.md

@@ -1,3 +1,7 @@
+## 9.2.0-alpha.2
+
+- Onboarding: Tweak referral wording in survey - [#32185](https://github.com/storybookjs/storybook/pull/32185), thanks @shilman!
+
 ## 9.2.0-alpha.1
 
 - Addon Docs: Add `__STORYBOOK_UNSAFE_TOCBOT__` global - [#32176](https://github.com/storybookjs/storybook/pull/32176), thanks @yannbf!

code/addons/onboarding/src/features/IntentSurvey/IntentSurvey.tsx

@@ -111,7 +111,7 @@ export const IntentSurvey = ({
       },
     },
     referrer: {
-      label: 'How did you learn about Storybook?',
+      label: 'How did you discover Storybook?',
       type: 'select',
       required: true,
       options: shuffleObject({

code/lib/cli-storybook/src/automigrate/helpers/logMigrationSummary.test.ts

@@ -111,7 +111,7 @@ describe('logMigrationSummary', () => {
 
       The automigrations try to migrate common patterns in your project, but might not contain everything needed to migrate to the latest version of Storybook.
 
-      Please check the changelog and migration guide for manual migrations and more information: https://storybook.js.org/docs/migration-guide
+      Please check the changelog and migration guide for manual migrations and more information: https://storybook.js.org/docs/releases/migration-guide
       And reach out on Discord if you need help: https://discord.gg/storybook"
     `);
   });
@@ -132,7 +132,7 @@ describe('logMigrationSummary', () => {
 
       The automigrations try to migrate common patterns in your project, but might not contain everything needed to migrate to the latest version of Storybook.
 
-      Please check the changelog and migration guide for manual migrations and more information: https://storybook.js.org/docs/migration-guide
+      Please check the changelog and migration guide for manual migrations and more information: https://storybook.js.org/docs/releases/migration-guide
       And reach out on Discord if you need help: https://discord.gg/storybook"
     `);
   });
@@ -153,7 +153,7 @@ describe('logMigrationSummary', () => {
 
       The automigrations try to migrate common patterns in your project, but might not contain everything needed to migrate to the latest version of Storybook.
 
-      Please check the changelog and migration guide for manual migrations and more information: https://storybook.js.org/docs/migration-guide
+      Please check the changelog and migration guide for manual migrations and more information: https://storybook.js.org/docs/releases/migration-guide
       And reach out on Discord if you need help: https://discord.gg/storybook"
     `);
   });

code/lib/cli-storybook/src/automigrate/helpers/logMigrationSummary.ts

@@ -63,7 +63,7 @@ export function logMigrationSummary({
     The automigrations try to migrate common patterns in your project, but might not contain everything needed to migrate to the latest version of Storybook.
 
     Please check the changelog and migration guide for manual migrations and more information: ${picocolors.yellow(
-      'https://storybook.js.org/docs/migration-guide'
+      'https://storybook.js.org/docs/releases/migration-guide'
     )}
     And reach out on Discord if you need help: ${picocolors.yellow('https://discord.gg/storybook')}
   `);

code/lib/cli-storybook/src/upgrade.ts

@@ -265,7 +265,7 @@ function logUpgradeResults(
   }
 
   logger.log(
-    `For a full list of changes, please check our migration guide: ${CLI_COLORS.cta('https://storybook.js.org/docs/migration-guide')}`
+    `For a full list of changes, please check our migration guide: ${CLI_COLORS.cta('https://storybook.js.org/docs/releases/migration-guide')}`
   );
 }
 

code/package.json

@@ -285,5 +285,6 @@
         "Dependency Upgrades"
       ]
     ]
-  }
+  },
+  "deferredNextVersion": "9.2.0-alpha.2"
 }

docs/_snippets/after-each-in-meta.md

@@ -0,0 +1,185 @@
+```ts filename="Page.stories.ts" renderer="angular" language="ts"
+import type { Meta, StoryObj } from '@storybook/angular';
+
+import { Page } from './Page';
+
+const meta: Meta<Page> = {
+  component: Page,
+  // 👇 Runs after each story in this file
+  async afterEach(context) {
+    console.log(`✅ Tested ${context.name} story`);
+  },
+};
+export default meta;
+
+type Story = StoryObj<Page>;
+
+export const Default: Story = {
+  async play({ canvas }) {
+    // ...
+  },
+};
+```
+
+```svelte filename="Page.stories.svelte" renderer="svelte" language="js" tabTitle="Svelte CSF"
+<script module>
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+
+  import Page from './Page.svelte';
+
+  const meta = defineMeta({
+    component: Page,
+    // 👇 Runs after each story in this file
+    async afterEach(context) {
+      console.log(`✅ Tested ${context.name} story`);
+    },
+  });
+</script>
+
+<Story name="Default" play={async ({ canvas }) => {
+  // ...
+  }}
+/>
+```
+
+```js filename="Page.stories.js" renderer="svelte" language="js" tabTitle="CSF"
+import Page from './Page.svelte';
+
+export default {
+  component: Page,
+  // 👇 Runs after each story in this file
+  async afterEach(context) {
+    console.log(`✅ Tested ${context.name} story`);
+  },
+};
+
+export const Default = {
+  async play({ canvas }) {
+    // ...
+  },
+};
+```
+
+```js filename="Page.stories.js" renderer="common" language="js"
+import { Page } from './Page';
+
+export default {
+  component: Page,
+  // 👇 Runs after each story in this file
+  async afterEach(context) {
+    console.log(`✅ Tested ${context.name} story`);
+  },
+};
+
+export const Default = {
+  async play({ canvas }) {
+    // ...
+  },
+};
+```
+
+```svelte filename="Page.stories.svelte" renderer="svelte" language="ts" tabTitle="Svelte CSF"
+<script module>
+  import { defineMeta } from '@storybook/addon-svelte-csf';
+
+  import Page from './Page.svelte';
+
+  const meta = defineMeta({
+    component: Page,
+    // 👇 Runs after each story in this file
+    async afterEach(context) {
+      console.log(`✅ Tested ${context.name} story`);
+    },
+  });
+</script>
+
+<Story name="Default" play={async ({ canvas }) => {
+  // ...
+  }}
+/>
+```
+
+```ts filename="Page.stories.ts" renderer="svelte" language="ts" tabTitle="CSF"
+// Replace your-framework with svelte-vite or sveltekit
+import type { Meta, StoryObj } from '@storybook/your-framework';
+
+import Page from './Page.svelte';
+
+const meta = {
+  component: Page,
+  // 👇 Runs after each story in this file
+  async afterEach(context) {
+    console.log(`✅ Tested ${context.name} story`);
+  },
+} satisfies Meta<typeof Page>;
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  async play({ canvas }) {
+    // ...
+  },
+};
+```
+
+```ts filename="Page.stories.ts" renderer="common" language="ts"
+// Replace your-framework with the framework you are using, e.g. react-vite, nextjs, vue3-vite, etc.
+import type { Meta, StoryObj } from '@storybook/your-framework';
+
+import { Page } from './Page';
+
+const meta = {
+  component: Page,
+  // 👇 Runs after each story in this file
+  async afterEach(context) {
+    console.log(`✅ Tested ${context.name} story`);
+  },
+} satisfies Meta<typeof Page>;
+export default meta;
+
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+  async play({ canvas }) {
+    // ...
+  },
+};
+```
+
+```js filename="Page.stories.js" renderer="web-components" language="js"
+export default {
+  component: 'my-page',
+  // 👇 Runs after each story in this file
+  async afterEach(context) {
+    console.log(`✅ Tested ${context.name} story`);
+  },
+};
+
+export const Default = {
+  async play({ canvas }) {
+    // ...
+  },
+};
+```
+
+```ts filename="Page.stories.ts" renderer="web-components" language="ts"
+import type { Meta, StoryObj } from '@storybook/web-components-vite';
+
+const meta: Meta = {
+  component: 'my-page',
+  // 👇 Runs after each story in this file
+  async afterEach(context) {
+    console.log(`✅ Tested ${context.name} story`);
+  },
+};
+export default meta;
+
+type Story = StoryObj;
+
+export const Default: Story = {
+  async play({ canvas }) {
+    // ...
+  },
+};
+```

docs/_snippets/automock-register-full.md

@@ -0,0 +1,21 @@
+```ts filename=".storybook/preview.ts" renderer="common" language="ts"
+import { sb } from 'storybook/test';
+
+// 👇 Automatically replaces all exports from the `lib/session` local module with mock functions
+sb.mock(import('../lib/session.ts'));
+// 👇 Automatically replaces all exports from the `uuid` package in `node_modules` with mock functions
+sb.mock(import('uuid'));
+
+// ...rest of the file
+```
+
+```js filename=".storybook/preview.js" renderer="common" language="js"
+import { sb } from 'storybook/test';
+
+// 👇 Automatically replaces all exports from the `lib/session` local module with mock functions
+sb.mock('../lib/session.js');
+// 👇 Automatically replaces all exports from the `uuid` package in `node_modules` with mock functions
+sb.mock('uuid');
+
+// ...rest of the file
+```

docs/_snippets/automock-register-mock-file.md

@@ -0,0 +1,21 @@
+```ts filename=".storybook/preview.ts" renderer="common" language="ts"
+import { sb } from 'storybook/test';
+
+// 👇 Replaces imports of this module with imports to `../lib/__mocks__/session.ts`
+sb.mock(import('../lib/session.ts'));
+// 👇 Replaces imports of this module with imports to `../__mocks__/uuid.ts`
+sb.mock(import('uuid'));
+
+// ...rest of the file
+```
+
+```js filename=".storybook/preview.js" renderer="common" language="js"
+import { sb } from 'storybook/test';
+
+// 👇 Replaces imports of this module with imports to `../lib/__mocks__/session.ts`
+sb.mock('../lib/session.js');
+// 👇 Replaces imports of this module with imports to `../__mocks__/uuid.ts`
+sb.mock('uuid');
+
+// ...rest of the file
+```

docs/_snippets/automock-register-spy.md

@@ -0,0 +1,21 @@
+```ts filename=".storybook/preview.ts" renderer="common" language="ts"
+import { sb } from 'storybook/test';
+
+// 👇 Automatically spies on all exports from the `lib/session` local module
+sb.mock(import('../lib/session.ts'), { spy: true });
+// 👇 Automatically spies on all exports from the `uuid` package in `node_modules`
+sb.mock(import('uuid'), { spy: true });
+
+// ...rest of the file
+```
+
+```js filename=".storybook/preview.js" renderer="common" language="js"
+import { sb } from 'storybook/test';
+
+// 👇 Automatically spies on all exports from the `lib/session` local module
+sb.mock('../lib/session.js', { spy: true });
+// 👇 Automatically spies on all exports from the `uuid` package in `node_modules`
+sb.mock('uuid', { spy: true });
+
+// ...rest of the file
+```