feat: implement new parameters api, make cli --help work and notify user on page errors that occured while processing stories for Steps

[Hotell]

Fixes:

false positives about Steps presence and execution

fixes false positives regarding story missing Steps definition.

Previously .steps property was always set on story because of logical error.

With this fix .step will exist on processed story only IFF a story really defines Steps

proper --help output

Features:

new API for defining Steps

This API should be used going forward as it supports various use-cases and Storybook version beyond v8

Before:

import {StoryWright, Steps} from 'storywright';
import {Button} from 'ui'

export default {
  component: Button,
  decorators: [ 
    (Story)=>{
       return <StoryWright steps={new Steps().snapshot('default').end()}>{ Story() }</StoryWright>
    }
  ]
}

After:

import {Steps, type StoryParameter} from 'storywright';
import {Button} from 'ui'

export default {
  component: Button,
  parameters: {
   storyWright: { 
       steps: new Steps().snapshot('default').end()
   }
  } satisfies StoryParameter
}

new CLI flag --bailOnStoriesError

💡 This is very useful for CI/CD pipelines to fail if there are any issues with stories or SW and Storybook stories fetching pipeline.

fails SW process in 2 places if enables:

1. errors occurred while processing stories -> it will exit process immediately.

2. errors occurred during creating snapshots images per story

new notification about issues that occurred while processing stories for Steps

previously these issues were consumed within page evaluation which consumer never received

improved Steps execution logging

Before:

After:

Related Issues

• [Bug]: v9 VR tests silently fail when griffel makeStyles api is used directly for story rendering fluentui#33861
• Closes
  • Storywright fails when storyStoreV7 is enabled #68
  • [Bug] StoryWright fails to fetch Steps when hooks are used in story #51

[Hotell]

outcome of running prettier -w

[Hotell]

outcome of running prettier -w

[Hotell]

outcome of running prettier -w

[Hotell]

these were clashing with actual args preventing proper --help output

[Hotell]

this fixes false positives regarding story missing Steps definition. this was previously always setting steps property. with this fix .step will exist on processed story only IFF a story really defines Steps