Index: Fix MDX to override project-level autodocs

[shilman]

Closes N/A

What I did

Fixed a regression introduced by the 8.1 tags work. Previously, you could set docsOptions.autodocs = true in main.js and then override the autodocs at a component level by adding MDX.

Starting in 8.1, we deprecated docsOptions.autodocs and converted to tags. We automigrated docsOptions.autodocs = true to tags: ['autodocs'] in .storybook/preview.js, which is the new equivalent. However, the code to allow overriding project-level autodocs with MDX was not updated.

I also updated all the docsOptions.autodocs = true tests to have tags = ['autodocs'] equivalents. We can delete the old ones in 9.0.

Checklist for Contributors

Testing

The changes in this PR are covered in the following automated tests:

• stories
• unit tests
• integration tests
• end-to-end tests

Manual testing

In a sandbox, write MDX for the button component:

{/* stories/Button.mdx */}
import { Meta, Canvas } from '@storybook/blocks';
import * as ButtonStories from './Button.stories';

<Meta of={ButtonStories} />

# Button

<Canvas of={ButtonStories.Primary} />

• In the old code this will crash with an error You created a component docs page for '${worseEntry.title}', but also tagged the CSF file with '${AUTODOCS_TAG}'. This is probably a mistake.,
• In the new code this will also error, because the user has explicitly tagged the component with autodocs.

Now set tags: ['autodocs'] in .storybook/preview.ts

• In the old code this will also error.
• In the new code, this will override the component's autodocs with MDX.

🦋 Canary release

This PR does not have a canary release associated. You can request a canary release of this pull request by mentioning the @storybookjs/core team here.

core team members can create a canary release here or locally with gh workflow run --repo storybookjs/storybook canary-release-pr.yml --field pr=<PR_NUMBER>

[greptile-apps]

PR Summary

• Updated chooseDuplicate method in /code/core/src/core-server/utils/StoryIndexGenerator.ts to handle project-level autodocs tags.
• Enhanced getProjectTags method in /code/core/src/core-server/utils/StoryIndexGenerator.ts to correctly parse and include autodocs tags.
• Added test cases in /code/core/src/core-server/utils/StoryIndexGenerator.test.ts for scenarios with 'autodocs' tags at project and component levels.
• Verified that MDX files can override project-level autodocs settings in new tests.
• Ensured autogenerated docs entries correctly include 'autodocs' tags.

_{2 file(s) reviewed, 1 comment(s)
Edit PR Review Bot Settings}

[greptile-apps]

🪶 style: Explicitly typed projectTags as Tag[].

[nx-cloud]

☁️ Nx Cloud Report

CI is running/has finished running commands for commit 14ef5cc. As they complete they will appear below. Click to see the status, the terminal output, and the build insights.

📂 See all runs for this CI Pipeline Execution

---

✅ Successfully ran 1 target

• nx run-many -t build --parallel=3

---

Sent with 💌 from NxCloud.

[valentinpalkovic]

Adjustment in src/core-server/utils/StoryIndexGenerator.test.ts:1530:21 also necessary