-
-
Notifications
You must be signed in to change notification settings - Fork 9.4k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Doc Blocks: Add support for of
prop to Primary
block
#23849
Doc Blocks: Add support for of
prop to Primary
block
#23849
Conversation
Hi everyone, this is my first contribution to the codebase. Please let me know if I can improve anything, thanks! |
|
||
const meta = { | ||
const meta: Meta<typeof Primary> = { |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Curious why you changed from the satisfies
operator to direct assignment of the type?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hi, thanks for reviewing my code! I changed it based off other PRs and off of Description.stories.tsx. But this is a good question, and after some research, I'll change it back to satisfies since it's just better for validation and type safety.
docs/api/doc-block-primary.md
Outdated
|
||
Type: CSF file exports | ||
|
||
Specifies the primary (first) story to be rendered. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Can we state something similar to Meta's of
prop description?
Specifies the primary (first) story to be rendered. | |
Specifies which CSF file is used to find the first story, which is then rendered by this block. Pass the full set of exports from the CSF file (not the default export!). |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Yeah sure thing, I'll push a commit with the other fix today.
…son2k/storybook into update-primary-block-of-prop
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@Wilson2k, thanks for addressing the feedback so promptly. Appreciate it 🙏 ! Documentation-wise, it's all good on my end. I'll defer to the other maintainers to see if they have anything else to say about this great contribution.
cc @JReinhold
Hope you have a great day.
Stay safe
Hey @JReinhold could you please take a look? |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Thanks for the PR and the patience, generally looks good! A few minor changes needed, but then it's ready!
MIGRATION.md
Outdated
##### Primary block | ||
|
||
The `Primary` block now also accepts an `of` prop as described above. It still accepts being passed `name` or no props at all. | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
These migration guides are between specific versions, adding this note here communicates that this was introduced in 7.0, while it's probably being introduced in 7.6.
I suggest you create a new top section below the Table Of Content called "From version 7.5.0 to 7.6.0", that includes this content. Given that this will move it "out" of the doc block section, you probably need to add a bit more context and link to this doc block section.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ok sounds good, I'll push a commit along with the other one updating the docs.
Specify 'meta' as the only valid type for useOf Co-authored-by: Jeppe Reinhold <[email protected]>
const resolvedOf = useOf(of || 'meta', ['meta']); | ||
story = getPrimaryFromResolvedOf(resolvedOf); |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm sorry for not realising this sooner, I just thought of it now. I think now that we supply 'meta'
as the only valid type, we don't need the "complex" error handling in getPrimaryFromResolvedOf
, as that is already done within useOf
based on the second argument - it should even be typed correctly.
So maybe you could try this and remove getPrimaryFromResolvedOf
entirely and see if that still works?
const resolvedOf = useOf(of || 'meta', ['meta']); | |
story = getPrimaryFromResolvedOf(resolvedOf); | |
const resolvedOf = useOf(of || 'meta', ['meta']); | |
story = resolvedOf.csfFile.stories[0] || null; |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hey, sorry for the late reply, I just tested it and it seems to work fine. Good catch, I'll push a commit with the changes.
of
prop to Primary
block
Partially implements #22490
What I did
of
prop via useOf with "meta" as only valid typeof
prop toSubtitle
#22552 as an exampleHow to test
yarn storybook:blocks
Checklist
MIGRATION.MD
Maintainers
ci:normal
,ci:merged
orci:daily
GH label to it to run a specific set of sandboxes. The particular set of sandboxes can be found incode/lib/cli/src/sandbox-templates.ts
["cleanup", "BREAKING CHANGE", "feature request", "bug", "build", "documentation", "maintenance", "dependencies", "other"]