Merge pull request #5806 from storybooks/5781-document-decorator-changes

Allow local decorators via params

examples/official-storybook/stories/core/decorators.stories.js

@@ -0,0 +1,39 @@
+import React from 'react';
+
+// We would need to add this in config.js idomatically however that would make this file a bit confusing
+import { addDecorator } from '@storybook/react';
+
+addDecorator((s, { kind }) =>
+  kind === 'Core|Decorators' ? (
+    <>
+      <p>Global Decorator</p>
+      {s()}
+    </>
+  ) : (
+    s()
+  )
+);
+
+export default {
+  title: 'Core|Decorators',
+  decorators: [
+    s => (
+      <>
+        <p>Kind Decorator</p>
+        {s()}
+      </>
+    ),
+  ],
+};
+
+export const all = () => <p>Story</p>;
+all.parameters = {
+  decorators: [
+    s => (
+      <>
+        <p>Local Decorator</p>
+        {s()}
+      </>
+    ),
+  ],
+};

examples/official-storybook/tests/__snapshots__/storyshots.test.js.snap

@@ -5077,6 +5077,23 @@ exports[`Storyshots Basics|ScrollArea vertical 1`] = `
 </div>
 `;
 
+exports[`Storyshots Core|Decorators all 1`] = `
+Array [
+  <p>
+    Global Decorator
+  </p>,
+  <p>
+    Kind Decorator
+  </p>,
+  <p>
+    Local Decorator
+  </p>,
+  <p>
+    Story
+  </p>,
+]
+`;
+
 exports[`Storyshots Core|Events Force re-render 1`] = `
 .emotion-0 {
   border: 0;

lib/client-api/src/client_api.js

@@ -203,7 +203,12 @@ export default class ClientApi {
         },
         {
           applyDecorators: this._decorateStory,
-          getDecorators: () => [...localDecorators, ..._globalDecorators, withSubscriptionTracking],
+          getDecorators: () => [
+            ...(allParam.decorators || []),
+            ...localDecorators,
+            ..._globalDecorators,
+            withSubscriptionTracking,
+          ],
         }
       );
       return api;